Docs / Manual
Bluedesk manual
Everything you need to launch, trade and manage tokens on Base with Bluedesk. Read Quick start if you are new, or jump to any section from the contents.
01 · Overview
Bluedesk is a token launch terminal for Base. It is an independent interface on top of Clanker v5, the protocol that deploys an ERC-20 token together with its Uniswap v4 pool in a single transaction.
Every launch mints a fixed supply of 1,000,000,000 tokens (18 decimals), and the whole supply goes into the pool. A Clanker v5 token charges a buy tax and a sell tax on every trade. That tax is split between the Clanker protocol, you as the creator, and optionally your holders (dividends) and a burn.
| Area | What you do there |
|---|---|
| Markets | Watch every new Clanker token on Base in real time, sort by newest, market cap or 24h change, and search. |
| Launch | Configure and deploy a token: identity, pair, tax, fee split, dividends, recipients and an optional creator buy. |
| Token page | Price chart, market stats, an in-page swap, and holder dividend claims. |
| Portfolio | Claim creator fees, edit image, description and links, and change fee recipient wallets. |
02 · Quick start
- STEP 01
Get a wallet
Install Bitget Wallet, MetaMask or Rabby. On mobile, use the wallet app's built-in browser.
- STEP 02
Fund it on Base
Hold a little ETH on Base for gas. Add more if you want to make a creator buy at launch.
- STEP 03
Connect
Press Connect in the header, pick your wallet and approve. Bluedesk switches you to Base if needed.
- STEP 04
Configure
Open Launch (L), fill in the four sections and review the order ticket on the right.
- STEP 05
Deploy
Press Deploy and sign one transaction. You are taken to the token page as soon as it confirms.
- STEP 06
Earn & manage
Trades start paying creator fees immediately. Claim them anytime from Portfolio (P).
03 · Wallets & network
Bluedesk runs on Base mainnet (chain ID 8453) only. Testnets are not supported because Clanker v5 has no factory on Base Sepolia.
| Device | How to connect |
|---|---|
| Desktop | Install a browser extension wallet such as Bitget Wallet, MetaMask or Rabby. Installed wallets appear by name in the Connect sheet. |
| Mobile | Open the site inside your wallet app. The Connect sheet offers one-tap links for Bitget Wallet, MetaMask and Trust Wallet. |
| Wrong network | If your wallet is on another chain, the Connect button turns into Switch to Base. |
Connecting only shares your address. Every launch, swap, claim or update needs a separate signature in your wallet. Your connection is remembered for the current browser tab only.
04 · Launch walkthrough
The launch form has four sections. The order ticket on the right updates live with every change.
01 · Identity
| Field | Rules | Notes |
|---|---|---|
| Image | PNG, JPG or GIF, up to 5 MB | Uploaded when you press Deploy. You can paste an ipfs:// or https:// URL instead. |
| Name | Up to 32 characters | Shown on Markets, explorers and wallets. |
| Ticker | Up to 10, A–Z and 0–9 | Converted to uppercase automatically. |
| Description | Up to 280 characters | Optional. Editable later from Portfolio. |
| Links | Website, X, Telegram, Farcaster | Optional. Editable later from Portfolio. |
02 · Pool & tax
Choose the paired token: ETH (WETH) or USDC. Your creator fees and holder dividends are paid in this token. Then set the buy tax and sell tax between 1% and 10% in 0.5% steps. They can differ.
03 · Creator fees
Split what is left of the tax after the protocol fee between you (creator), your holders and a burn. The three always add up to 100%. If you send any share to holders, also set the minimum holding a wallet needs to earn dividends. Add up to 6 extra wallets to share the creator part; the split must total exactly 100%.
04 · Creator buy
Optionally buy your own token inside the launch transaction (ETH-paired tokens only). See Creator buy below.
05 · Tax & fee routing
Every buy and every sell pays the tax you set. The tax is routed in this order:
| Step | Share | Goes to |
|---|---|---|
| 1. Protocol fee | 10% of the tax | Clanker. Always at least 0.5% and at most 1% of the trade value. |
| 2. Bluedesk fee | 0% (beta) | The interface. Shown in the launch form before you sign. |
| 3. Holders | 0–100% of the rest | Holder dividends, claimed by eligible holders. |
| 4. Burn | 0–100% of the rest | Burned: sent to the dead address 0x…dEaD when claimed. |
| 5. Creator | Whatever remains | Your fee recipients, in the paired token. |
Worked examples · a $1,000 buy
| Setup | Tax | Protocol | Holders | Burn | Creator |
|---|---|---|---|---|---|
| 1% tax, 100% creator | $10 | $5 | $0 | $0 | $5 |
| 5% tax, 100% creator | $50 | $5 | $0 | $0 | $45 |
| 5% tax, 20% holders, 10% burn | $50 | $5 | $9 | $4.50 | $31.50 |
| 10% tax, 50% holders | $100 | $10 | $45 | $0 | $45 |
In the first row, 10% of the tax would be $1, but the protocol minimum is 0.5% of the trade, so it takes $5. In the last row, 10% of the tax is exactly the 1% maximum. Examples assume the Bluedesk fee is 0%.
06 · Creator fees
The creator share of every trade accrues to your recipients in the paired token (ETH or USDC). Your connected wallet is always recipient #1 and token admin. You can add up to 6 more wallets, for example a team or treasury, with any percentage split that totals 100%.
Fees are not sent automatically. Open Portfolio, find the token and press Claim fees; the unclaimed amount is shown above the button. A claim pays the whole balance for that recipient.
Percentages are fixed at launch, but the admin of each slot can point it to a different wallet with Recipients → change recipient. Fees already earned stay with the previous wallet.
07 · Holder dividends
If you send part of the tax to holders, it accrues as dividends in the paired token. Only wallets holding at least the minimum holding set at launch qualify. It must be between 10,000 and 1,000,000,000 tokens. While no holder qualifies, that share goes to the protocol.
Holders claim on the token page: the Holder dividends panel shows the claimable amount for the connected wallet and a Claim button. ETH dividends are paid as native ETH. Nothing is airdropped and nobody needs to stake.
Pick the minimum with care: too low and dust wallets dilute real holders, too high and few holders earn anything.
08 · Burn
The burn share is used to remove your token from circulation. Burn credits are sent to the dead address 0x000000000000000000000000000000000000dEaD when they are claimed, which permanently reduces circulating supply.
09 · Creator buy
A creator buy (also called dev buy) spends ETH from your wallet to buy your own token in the same transaction as the launch, so nobody can buy before you. It is separate from creator fees and pays the normal buy tax. It is available for ETH-paired tokens only.
Set Max slippage between 0.1% and 49%. If the buy would receive fewer tokens than your slippage allows, the whole launch reverts and only gas is spent. Leave the amount empty to skip it.
10 · Sniper protection
Bots often buy in the first block of a launch. Clanker applies an anti-snipe surcharge that starts very high and decays to your normal tax. Under the current factory policy on Base it starts at a 99% total fee and falls to your tax over 20 seconds. The schedule is set by the Clanker factory, not by Bluedesk, applies to every launch automatically, and can change.
11 · Markets
Markets lists Clanker tokens on Base from the public Clanker API.
| Control | What it does |
|---|---|
| New 1 | Newest first. Polls every 5 seconds; new rows are highlighted and counted in Session. |
| Top 2 | Sorted by market cap. Snapshot, refreshed on reload. |
| Trending 3 | Sorted by 24h price change within the loaded page. |
| Search / | Name, ticker or contract address. |
| Bluedesk only | Shows only tokens launched through Bluedesk. |
The ticker tape at the top of every page shows the 20 latest launches and refreshes every 30 seconds. Hover it to pause.
12 · Token page & swap
Each token page shows price, market cap, 24h volume, liquidity, 1h and 24h change, holders and a price chart (5m, 15m or 1h candles), plus the description, links and creator. Use share link to copy the page URL.
The Swap panel buys or sells directly against the token's Uniswap pool through the official Universal Router. Quotes come from Uniswap's Quoter and already include the token's tax. Pick a max slippage of 1%, 3%, 5% or 10%; the minimum received is shown before you confirm.
| Action | Signatures |
|---|---|
| Buy with ETH | 1: the swap. |
| Buy with USDC | Up to 3 the first time: approve USDC for Permit2, allow the router in Permit2, then the swap. |
| Sell | Up to 3 the first time: approve the token for Permit2, allow the router, then the swap. Later sells need 1. |
| Claim dividends | 1, from the Holder dividends panel (tokens with dividends only). |
If an in-page swap is not available for a token, a link to app.uniswap.org is shown instead.
13 · Portfolio
Portfolio lists every token your connected wallet launched or administers on Base. For each token you can:
| Action | What happens |
|---|---|
| Claim fees | Sends your accrued creator fees to your wallet in the paired token. One transaction. |
| Edit token → image | Uploads a new image and updates it on-chain. Can take a few minutes to show everywhere. |
| Edit token → description & links | Updates the description and website, X, Telegram and Farcaster links in one transaction. |
| Recipients | Lists every fee slot with its share, wallet and admin. A slot's admin can change its wallet. |
Only the right admin can make a change. The contract rejects anyone else, and the error is shown in the panel.
14 · Keyboard shortcuts
| Key | Action |
|---|---|
| M | Markets |
| L | Launch |
| P | Portfolio |
| D | Docs |
| 1 2 3 | Markets: New, Top, Trending |
| / | Markets: focus search |
| Esc | Close the wallet sheet |
Shortcuts are ignored while you are typing in a field.
15 · Limits
| Parameter | Value |
|---|---|
| Network | Base mainnet, chain ID 8453 |
| Supply | 1,000,000,000 tokens, 18 decimals, fixed |
| Paired token | ETH (WETH) or USDC |
| Buy / sell tax | 1% to 10%, steps of 0.5% |
| Protocol fee | 10% of tax, min 0.5% and max 1% of the trade |
| Holders + burn | 0% to 100% of the creator side combined, steps of 5% |
| Dividend minimum holding | 10,000 to 1,000,000,000 tokens |
| Fee recipients | 1 to 7, split must total 100% |
| Name / ticker / description | 32 / 10 / 280 characters |
| Image | PNG, JPG or GIF, up to 5 MB |
| Creator buy | ETH-paired tokens only; slippage 0.1% to 49% |
| Swap slippage | 1%, 3%, 5% or 10% |
16 · Contracts
Bluedesk does not deploy its own contracts. Tokens are created by the Clanker v5 factory through the official clanker-sdk, and swaps route through Uniswap's contracts on Base:
| Contract | Address on Base |
|---|---|
| Uniswap Universal Router | 0x6fF5693b99212Da76ad316178A184AB56D299b43 |
| Uniswap v4 PoolManager | 0x498581fF718922c3f8e6A244956aF099B2652b2b |
| Uniswap v4 Quoter | 0x0d5e0F971ED27FBfF6c2837bf31316121532048D |
| Uniswap v4 StateView | 0xA3c0c9b65baD0b08107Aa264b0f3dB444b867A71 |
| Uniswap v3 Quoter (older tokens) | 0x3d4e44Eb1374240CE5F1B871ab261CD16335B76a |
| Permit2 | 0x000000000022D473030F116dDEE9F6B43aC78BA3 |
| WETH | 0x4200000000000000000000000000000000000006 |
| USDC | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
For the Clanker factory, fee escrow and dividend contracts, see the official Clanker documentation ↗.
17 · Glossary
| Term | Meaning |
|---|---|
| CA | Contract address of a token. |
| Paired token | The asset your token trades against in its pool (ETH or USDC). Fees and dividends are paid in it. |
| Buy / sell tax | Percentage taken from each buy or sell and routed as described in Tax & fee routing. |
| Protocol fee | Clanker's cut of the tax. |
| Creator fees | Your share of the tax, claimable from Portfolio. |
| Dividends | The holders' share of the tax, claimed by eligible holders on the token page. |
| Minimum holding | The token balance a wallet needs to earn dividends. Set at launch. |
| Fee slot | One recipient of the creator share, with a fixed percentage, a wallet and an admin. |
| Token admin | The wallet allowed to update the token's image and metadata. Yours by default. |
| Creator buy | A purchase of your own token inside the launch transaction. |
| Slippage | The maximum price movement you accept between quote and execution. |
| Permit2 | Uniswap's shared approval contract used for ERC-20 swaps. |
| Market cap | Token price × supply, in USD, from the Clanker API. |
18 · Troubleshooting
| Message | What to do |
|---|---|
| Switch to Base | Your wallet is on another network. Press the button and approve the switch. |
| No browser wallet found | Install Bitget Wallet, MetaMask or Rabby and refresh, or open the site in your wallet app on mobile. |
| You cancelled in your wallet | The request was rejected in the wallet. Try again and approve it. |
| Image upload is not configured | Paste an image URL (ipfs:// or https://) instead of uploading a file. |
| Fee split must total exactly 100% | Adjust recipient percentages until the total shows 100%. |
| Recipient N needs a valid 0x address | Check the extra recipient address: 0x followed by 40 hex characters. |
| Minimum holding must be between … | Enter a number from 10,000 to 1,000,000,000. |
| Creator buy is only available … ETH | Switch the pair to ETH, or clear the creator buy amount. |
| Launch reverted | Usually the creator buy hit its slippage limit. Raise max slippage or lower the buy amount. |
| Token not indexed yet | The token is new. Wait about a minute; the page retries by itself. |
| Claim button disabled | There is nothing to claim yet, or your wallet is below the dividend minimum holding. |
| Not enough liquidity for this amount | Lower the swap amount. |
| The swap reverted | Price moved past your slippage. Try a higher slippage or a smaller amount. |
| Not enough balance for this swap plus gas | Keep a little ETH for gas. MAX already leaves a small reserve. |
19 · FAQ
What is Clanker?
Clanker is a token launch protocol on Base. Its contracts create an ERC-20 and its Uniswap v4 trading pool in one transaction. Bluedesk is an independent interface on top of Clanker v5; it does not run its own token contracts.
How much does it cost to launch?
There is no listing fee. You pay Base network gas (usually a few cents) plus the ETH for your creator buy, if you add one. The Bluedesk interface fee is 0% during beta.
How many tokens are created?
Every launch mints a fixed supply of 1,000,000,000 tokens with 18 decimals. The whole supply goes into the Uniswap pool; nothing is reserved for the creator except what you buy with a creator buy.
Who owns the token after launch?
Your wallet is the token admin and the first creator-fee recipient. Neither Bluedesk nor Clanker can move your fees or change your recipients.
Can I change the tax after launch?
No. Buy tax, sell tax, the holders share, the minimum holding and the burn share are fixed in the contract at launch. Pick them carefully.
What can I change after launch?
The image, the description, the links, and which wallet each fee-recipient slot pays. Each change is one transaction from Portfolio.
Why is my new token not showing up yet?
New tokens take about a minute to reach the Clanker index that powers Markets, the token page and Portfolio. The token page keeps checking on its own after a launch.
How do holders get dividends?
Holders with at least the minimum balance set at launch (10,000 tokens or more) accrue dividends. They claim them with the Claim button in the Holder dividends panel on the token page.
Which wallets work?
Any browser wallet that supports Base: Bitget Wallet, MetaMask, Rabby and others. On mobile, open the site inside your wallet app's browser.
Is Bluedesk audited or affiliated with Clanker or Base?
No. Bluedesk is an independent interface. Token logic lives in Clanker's contracts and trades route through Uniswap's contracts.
20 · Risk & disclaimer
Bluedesk is an independent interface. It is not affiliated with Clanker, Base, Coinbase or Uniswap. Market data comes from the Clanker API and may be delayed or incomplete. Nothing on Bluedesk is financial, legal or tax advice.
Ready to deploy
+ Launch token