Docs
Rules of the course.
How Birdie Labs plays, how it is scored, what the real hardware does, and how the Weekly Purse settles. Pre-launch: everything here describes the product as it will run when the daily course opens.
Overview
Birdie Labs is a daily quantum puzzle scored like golf. Every day at 00:00 UTC a new target quantum state drops. You build it on a small circuit with as few gates as you can: every gate is a stroke, and our reference solution is par.
When the hole closes, the shortest verified circuit of the day runs on a real quantum processor. The receipt, ideal against measured, is published and anchored on Solana.
- ›One hole a day, the same hole for everyone
- ›Six swings, server-verified, with per-qubit feedback
- ›A spoiler-free share card for every result
- ›A handicap that improves as you do
- ›A Weekly Purse for wallets that par all seven holes
How a hole plays
- 100:00 UTC: the hole drops with a target state (2 to 4 qubits), the gate set for the day and par.
- 2Open the app as a guest, or connect a wallet to keep a scorecard.
- 3Place gates on the wires. The live state vector, probability bars and Bloch spheres follow every gate.
- 4Swing: the server re-simulates your circuit and answers per qubit. You have six swings.
- 5Holed: fidelity to the target is 0.999 or more. Your score is gates used against par.
- 6Share the grid: how you got there, never which gates you used.
- 723:59 UTC: the hole closes. The shortest verified circuit becomes the Hole Champion; the earliest timestamp wins ties.
- 8The champion circuit runs on real hardware and the receipt is published.
- 9Sunday 23:59 UTC: the week closes and the Weekly Purse settles.
⚠ Building between swings is free and unlimited. Only swings are counted.
Scoring
Every gate is one stroke, two-qubit gates included. Measurement is not allowed: holes target the state before measurement.
- Hole-in-One
- Holed with a single gate
- Condor (−4)
- Four gates under par
- Albatross (−3)
- Three gates under par
- Two under (−2)
- Two gates under par
- Birdie (−1)
- One gate under par: the daily goal
- Par (0)
- Matched the reference solution
- Bogey (+1)
- One gate over par
- Double bogey (+2)
- Two gates over par
- Unholed
- Six swings used without reaching the target
Swings and feedback
A swing submits the whole circuit. The server simulates it with the same open-source engine your browser uses and returns three things.
- Total fidelity
- F = |⟨target|ψ⟩|², shown as a percentage
- Per-qubit band
- From each qubit's reduced state against the target's: 🟩 match ≥ 0.99 · 🟨 close ≥ 0.50 · ⬛ off below
- Stroke count
- Gates used in that swing
⚠ For an entangled target, every qubit's local state can match while the joint state is still wrong (a phase between them). That is why the total fidelity is shown too.
How par is set
- 1Each hole starts as a random circuit from the day's gate set, kept only if the target is entangled or phase-sensitive and cannot be reached in one or two gates.
- 2An exhaustive shortest-path search over the gate set (states compared up to a global phase) finds the true optimum: proven for 2 and 3 qubits, best known for 4.
- 3Par = optimum + 1. The shortest circuit always scores a Birdie.
- 4A 4-qubit hole solved below the best known is a Course Record (badge plus a bonus from the Reserve).
- 5Hole hashes for the next seven days are published before the week starts, so nobody can change a hole after seeing who plays it.
- Monday
- 2 qubits · Clifford gates · par 4
- Tuesday
- 2 qubits · T gates, phase matters · par 5–6
- Wednesday
- 3 qubits · GHZ-style entanglement · par 5–6
- Thursday
- 3 qubits · phase kickback · par 6
- Friday
- 3 qubits · quarter-turn rotations · par 6–7
- Saturday
- 4 qubits · the long hole · par 7–8
- Sunday
- 4 qubits · signature hole · par 7–8
Hardware runs and receipts
Every day after the hole closes, the Hole Champion circuit is compiled for a commercial quantum processor (superconducting or trapped-ion), reached through public quantum-cloud programs, and run for 1,024 shots.
- Ideal distribution
- From the open-source simulator
- Measured distribution
- The raw counts from the device
- Fidelity
- Hellinger fidelity between the two
- Run details
- Device, qubits, job ID, shots, timestamp, calibration time, cost
- Anchor
- SHA-256 of the receipt JSON, written to Solana with the Memo program from the Hardware Fund wallet
⚠ Real hardware is noisy. Measured counts will not match the ideal bars exactly, and receipts are published as measured, without correction. If a device is down, the run moves to the next device on the list and the receipt says which one and why.
Weekly Purse
Half of every creator fee goes to the Purse Vault. Each week it is split in equal shares between the wallets that qualified.
Eligible wallet = all of
- ›Holed all 7 holes of the week at par or better
- ›Held at least 100,000 $BIRDIES at every hourly snapshot of the week
- ›One wallet per scorecard, signed in for every swing
Settlement, Monday 00:00 UTC
- 1The Purse multisig swaps what the vault received into SOL through Jupiter.
- 2The eligible list and its merkle root are published.
- 3A 24-hour public review window: anyone can dispute a wallet.
- 4A merkle distributor round is funded with that exact total; claims stay open for 28 days.
- 5Unclaimed SOL rolls into the next week's purse.
⚠ Shares are equal for every eligible wallet. Holding more tokens never means a bigger share. Mulligan swings never count toward eligibility.
Creator fee split
$BIRDIES launches on PumpFun. Every trade on the bonding curve, and later on PumpSwap, pays the PumpFun creator fee (about 0.30% on the curve, up to about 0.95% on PumpSwap at small market caps).
- 50%Purse vault (Squads multisig): the Weekly Purse
- 20%Hardware Fund: daily runs and personal runs
- 25%Operations: team, infrastructure, hole authoring, audits, growth
- 5%Reserve: Course Records, Majors top-ups, spare hardware
⚠ PumpFun fee sharing is configured once at launch (up to 10 recipients, shares summing to 100%) and its admin key is revoked in the same session. The split is frozen on-chain. Distribution is permissionless: anyone can run the crank.
Membership tiers
- Range · hold 0
- Daily hole, share card, streaks, handicap, leaderboards, the Driving Range, every receipt
- Birdie · hold 100k (0.01%)
- Weekly Purse eligibility, past-hole replays, Birdie badge
- Albatross · hold 1M (0.1%)
- 1 Personal Hardware Run per month, early entry to Majors, custom share-card frame
- Condor · hold 5M (0.5%)
- 3 Personal Hardware Runs per month, propose community holes, name on the Clubhouse wall
What the token never does
- ›Never changes a score
- ›Never buys a bigger purse share
- ›Never unlocks extra purse swings
- ›Never gates the daily hole, the share card or the Range
- ›Never passes through a custodial account
Token sinks (Phase 2)
- ›Mulligan: burn about $0.50 of $BIRDIES for a seventh swing (streak only)
- ›Streak Freeze: burn about $1 to protect a streak through one missed day, at most twice a month
- ›Card frames: burn to unlock seasonal frames
- ›Majors entry: burn a fixed amount to enter the monthly Major
⚠ Burn amounts reset on the 1st of each month from the 30-day average price. Every burn is an SPL burn.
Tokenomics
- Total supply
- 1,000,000,000 $BIRDIES
- Launch
- PumpFun bonding curve, fair launch
- Quote asset
- An xStock (tokenized equity on Solana); default GOOGLx, final pick on launch day
- Presale / team / private round
- None
- Dev buy
- Disclosed at launch; if any, locked 90 days in a public vesting contract
- Mint authority
- Revoked at creation
- Freeze authority
- None
- Graduation
- Liquidity migrates to PumpSwap when the curve completes
- Payouts
- Always in SOL
Handicap and badges
- 1Take your last 20 holes.
- 2Score each as strokes over par; an unholed hole counts +3.
- 3Your handicap is the average of your best 8, shown with one decimal.
- First Birdie
- Your first hole under par
- Hole-in-One
- Holed with a single gate
- Course Record
- Beat the best known on a 4-qubit hole
- Full Card
- 7/7 at par or better in one week
- Iron 7 · 30 · 100
- Streaks of 7, 30 and 100 days
- Bell Ringer
- 10 Bell-state holes
- Teleporter
- The monthly teleportation hole
- Phase Hunter
- 10 phase-sensitive holes
- First Swing Club
- Holed on the first swing 10 times
- Receipt Holder
- Your circuit ran on real hardware
Fair play
- Scripted solvers
- Equal shares plus a full week of holding per wallet: every extra wallet costs real capital
- Buying in for Sunday
- Hourly balance snapshots at a random minute, all week
- Fresh wallet clusters
- Funding-graph checks flag them for review during the 24-hour window
- Retries
- Six server-verified swings; Mulligan swings never count for the purse
- Edited holes
- Hole hashes published a week ahead
- Clock games
- Server clock only; earliest verified timestamp wins ties
Purse on-chain
No custom program holds player money. The purse runs on programs that are already audited and live on Solana mainnet.
- Fee sharing
- PumpFun fee sharing sends 50% of the creator fee to a Squads v4 multisig vault, configured once at launch with the admin revoked
- Swap
- Each Monday the multisig swaps the vault's balance into SOL through Jupiter
- Publish
- The eligible list and merkle root are published, then 24 hours of public review
- Fund
- The multisig funds a merkle distributor round with exactly the published total
- Claim
- Each wallet claims its equal share with its proof; after 28 days unclaimed SOL returns to the next purse
- Squads v4
- SQDS4ep65T869zMMBKyuUq6aD6EgTu8psMjkvj52pCf
- Merkle distributor
- mERKcfxMC5SqJn4Ld4BUris3WKZZ1ojjWJ3A3J5CKxv
- Memo (receipts)
- MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr
⚠ Every multisig action is a public transaction. The receipt anchors come from a separate Hardware Fund wallet.
Roadmap
- Phase 1 · weeks 1–2 (now)
- Engine, the Green, six swings, share card, scorecard, 21 holes, daily hardware runs, Purse Vault, 8 Range lessons
- Phase 2 · months 1–2
- Majors, token sinks, personal hardware runs, seasons, home-screen install, 16 Range lessons
- Phase 3 · months 3–6
- Noise holes, 5-qubit Sundays, community holes, matchplay, sponsored holes, Classroom Mode beta
- Phase 4 · months 6–12
- Hole API, hardware partner runs, two-device receipts, course packs, the Annual Open
FAQ
Do I need the token to play?
No. The daily hole, the share card, streaks, the handicap and the Range are free forever. The token is how a wallet enters the Weekly Purse and reaches personal hardware runs.
Is the hardware run real?
Yes. It runs on a commercial quantum processor, and the receipt carries the device, the job ID and the raw counts, with its hash on Solana.
Can a script solve the holes?
Small holes, yes. Scores still need a signed session per swing, the purse needs a full week of holding per wallet, and shares are equal, so extra wallets cost real capital.
Why is the purse paid in SOL?
The coin's curve is quoted in a tokenized equity, and those are restricted in some places. Paying in SOL keeps payouts simple and global.
Where is the contract address?
On the landing page, in the contract box, once the coin launches. Until then it reads TBA. Trust no other source.
Birdie Labs is an independent, community-launched project. $BIRDIES is a memecoin with utility inside the Birdie Labs game; it is not a security and not a claim on any company, equity or revenue. The Weekly Purse is a skill-based performance reward and can be small or zero. Tokenized equities are restricted in some jurisdictions; the purse pays in SOL. Hardware results are published as measured. Birdie Labs is an educational game, not an accredited course. Not affiliated with any quantum hardware company, equity issuer, exchange or social network. Crypto assets are volatile: do your own research.