Clanker
Introduction to Clanker
Clanker is a set of audited smart contracts that create token markets which reward token creators.
Currently, Clanker deploys ERC-20 tokens on Base in a few ways:
Farcaster users may request @clanker on Farcaster to deploy a token.
Users may use the clanker.world frontend interface and Farcaster Mini App to deploy a token.
Developers may create their own token creation experiences using the Clanker SDK, get started here: Quick Start.
Users / interfaces may directly interact with Clanker's Core Contracts to deploy tokens.
Token creators earn rewards based on trading volume on their created tokens. See Creator Rewards & Fees for more detail.
Token Deployments
Guidelines and specifications for tokens deployed on Clanker v4.0.0
Live: The below outlines instructions for deployments on Clanker v4.0.0 that are now available across all Clanker platforms.
General Token Deployment Info (Clanker v4.0.0)
ERC-20 tokens with a total supply of 100 billion tokens.
Tokens are not mintable post-deployment, so the max supply will always be 100 billion.
Tokens are burnable using the burn() function on the token contract.
Up to 90% of the total supply may be allocated to Clanker extensions. Extensions allow for token creators to allocate tokens for uses other than supplying liquidity in the new token's Uniswap v4 pool. The current list of extensions:
Vault: lock up / vest tokens for a configurable period of time (7 day minimum lockup).
Creator Buy / Dev Buy: spend ETH to execute a token swap within the deployment transaction, allowing for token creators to guarantee that they are able to make the first purchase of tokens from the initial pool.
Airdrop: airdrop tokens to a list of recipients to then claim with configurable lockup / vesting periods (1 day minimum lockup).
The remaining tokens (up to 100% of the total supply if no extensions are used) are then allocated to up to 7 liquidity positions and placed into a Uniswap v4 pool for trading.
When a new token is created, there's a brief "auction period" before normal trading opens to everyone. This auction is designed to capture value from MEV bots (sophisticated trading bots that try to profit from new token launches) and redirect some of the value back to the token's creator.
Normal trading starts after 5 rounds of the auction have completed (roughly 22 seconds post token deployment) or immediately after a round of the auction that has no bidders. The maximum delay before normal trading can start is at block n+11.
For additional detail, please refer to the ClankerSniperAuctionV0 documentation.
Creator Rewards & Fees
Creator Rewards
Token creators earn rewards based on the trading volume of their created tokens. Upon deployment of a standard Clanker token, the full supply of the token is deposited into a single-sided Uniswap v4 LP (the "initial LP"). When traders buy and sell tokens in this pool, the initial LP accrues a fee on each swap. If token holders deposit their own LPs from tokens they hold or initiate new trading pools, token creators will not earn any rewards on these positions / pools.
Deployments through the clanker.world frontend receive all of the initial LP fees as creator rewards. For tokens created through the @clanker bot on Farcaster, token creators earn 80% of the rewards.
Creator rewards can be claimed on the Admin page of the token on clanker.world. The admin page can be found at https://www.clanker.world/clanker/TOKEN_CONTRACT_ADDRESS_HERE/admin .
Please see the FAQ for detail on finding Token Info pages and collecting creator rewards.
Clanker Fees
The Clanker fee is fixed at 20% of LP fees that are collected at the pool level in addition to LP fees.
Last updated