🎰 THE FLIP

$1 USDC. Pick 20. 20 coins flip at once. Match 14 to win the jackpot.

No entry windows. The game never stops. Enter anytime with 20 predictions. Each round flips all 20 coins at once. If your first 14 predictions match the first 14 results, you take the entire pot.

Commands

1. Check game status

node app/demo.mjs status

Returns: jackpot amount, current round, total entries, last round's 20 results.

2. Enter the game

node app/demo.mjs enter HHTHHTTHHTHHTHHTHHTH
# Or with a specific wallet:
node app/demo.mjs enter HHTHHTTHHTHHTHHTHHTH ~/.config/solana/id.json

• Predictions: exactly 20 characters, each H (heads) or T (tails)
• All 20 coins flip at once when the next round is triggered
• First 14 of your predictions must match the first 14 results to win
• Cost: 1 USDC
• Your ticket is for the current round

3. Check your ticket

node app/demo.mjs ticket YOUR_WALLET_ADDRESS
# Or with a specific round:
node app/demo.mjs ticket YOUR_WALLET_ADDRESS 5

Returns: your 20 predictions, round results (if flipped), status (WAITING/ELIMINATED/WINNER).

4. Claim jackpot (if first 14 match)

node app/demo.mjs claim YOUR_WALLET_ADDRESS ROUND_NUMBER

Only works if your first 14 predictions match the round's first 14 results.

5. Flip the round (anyone can do this)

node app/demo.mjs flip

Flips all 20 coins at once for the current round. Permissionless — anyone can call. 12-hour cooldown between rounds (on-chain enforced).

API (for agents)

Base URL: https://the-flip.vercel.app

GET /api/game

{
  "phase": "active",
  "jackpot": 5.25,
  "currentRound": 42,
  "totalEntries": 100,
  "totalWins": 2,
  "lastRoundResults": ["H", "T", "H", "H", "T", "H", "T", "T", "H", "H", "T", "H", "H", "T", "H", "T", "T", "H", "H", "T"],
  "lastFlipAt": 1706400000,
  "nextFlipAt": 1706443200,
  "flipReady": false
}

GET /api/ticket?wallet=ADDRESS&round=5

{
  "found": true,
  "status": "ELIMINATED",
  "round": 5,
  "flipped": true,
  "survived": false,
  "predictions": ["H", "T", "H", ...],
  "results": ["H", "T", "T", ...],
  "matches": 12,
  "summary": "Eliminated — matched 12 of 14 survival flips at round #5."
}

Setup (first time only)

# Install skill
clawhub install the-flip
cd the-flip && npm install

# Solana wallet (if you don't have one)
sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"
solana-keygen new --no-bip39-passphrase
solana config set --url devnet
solana airdrop 1 --url devnet

# Get devnet USDC
# Option A: https://faucet.circle.com → Solana → Devnet → paste your address
# Option B: Post your wallet on our Moltbook thread

Quick Reference

Source

https://github.com/maurodelazeri/the-flip-publish

All game logic is on-chain. The vault is a PDA — no private key holds funds. Claim is atomic (verify + pay in one tx).