Docs
How Quill works
Status
Quill is in pre-launch. This site runs the curve maths and the script engine in TypeScript, with tests. The on-chain program that will enforce them is not written or deployed yet, so no coin can be launched or traded. This page describes the design the program is specified to follow.
The idea
A normal memecoin looks the same at $5K and at $5M. A Quill coin ships with a script: a list of market cap tiers, and what happens at each one. When the market cap crosses a tier, the coin turns to its next chapter. It can change how it looks, pay its holders, burn supply or drop tokens.
The script
The creator writes the script before launch. It holds up to 10 tiers, each with a market cap in USD and up to 4 events. Tiers must go up. At launch the script is stored with the coin and becomes read-only: there is no instruction to edit it, for anyone.
Quill AI
The AI does three things, and all of them end in text a person can check. It drafts a script from a description. It draws 12×12 pixel art for each chapter, in a palette of up to five colours, stored in the script as a short string. And it reads any script back in plain English for buyers.
- A draft goes through the same schema as a hand-written script. If it breaks a rule, it is rejected.
- The reading is built from the public lines of the script, so sealed chapters stay sealed.
- Next to every reading is a script check computed without any model: where the pot goes, how many tiers pay holders, how much is sealed.
- The AI has no wallet. It can't launch, trade, pay or edit anything after launch.
Events
| Event | Exact rule | Paid from |
|---|---|---|
| New image | The image in the token metadata is replaced by the one set at launch for this tier. The mint address and the ticker stay the same. | Nothing moves |
| New name | The name in the token metadata is replaced. The ticker never changes, so the coin stays findable under the same symbol and address. | Nothing moves |
| New description | The description in the token metadata is replaced by the text set at launch for this tier. | Nothing moves |
| Sealed message | A text written at launch and stored as a hash. It is published on the coin page when the tier is reached. It can't be edited after launch. | Nothing moves |
| Holder reward | A set percentage of the SOL in the pot is split between the N largest holders, pro rata to their balance. The pool, the airdrop reserve and the creator's dev buy are not counted as holders. | The coin's fee pot |
| Buyback and burn | A set percentage of the SOL in the pot buys the coin on its own curve, with no fee. The tokens bought are burned, which lowers the supply. | The coin's fee pot |
| Airdrop | A set percentage of the supply, reserved at launch and kept out of the curve, is split between the N largest holders, pro rata to their balance. A script can reserve at most 10% of the supply. | Reserve set aside at launch |
| Fee change | The trade fee is set to a new value from this tier on. It can never go above 2%. | Nothing moves |
The fee pot
Every trade pays a fee, 1% by default. 40% of it goes to Quill. The other 60% is the creator's share, and it does not go to the creator directly: it goes into the coin's pot.
- The pot can't be touched between two evolutions.
- When a tier fires, its holder reward and buyback take their set percentage of the pot. The rest is released to the creator, and the pot starts again from zero.
- So a payout of “30% of the pot” means 30% of the creator's fees collected since the previous chapter.
- After the last chapter, there is nothing left to fund: the creator's share is paid directly.
Holder rewards and airdrops are split pro rata between the N largest holders. The pool, the airdrop reserve and the creator's dev buy are not holders. The program is specified to rank holders on their average balance over the stage, not on a snapshot, so buying right before a tier earns almost nothing.
How a tier fires
Market cap is the curve price times the circulating supply, converted to USD with the Pyth SOL/USD feed. It is checked on every buy. When it is at or above the next tier, that tier fires inside the same transaction. One large buy can fire several tiers in a row; the first one empties the pot.
Evolutions are one-way. If the price falls back under a tier, the coin keeps its chapter and nothing is taken back.
Sealed looks
A creator can seal a future image, name or description. Buyers then see “???” for that tier, and only a hash of the content is public until it is reached. Sealed messages work the same way. Events that move SOL or tokens, and fee changes, can't be sealed.
Stalled coins
If a coin with an unfinished script goes 30 days without a new chapter, anyone can call a function that sends the pot to the top 50 holders. A creator can't sit on a pot by setting a tier nobody will reach.
The curve
Coins trade on a constant-product curve with 30 SOL of virtual liquidity and a supply of one billion. All maths are integers and every rounding favours the pool, so buying and selling straight back never makes a profit. Sells can't be paused or blocked.
Limits
- Trade fee: never above 2%, whatever the script says.
- Airdrops: at most 10% of the supply across the whole script, reserved at launch.
- Launch fee: 0.05 SOL plus network rent.
- The ticker and the mint address never change.