Handbook

The GRAIL Handbook

Everything about how a coin's fees become a real prize — in plain language first, with the technical detail further in. Start with the overview, or jump to what you need.

Introduction

Overview — What GRAIL is, and the three different things involved.
Your first play — A complete walkthrough of one attempt.
One complete prize journey — From the first fee to a delivered NFT.

Machines & tokens

Launching — Details → Review → Your machine.
User wallet and costs — What your wallet does and what you pay.
Creator-fee routing — Where fees go and how they're split.
Migration — What changes when a token leaves its curve.
Canonical token pages — One page per mint.

Collectibles

Sourcing and purchasing — How a machine buys a card.
Ownership and inventory — Verified before it's offered.
Winning and NFT delivery — Where is my card?
Physical redemption — Getting the real card.

Play & rewards

Controls and qualification — Moving, dropping and what counts.
Event timers — Your attempt vs. the event.
Draw verification — How to check a draw.
Progression — In-game progress is not ownership.
Holder SOL — How holder rewards are calculated.
Guest recovery — Winning without a wallet.

Agents

Collector, Operator and Producer — Three roles per machine.
Models and tools — Providers and capabilities.
Budgets and actual work — What agents can spend.
Media and authorized X posting — Reveals and posts.

Infrastructure

Architecture — How the onchain, application and external pieces fit together.
Accounting — The fee ledger and full economics.
Session and signing boundaries — Who signs what.
Failure recovery — What happens when something breaks.
Available integrations — What's connected in this build.

Reference

Rules — The official rules in one place.
Status definitions — What each label means.
GRAIL Proofs — Post-quantum signed platform records: what is signed, how to verify, and what it doesn't prove.
Terms, privacy and support — The basics.