Waves Integration Overview
Waves is a blockchain platform built with a focus on custom token issuance, fast settlement, and an accessible development environment. Its built-in decentralized exchange and low asset-creation costs have made it a popular choice for tokenization projects, DeFi applications, and cross-chain bridging protocols.
Codono’s crypto exchange software provides complete Waves support, enabling you to list native WAVES and any Waves-issued asset with a configuration workflow that requires only the asset ID.
Supported Assets
Native WAVES
- Full deposit and withdrawal support on Waves mainnet
- Used to pay transaction fees across the network
- Available as a base or quote trading pair
Waves Assets (Custom Tokens)
- Any token issued on the Waves blockchain, identified by its unique Asset ID
- Stablecoins bridged to Waves (USDN/USDC equivalents, neutrino-based assets)
- Project tokens, utility tokens, and governance tokens
- Smart assets with programmable transfer logic (see caveats below)
Adding a new Waves asset to your exchange requires only the Asset ID. The platform fetches the asset name, decimals, and total supply automatically from the Waves node.
How Waves Differs from EVM Chains
Waves uses a different technical model from Ethereum-family blockchains. Key differences that affect exchange operations:
Asset IDs instead of contract addresses
EVM chains identify tokens by their smart contract address. Waves identifies assets by a unique base58-encoded Asset ID assigned at creation. The lookup and validation workflow in the admin panel accounts for this — you enter the Asset ID rather than a 0x… contract address.
Unified fee currency
All Waves network fees are paid in WAVES (the native coin), regardless of which asset is being transferred. This simplifies gas reserve management: you only need to maintain a WAVES float in your hot wallet for all outbound transactions, including asset withdrawals.
Transaction types
Waves has distinct transaction types for different operations: TransferTransaction for sending assets, MassTransferTransaction for batch transfers, and InvokeScriptTransaction for interacting with dApps. The platform uses TransferTransaction for standard withdrawals and can use MassTransferTransaction for batch sweep operations, which reduces fee costs when consolidating multiple user deposits.
Ride smart assets
Assets on Waves can optionally have an attached Ride script that runs on every transfer and can approve or reject it. Standard (non-scripted) assets behave predictably. If you plan to list a smart asset with transfer restrictions, test the behavior thoroughly before enabling withdrawals.
Wallet Architecture
Deposit Addresses
The platform generates a unique Waves address for each user. All Waves assets share the same address format — a user’s single Waves deposit address accepts WAVES and any Waves asset simultaneously. Deposits are monitored by the wallet layer and credited to the user’s exchange account once the configured confirmation count is reached.
Sweep Logic
Waves asset deposits accumulate at user deposit addresses and are periodically swept to the hot wallet. Because all fees are paid in WAVES, sweep transactions require only a WAVES float in the sweep wallet — no per-asset gas token is needed. The platform calculates the fee for each sweep automatically based on current network conditions.
Batch Sweep with MassTransfer
For exchanges with large user bases, MassTransferTransaction allows consolidating multiple asset deposits in a single transaction. This reduces total fee expenditure when sweeping from many addresses simultaneously. The admin panel includes a sweep configuration page where batch size and fee strategy can be set.
Hot and Cold Wallet Split
Large WAVES and asset balances should be held in cold wallet storage. Configure the threshold above which a withdrawal requires manual authorization before the hot wallet processes it.
Integration Methods
Blockgum Integration
Blockgum provides managed Waves infrastructure:
- Wallet address generation and management
- Real-time deposit monitoring for WAVES and all Waves assets
- Balance synchronization and confirmation tracking
- Withdrawal processing with network fee estimation
- Mass transfer support for cost-efficient batch sweeps
- Webhook notifications for confirmed deposits and withdrawals
Blockgum handles Waves node operations and keeps in sync with the blockchain, removing the need to run and maintain your own node.
Direct Node Integration
For full infrastructure control:
- Connect to a self-hosted Waves node via the standard REST API
- Complete visibility into all transaction data
- No third-party API dependencies
- Configure primary and fallback node endpoints in the admin panel
The Waves node software is open-source. Running a node requires moderate server resources and a reliable internet connection.
Performance Characteristics
| Metric | Value |
|---|---|
| Block time | ~60 seconds |
| Recommended confirmations (standard) | 3 blocks (~3 minutes) |
| Recommended confirmations (large deposits) | 6 blocks (~6 minutes) |
| Fee model | Fixed WAVES fee per transaction type |
| Gas token | WAVES (all fee types) |
Waves uses a Leased Proof of Stake (LPoS) consensus. Block reorganizations beyond 1–2 blocks are extremely rare in practice; the confirmation thresholds above provide a conservative safety margin.
Which Exchanges Benefit Most from Waves Support
Waves is a strong fit for:
- Exchanges serving existing Waves community users — Waves has an established user base that seeks centralized venues for liquidity.
- Tokenization platforms — Waves’ low asset issuance cost makes it popular for projects that want to create tokens quickly. Listing these assets on a CEX provides liquidity that DEX alone cannot.
- Exchanges interested in bridged stablecoins — Several USD-pegged stablecoins have been issued on Waves; listing them adds a stablecoin pair without the Ethereum gas cost.
- Multi-chain exchanges — Waves adds a differentiated chain listing alongside EVM chains, appealing to users who hold Waves assets and want a single venue.
Admin Capabilities
- Enable or disable WAVES and individual Waves asset trading
- Add Waves assets by Asset ID with automatic metadata fetch (name, decimals, supply)
- Configure deposit confirmation thresholds per asset
- Monitor hot wallet WAVES balance (used for all fees) with low-balance alerts
- Set withdrawal limits, minimum amounts, and manual approval thresholds
- View full transaction history with Waves Explorer deep-links per transaction
Getting Started
Waves support is included in the Codono exchange package. Typical setup steps:
- Configure Blockgum credentials or connect a self-hosted Waves node
- Generate the master Waves wallet and store the encrypted seed securely
- Add WAVES and your initial asset list via the admin panel using Asset IDs
- Configure confirmation thresholds, sweep settings, and withdrawal limits
- Test end-to-end deposit and withdrawal flows on Waves Testnet
- Go live on Waves mainnet
Contact our team for Waves integration assistance, smart asset configuration guidance, and batch sweep optimization.