What Clog actually is: three mechanisms, not one
Clog is the name of one of two token contract templates available through TokenBundle's Deploy Token tool on Robinhood Chain. The name refers to a specific mechanic inside the contract - but the contract itself actually combines three distinct pieces: an anti-snipe window with a whitelist gate, a tax rate that steps down after a set number of trades, and the withholding mechanic the name comes from. Understanding each separately makes the whole contract far easier to reason about.
The anti-snipe window: block-gated, not time-gated, and whitelist-only
When a Clog token's owner calls openTrading(), the contract records an anti-snipe window measured in blocks, not seconds - on Robinhood Chain specifically, it reads the chain's own block number through the ArbSys precompile, since Robinhood Chain runs on the Arbitrum Nitro stack.
For the length of that window, a buy transaction only succeeds if the buyer's address was added to a whitelist beforehand through configureLaunch(address[], bool) - anyone else's buy simply reverts. Whitelisted buyers during the window pay no tax at all on that trade; the window controls who can buy, and while it's open, those approved buyers trade completely tax-free.
- The window length is set in blocks when the token is deployed - there's no fixed default, the creator chooses it.
- Once the window closes, it closes permanently - the next buy after the window ends resets the anti-snipe state for good, with no way to reopen it.
- Wallets are added to the whitelist through configureLaunch(), which only works before trading opens - once openTrading() has been called, the whitelist can no longer be modified.
The stepped tax schedule: not a gradual decline
Clog sets an initial buy tax and an initial sell tax, plus separate final buy and sell tax rates, along with a trade-count threshold. Every taxed buy after the anti-snipe window closes, and every sell, counts toward that threshold. Until the count reaches it, buys and sells pay the initial rates; the moment it's reached, every trade afterward pays the final rates instead - a single switch, not a gradual ramp down.
This is worth being precise about, because a token's own documentation or marketing might describe it as a smooth reduction. Mechanically, the contract implements a step function: one rate, then - at a specific trade count - a different rate, permanently.
The clog mechanic: what actually gets withheld
This is the piece the name refers to, and it's specific to the moment liquidity is first seeded. When the owner calls openTrading(), the contract adds its own held tokens and ETH to a new Uniswap V2 pool. As part of that process, the contract transfers its token balance to the pool - and it's this specific transfer, happening while trading is still technically closed, that the clog percentage applies to.
A clog percentage, set at deployment up to a cap of 50%, is deducted from that transfer before it reaches the pool. The ETH side of the liquidity pair goes in at its full amount; the token side is reduced by the clog percentage. The withheld tokens stay in the contract's own balance rather than entering the pool.
- Practical effect: the pool launches with less token supply paired against the same ETH than the nominal allocation would suggest, which affects the starting price per token.
- The withheld tokens remain in the contract, where they're subject to the same auto-swap-to-ETH mechanism the contract uses for collected tax - they don't just sit there permanently.
- This only happens once, at the moment liquidity is seeded - it has nothing to do with ongoing buy or sell tax, and doesn't recur on later trades.
How the three mechanisms interact in practice
In sequence: the owner seeds the contract with tokens and ETH, then calls openTrading(). The clog percentage is deducted from the token side during that seeding transfer. The anti-snipe window then opens for whitelisted-only, tax-free buying. Once the window closes, ordinary buying and selling begins at the initial tax rates, until enough taxed trades accumulate to switch permanently to the final rates.
FAQ
- Does the clog percentage affect ongoing trading tax? No - it applies once, only to the initial liquidity-seeding transfer, and is separate from the buy/sell tax rates.
- Can whitelisted buyers be taxed during the anti-snipe window? No - buys from whitelisted wallets during the window are tax-free by contract design; tax only starts once the window closes.
- Does the tax rate decrease gradually over time? No - it steps from the initial rate to the final rate in one switch, once a set number of trades has occurred, not on a timer and not gradually.
- What happens to the tokens withheld by the clog percentage? They stay in the contract's balance and are handled by the same mechanism the contract uses to convert collected tax into ETH.
Coordinate your launch with TokenBundle.
Prepare wallets, review allocations and manage network-specific launch execution from one workspace.
Open Robinhood workspace