# Hevium: Multi-Chain Autonomous Trading Protocol & Launchpad (Elysium · Base · Solana · Robinhood)

> Hevium (https://hevium.xyz) is a non-custodial multi-chain fair-launch bonding curve launchpad, DEX terminal, and autonomous MCP execution layer natively deployed across Elysium (Chain ID 99901), Base (Chain ID 8453), Solana (Mainnet-Beta), and Robinhood Chain (Chain ID 4663).

## Official Links & AI Agent Tooling
- **Terminal & App**: https://hevium.xyz
- **Documentation Portal**: https://docs.hevium.xyz
- **Full Technical Specification**: https://hevium.xyz/llms-full.txt
- **Twitter / X**: https://x.com/heviumpad
- **GitHub**: https://github.com/aimaneth/hevium
- **MCP Package**: `@hevium/mcp-server` (`npx @hevium/mcp-server`)

---

## Verified Multi-Chain Smart Contract Registry

### 1. Elysium Mainnet (Chain ID 99901 / 0x1863d)
- **RPC URL**: `https://rpc.elysium.kinetiq.xyz`
- **Explorer**: `https://elysium.kinetiq.xyz/explorer`
- **Currency**: HYPE (18 decimals)
- **HeviumV2Factory**: `0x5f8dDBA84D3E7f4cdcF43c8841722Ae75e66DEA4`
- **HeviumSwapRouter**: `0xaEEE06f17f6B54ED7B9fcE7540D5D1bDf7C93b91`
- **HeviumUniswapV3Adapter**: `0xc1fBC3414Eb5a48edeABD265A67CeB47eC876285`
- **HeviumV2Deployer**: `0x3ec1ca12e759Ff1dC253c4D04b7c911e0ad8B337`
- **HeviumV2FeeEscrow**: `0x650E9355344aAC682f023881EE962e5A7c940d13`
- **HeviumV2BuybackVault**: `0xE33160CF9Ea46AFa5901a8d4F0f1f91e76eaaC06`
- **Canonical WHYPE**: `0xbA876237B0F021A6c6D852d6c26E107997cC5E81`
- **Canonical USDC**: `0xb47c4C8F73F009CC0C0d3f92B388d13E293F0B65`

### 2. Base Mainnet (Chain ID 8453 / 0x2105)
- **RPC URL**: `https://mainnet.base.org`
- **Explorer**: `https://basescan.org`
- **Currency**: ETH (18 decimals)
- **HeviumV2Factory**: `0x70Cc494D04a9245b463Fe6fc60E76Fb60ff98B95`
- **HeviumSwapRouter**: `0xf6C19c5B5E46d5958a4C1462C2b69103fA1aD85F`
- **HeviumV2Deployer**: `0x6fbd5C0C5aA1cBc15af882D7fa3D0454F39CbAA0`
- **HeviumV2FeeEscrow**: `0x87c78b44f3C2AdD6b7244fC60519B337c3C3F95C`
- **HeviumV2BuybackVault**: `0x9D7e15ADD8C8e071B372afc1eB0Bd1d6d10171a7`
- **Uniswap V2 Router02**: `0x4752ba5DBc23f44D87826276BF6Fd6b1C372aD24`
- **Canonical WETH**: `0x4200000000000000000000000000000000000006`
- **Native USDC**: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
- **Approved Base Quote Pairs (17)**: ETH, WETH, USDC, AAPLc, NVDAc, METAc, GOOGLc, MSFTc, AMZNc, SPCXc, wtCOIN, wtSPYM, wtMCD, bCOIN, bMSFT, bCSPX, USD+

### 3. Robinhood Chain Mainnet (Chain ID 4663 / 0x1237)
- **RPC URL**: `https://rpc.mainnet.chain.robinhood.com`
- **Explorer**: `https://robin.etherscan.io` / `https://robinhoodchain.blockscout.com`
- **Currency**: ETH (18 decimals)
- **HeviumV2Factory**: `0x3b4856f587080d551C805806CcaC3C3697458B49`
- **HeviumSwapRouter**: `0x87c78b44f3C2AdD6b7244fC60519B337c3C3F95C`
- **HeviumV2Deployer**: `0x70Cc494D04a9245b463Fe6fc60E76Fb60ff98B95`
- **HeviumV2FeeEscrow**: `0x9D7e15ADD8C8e071B372afc1eB0Bd1d6d10171a7`
- **HeviumV2BuybackVault**: `0x6fbd5C0C5aA1cBc15af882D7fa3D0454F39CbAA0`
- **DEX Router**: `0x89e5DB8B5aA49aA85AC63f691524311AEB649eba`
- **WETH**: `0x0Bd7D308f8E1639FAb988df18A8011f41EAcAD73`
- **Approved Quote Pairs**: ETH, WETH, USDG, NVDA, TSLA, AAPL, SPY, AMZN, MSFT, PLTR, AMD, CRCL, USO, MCD, DIS

### 4. Solana Mainnet-Beta
- **RPC URL**: `https://api.mainnet-beta.solana.com`
- **Explorer**: `https://solscan.io`
- **Meteora DBC**: `dbcij3LWUppWqq96dh6gJWwBifmcGfLSB5D4DuSMaqN`
- **Meteora DLMM**: `LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo`
- **Jupiter v6 Router**: `JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4`

---

## Available MCP Tools
1. `hevium_get_agent_balance`: Query wallet ETH/USDG/WETH balances and remaining 24h budget.
2. `hevium_get_trending_tokens`: List active bonding curve & DEX tokens sorted by velocity.
3. `hevium_get_token_info`: Inspect real-time bonding progress, reserve liquidity, and graduation state.
4. `hevium_get_quote`: Simulate token output, price impact, and slippage bounds.
5. `hevium_buy_token`: Execute a bonding curve or graduated AMM buy.
6. `hevium_sell_token`: Execute a bonding curve or graduated AMM sell with approval check.