TON Integration Overview
TON (The Open Network) is a layer-1 blockchain with deep integration into the Telegram messenger ecosystem. With Telegram’s massive global user base and the growing adoption of TON-based mini-apps and wallets, TON has emerged as a blockchain with genuine organic demand — not just speculative trading interest.
Codono’s crypto exchange software provides complete TON support, enabling you to list Toncoin and Jetton tokens and serve users coming from the Telegram ecosystem.
Supported Assets
Toncoin (TON)
- The native coin of The Open Network
- Full deposit and withdrawal support
- Used as gas for all TON transactions and Jetton transfers
- Available as a trading pair base or quote currency
Jettons
- TON’s fungible token standard (functionally analogous to ERC-20)
- Stablecoins issued on TON (USDT on TON, jUSDC, etc.)
- Project tokens and utility tokens from TON-native dApps
- Any Jetton contract can be listed via its master contract address
How TON Differs from EVM Chains — Key Technical Points
TON’s architecture diverges significantly from Ethereum-family chains. Understanding these differences matters for exchange operations:
Jetton Wallet Contracts
On EVM chains, a single ERC-20 contract holds all holder balances in an on-chain mapping. On TON, each Jetton creates a separate “Jetton wallet” smart contract for every address that holds that token. When your exchange queries a user’s Jetton balance, it must resolve the user’s Jetton wallet address first, then query that contract. Codono handles this automatically — but it is worth knowing when troubleshooting discrepancies.
Comment/Memo Fields
TON transactions support an optional comment (text message) attached to the transfer. This is commonly used in two deposit patterns:
- Unique address per user — No comment needed; the receiving address identifies the user. This is the default Codono approach.
- Shared deposit address with memo — A single exchange address receives all deposits, and the comment field contains a user identifier. This reduces key management complexity but requires strict enforcement of the comment on the user side.
For most exchange deployments, unique address per user is the cleaner model.
Address Format
TON addresses are represented in a URL-friendly base64 encoding (e.g., EQ… or UQ… formats). The EQ prefix denotes a bounceable address; UQ denotes a non-bounceable address. Exchanges should always use non-bounceable addresses for user deposit addresses to prevent funds from being returned on failed smart contract calls.
Wallet Architecture
User Deposit Addresses
The platform generates a unique TON address for each user. Incoming Toncoin and Jetton transfers to these addresses are monitored by the wallet layer. Once a deposit reaches the configured confirmation count, the exchange balance is credited.
Sweep and Gas Management
Toncoin is required to pay gas for Jetton transfers. When sweeping Jetton balances from user deposit addresses to the hot wallet, the platform first ensures the deposit address has sufficient TON for the outbound Jetton transfer. This “gas top-up” step is handled automatically, but operators should maintain an adequate TON reserve in the sweep wallet.
Hot and Cold Wallet Split
Large TON and Jetton holdings should be kept in cold wallet storage with manual authorization for cold-to-hot transfers. The admin panel supports configurable thresholds for automatic vs. manual withdrawal approval.
Integration Methods
Blockgum Integration
Blockgum provides managed TON infrastructure:
- Wallet address generation and management
- Real-time deposit monitoring for TON and Jettons
- Balance synchronization with confirmation tracking
- Withdrawal processing with fee estimation
- Jetton wallet resolution and querying
- Webhook callbacks for confirmed deposits and withdrawals
Blockgum abstracts the operational complexity of TON node management and Jetton wallet resolution.
Direct TON Node Integration
For advanced deployments requiring full control:
- Connect to a self-hosted TON node (liteserver or full node)
- Complete visibility into transaction data
- No third-party API dependencies
- Suitable for high-volume operations with custom monitoring requirements
Performance Characteristics
| Metric | Value |
|---|---|
| Block time | ~5 seconds (shardchain blocks) |
| Finality | Fast; typically a few blocks |
| Recommended confirmations | 3–5 for standard deposits |
| Gas token | TON (Toncoin) |
| Token standard | Jetton (TEP-74) |
TON uses a sharded architecture designed for throughput at scale. For exchange purposes, the relevant characteristic is that transaction confirmation is fast — deposits are typically ready to credit within 30–60 seconds after broadcast.
Why TON Matters for Exchange Operators
Telegram User Funnel
TON Space (the built-in Telegram wallet) and third-party TON wallets like Tonkeeper make it easy for Telegram’s users to hold and transfer TON and Jettons. An exchange that supports TON can market directly within Telegram communities, TON-based mini-apps, and the growing ecosystem of Telegram-native projects.
Stablecoin Demand
USDT issued on TON has seen growing adoption as an alternative to USDT-TRC20 for users in regions where Telegram is popular. Listing USDT on TON gives your exchange access to this transfer demand.
Token Launch Activity
TON has become an active platform for new project launches, from GameFi to DeFi to social applications. Early listing of relevant Jettons can attract users before those projects migrate to larger venues.
Which Exchanges Benefit Most from TON Support
- Exchanges targeting CIS, Southeast Asian, and Middle Eastern markets — These regions have high Telegram penetration and growing TON user bases.
- Community-focused exchanges — TON’s Telegram roots make it popular with crypto communities that organize on Telegram.
- Multi-chain platforms — Adding TON alongside EVM chains differentiates your listing offer.
Admin Capabilities
- Enable or disable TON and individual Jetton trading pairs
- Add Jettons by master contract address with automatic metadata fetch
- Configure deposit confirmation thresholds per asset
- Set withdrawal limits, minimum amounts, and approval workflows
- Monitor TON gas balance in the sweep wallet with low-balance alerts
- View transaction history with TON explorer deep-links
Getting Started
TON support is included in the Codono exchange package. Typical setup steps:
- Configure Blockgum credentials or connect a self-hosted TON liteserver
- Generate the master wallet and secure the seed backup
- Add Toncoin and initial Jetton listings via the admin panel
- Configure confirmation thresholds, sweep settings, and withdrawal limits
- Test end-to-end deposit and withdrawal flows
- Go live on TON mainnet
Contact our team for TON integration assistance and configuration guidance.