Exchange Integration
This page provides a summary of exchange integration requirements for listing LYTH, the native token of Monolythium.
Overview
Monolythium is a Cosmos SDK-based blockchain with full EVM compatibility. Exchanges can integrate using standard Ethereum tooling (recommended) or native Cosmos SDK interfaces.
The token LYTH uses 18 decimals with a base denomination of alyth. Both EVM (0x...) and Cosmos (mono1...) address formats are supported and represent the same underlying account.
For complete integration documentation, sample code, and environment templates, refer to the Full Integration Pack in the mono-core repository.
Networks
| Network | Cosmos Chain ID | EVM Chain ID (Dec) | EVM Chain ID (Hex) | Status |
|---|---|---|---|---|
| Localnet | mono-local-1 | 262145 | 0x40001 | Development |
| Sprintnet | mono-sprint-1 | 262146 | 0x40002 | Early Testing |
| Testnet | mono-test-1 | 262147 | 0x40003 | Public Testing |
| Mainnet | mono-1 | 262148 | 0x40004 | Production |
Token Details:
- Symbol:
LYTH - Base Denom:
alyth - Decimals: 18
- Block Time: ~2 seconds
Endpoints
Exchanges should run their own dedicated RPC nodes for production use. The following endpoint types are available:
| Endpoint Type | Default Port | Purpose |
|---|---|---|
| CometBFT RPC | 26657 | Consensus queries, tx broadcast |
| Cosmos REST (LCD) | 1317 | Account/bank queries |
| Cosmos gRPC | 9090 | High-performance queries |
| EVM JSON-RPC | 8545 | Ethereum-compatible API |
| EVM WebSocket | 8546 | Real-time subscriptions |
Best Practice: Do not rely on public endpoints for production exchange operations. Run dedicated RPC nodes (not validators) with appropriate redundancy.
Deposits and Withdrawals
Recommended Path: EVM JSON-RPC
Most exchanges should use the EVM JSON-RPC interface for LYTH integration:
- Use standard Ethereum tooling (ethers.js, web3.js, etc.)
- Monitor deposits via block scanning or event watching
- Broadcast withdrawals using standard EVM transaction signing
Address Formats
Both address formats represent the same account:
| Format | Example | Usage |
|---|---|---|
| EVM (hex) | 0x1234...abcd | EVM transactions, MetaMask |
| Bech32 | mono1zg69g5... | Cosmos transactions, CLI |
The same private key controls both representations.
Finality and Confirmations
Monolythium uses CometBFT consensus with deterministic finality:
- Once a block is committed, it is final and cannot be reverted
- Unlike probabilistic chains, no extended confirmation waiting is required
- Recommended policy: 1-2 blocks (exchanges may choose higher per internal policy)
Fees and Economics
Transaction Fees
All transaction fees (EVM and Cosmos) follow this split:
| Destination | Percentage |
|---|---|
| Burned | 90% |
| Distributed to validators | 10% |
Minted Inflation Rewards
New tokens minted through inflation are distributed:
| Destination | Percentage |
|---|---|
| Dev Fund | 10% |
| Validators (via rank rewards) | 90% |
Additional Notes
- Voluntary burns are supported via
MsgBurn - Validator creation requires burning 100,000 LYTH
- Initial inflation: 12%, switching to 8% after ~6 months
Upgrades and Operations
No Rollback Policy
Monolythium does not support chain state reversals. In case of critical issues:
HALT → PATCH → UPGRADE → RESTART
Upgrade Notices
- Planned upgrades: 7+ days notice
- Security patches: Immediate coordination
- Monitor official channels for announcements
Monitoring
Key metrics to track:
- Block height (compare to network)
- Sync status
- Peer connectivity
- RPC endpoint health
Mesh/Rosetta (Optional)
For exchanges using the Rosetta/Mesh specification, an optional sidecar service is supported:
- Provides standardized Data API and Construction API
- Runs alongside your monod node
- Not part of consensus; can be enabled on RPC nodes only
This is optional—most exchanges will prefer direct EVM JSON-RPC integration.
Full Integration Pack
Complete integration documentation, sample code, and templates are available in the mono-core repository:
Repository: monolythium/mono-core
Path: ops/exchange-integration/
Reference Commit: 16eec69
The pack includes:
| Document | Description |
|---|---|
README.md | Overview and quick start |
NETWORK_INFO.md | Detailed network parameters |
NODE_SETUP.md | Exchange-grade node deployment |
ENDPOINTS.md | Full endpoint configuration |
DEPOSITS_WITHDRAWALS.md | Implementation guide |
FEES_AND_ECONOMICS.md | Complete fee structure |
UPGRADES_AND_OPERATIONS.md | Operational procedures |
ROSETTA_MESH.md | Mesh sidecar details |
SAMPLE_CODE/ | JavaScript examples, Postman collections, curl scripts |
templates/ | Environment configuration templates |