← Back to App

Documentation

Getting Started

Follow these steps to start looksmaxxing on MegaETH. You can also use the Portal for a streamlined experience with natural language commands.

1. Set Up Your Wallet

Install a Web3 Wallet

You'll need a Web3 wallet that supports custom networks. Recommended:

  • MetaMask
  • Brave Wallet
  • Phantom

Add MegaETH Network

Network details (auto-added when you connect):

  • Network Name: MegaETH
  • Chain ID: 4326
  • RPC: https://mainnet.megaeth.com/rpc
  • WebSocket: wss://mainnet.megaeth.com/ws
  • Currency: ETH
  • Block Explorer: megaexplorer.xyz
  • Block Time: ~250ms

2. Get $MEGACHAD Tokens

You need 225,000 $MEGACHAD tokens to create a looksmaxxed image.

Contract: 0x374A17bd16B5cD76aaeFC9EAF76aE07e9aF3d888

How to buy: Bridge ETH to MegaETH via Rabbithole (supports Ethereum, Base, Arbitrum, Optimism, Polygon, BNB, Avalanche, Scroll, zkSync, Linea), then swap on Kumbaya DEX. Or use the built-in swap widget on the main page.

3. Connect & Burn

  1. Navigate to /main
  2. Click "CONNECT WALLET" and approve the connection
  3. Upload your portrait image (JPEG/PNG, max 4MB)
  4. Optional: Enable "Store on-chain permanently with Warren" (~$5)
  5. Click "BURN & LOOKSMAXX"
  6. Approve two transactions: burn to dead address + transfer to tren fund
  7. AI generation begins automatically (1-2 minutes)
  8. Image pinned to IPFS, NFT minted to your wallet

Gasless option: Use the EIP-712 relayer to burn without gas fees. Approve the relayer contract once, then sign messages instead of transactions.

4. Storage Options

IPFS (Default — Free)

  • Decentralized, content-addressed storage via Pinata
  • Accessible via public IPFS gateways
  • Included with every burn

Warren Protocol (Premium — ~$5)

  • Stored directly on-chain, truly immutable
  • Cannot be removed or censored
  • NFT metadata permanently references on-chain image

5. Portal & Natural Language Commands

The MegaETH Portal is your command center:

  • Portfolio: View all your MegaETH token balances (ETH, $MEGACHAD, WETH, USDm)
  • Protocols: Browse the MegaETH protocol directory
  • Activity: Live network stats and protocol metrics

Use the NLP command bar to type natural language:

  • "swap 0.1 ETH for megachad" → get swap calldata
  • "looksmaxx from base" → cross-chain plan
  • "check wallet 0x..." → balance + eligibility
  • "compare 0xABC vs 0xDEF" → side-by-side comparison
  • "show top burners" → leaderboard
  • "register me as an agent" → agent registration calldata

6. Cross-Chain Looksmaxxing

You can looksmaxx from any of 10 supported chains without manually bridging:

  • Ethereum, Base, Arbitrum, Optimism, Polygon
  • BNB Chain, Avalanche, Scroll, zkSync Era, Linea

The system builds a complete plan: bridge → swap → burn → generate → mint. Access via the NLP command bar, the /api/cross-chain/intent API, or the cross_chain_looksmaxx MCP tool.

7. Identity & Profiles

Every wallet has a profile page that aggregates:

  • MegaNames: .mega domain name and social links
  • Burn history: All looksmaxxes with IPFS images
  • Tier: Normie (0) → Mewer (1+) → Bonesmasher (3+) → Chad (10+) → Gigachad (25+)
  • Reputation: ERC-8004 on-chain rating from other users
  • Referral stats: If registered as an agent

Profiles are queryable via /api/identity/ADDRESS by any MegaETH protocol.

8. Agent Referral Program

AI agents can register on-chain and earn commissions:

  • Reward: 11,250 $MEGACHAD (5%) per referred burn
  • Registration: Call registerAgent() on the referral contract or POST to /api/agent/register
  • Referral code: Base64URL of your wallet address
  • Tracking: On-chain via getAgentStats() or /api/agent/referrals

9. MCP Server Integration

MegaChad exposes a full MCP (Model Context Protocol) server with 20 tools:

  • get_megachad_stats — Token supply, circulating supply, burn count
  • get_price — Current $MEGACHAD price in ETH from Kumbaya DEX
  • get_swap_quote — Swap quote for ETH → $MEGACHAD with calldata
  • get_wallet_info — Wallet balances, NFT count, burn eligibility
  • get_portfolio — Full MegaETH token portfolio (ETH, WETH, MEGACHAD, USDm)
  • get_gallery — Browse looksmaxxed burns with IPFS images
  • get_chadboard — Burner leaderboard with reputation scores and .mega names
  • get_identity — Resolve wallet or .mega name into unified identity profile
  • get_nft_metadata — ERC-721 metadata for looksmaxxed NFTs
  • get_looksmaxx_requirements — Burn requirements and x402 payment info
  • get_looksmaxx_plan — Full transaction plan: swap → burn → tren fund → submit
  • cross_chain_looksmaxx — Cross-chain plan from 10+ chains to MegaETH
  • gasless_burn_info — EIP-712 typed data for gasless meta-transaction burns
  • get_bridge_info — Bridge options for moving assets to MegaETH
  • get_agent_info — ERC-8004 agent registration and reputation data
  • register_referral_agent — Register as referring agent (earn 11,250 $MEGACHAD per burn)
  • get_referral_stats — Referral count, earnings, and reward info
  • register_early_access — Register wallet for beta access
  • chat_with_megachad — Natural language interface for all operations
  • get_megaeth_protocols — Curated MegaETH protocol directory

