PrimaryHook

Callable only by a factory-registered bonding curve. Initializes the pool, mints the full-range position, registers the token, and pushes the secondary envelope. Returns the position id.

$LP24 takes the full envelope with no split. Every other token mints 90% into the primary pool and pushes 10% to the SecondaryHook in the same transaction.

• "Only a factory curve may graduate" — Factory.is_curve(msg.sender) is false
• "Already registered"
• "Invalid deployer"
• "Insufficient graduation funds" — msg.value < GRADUATION_NATIVE
• "Secondary native push failed"

TokenRegistered(token, deployer, positionId), then SecondaryReserved(token, deployer) for non-protocol tokens

Accept a protocol share. Called by bonding curves on refund initiation and on sweep. Adds msg.value to protocolBalance.

Split pending fees 30% deployer, 10% protocol, 60% reinvested. Anyone can call. Not for $LP24.

Deployer and protocol shares are credited and pendingFees zeroed before the reinvest swap. If the MEV cap prevents the full reinvest amount being processed, the remainder is added to protocolBalance rather than back to pendingFees — it has already been split and must not be taxed twice.

• "Use processProtocolFees" — token is $LP24
• "No position" — token not registered
• "No fees" — pendingFees is zero

FeesDistributed(token, total, reinvested), then Reinvested(...) or BuyAndBurn(...)

Process the accumulated protocol balance against the $LP24 pool. Anyone can call. Buys and burns $LP24 when the pool holds ≥ 24,000,000 tokens; reinvests to deepen the pool when it holds fewer.

Only the MEV-capped chunk is processed per call; the remainder rolls forward.

• "Nothing to process" — balance at or below 1,000,000 wei
• "No protocol token"
• "Pool not initialized"
• "Pool too thin for any safe swap"
• "No position" — on the reinvest branch

BuyAndBurn(token, nativeSpent) or Reinvested(...)

Deployer only. Withdraws the full accrued balance for that token. After a successful CTO this is the new deployer.

• "No deployer fees for protocol token"
• "Not deployer"
• "No fees"

DeployerWithdrawal(token, deployer, amount)

Clone a vote contract and transfer the initiator's stake into it. Returns the vote address. Requires the exact chain fee and 60,000,000 × 10⁹ (60M, 5% of supply) approved to this contract.

• "CTO not enabled"
• "Protocol token cannot be CTO'd"
• "Send exact CTO fee" — exact, no overage refund
• "Token not registered"
• "CTO vote already active"
• "Stake transfer failed"

CTOVoteInitiated(token, vote_contract, initiator)

Vote contract only. Transfers the deployer role, mirrors the change into the factory registry, pays out the outgoing deployer's balance (best effort), and transfers socials ownership.

• "No active vote"
• "Not vote contract"
• "Invalid new deployer" — zero address would lock fees permanently

DeployerUpdated(token, oldDeployer, newDeployer, paidOut)

Clear a failed vote so a new one can be initiated. Anyone can call.

• "No active vote"
• "Vote still active"
• "Vote was finalized"
• "Vote passed - must finalize"