Token Management

Manage which tokens are available in your Telegram group.

Adding Tokens

Use the /addtoken command to add a new token to your group:

/addtoken

This starts an interactive flow:

1. Select Chain — Choose the blockchain (currently Solana)
2. Enter Token Address — Paste the token's mint address
3. Confirm — The bot verifies the mint on-chain and adds the token

Anyone can also list a token from the website at /realm/list-token. Either way the token is live as soon as it passes the checks below. A symbol that is already listed cannot be taken by a second mint.

Token Requirements

Anyone can add a token, so the mint itself has to be safe to custody. The bot checks the mint on-chain and refuses it unless:

• It is a legacy SPL Token Program mint. Token-2022 mints are not supported (transfer fees, transfer hooks and permanent delegates can skim or pull from the custodial wallet).
• Mint authority is revoked, so nobody can inflate the supply against the LPs.
• Freeze authority is revoked, so nobody can freeze the platform's token account and lock every balance.
• It has no transfer fee (a Token-2022 feature, so this follows from the first rule).

Other details:

• Decimals are read from the mint on-chain, never from third-party metadata.
• Name and symbol come from Jupiter's token list; the mint must be found there. Symbols are reduced to A-Z 0-9 . - and at most 12 characters.
• If the mint cannot be verified on-chain (RPC error), the listing is refused; try again in a moment.
• Native SOL is the one address with no mint account behind it and is exempt from these checks.
• The token is available for use as soon as it is active.

Removing Tokens

Use the /removetoken command to remove a token from your group:

/removetoken

This shows a list of currently enabled tokens. Click one to remove it.

Restrictions

• You cannot remove the last token — at least one token must remain
• Removing a token doesn't affect existing user balances

Viewing Available Tokens

Any user can see which tokens are available in the group:

/tokens

This shows:

• Token symbol and name
• Mint address and decimals
• Current pool balance
• Total deposited/withdrawn

Default Token Behavior

When users don't specify a token in commands:

• The system uses the user's preferred token (if set)
• Or the first token in the group's allowed list

Users set their preferred token with /set_token in a group or from /profile → 🎯 Pref Token. The preference is global, not per group.

Tips for Admins

Starting a New Group

1. Add the bot with /start
2. Grant admin permissions to the bot
3. Add your community's token with /addtoken
4. Announce to your community!

Multiple Tokens

You can add multiple tokens to support different communities or use cases:

• Native tokens for your project
• Popular tokens like SOL, USDC
• Meme tokens for fun

Security Notes

• Only group admins can add/remove tokens in a group
• Token mints are verified on-chain before listing
• Adding a malicious token won't affect other tokens

Available Admin Commands

Coming Soon

Future admin features planned:

• /config — Advanced group settings
• /stats — Group activity statistics
• /ban / /unban — User moderation