GeodeFactory.sol

Overview

GeodeFactory handles one-transaction token launches. It deploys a GeodeToken ERC20, mints the full supply to the hook, computes the pool key, configures the hook, and registers the bonding curve — all atomically. The v4 pool is NOT initialized at launch. It will be initialized at graduation at the terminal curve price for price-continuous handoff.

Immutables

IPoolManager public immutable poolManager;
GeodeHook public immutable hook;
Currency public immutable weth;    // WETH or native ETH wrapper

Launch Parameters

struct LaunchParams {
    string name;                    // Token name
    string symbol;                  // Token symbol
    uint256 totalSupply;            // Total supply (18 decimals)
    uint256 virtualTokenReserve;    // Vt (>= totalSupply for asymptotic pricing)
    uint256 virtualEthReserve;      // Ve (starting price = Ve / Vt)
    uint24 deployerRoyaltyBps;      // Deployer's surplus share (max 50%)
    uint256 batchInterval;          // Blocks between settlements
    uint24 directSwapFeeBps;        // Direct swap fee (post-graduation)
    uint256 settlementFeeBps;       // Settlement fee per intent
    uint256 maxBatchSize;           // Max intents per side
    int24 tickSpacing;              // Pool tick spacing
    uint256 graduationEthThreshold; // ETH threshold (0 = default 85 ETH)
}

Launch Flow

`launch()`

function launch(LaunchParams calldata params)
    external returns (address tokenAddress, PoolId poolId)

Validate

totalSupply > 0
virtualTokenReserve > 0 and virtualEthReserve > 0
deployerRoyaltyBps <= 5000 (max 50%)
maxBatchSize between 1 and 256
virtualTokenReserve >= totalSupply (all tokens go to curve)

Deploy ERC20

GeodeToken token = new GeodeToken(
    params.name, params.symbol,
    params.totalSupply, address(hook)
);

Full supply minted to the hook contract.

Determine Currency Ordering

Uniswap v4 requires address(currency0) < address(currency1). WETH is always currency0 (lower address). If the token address is lower than WETH, the launch reverts with TokenSortOrderViolation.

Build Pool Key

PoolKey memory key = PoolKey({
    currency0: weth,
    currency1: Currency.wrap(tokenAddress),
    fee: 0x800000,    // Dynamic fee flag
    tickSpacing: 60,   // Default
    hooks: IHooks(address(hook))
});

The pool is NOT initialized in v4 — no poolManager.initialize() call.

Configure Hook

Calls hook.geodeInitializePool(key, config) with the curve parameters. Because config.deployer != address(0), this call is restricted to the factory.

Calls hook.registerLaunch() to set up LaunchState tracking with virtual reserves and graduation threshold.

Launch Record

struct LaunchRecord {
    address deployer;
    address tokenAddress;
    PoolId poolId;
    uint256 totalSupply;
    uint256 launchBlock;
    bool exists;
}

Stored in mapping(PoolId => LaunchRecord) public launches with a global launchCount.

Events

event TokenLaunched(
    PoolId indexed poolId,
    address indexed deployer,
    address indexed tokenAddress,
    string name, string symbol,
    uint256 totalSupply,
    uint256 virtualTokenReserve, uint256 virtualEthReserve,
    uint24 deployerRoyaltyBps,
    uint256 graduationEthThreshold
);

Source