Factory

Deploy a token + bonding curve pair. Returns (token, curve). Anyone can call once the protocol token exists.

Must equal the chain's deployment_fee exactly — Base 0.06 ETH, BSC 0.18 BNB, Polygon 1,440 POL, Robinhood 0.06 ETH, Gnosis 144 xDAI. Forwarded in full to the bonding curve.

• "Protocol token not yet deployed" — deploy_protocol_token has not run
• "Incorrect fee" — msg.value != deployment_fee
• "Invalid name/symbol" — either is empty
• "Invalid salt" — anchor block is zero
• "Anchor not mined" — block.number <= anchor_block
• "Too late" — past the inclusion window
• "Blockhash unavailable" — anchor more than 256 blocks back
• "Blockhash mismatch" — salt's committed prefix does not match
• "Vanity miss" — resulting address does not start 0x24

PairDeployed(token, curve, deployer, name, symbol, packed_socials)

Deploy the protocol token pair. System deployer only, callable once. Uses CREATE rather than CREATE2, so the address depends only on this factory and its internal nonce. No fee, no socials registration; the initial mint goes to the vesting contract.

• "Not system deployer"
• "Protocol already deployed" — permanent one-shot lock
• "Invalid name/symbol"

ProtocolPairDeployed(token, curve, deployer, name, symbol)

Move a token between deployer enumerations on CTO finalization. Callable only by the primary hook / graduation manager. O(1) swap-and-pop on the old owner, append on the new.

• "Only hook" — caller is not the registered hook

Every token an address has ever launched, in any state. Intended for off-chain eth_call — the array can be large.

Number of tokens launched by an address.

Paginated access, so on-chain callers never materialize the full array.

• "Index OOB"