Frequently Asked Questions

​

General

​

What is Geode?

Geode is the trading venue and launchpad for Uniswap v4 hook coins. It provides the infrastructure to launch tokens with novel on-chain mechanics (starting with bonding curve tokens), trade them with intent-based execution at uniform clearing prices, and discover them in one place. Built natively as a Uniswap v4 hook.

​

How is Geode different from a regular DEX?

​

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:

1. Direct swap: Trade instantly — for curve pools, the hook handles the swap via the bonding curve; for standard pools, it routes through the AMM. A 0.3% fee (curve pools) is split three ways: 1/3 to the curve reserve, 1/3 to treasury, 1/3 to surplus.
2. 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.

See the Quick Start for a step-by-step guide.

​

What fees do I pay?

Both fees are in addition to any standard Uniswap v4 pool fee.

​

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 your minAmountOut (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 execute geodeSettleBatch() 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?

Call GeodeFactory.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, initializes the v4 pool, and activates the permanent 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 serves as the permanent primary market for hook coins launched on Geode. The full supply is pre-minted to the hook — buying dispenses tokens from the hook’s reserve, selling absorbs them back. Inspired by the hook format pioneered by tokens like SATO. The curve handles primary issuance, while secondary pools on other venues create natural spread dynamics.

​

What are spread dynamics?

The curve price and secondary market prices naturally diverge — they answer different questions. The curve reflects cumulative buy/sell demand on the hook; secondary pools reflect broader market sentiment. The spread between them creates an emergent trading game: arbitrageurs can buy from the curve and sell on secondary (or vice versa), keeping the prices loosely tethered while the spread itself provides the action.

​

Is the curve permanent?

Yes. Unlike other launchpad protocols that “graduate” curves into AMM pools (creating unsold supply problems and awkward price translation), Geode’s Geocurve is permanent. The v4 pool exists as an empty shell — the hook handles all pricing via BEFORE_SWAP_RETURNS_DELTA. A portion of each swap fee goes directly to the curve’s ETH reserve, permanently increasing the floor price. Secondary pools are additive, not a replacement.

​

Do I need to provide liquidity?

No. The bonding curve IS the liquidity. There is no separate liquidity provision step. The entire token supply goes to the hook at launch, and the curve handles all price discovery and trading.

​

Do deployers earn fees?

Yes. Deployers earn a configurable royalty (up to 50%) drawn from accumulated surplus on their token’s pool.

​

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 calls geodeSettleBatch(), 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/Geode-vAMM.

​

Getting Help