How It Works

1 · Deploy. You describe the card: Pokémon, grader, grade range, language, years, sets, price, how far under fair value, keywords, exclusions and buy order. The worker canonicalizes the rules and returns their keccak256 hash. You pick what happens to bought cards, who can win, whether winners can sell back, and name the coin.

2 · Launch. One wallet prompt launches the coin on pump.fun (1B supply, no allocation, bonding curve that graduates to PumpSwap), creates its pump.fun fee sharing and locks it to the strategy: vault 80%, platform 20%, optionally up to 10% to you out of the vault's share. pump.fun makes that split permanent. The same prompt registers the strategy with its rules hash, and makes your dev buy if you set one. Already launched on pump.fun? Register the coin instead; the same lock applies.

3 · Fees. pump.fun pays every coin's creator a fee on each trade: 0.30% of volume on the bonding curve, and up to 0.95% on PumpSwap after graduation. For a strategy coin that fee belongs to its vault. Every minute the worker triggers pump.fun's permissionless distribution, which pays the vault, the platform and any deployer share directly.

4 · Scan. Every minute the worker reads live Collector Crypt listings on Solana, normalizes them (numeric grades, canonical languages and sets, USD prices, insured value as fair value) and ranks the ones that fit each strategy's rules in its buy order.

5 · Buy. When the vault covers the top match, the executor calls release, which only pays the strategy's own buying wallet and only up to a rolling 24h cap. That wallet swaps SOL for USDC on Jupiter, buys the card on Collector Crypt and moves it into the vault. record_purchase then checks it really is a Collector Crypt card sitting in the vault and fixes its draw round.

6 · Cards come out. Depending on the strategy, each card is raffled to one holder after its delay, drawn with the rest of a scheduled drop, put in a pool for pack openers, or kept forever. Every draw is verified on-chain and the card goes straight from the vault to the winner's wallet. Anyone can send SOL, or a card, to a vault to speed it up.

Raffle. The deployer picks a delay from 1 hour to 30 days (default 24h). When a card is recorded the program computes the drand quicknet round for boughtAt + delay. At that time the worker builds the snapshot: every wallet's balance integrated over the window, laid out as contiguous ticket ranges and committed to with a Merkle root. It submits the round's signature, the root, and the winner's range with a proof. The program derives the ticket and refuses any winner whose range doesn't contain it.

Why drand and time-weighting. drand's randomness is produced jointly by independent operators, so nobody can predict or choose it, including us. Tickets are balance multiplied by time held across the whole window, so odds reflect how long you actually held, and buying right before a draw earns almost nothing. If nobody eligible held during the window, the draw moves to a fresh future round.

Delivery. The card sits in the strategy's vault until its draw. Once settled, anyone can trigger deliver (the worker does it immediately), and the program sends the NFT from the vault to the winning wallet. There is nothing to claim.

Keep. Keep strategies never part with a card: the coin is backed by a collection that only grows, held by its vault.

Drops. A drop strategy picks a period (a day to 30 days). Every card bought is scheduled for the next drop time at least an hour away, so cards pile up and are drawn together, each with its own ticket over its own window. One countdown, several winners.

Packs. A pack strategy sets a price in coins. Bought cards go into a pool of up to 200. Opening a pack burns that many coins through the token program and fixes a drand round about 6 seconds ahead. When it's out, the pool slot is sha256(domain, randomness, strategy, pack id) mod pool size, the program moves that card out of the pool, and it's delivered to the opener. Nobody, including us, knows the card when you open.

Draw rules. A strategy can require a minimum average hold, cap any one wallet's share of the tickets, leave the creator out and boost wallets that held through every snapshot. The rules sit in the strategy's rules file, so the on-chain hash locks them, and they're applied in a fixed order anyone can repeat from the published snapshot.

Sell-back. If the deployer allows it (up to 90%), a winner can send the card back to the vault and is paid that share of what it cost. The card is scheduled for a fresh draw, or returns to the pack pool.

Sell to a vault. Pack vaults can buy cards from collectors. The worker quotes 90% of Collector Crypt's insured value, the collector and the executor both sign one transaction that moves the card into the vault and pays the seller, and the purchase counts toward the vault's 24h spending cap.

Donations. Anyone can send a Collector Crypt card into any vault. The program records it with the donor's wallet, and it is drawn, dropped or packed like a bought card. A card can only be recorded once per strategy.