Optimism Token Manager: Exempt Any Address From the Holding Limit

Built for Tokenry ERC-20s on OP Mainnet, the Optimism token manager changes a token's owner settings, including which addresses its holding limit skips. Only the deploying wallet sees these tabs, and only while it is still the owner. Each change costs gas plus an L1 data fee, both in ETH rather than the OP token, and Tokenry adds no fee.

Optimism ERC-20Free to use, pay only network gas

Token

Choose a token

Showing tokens deployed from your connected wallet

Connect your wallet to see your tokens

Why Tokenry

  • No Code Required

    Create and launch tokens without writing any code. Visual configuration for all features.

  • Fully Transparent

    All token data is publicly visible and verifiable on block explorers.

  • Multi-Chain

    Works on Solana and 8 EVM chains, including Ethereum, Base, Arbitrum, Polygon and BNB Chain.

  • Full Ownership

    You have full control. We never hold your keys, tokens, or authority.

How it works

Exempting an address from the max wallet limit on OP Mainnet

  1. 1

    Token card with an Anti-Whale tab

    Connect the deploying wallet on OP Mainnet. It lists only its own Tokenry tokens, with tabs open while it still owns them. Anti-Whale needs the anti-whale feature from deploy.

  2. 2

    Address pasted under Exempt from the limit

    Open Anti-Whale. It shows Current limit as a percent and Per wallet in tokens. Paste one address per transaction, then press Exempt, or Remove exemption to undo it.

  3. 3

    Contract and network check in the wallet prompt

    Pressing Exempt opens the wallet prompt with no Tokenry screen before it, so confirm the token contract and OP Mainnet there. Success shows "Confirmed on-chain." with an Etherscan link.

Related guide

How to create a token on Optimism

How to create a token on Optimism with no code: deploy an ERC-20 in about a minute, auto-verified on Optimistic Etherscan. You need ETH for gas, not OP.

More guides

All articles

FAQ

Frequently Asked Questions

Something not covered here? Contact support.

How do I let one wallet hold more than my token's max wallet limit?

Exempt it in the Anti-Whale tab. Exempt sends one transaction that calls setExemptFromAntiWhale on your token contract, with no ETH sent and no token approval. The tab lists no exempt addresses, so check one by entering it in isExemptFromAntiWhale under Read Contract on Etherscan, where the contract is verified. Each change also logs an ExemptFromAntiWhaleUpdated event that anyone can read.

Which addresses are exempt from the holding limit when the token is deployed?

The deploying wallet and the token contract, on every token with the limit. A tax token also exempts the DEX router chosen at deploy, Uniswap v2 by default, and newer tax tokens exempt Tokenry's pool launcher too. Its deploy pair skips the check while it stays marked as an LP pair. A new owner and other pools start without one, and the deploying wallet keeps its exemption after a transfer.

Why did a buy or transfer revert with "exceeds max wallet holding"?

The receiving address would have gone over the limit. The contract adds the full amount sent, before any tax, to that address's balance. It reverts with "Token: exceeds max wallet holding" when the sum is higher. A buyer can still receive up to the limit minus its balance. If the receiver is a pool or a contract, exempt it and retry; mints are checked the same way.

Can I turn off the holding limit on my Optimism token?

Not in the Anti-Whale tab. Its field accepts 0.5% to 100%, so it never sends 0, and saving a new holding limit fails for tokens with decimals. The contract itself treats 0 as no limit. Until you renounce, the owner wallet can call setMaxWalletHolding with 0 on Etherscan's Write Contract tab if the contract is verified.

The details

More about the Optimism Token Manager

01

The holding limit as a token amount

The holding limit, labelled Max wallet in the manager, is the most tokens one address may hold. It is a token amount, not a share of supply, set at deploy with the anti-whale feature in the Optimism token creator. On every transfer, buy and mint, only the receiving address is checked; burns never are.

Because the limit is a token amount, a mint lowers its share of supply and a burn raises it. After a renounce, the limit and every exemption can no longer change. Owners of a Tokenry token on Ethereum, Base or Arbitrum One open their chain's page from the token manager hub.

02

Liquidity pools and contracts that need an exemption

A liquidity pool counts as a holder. Apart from a tax token's marked LP pairs, such as its deploy pair with the default router, any other Uniswap v2 pair or v3 pool needs an exemption, and so does the v4 PoolManager, which holds the tokens of v4 pools. Without one, sells and deposits into the pool revert once its balance would pass the limit. A v3 or v4 deposit above the limit through Tokenry's pool creator also needs its pool launcher exempt.

Exempt a v3 pool or the PoolManager only; never mark them as LP pairs, since taxed sells through them revert. Tokenry's pool creator warns when a first deposit is above the limit and links to this manager.

The Optimism multisender sends to up to 400 wallets per transaction. Each transaction first pulls its batch total into the multisender contract, then pays each wallet, so exempt that contract when a batch total would pass the limit; each recipient is still checked.

More Optimism tools

Optimism Token CreatorCreate a new token
Optimism Liquidity Pool CreatorOpen trading for a token
Optimism Add LiquidityDeepen an existing pool
Optimism Remove LiquidityWithdraw your liquidity
Optimism MultisenderAirdrop to many wallets
All Optimism toolsOptimism token hub