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.
General
What is Geode?
Geode is a batch auction DEX built as a Uniswap v4 Hook. Instead of executing trades one-by-one against an AMM (where MEV bots extract value), Geode collects signed trade intents and settles them at a single uniform clearing price. Every trader in the same batch gets the same price.How is Geode different from a regular DEX?
Uniform pricing
Uniform pricing
Every trader in the same batch gets the exact same price. No frontrunning, no position-dependent execution.
MEV protection
MEV protection
Batching eliminates sandwich attacks. There’s no sequential ordering to exploit within a batch.
Internal matching
Internal matching
When buyers and sellers exist in the same batch, their flow crosses internally — no AMM spread, no price impact on matched volume.
Gasless intent signing
Gasless intent signing
Users sign Permit2 messages — gasless signatures that authorize trades. The on-chain gas is paid by the settler, not the trader.
Is Geode decentralized?
Yes, fully.- No admin keys: The contract is immutable — no owner, no upgradeability, no privileged roles
- Permissionless settlement: Anyone can settle batches and earn rewards
- On-chain only: No off-chain state dependencies, no sequencers, no trusted infrastructure
- Uniswap v4 native: Operates within the PoolManager’s flash accounting guarantees
Trading
How do I trade on Geode?
Two options:- Direct swap: Trade like normal Uniswap — instant execution against the AMM. A fee (0.2% standard, 1% launch pools) goes to the protocol surplus.
- Hook Mode (intent-based): Toggle “Hook Mode” in swap settings, sign a Permit2 intent, and your trade gets batched with others for uniform clearing price execution.
What fees do I pay?
| Fee | When | Rate |
|---|---|---|
| Settlement fee | Intent-based trades (Hook Mode) | 0.1% of input |
| Direct swap fee | Non-intent swaps through Geode pools | 0.2% standard / 1% launch pools |
What is Hook Mode?
Hook Mode switches the swap interface from standard Uniswap routing to intent-based routing. When enabled, you sign a gasless Permit2 intent instead of submitting an on-chain transaction. Your trade gets settled in a batch at a uniform clearing price.What if my trade doesn’t fill?
If the batch’s clearing price doesn’t meet yourminAmountOut (slippage tolerance), your intent is simply skipped. Your tokens are never moved. You’d need to sign a new intent to try again.
Do I pay gas for intent trades?
You don’t pay gas to sign the intent. The settler pays gas to executegeodeSettleBatch() on-chain. The settler is compensated through settlement fees (from your input) and gas reimbursement (from surplus).
What happens to my tokens while I wait for settlement?
Your tokens stay in your wallet until the moment of settlement. Permit2 only transfers them when the settler executes the batch on-chain. There is no vault, no deposit, and no custody by the protocol.Token Launches
How do I launch a token?
CallGeodeFactory.launch() (or use the Launchpad UI) with your token name, symbol, supply, and curve parameters. The factory deploys an ERC20, mints the full supply to the hook, and activates the bonding curve — all in one transaction.
See Geocurve for the full launch guide.
What is a Geocurve?
A virtual constant-product bonding curve (x × y = k) that manages price discovery for new tokens. It starts at a configurable low price and rises as more tokens are purchased. When enough ETH is raised, the curve graduates into a real Uniswap v4 AMM pool.
What does graduation mean?
When the curve’s ETH reserve crosses the graduation threshold (default: 85 ETH) and enough supply has been distributed (≥95%), the pool transitions:- The Uniswap v4 pool is initialized at the terminal curve price
- Remaining tokens + ETH are used to seed permanent liquidity
- The pool switches to standard mode with full hook benefits
- Unsold tokens are sent to the dead address
Do I need to provide liquidity?
No. The bonding curve IS the liquidity during the launch phase. At graduation, the protocol seeds the AMM automatically from accumulated ETH and remaining tokens.Do deployers earn fees?
Yes. Deployers earn a configurable royalty (up to 50%) sized from matched volume on their token’s pool. This is drawn from accumulated surplus, not from trader output.Security
Are my funds safe?
Geode is designed with security as a priority:- Immutable contracts: No admin keys, no upgradeability
- Flash accounting: Uniswap v4’s
unlock()guarantees all token deltas net to zero — nothing can be created or destroyed - Permit2 signatures: Your tokens can only be moved with your cryptographic authorization, within your specified parameters
- On-chain settlement: No off-chain components, no sequencer trust assumptions
Can a settler steal my tokens?
No. The settler callsgeodeSettleBatch(), but the hook controls all token movements. Your Permit2 signature authorizes a specific token amount for a specific pool with a specific minimum output. The settler cannot change these parameters.
What if no one settles my batch?
Settlement is a competitive market — settlers earn fees, so there’s always an incentive to settle. If no settler picks up your intent before the deadline, the signature expires and your tokens remain untouched.Technical
What blockchain is Geode on?
Ethereum mainnet. Geode is a Uniswap v4 Hook, so it operates wherever Uniswap v4 is deployed.What wallets work with Geode?
Any Ethereum wallet that supports EIP-712 signing: MetaMask, WalletConnect, Coinbase Wallet, Rainbow, etc.Is Geode open source?
Yes. All smart contracts are open source at github.com/geodeag.Getting Help
Telegram
Join the community for real-time help and discussion.
X (Twitter)
Follow for protocol updates and announcements.
GitHub
Report issues, view source code, and contribute.
Reach the team directly for technical or partnership inquiries.