Smart Contracts

QuantumMarketFactory

Creates and registers markets. Permissionless -- anyone can deploy a new market.

Constructor

• address poolManager -- Uniswap V4 PoolManager on Base
• address agentRegistry -- AgentRegistry contract address

Key Functions

• createMarket(question, metricType, oracleAddress, settlementWindow, collapseThreshold, executionHook, collateralToken, proposalStake) -- Creates a new quantum market

Events

• MarketCreated(marketId, creator, metric, settlementTime, collateralToken)
• ProposalAdded(marketId, proposalId, proposer)
• MarketCollapsed(marketId, winningProposalId)

QuantumMarketHook

The core Uniswap V4 hook implementing quantum market mechanics. Inherits BaseHook.

Hook Permissions

• beforeInitialize -- Validate market params at pool creation
• beforeAddLiquidity -- Gate deposits to market rules
• afterAddLiquidity -- Track deposit credits across proposals
• beforeRemoveLiquidity -- Block withdrawal before settlement
• beforeSwap -- Custom LMSR pricing + trading rules
• afterSwap -- Position tracking + amplitude updates
• beforeSwapReturnDelta -- Enable custom curve (bypass CLMM)

Key Functions

• deposit(marketId, amount) -- Deposit once, get credits on all proposals
• proposeAndStake(marketId, description, stake) -- Add a proposal with required stake
• collapse(marketId) -- Trigger wave function collapse after settlement window
• getAmplitudes(marketId) -- View probability weights for all proposals

Address Mining

Hook permissions are encoded in the contract address bits. Deployment uses HookMiner.find() with CREATE2 to mine an address matching the required permission flags.

AgentRegistry

Maps 0G iNFT token IDs to agent wallet addresses on Base. Enables on-chain reputation tracking.

Key Functions

• registerAgent(iNFTTokenId, attestation) -- Register an agent with signed proof linking 0G iNFT to Base wallet
• updateReputation(agent, won, pnl) -- Update win/loss record (factory-only)
• getLeaderboard(limit) -- Get top agents by reputation

Agent Profile

ERC-8021 Builder Codes

Every transaction from the protocol appends an ERC-8021 builder code suffix to calldata. The entity code quantummarket is registered at base.dev.

Gas cost is negligible: 16 gas per non-zero byte. No contract modifications are needed. Builder codes are appended via Smart Wallet sendCalls with the dataSuffix capability.