Codex of coin rulesSolana mainnet
Read a coin's rules before you buy it.
Paste any Solana coin and we read the rules written into it: a fee on every sale, who can freeze or take your tokens, who can print more. Then we say what each rule means, in plain words.
Reads Token-2022 extensions, mint and freeze authorities, holder spread and the launch block, live. Nothing to sign.
Article I How it works in 3 steps
- i.
You paste a coin
A coin address, or just its name. No wallet needed.
- ii.
We read it from the chain
Its built-in rules, its owners and its first block of trades.
- iii.
You get a rule sheet
Every rule with a plain verdict: fine, worth knowing, or serious.
New to the words? See plain words. Reading is free and read-only. Nothing is moved or charged unless you choose to sign, and this site never asks you to.
Article II · Tool 1
Check a coin's rules
What this does: reads the coin's own account on mainnet and turns every rule inside it into a numbered clause with a plain verdict.
The rule sheet appears here. Try PayPal USD: it carries seven rules, more than most coins.
Article III
How a coin's rules are read
- 1. The raw account. Every coin is one account on Solana: a row of bytes anyone can fetch. We ask mainnet for it.
- 2. The rule blocks. After the first 166 bytes, Token-2022 coins list their rules as blocks: a type, a length, then the value.
- 3. The plates. Each block becomes a named rule: sale fee, freeze power, permanent delegate, transfer hook and more.
- 4. The verdict. We weigh who holds each power, then seal a plain reading: fine, worth knowing, or serious.
Article IV · Tool 2
Sale-fee calculator
What this does: if a coin takes a cut of every transfer, it shows exactly how much arrives, using the coin's own fee rule and the current epoch.
The math is the same as the token program's: the fee is rounded up and capped at the coin's maximum.
Enter a coin and an amount.
Article V · Tool 3
Big-holder cap check
What this does: lists the 20 largest holders of a coin, tells pools apart from people, and shows who is above the cap you set.
The holder roll appears here.
Article VI · Tool 4
Launch-block buyers
What this does: finds the very first block of a coin's life and shows who bought in it, before the public could react. A big share there is called a bundle.
Works best on young coins (hours or days old). Reads two blocks, about 0.8 seconds of chain time.
The launch record appears here.
Article VII · Tool 5
Rules on the coins I hold
What this does: looks at a wallet's coins and flags any that carry a fee, a freeze power or a delegate who could move them.
Connect a wallet at the top right, or paste any public wallet.
Article VIII
The rules a coin can carry
Token-2022 lets a coin's creator switch on rules at launch. Some are harmless labels. Some give one key real power over your tokens. Here is each one, and how we grade it.
Article IX
Flowcharts
Two drawings of what happens when you use Rulecast: the path of one reading, and where every piece of data comes from.
Article X
Roadmap
What works today, what we are building, and what is only planned. "Done" means you can use it on this page right now.
Phase 1 · Done
Rule reader
- Token-2022 extensions and authorities decoded live
- Plain verdict for every clause
- Search by name or address
Phase 2 · Done
Holder and launch checks
- Sale-fee calculator with the program's own rounding
- Top-20 holder roll with pools told apart
- Launch-block buyers from the first two blocks
Phase 3 · Done
Wallet check
- Connect a wallet and flag every coin you hold
Phase 4 · Building
Rule history
- Show when a fee rate or key last changed
- Shareable rule-sheet links
Phase 5 · Planned
Watch list
- Opt-in alerts when a coin you hold changes a rule
- Compare two coins side by side
Article XI
Tokenomics
Planned The coin has not launched yet. This is the planned structure, and it follows the same rules we grade other coins by.
- Total supply
- 1,000,000,000 fixed
- Presale
- None
- Team allocation
- 0% unless bought on the curve
- Mint authority
- Off at launch
- Freeze authority
- Off at launch
- Liquidity
- Locked or burned at graduation
A fair launch: everyone buys on the same public curve. Nothing here is a promise of price or returns.
Article XII
Plain words
- Coin address, mint, CA
- The address of the coin's own account on Solana. Every copy of the coin points back to it.
- Token-2022
- Solana's newer token program. Coins made with it can carry built-in rules (extensions). Older coins use the classic SPL Token program.
- Mint authority
- A key that can create more of the coin. If it is gone ("revoked"), the supply is fixed for good.
- Freeze authority
- A key that can lock any holder's tokens so they cannot be sold or sent.
- Permanent delegate
- A key that can move or burn tokens out of any wallet, without asking.
- Transfer fee
- A cut taken on every transfer, including sales. It is held back in the receiver's account for the fee owner to collect.
- Transfer hook
- A program the coin calls on every transfer. It can block transfers by its own logic.
- Block, slot
- One tick of the chain, about 0.4 seconds. Trades in the launch block were lined up before anyone could see the coin.
- Bundle
- Several buys packed into the same block as the launch, often by the creator's own wallets.
- Token account
- The small account that holds one coin for one wallet. Pools hold coins in token accounts too.
Article XIII
Questions
What is this, in one sentence?
A free reader that shows you the rules built into a Solana coin, who holds the keys to them, and who bought in its first block, explained in plain words.
Is it safe? Does it touch my money?
It only reads public data. Connecting a wallet shares your public address and nothing else. This site never asks you to sign a transaction, never holds funds, and cannot move anything.
Where does the data come from?
Coin accounts, holders, signatures and blocks come straight from Solana mainnet through our read-only proxy. Names and a second opinion on bundles come from Jupiter's public data. Nothing is invented.
Is a "fine" verdict a promise the coin is safe?
No. The verdict is a model: it grades the rules and powers written into the coin. It cannot see the team's plans, off-chain promises or the price. A coin with clean rules can still fall to zero.
Why can't the launch check find some coins?
For very busy coins the first block is buried under hundreds of thousands of trades. We look through the creator's wallet history to find it, and if that fails we say so rather than guess.
Why does a big holder show as "pool"?
Liquidity pools and curves hold coins on behalf of every trader. We check who owns each large account: when it is a program rather than a person, we mark it as a pool.