Documentation Index
Fetch the complete documentation index at: https://docs.geode.ag/llms.txt
Use this file to discover all available pages before exploring further.
Trading on Geode
Geode has two trading paths: direct swaps (standard Uniswap routing) and intent-based swaps (batch settlement via the hook). The UI supports both via a “Hook Mode” toggle in swap settings.Direct Swap (Standard Path)
This works exactly like any Uniswap v4 swap. Your trade executes immediately against the AMM.Connect Wallet
Connect your Ethereum wallet (MetaMask, WalletConnect, Coinbase, or any standard wallet) to the Geode app at geode.ag.
Select Tokens
Choose your input and output tokens from the token selector. Any token with a Geode-configured pool is available.
Direct swap fee: Direct swaps through Geode-configured pools pay a fee (0.2% for standard pools, 1% for launch pools) that goes to the protocol surplus. This is separate from the standard Uniswap pool fee.
Intent-Based Swap (Hook Mode)
This is Geode’s core innovation. Instead of swapping immediately, you sign an intent that gets settled in a batch at a uniform clearing price.Enable Hook Mode
In the swap interface, open Settings and toggle Hook Mode on. This switches from direct routing to intent-based routing.
Configure Your Trade
Enter the tokens and amount you want to swap. Set your slippage tolerance — this becomes your
minAmountOut (the worst price you’ll accept).Sign the Intent
Click “Swap” and sign the Permit2 message in your wallet. This is a gasless signature — no on-chain transaction yet.The signed message authorizes the settler to pull your tokens and execute the trade at the clearing price if your limit price is met.
Batch Settlement
A permissionless settler collects your intent (along with others), calls
geodeSettleBatch() on-chain, and your trade executes at the batch’s uniform clearing price.You receive your output tokens directly to your wallet. A small settlement fee (default 0.1%) is deducted from your input before routing.Launching a Token
Geode’s launchpad lets anyone deploy a new token with a bonding curve (Geocurve) — no upfront liquidity required. When enough ETH is raised, the token automatically graduates to a full Uniswap v4 AMM pool.Open the Launchpad
Navigate to the Launch tab in the Geode app. Connect your wallet if you haven’t already.
Configure Your Token
Provide the token name, symbol, and supply. Set the virtual reserves that determine the starting price and curve shape.The starting price is
virtualEthReserve / virtualTokenReserve.Launch
Submit the transaction. The
GeodeFactory contract deploys your ERC20 token, mints the full supply to the hook contract, and activates the bonding curve — all in one transaction.Your token is immediately tradeable on the Geocurve.Graduation
As buyers purchase your token, ETH accumulates in the curve reserve. When the reserve crosses the graduation threshold (default: 85 ETH), the curve transitions to a real Uniswap v4 AMM with permanent liquidity.After graduation, your token trades in standard mode with full hook benefits (batch settlement, internal matching, MEV protection).
Deployer royalty: Token deployers earn a configurable share of the surplus generated by trading activity on their pool (capped at 50%).
What’s Next?
How It Works
Deep dive into the settlement flow, clearing price algorithm, and Uniswap v4 hook architecture.
Intent System
Understand the GeodeIntent struct, Permit2 signing, and replay protection.
Geocurve
Learn how the bonding curve works, pricing math, and the graduation process.
Economics
Fee model, surplus management, settler rewards, and wash trade resistance.