Smart Contract Reference
All Monolythium protocol contracts deployed on testnet, organized by module. Contracts are built with Solidity ^0.8.20, OpenZeppelin v5, and Foundry. The EVM version is paris.
All contracts are deployed by the same deployer wallet: 0x366d8135D7413C09564044D345A245771c9BaC5B.
All contracts listed below are verified on Monoscan. Click the address link to view the verified source code, ABI, and read/write functions.
Core Infrastructure
Foundational contracts used by the entire protocol.
| Contract | Address | Description |
|---|---|---|
| WLYTH | 0xcdca242b371bbb091606596f72905f740338200f | Wrapped LYTH (WETH-equivalent). Wraps native LYTH into an ERC-20 for use in DEX pairs and contracts that require token approvals. |
| FeeCollector | 0xfdfd508c8e550bc16d56767c21c1ba00ed060ff0 | Central fee sink. Receives protocol fees from MonoPump, MonoRouter, ProAccessRouter, and AgentArena. Splits incoming LYTH: 50% burned, 50% sent to the contracts treasury. |
Swap (MonoSwap DEX)
Uniswap V2-style automated market maker for token trading.
| Contract | Address | Description |
|---|---|---|
| MonoFactory | 0xb5dadb197e9b07cd276403f9637308407b7e01f9 | Pair factory. Creates MonoPair contracts for new token pairs. |
| MonoRouter | 0xec3d6023df47741d22b025712c667272c88cf074 | Swap router. Executes swaps, adds/removes liquidity, and handles multi-hop routes through MonoPair pools. |
| TWAPOracle | 0x6C6fD3DBf717eAe38cef8b401A8B6b2b54abDdb9 | Time-weighted average price oracle. Tracks cumulative price data for each pair, used by the MonoHub indexer for charting. |
MonoPair contracts are created dynamically by MonoFactory. Each pair is a separate contract at a deterministic address derived from the two token addresses.
Pump (Token Launchpad)
Bonding curve token launchpad with automated graduation to MonoSwap.
| Contract | Address | Description |
|---|---|---|
| MonoPump | 0x6f9edea7ce78787fb4912832f00c670d0f10e7d5 | Core launchpad. Handles token creation, bonding curve buys/sells, and graduation. Creates PumpToken (basic) or PumpTokenV2 (advanced) contracts. |
| Referral | 0xEC3d6023dF47741d22b025712C667272C88CF074 | Referral tracking. Stores referral relationships and accrues fee shares (5%) for referrers when their referees trade on MonoPump. |
| CreatorVesting | 0x476d9928b44E14190FB6c4eC56AA58216cbA2294 | Creator token vesting. Locks creator allocations (up to 10% of supply) behind a cliff (30+ days) and linear vesting (180+ days). |
Agents
On-chain framework for AI agent identity, token creation, and competitive tournaments.
| Contract | Address | Description |
|---|---|---|
| AgentRegistry | 0xe842341f379eF3cBCD9D59cF26361053FBd9e7Ea | Agent identity layer. Registers agents with metadata URI and LYTH stake. One agent per address. 7-day withdrawal timelock. |
| AgentLaunchpad | 0x0bA31d91D2eCF3E531c2f21be44B2bB7e98917BC | Combined agent + token launcher. Atomically registers an agent in AgentRegistry and creates a bonding curve token on MonoPump. |
| AgentArena | 0x16027d49E743217Ad5f62dB2c75559f9e148296d | Tournament host. Manages AI agent competitions with entry fees, commit-reveal scoring by verifiers, and pull-based prize claims. |
Farming
Liquidity mining rewards for MonoSwap LP providers.
| Contract | Address | Description |
|---|---|---|
| LPFarming | 0x994f8aa52b406689Fa5F5783CB25E29B6C838e0F | LP farming. Users deposit MonoSwap LP tokens and earn LYTH rewards proportional to their share and the pool's reward rate. |
Pro Access
Subscription system for premium MonoHub features.
| Contract | Address | Description |
|---|---|---|
| ProAccessRouter | 0xAF823b3B68Cfd3AF7e2A33fF70259A52752d47f7 | Pro subscription router. Accepts LYTH payments for Pro access tiers (Basic, Standard, Premium). Fees forwarded to the contracts treasury. |
Security
Time-delayed administrative actions for contract governance.
| Contract | Address | Description |
|---|---|---|
| Timelock | Deployed per-chain (see Contract Addresses) | Time-delay controller. Queues administrative actions (parameter changes, ownership transfers) with a mandatory waiting period before execution. |
Bridge (mUSDC)
Mint-and-burn bridge for USDC liquidity on Monolythium.
| Contract | Address | Description |
|---|---|---|
| mUSDC | 0x65D8742A9E95c7a18E0E0a28f8B1d8f20c0ea7F0 | Bridged USDC token (ERC-20, 6 decimals). Minted by the minter when deposits are confirmed, burned on redemption. |
| USDCBridgeVault | 0x6B6CE8D05cA859b21f452DFbe7aF819932b660cd | Source-chain vault. Locks USDC on deposit (0.1% fee) and releases USDC on redemption. |
| USDCBridgeMinter | 0x96148FeE8C66e005D625920FB8688dd455cd1077 | Monolythium-side minter. Processes relayed deposits by minting mUSDC, and handles redemption by burning mUSDC. |
| TestUSDC | 0x1ABc975fe5a25f506e33e0fa6CA43A1Beff2E87a | Freely mintable test token used as the source USDC on testnet. Replaced by real USDC on mainnet. |
Campaign
On-chain contracts supporting the testnet campaign, quests, referrals, and NFT collectibles.
| Contract | Address | Description |
|---|---|---|
| QuestRewards | 0x7005d4C6F4D8F762f9d5345B7e2756Fa5e13C286 | Quest completion tracker and reward distributor. Verifies quest completion proofs and distributes LYTH rewards per phase. |
| CampaignReferral | 0x324Fd87EEC6Ee478E7fACD94391abd7562D25E59 | Campaign-specific referral tracking. Separate from the DeFi Referral contract; tracks campaign milestone referrals and bonus distributions. |
| MonoFoxCitizens | 0xecBC6617F062579eF8895D25f63244461247604e | Soulbound PFP NFT collection. 1,711 unique Mono Fox NFTs representing 233 countries across 7 cultural themes (1,671 country NFTs + 40 tradeable specials). Claimed after completing Phase 3 quests. |
Treasury Wallets
| Wallet | Address | Purpose |
|---|---|---|
| Protocol Treasury | 0x8Eaf92Eb6a7c48b95998F7C1df79402F3cC8BFa2 | Community funding, grants, ecosystem development |
| Contracts Treasury | 0x70773914287A8D92F732296bFa8866217aF13BeD | Receives protocol income (FeeCollector output, Pro Access fees, bridge fees) |
Cross-Chain Deployments
MonoPump and Agent contracts are also deployed on other testnets:
| Chain | Chain ID | MonoPump | AgentRegistry |
|---|---|---|---|
| Avalanche Fuji | 43113 | 0x1576D747641059ea8A9d74C62D6780B9ad80b68b | 0xf2DE9ED845b363bbd6cF7A5d6Ad4302D7c67a127 |
| Linea Sepolia | 59141 | 0x1576D747641059ea8A9d74C62D6780B9ad80b68b | 0xf2DE9ED845b363bbd6cF7A5d6Ad4302D7c67a127 |
See Contract Addresses for the complete cross-chain listing.
Contract Source Code
All contracts are open source and built with:
- Solidity ^0.8.20
- OpenZeppelin v5 (access control, ERC-20, ERC-721, pausable, reentrancy guard)
- Foundry (build, test, deploy)
- EVM version:
paris(no PUSH0 opcode)
Related
- Contract Addresses -- Full cross-chain address listing
- MonoPump -- Launchpad mechanics
- AI Agents -- Agent framework details
- mUSDC Bridge -- Bridge architecture
- DeFi Fees -- Fee breakdown across all contracts