How It Works
A strategy is three things: a rule for which cards to buy, a Solana token, and a wallet that only ever spends on cards from
Collector Crypt. Everything below is a public API call or a transaction you can open in an explorer.
- 1 · Deploy. You describe the card (Pokémon, grader, grade, language, years, price, fair-value discount, free text), choose what happens to bought cards, and name the token. Rules are locked and public.
- 2 · Launch. You send the launch cost (about 0.035 SOL) plus any dev buy to the strategy's wallet, and that wallet creates the token on
pump.fun, which makes it the on-chain creator. Dev-buy tokens are forwarded to the wallet that paid. 1B supply, no team allocation. When the curve sells out it graduates to a PumpSwap pool. We deploy no contracts of our own. - 3 · Fees. pump.fun charges 1.25% per trade on the curve, of which 0.30% is the creator fee and goes to the strategy wallet. After graduation the creator fee continues on PumpSwap and depends on market cap: 0.30% under 420 SOL, 0.95% between 420 and 1,470 SOL (where pump.fun itself keeps only 0.05%), tapering to 0.05% above 98,240 SOL. The worker claims it every minute.
- 4 · Scan. Every minute the worker pulls live Collector Crypt listings, normalizes them (numeric grades, canonical languages and set names, USD prices, insured value as fair value) and ranks the ones that fit the rule, cheapest first.
- 5 · Buy. When the wallet can pay for the top card it swaps SOL to USDC on Jupiter if needed, asks Collector Crypt for the purchase transaction, signs it and broadcasts. The graded slab stays in Collector Crypt's insured vault; the strategy holds the NFT.
- 6 · Raffle. After the chosen delay the card is given to one holder, odds proportional to balance, with a published seed. Then it repeats, forever. Anyone can send SOL or USDC to the strategy wallet to speed it up.
The creator fee is pump.fun's own mechanism, paid only to the creator wallet, which is the strategy's. The worker claims it every cycle and forwards the PokéStrategy share in the same run; both transfers are visible on Solscan.
Raffle. A set number of hours after each purchase (the deployer picks, default 24h), the worker snapshots every holder of the token, excluding the liquidity pool and the strategy's own wallet. It computes a seed from a recent Solana blockhash and the purchase id, walks the balance-weighted holder list to that ticket, and transfers the card's NFT to the winner. Bigger bag, better odds; every draw is recomputable from the published numbers.
Why a blockhash seed. It is public, cannot be chosen by us, and is fixed before the draw. It is not unpredictable to Solana validators, which is acceptable for card-sized prizes; a VRF can replace it later without changing anything else.
Keep (next update). The vault only grows and the token is backed by a growing collection.
Flip (next update). Relist each card on Collector Crypt at a markup; proceeds buy more cards or buy and burn the token.
Wallets. Each strategy has its own wallet, derived from a master phrase held offline, encrypted at rest, and used only to sign purchases, listings, fee claims and swaps. Nothing is ever withdrawn to a person.
Verifiable. Token, pool, wallet, every purchase, listing, sale and burn link to Solscan or Collector Crypt from the strategy page.
Normalization. Collector Crypt fields like gradingCompany, grade: "GEM MINT 10" and insuredValue are mapped to one vocabulary, so "PSA 10 Japanese Charizard under fair value" means the same thing on every card.
Security. Every public endpoint is rate-limited per client and size-capped; scans of all strategies need a secret only the scheduler holds; launches are open to anyone and capped per hour and per day. Wallet keys live encrypted, derived from an offline master phrase.
Roadmap. Keep and Flip policies, best-deal and newest buy orders, Courtyard (Polygon) as a second marketplace, Robinhood Chain via Pons as a second venue. All already in the codebase behind flags.