Documentation
Comprehensive technical documentation for developers building on Monolythium. Find API references, integration guides, and code examples.
Go from zero to deployed in minutes
Three steps to your first smart contract on Monolythium. Our toolchain handles the complexity so you can focus on building.
Install the CLI
Install the Monolythium developer toolkit globally. Includes the compiler, deployer, and local test node.
curl -sSf https://get.mono.dev | sh
# verify installation
mono --version
Connect Wallet
Configure your wallet for the Monolythium network. Compatible with MetaMask, Keplr, and any EVM/Cosmos wallet.
mono wallet init
# import existing key
mono wallet import --keyfile key.json
Deploy First Contract
Scaffold, compile, test, and deploy your first smart contract to Monolythium testnet in one workflow.
mono init my-dapp --template evm
mono compile && mono test
mono deploy --network testnet
Understand the fundamentals
Learn the building blocks of Monolythium: how accounts work, how transactions flow, and how the network reaches consensus.
Accounts
Dual-format addresses supporting both Ethereum (0x) and Cosmos (mono1) formats. Unified account model with a single private key.
- Externally Owned Accounts (EOA)
- Contract Accounts
- Module Accounts (governance, staking)
Transactions
Submit EVM transactions (ethers.js) or Cosmos SDK messages (cosmjs). Both types settle on the same chain with ~2s finality.
- EVM transactions (type 0, 2)
- Cosmos SDK messages
- IBC cross-chain transfers
Blocks & Consensus
CometBFT consensus produces blocks every ~2 seconds with instant finality. No reorganizations, no confirmation waiting.
- ~2s block time, instant finality
- 53 active DPoS validators
- IBC interoperability
Smart Contracts
Full EVM equivalence means every Solidity contract works unchanged. Deploy existing Ethereum dApps with zero modifications.
- Solidity / Vyper support
- EVM precompiles for Cosmos
- Upgradeable proxy patterns
Gas & Fees
EIP-1559 fee model with a 90% burn mechanism. Dynamic base fee adjusts to network demand, keeping costs predictable.
- EIP-1559 base + priority fee
- 90% of fees burned (deflationary)
- ~$0.001 average tx cost
LYTH Token
Native gas token and staking currency. Used for transaction fees, validator delegation, and on-chain governance proposals.
- Gas payments & staking
- Governance voting power
- 18 decimal precision (EVM native)
Connect via any protocol
Ethereum-compatible JSON-RPC, real-time WebSocket subscriptions, and Cosmos-native REST/gRPC endpoints. All in one node.
JSON-RPC
EVMFull Ethereum JSON-RPC compatibility. Use ethers.js, web3.js, viem, or any EVM tooling without changes.
POST https://rpc.monolythium.com
- eth_sendTransaction
- eth_call, eth_estimateGas
- eth_getLogs, eth_getBalance
- debug_traceTransaction
WebSocket API
Real-timeSubscribe to real-time events, new blocks, pending transactions, and contract log emissions over persistent connections.
wss://ws.monolythium.com
- eth_subscribe (newHeads)
- eth_subscribe (logs)
- eth_subscribe (pendingTx)
- Tendermint event subscriptions
REST & gRPC
CosmosCosmos SDK REST endpoints and gRPC services for staking, governance, IBC, and all native chain modules.
https://api.monolythium.com
grpc.monolythium.com:9090
- /cosmos/staking/v1beta1/*
- /cosmos/gov/v1/*
- /ibc/core/channel/v1/*
- /cosmos/bank/v1beta1/*
Ship faster with familiar tools
Monolythium is fully EVM-compatible. Use the same Solidity contracts, the same development tools, and the same deployment workflows you already know — with 2-second finality and lower fees.
-
Full Ethereum JSON-RPC compatibility — use ethers.js, web3.js, or viem
-
Deploy Solidity contracts directly with Hardhat or Foundry
-
Access Cosmos-native modules through the EVM precompile interface
-
90% fee burn creates deflationary tokenomics for your dApp ecosystem
import { ethers } from "ethers";
// Connect to Monolythium mainnet
const provider = new ethers.JsonRpcProvider(
"https://rpc.monolythium.com"
);
// Initialize wallet from private key
const wallet = new ethers.Wallet(
process.env.PRIVATE_KEY, provider
);
// Deploy a contract
const factory = new ethers.ContractFactory(
abi, bytecode, wallet
);
const contract = await factory.deploy();
await contract.waitForDeployment();
console.log(
"Deployed to:",
await contract.getAddress()
);Chain ID
42069
Block Time
~2s
Fee Burn
90%
Build with your favorite language
Official SDKs and client libraries for JavaScript, Rust, Python, and Go. Type-safe interfaces maintained by the Monolythium core team.
Connect to Monolythium
Mainnet and testnet RPC endpoints, chain identifiers, block explorers, and essential network configuration for developers.
GitHub Repositories
monolythium/mono-core
Core blockchain node software — Cosmos SDK + CometBFT
monolythium/monoscan
Block explorer for transactions, accounts, and validators
monolythium/mono-commander
Terminal interface for node operators and monitoring
monolythium/mono-docs
Official documentation source — contribute and improve
Network Endpoints
https://rpc.sprintnet.monolythium.com