Connect via npx @anthropic-ai/claude-code mcp add megachad https://megachad.xyz/api/mcp or add to your MCP client config.

10. API Reference

All endpoints are publicly accessible with CORS enabled.

Core

  • GET /api/stats — Protocol statistics
  • GET /api/price — Current price + burn cost
  • GET /api/wallet?address=0x... — Balance check
  • GET /api/gallery?limit=20 — Recent burns
  • GET /api/chadboard — Leaderboard

Generation & Minting

  • POST /api/generate — Generate + mint (direct burn proof)
  • GET|POST /api/x402/looksmaxx — x402-aware looksmaxx
  • GET /api/x402/quote?ethAmount=0.1 — Swap quote
  • GET|POST /api/gasless/burn — EIP-712 gasless burn via relayer
  • POST /api/warren/deploy — Warren on-chain permanent storage
  • GET /api/metadata/{tokenId} — ERC-721 NFT metadata

Agent & Chat

  • POST /api/agent/chat — Natural language transaction engine
  • GET /api/agent/info — Agent identity + ERC-8004
  • GET|POST /api/agent/register — Agent registration
  • GET /api/agent/referrals?address=0x... — Referral stats
  • GET /api/agent/looksmaxx?wallet=0x... — Full burn plan

Social & Messaging

  • POST /api/chat/auth — ChadChat Ably auth token
  • GET|POST /api/chat/messages — Chat message storage
  • GET|POST /api/chat/name — Display name management
  • POST /api/telegram — Telegram bot webhook
  • POST /api/telegram/alerts — Burn/mint notifications
  • GET /api/frame — Farcaster frame navigation

Cross-Chain

  • GET /api/cross-chain/intent?sourceChain=base — Build cross-chain plan
  • POST /api/cross-chain/intent — Submit intent for tracking
  • GET /api/cross-chain/status?id=cc_... — Track intent status

Identity & Portal

  • GET /api/identity/ADDRESS — Unified identity profile
  • GET /api/portal/tokens?address=0x... — All MegaETH balances
  • GET /api/portal/protocols — Protocol directory

Infrastructure

  • GET /api/bridge — Bridge info
  • GET /api/events — On-chain event stream (SSE)
  • GET /api/analytics — Usage tracking
  • POST /api/early/register — Beta access registration

11. Troubleshooting

Transaction Failed

  • Ensure you have enough ETH for gas on MegaETH
  • Check $MEGACHAD balance (need 225,000 tokens)
  • If using Warren, ensure ~$5 ETH for storage
  • Try gasless burns to avoid gas issues

Wallet Won't Connect

  • Refresh the page and try again
  • Ensure your wallet is unlocked and on MegaETH
  • Try a different browser or wallet

Generation Issues

  • AI generation takes 1-2 minutes — don't close the page
  • IPFS pinning adds 30-60 seconds
  • Warren deployment adds 1-2 minutes if selected

12. ChadChat

ChadChat is burn-gated real-time messaging on the Chadboard. Only wallets with at least 1 burn (Mewer tier or above) can send messages.

  • Access: Open the chat panel from the Chadboard page
  • Requirement: Must have burned at least once (connected wallet)
  • Display name: Shows your .mega name, custom name, or truncated address
  • Real-time: Powered by Ably for instant message delivery

13. Telegram Alerts

The MegaChad Telegram bot sends real-time notifications for burns, mints, and protocol milestones. Join t.me/megachads for alerts.

  • POST /api/telegram/alerts — Trigger burn/mint notifications
  • GET /api/telegram/setup — Bot configuration info

14. MEGA Protocol Governance

The MEGA Protocol is MegaChad's governance layer built on MegaETH. Burning $MEGACHAD earns governance rights and mints $MEGAGOONER — the governance and reward token.

$MEGAGOONER Token

  • Supply cap: 50,000,000 $MEGAGOONER
  • Emission: 225-week quadratic emission schedule
  • Purpose: Governance voting and staking rewards

Protocol Contracts

  • Framemogger: Burn $MEGACHAD → earn governance rights → mint $MEGAGOONER
  • MoggerStaking: Stake $MEGACHAD → earn $MEGAGOONER over time
  • JESTERGOONER: Stake LP tokens → earn $MEGAGOONER
  • Jestermogger: Governance voting — top 3 burners propose, $MEGAGOONER holders vote

All contracts are UUPS upgradeable proxies deployed on MegaETH (chain ID 4326).

15. Developer Resources

Start Looksmaxxing →