Token Configuration

☝️ Important — All tokens (Jettons) passed to either parameter must be listed on swap.coffee to be recognized and rendered correctly in the widget.

​

sendReceiveTokenAddresses

sendReceiveTokenAddresses?: string[];

• Defines a custom list of token addresses (Jettons) that should be available in the Send and Receive sections of the widget.
• Use this when you want to set a unique pair of tokens that users can swap from or to.

createSwapWidget("#test", {
  sendReceiveTokenAddresses: [
    "EQAvlWFDxGF2lXm67y4yzC17wYKD9A0guwPkMs1gOsM__NOT", // SEND -> NOT
    "EQCl0S4xvoeGeFGijTzicSA8j6GiiugmJW5zxQbZTUntre-1" // RECEIVE -> CES
  ],
  otherConfig...
});

🚧 Warning — If you pass an invalid token address, the widget and pair will not render correctly.

​

limitedJettonLists

limitedJettonLists?: string[];

createSwapWidget("#test", {
  limitedJettonLists: [
    "EQC98_qAmNEptUtPc7W6xdHh_ZHrBUFpw5Ft_IzNU20QAJav", // tsTON
    "EQBa6Oofc4vQZ1XZLTYRkbX4qWUWBCf0sFBgo0kdxdlw6rqN", // M5
    "EQAvlWFDxGF2lXm67y4yzC17wYKD9A0guwPkMs1gOsM__NOT", // NOT
    "EQD0KpcRMh-sKO2z5-vOjgvFjTT58tO-2Nmvxqg5ocFQFtWz"  // FPIBANK
    // other token addresses ...
  ],
  otherConfig...
});

🛑 This setting completely replaces the default token list — use it when you want a hard limit on what’s shown.

​

Default Assets

• TON (Toncoin)
• USDT (Tether USDT on TON)
• CES (swap.coffee)

​

Search for Any Token

✅ As long as the token is listed on swap.coffee, it can be found.

​

enableCommunityTokens

enableCommunityTokens?: boolean;

• true (default): Community tokens are included in the main token list and mixed with whitelist tokens from swap.coffee
• false: Only verified or imported tokens will be shown, excluding community tokens

createSwapWidget("#test", {
  enableCommunityTokens: false, // Only verified tokens
  otherConfig...
});

📝 Note — When disabled, users will only see tokens that have been officially verified or manually imported, providing a more curated token selection.