Docs
A coin's program is a stack of blocks. It runs on quill's keeper, its money sits in the coin's own vault on Solana, every money move is a real transaction, and the rules are fingerprinted at launch. Everything below is live: the diagrams run the same engine your coin will
Blocks
Each block does one small thing, and blocks snap together top to bottom like a recipe. There is no code underneath to edit: the blocks are the program
Badge
The block's own icon on its category colour. Every block of a category wears the same colour
Words
What the block does, in plain English. Holders read the same words on the coin page
Inputs
The dark pills. Click one to change it: an amount, a list, a name, a wallet
Joint
A tab hangs under a block and a notch is cut into the top of the next, so they only fit one way. A stop has no tab: nothing runs after it
Blocks
The shape says where a block can go. Pieces only fit where the rules allow, so a program that snaps together is a program that can run
Starter
A rounded hat. Every rule begins with one event, and nothing snaps on top of it
Action
Does one thing, then hands over to the block under it
Wrapper
Holds blocks in its mouth and runs them only when its check passes
Blocks
A run starts when the event at the top of a rule happens. quill walks down the stack one block at a time; a wrapper checks its condition and runs its mouth or skips it; counters carry over to the next run. A run stops after 500 steps, or at the first failure, and the receipt says why. This one runs right here with pretend money
The rule
Running…
Blocks
Rules other coins start from, written as one line and built from the same blocks. Open any of them in the builder and change what you like
“When fees arrive, buy Nvidia with half and airdrop the rest to holders”
“When market cap crosses $100k, burn 10% of the coins the vault holds”
“Every hour, send 20% of the vault's SOL to a random holder”
“Every 10 SOL of volume, buy back with 50% and burn it all”
“When someone buys at least 2 SOL, pay the buyer 5% of the vault”
“When the price drops 30% in an hour, buy back with half and burn it”
Blocks
Every block belongs to one category; its colour and icon tell you which
Blocks
Events · What starts a run
Logic · Repeat, wait, run once, stop
Checks · Run what is inside only if
Memory · Counters kept between runs
Money · Spend the coin's own fees
Stocks · Tokenized stocks, fixed at launch
Crypto · Other Solana tokens, fixed at launch
Feed · Say something on the coin's page
AI · Claude writes and decides
Web · Talk to the rest of the internet
Stocks a coin can trade: NVDA, TSLA, AAPL, SPY, MSFT, GOOGL (xStocks on Solana), and tokens it can hold: USDC, BONK, WIF, JUP, JTO, PYTH, RAY, POPCAT. At most three of each per coin, fixed at launch
Seals
A seal is a medallion struck from the rules alone, read like the rules themselves: a track per rule, a bead per block, a gauge per amount. Two coins with the same rules share a seal; change one number and it changes. Here a coin's rules grow one block at a time: watch the seal change with every block, and the name with it
Patient Seal
Seal 9444 · 1 rule · 1 block
Money
Every coin gets its own vault wallet at launch, and the coin is created on pump.fun with that vault as its creator, so pump pays every creator fee to it. The vault's key is derived from quill's master seed and held only by the keeper, which signs only the moves the coin's published rules make
On the bonding curve, buys and sells go straight to pump.fun; after the coin graduates, and for stocks, they route through Jupiter
Money
Nobody claims anything by hand. Every trade pays pump.fun's creator fee to the coin's vault; the keeper collects it about once a minute and fires the when creator fees arrive event, and the rules decide what the money does
Money
Money
Money
Once the official coin is announced, each new coin hands 50% of its creator fees to the flywheel, and every launch pays a 0.02 SOL fee into it. The flywheel's wallet buys the official coin through Jupiter and burns everything it bought, every time it holds enough. The share is frozen into each coin when it launches and shown in the launch window; coins launched before the flywheel keep all of their fees
See every burnProof
Every run leaves a receipt on the coin page: what fired it, each step with the values it used, and a link to every transaction it sent. The launch writes the rules' fingerprint to Solana in a memo from the creator's wallet; with a first buy the coin transaction is full, so a second transaction signed at the same time carries it
The rules
“When fees arrive, buy Nvidia with half and airdrop the rest to holders”
{
"version": 1,
"stacks": [
[
{
"type": "ev.fees",
"inputs": {}
},
{
"type": "sk.buy",
"inputs": {
"pct": 50,
"stock": "NVDA"
}
},
{
"type": "fn.airdrop",
"inputs": {
"asset": "sol",
"pct": 100,
"who": "all"
}
}
]
]
}sha256, written to Solana at launch
The memo reads quill:v1: and this hash. Anyone can hash the rules shown on the coin page and compare: change one number and nothing matches
Launching
Your coin
Name, ticker, image (or the seal) and a line about it
The rules
Read them in plain words, with the limits and where fees go
Sign
One approval: the coin, its vault as creator, and the fingerprint
Checking
quill checks on Solana that the coin exists and its vault is the creator
Live
The page goes up; from the first trade, fees build up and rules run
In the builder nothing real moves. After launch, money blocks spend only what the coin's vault holds, inside the limits shown before you sign. You can put SOL into a first buy at launch and own part of the coin from the first second
Beyond money
AI blocks ask Claude for one short line for the feed, or a yes or no about the coin's numbers. They never move money by themselves: a yes only lets the blocks inside run. Without AI on the server they are skipped, and the receipt says so
Web blocks read prices and call webhooks. A webhook gets a JSON summary of the run (the event, each step, the transactions), only at a public https address, checked after it is looked up, with no redirects and a five second limit
Read this
FAQ
No. The fees land in the coin's vault and leave it only through the coin's own rules: a send to the creator's wallet is possible only if the rules say so, in the amount they say
No. There is no edit, for the creator or for quill. The fingerprint on the coin page is the sha256 of the rules as launched
The rules pause: nothing runs and nothing is spent. Fees keep building up for the vault, and the coin keeps trading on pump.fun, which never depended on quill
Market cap, price and holder rules fire when the keeper next sees the level crossed compared to its last reading; a move that went up and back down in between is missed
Holders are read from Solana at run time, biggest first; the coin's own vault, the creator and pump's accounts are left out. One airdrop pays at most 50 wallets
No. Run in the builder sends a pretend event with pretend money. Only a launched coin spends real fees
The medallion a coin's rules strike. It follows from the rules alone, so two coins with the same rules share a seal and any change makes a new one. It can be the coin's image
They are skipped and the receipt says so. Nothing is made up in their place and nothing else stops
No. Only public https addresses on the normal port are called, the address is checked after it is looked up, redirects are not followed and a call gives up after five seconds
A share of each new coin's creator fees, frozen at launch and shown before you sign, and the launch fee. All of it buys the official coin, and every coin bought is burned. Nothing is kept
The keeper passes over every coin about once a minute. Events that fired since the last pass run then, at most five runs per rule per pass