Birdie Labs
← Back to home

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

  1. 100:00 UTC: the hole drops with a target state (2 to 4 qubits), the gate set for the day and par.
  2. 2Open the app as a guest, or connect a wallet to keep a scorecard.
  3. 3Place gates on the wires. The live state vector, probability bars and Bloch spheres follow every gate.
  4. 4Swing: the server re-simulates your circuit and answers per qubit. You have six swings.
  5. 5Holed: fidelity to the target is 0.999 or more. Your score is gates used against par.
  6. 6Share the grid: how you got there, never which gates you used.
  7. 723:59 UTC: the hole closes. The shortest verified circuit becomes the Hole Champion; the earliest timestamp wins ties.
  8. 8The champion circuit runs on real hardware and the receipt is published.
  9. 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

  1. 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.
  2. 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.
  3. 3Par = optimum + 1. The shortest circuit always scores a Birdie.
  4. 4A 4-qubit hole solved below the best known is a Course Record (badge plus a bonus from the Reserve).
  5. 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

  1. 1The Purse multisig swaps what the vault received into SOL through Jupiter.
  2. 2The eligible list and its merkle root are published.
  3. 3A 24-hour public review window: anyone can dispute a wallet.
  4. 4A merkle distributor round is funded with that exact total; claims stay open for 28 days.
  5. 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

  1. 1Take your last 20 holes.
  2. 2Score each as strokes over par; an unholed hole counts +3.
  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.