Contract reference
The contracts hold custody and enforce the lifecycle.
Contract map
Use the generated collector bindings and a verified deployment manifest. Never substitute fixture addresses into a public-network transaction.
| Contract | Responsibility |
|---|---|
| CollectorFactory | Launch registry, allocation, graduation, shutdown timestamp |
| CollectorCurve / CollectorMarket (v4 hook) | Curve execution and Uniswap v4 markets |
| CollectorFeeVault / CreatorBuyLock | Creator/platform quote fees and creator purchase locks |
| CollectorPackVault / ClaimNFT | Pack requests, reveal, ownership, return and redemption |
| CollectorInventory | Private issuance root, aggregate proofs and token custody |
| CollectorRewards | Project-isolated quote earnings, repeat claims and exits |
| BuybackReserve | Per-pack protected quote reserves |
| CollectorCollectibleZone | Seaport claim-state settlement checks |
Read before writing
Read factory.shutdownAt(), vault.requests(id), vault.decisionDeadline(id), NFT ownership, and the relevant earnings pool before preparing a transaction. decisionDeadline is the effective deadline; the raw request field alone can miss a shutdown extension.
Read inventory.root() before sealing. Graduation roots are immutable snapshots. Existing approvals are not authorization to bypass current contract state. Simulate writes against the same deployment before requesting a wallet signature.
Direct settlement
refundRequest(id) returns an eligible pending payment to its payer. requestOpen(id) normally requires ownership and becomes permissionless during shutdown. finalizeOpen supplies the committed manifest. keep and return methods enforce the owner and whole-pull state; settleExpiry releases only elapsed protection.
disclose validates a token aggregate witness. finalizeShutdown checks all closure obligations. claimEarnings(id) pays accrued quote while keeping the card active; redeem(id) burns the card and pays backing plus unclaimed quote. Swaps burn launch tokens directly. See the source ABIs for exact argument types; numeric token amounts use raw integer units.