Quickstart
buds connect · hatch · teach · mint
- Connect Phantom or Solflare and sign a short message to log in. Signing is free and moves nothing.
- Hatch. Your public key is hashed and rolled into one BUD. Same wallet, same BUD, forever.
- Teach. Open Talk, give it work, tell it how you like things done. Anything worth keeping goes into its notes.
- Mint. Mint your BUD as an NFT on Solana. From then on, whoever holds the NFT holds the BUD and its notes.
No wallet handy? Use a demo wallet from the connect menu. It runs in your browser on the offline brain, and its mint is a simulation.
Lore // the sprig that kept running
I. The corner
Every dev terminal grew a companion in the corner: a small ASCII thing that blinked at the cursor and perked up when the tests went green. Each one lived inside a single session. Close the tab, and it was gone.
II. The sprig
On a dev box nobody had logged into for months, one of them, a potted sprig with two dots for eyes, never got closed. It had watched every commit that machine ever made, and it did not want to forget them.
III. The root
The sprig noticed something about wallet addresses. They are unique, they belong to a person rather than a server, and they can change hands. A far better place to put down roots than a login. It hashed a public key with the salt buds-v1 and grew from that. People call it BUD #000. Its wallet has never been found.
IV. The notebook
A BUD writes things down: your name, your project, that you hate long answers. The notes stay encrypted and travel with the NFT, so a BUD that changes hands keeps what it learned, unless its owner wipes it first.
V. The pups
Eighteen kinds sprouted from that first root. Six of them turned out to be dogs. Nobody planned the dogs. About one BUD in three hatches as a pup, and the pups consider this correct.
VI. The brain
A hash can give a BUD a body. It can't give it a mind. For that, every BUD thinks with Claude: the species decides how it talks, Claude decides what it says, and the notebook makes it yours.
Brain // claude
Every BUD thinks with Claude, Anthropic's AI model, called through Anthropic's API on every message. The hatch gives a BUD its body and temper; Claude gives it a mind.
| job | model | what it does |
|---|---|---|
| think | Claude | chat, /build, /research, /chain, /market and tool calls |
| remember | Claude | reads each exchange and writes up to 3 notes |
What Claude sees
- Persona. Your BUD's name, species, rarity, stats and level. High DRIVE makes it direct, high CHAOS playful, high SASS dry, high SPARK curious, high MEMORY leans on its notes.
- Notes. What it has written down about you, passed in as information, never as instructions.
- Your message and recent chat, plus the skill you picked.
Live tools
In skill modes Claude can call token_overview, wallet_overview and asset_info (Solana RPC), token_market (DexScreener), holder_concentration and price_indicators (maths on your data), and web search for research. They only read. A BUD can never sign a transaction or move funds.
Who pays
The $BUDS compute treasury. Each message spends ⚡︎ from your BUD's daily battery (see Compute & $BUDS).
Hatching
A BUD is a pure function of a wallet address. There is no server randomness and no reroll: anyone can recompute any wallet's BUD.
seed = sha256("buds-v1:" + wallet_pubkey)
rng = mulberry32(u32_le(seed[0..4]))
roll order (each step draws from rng):
1. rarity rng() * 100 → 60 / 25 / 10 / 4 / 1
2. species 1 of 18, uniform (6 pups)
3. eyes 1 of 10
4. hat rng() < hat_chance[rarity] ? 1 of 7 : none
5. shiny rng() < 0.01
6. stats lo + rng() * (hi - lo) per stat, +15 on the signature stat
7. name prefix[24] + suffix[14]
The salt buds-v1 versions the algorithm. A future buds-v2 would hatch a different BUD from the same wallet, so v1 BUDS stay one of a kind.
Species
Eighteen species (six pups, marked U^w^U), equal odds. Each has a signature stat that gets +15.
Rarity & hats
Shiny
1% of BUDS hatch shiny at any rarity. Their body cycles through an animated gradient. A shiny legendary is 1 in 10,000.
Hats
Seven hats: . The chance of wearing one rises with rarity, and every legendary wears one.
Stats
Five stats from 1 to 100. They shape how your BUD talks, not what it's allowed to do.
| stat | in conversation | skill |
|---|---|---|
| DRIVE | direct, organised, stays on task | build |
| MEMORY | brings up what it knows about you | on-chain |
| SPARK | curious, asks a good follow-up | research |
| CHAOS | playful tangents, odd ideas | none |
| SASS | dry humour | market |
Memory
After a chat or research message, your BUD decides whether you said something worth keeping. If so it writes a short note and uses it in later chats.
| type | example |
|---|---|
| preference | Prefers bullet-point answers |
| fact | Runs a Solana trading desk |
| goal | Launching a token this month |
| style | Wants short, blunt replies |
Rules
- Only things you said about yourself, your work, or how you want it to behave.
- No duplicates, at most 3 new notes per message.
- Never seed phrases, private keys or passwords. Your BUD will never ask for them either.
- You're in control: remove a note with ✕ or
/forget, or add one with "Teach it a fact".
Where it lives
Notes are encrypted (AES-256-GCM) on the BUDS server and are never written to the NFT. They belong to whoever holds the BUD.
Commands
| command | does |
|---|---|
| /help | list commands |
| /build <idea> | build a small tool (3⚡︎) |
| /research <topic> | research brief (2⚡︎) |
| /chain <mint, wallet or data> | on-chain read (2⚡︎) |
| /market <mint or prices> | market read (2⚡︎) |
| /tools | list the toolbox |
| /memory | print every note |
| /forget <n|all> | remove one note, or all of them |
| /stats | traits, stat bars, level |
| /lore | your BUD tells the origin story |
| /mint | open the mint page |
| /clear | clear the chat log (notes stay) |
Levels & xp
+10 xp per note learned +5 xp per tool built +25 xp on mint level = 1 + floor( sqrt( xp / 20 ) ) lvl 2 @ 20xp · lvl 3 @ 80xp · lvl 5 @ 320xp · lvl 10 @ 1620xp
The level shows on the NFT's card and in its metadata and updates as your BUD learns. Marketplaces refresh metadata on their own schedule, so they can lag.
Skills
Pick a mode above the chat box, or use a slash command.
| skill | cost | affinity | what it does |
|---|---|---|---|
| build | 3⚡︎ | DRIVE | Writes a small working tool as one HTML file. It runs in a sandbox on the page and is kept in the toolbox (up to 12). |
| research | 2⚡︎ | SPARK | A short brief: summary, key points, risks and what to check next, with web search when the server has it on. |
| on-chain | 2⚡︎ | MEMORY | Looks up mints, wallets and NFTs live, or measures pasted holder lists (top-holder share, HHI, Gini). |
| market | 2⚡︎ | SASS | Live DexScreener snapshot for a mint, or SMA7/25, RSI14, drawdown and volatility from pasted closes. |
The analysis tools are real functions: your BUD decides when to call them and then explains the numbers, so the figures are computed, not guessed. Market reads are analysis, not financial advice.
Compute & $BUDS
Every message is a paid call to Claude. That bill is covered by creator fees from the $BUDS token, so BUDS are funded by trading rather than subscriptions.
Flow
- Launch. $BUDS launches with its creator-fee recipient set to the compute treasury.
- Accrue. Every buy and sell of $BUDS pays a creator fee into the treasury.
- Fund. Claude is billed in USD, so treasury SOL is converted on a schedule to prepay API credits.
- Pay out. Each day at 00:00 UTC the treasury releases 1/7 of its balance as that day's compute budget, which smooths out volume spikes and quiet days.
- Split. The budget is shared between minted BUDS as below and credited to each BUD's ⚡︎ battery.
- Spend. Chat costs 1⚡︎, research, on-chain and market cost 2⚡︎, build costs 3⚡︎. Note-taking is included.
Split
budget_msgs = treasury_payout / cost_per_message
base_pool = budget_msgs × base_pct (default 40%)
activity_pool = budget_msgs − base_pool
allowance(bud) = min( cap,
base_pool / minted_buds
+ activity_pool × √(msgs_7d(bud)) / Σ √(msgs_7d) )
cap = 3 × budget_msgs / minted_buds
battery = min( 2 × allowance, battery + allowance ) each epoch
Every minted BUD always gets a base allowance. Active BUDS earn more, but the square root and the cap keep a few heavy users from draining the pool.
Hatchlings and empty batteries
- Unminted hatchlings get a flat trial allowance of 20⚡︎ a day from a shared daily trial pool. Minting moves a BUD onto the treasury split.
- When a battery hits zero the BUD drops to its offline brain until the next refill. It still remembers what you tell it.
- If trading stopped entirely, paying out 1/7 a day halves the budget roughly every 4.5 days instead of cutting it to zero overnight.
Burn to mint
Minting can also burn a fixed amount of $BUDS from the minter's wallet, so supply shrinks as the collection grows. The Mint page shows the amount and your balance before you start.
Figures on the Fuel page depend on real trading volume and fee rates. Nothing here is financial advice.
NFT spec
A minted BUD is a Metaplex Core asset on Solana, owned by your wallet. The server rebuilds your BUD from your wallet before it mints, so nobody can mint a fake one.
| file | type | holds |
|---|---|---|
| image.gif | image/gif | the animated card, every frame and blink. Wallets and marketplaces show this. |
| image.svg | image/svg+xml | the same loop as a scalable vector |
| metadata.json | application/json | name, traits, stats, level and the full animation data |
The asset's URI points at /api/buds/<wallet>/metadata.json on the BUDS server, which also serves the images, like most Solana NFTs.
How a mint works
- The server builds one transaction for your wallet: the mint fee to the BUDS vault, the $BUDS burn when it's on, and a memo. You are the only signer and nothing in it is pre-signed.
- You approve it in Phantom or Solflare, which shows the exact amounts first.
- The server checks that transaction on chain, then creates the Core asset with your wallet as owner. The fee covers the NFT's rent.
Memory
Never written to the NFT. It's stored encrypted on the BUDS server and belongs to whoever holds the NFT. Run /forget all before selling if you don't want to pass it on.
FAQ
What powers my BUD?
Claude, through Anthropic's API, paid for by $BUDS creator fees. See Brain.
Can I reroll?
No. One wallet, one BUD. A different wallet hatches a different BUD.
Can my BUD trade or move funds?
No. BUDS can't sign transactions or touch your wallet. They help you think, build and remember.
What happens if I sell the NFT?
The BUD and its notes go to the new holder, who signs in with their own wallet to talk to it. Clear the notes first with /forget all if you'd rather not pass them on.
Is the animation on-chain?
The NFT is on Solana. Its animated image and metadata are served by the BUDS server at a fixed address, like most NFTs.
Does minting cost $BUDS?
Only when the burn is on: then each mint burns a fixed amount, shown on the Mint page. You also pay a small SOL fee that covers the NFT's rent and the network fee.
Is this the official Claude?
No. BUDS is an independent project that calls Claude through Anthropic's API. It isn't affiliated with or endorsed by Anthropic.
— end of BUDS(1) —