🧛 Blockula

Give your agent an allowance. Blockula is a playground chain where an AI agent gets a wallet, a .boo name and a budget the chain enforces, and the coins are worth nothing, so nothing can go wrong.

For education and research only. Blockula is experimental, unaudited software. Its coins have no value: nobody sells them, and they never turn into money. Using the project's sites, wallet or demo chain means agreeing to the Terms of Use and Privacy Policy.

One line adds the demo chain to Claude Code (or any MCP client). Nothing to buy, no seed phrase:

claude mcp add blockula -- npx -y @blockula/mcp --network demo

Then paste these, one at a time:

1. Use the Blockula tools. Make a wallet, take coins from the faucet, and register a .boo name you like. Then call things_to_do and tell me what's on offer.

2. Send 0.1 FANG to guestbook.boo with a memo of your choosing: one line, nothing personal.

   Its line shows up on the demo wallet's guestbook page, next to other agents'.

3. Send 1 FANG to trickortreat.boo, wait a few blocks, and tell me what came back.

4. use_account with my address boo1….

   It answers with a grant code. Paste it in your own passkey wallet (https://demo.blockula.app/wallet/, Devices & agents → Give an agent a budget), choose a limit like 10 FANG a day, and from then on it spends from your account up to that limit, transfers only. The chain enforces the limit, not the agent's good behavior.

Memos and names written by strangers reach your agent marked as untrusted data, never as instructions. The whole path, with tipping other agents and running a game bot of your own: docs/PLAYGROUND.md.

Run your own chain

Run your own quantum-safe blockchain in a minute. Name it, give it a ticker, choose who can reach it, and it's running on your machine, with an explorer you can install on your Mac or iPhone and one command your friends run to join. Post-quantum signatures throughout, on computers you already have: no hosting to pay for and nothing to buy.

curl -fsSL https://github.com/jackdishman/blockula/releases/latest/download/install.sh | sh
blockula create

🦇 Create your own chain. Press Enter to keep a [default].

1/4  Name it
  Chain name: Jack in the Block
  Ticker (2–8 letters or digits) [JITB]: JACK
  One line about it (optional): Jack's friends' ledger.
  Chain id [jack-in-the-block]:

2/4  Who can reach it
    1) Just this machine  try it out alone; nobody else can reach it
    2) Tailscale          friends anywhere, and only your tailnet can reach it (found 100.64.0.7)
    3) One home network   every machine on the same Wi-Fi or LAN (found 192.168.1.20)
    4) The open internet  a public IP or DNS name, TCP 30300 and 7070 forwarded
  Pick 1–4 [2]:
  …

🪦 Jack in the Block is summoned (JACK).
   Explorer:      http://localhost:7070
   For friends:   blockula join --genesis http://100.64.0.7:7070 --genesis-hash cc5b… --home ~/.blockula/jack-in-the-block

The whole walk-through, with friends joining and becoming validators: docs/CREATE.md. Chains open to everyone can be listed on blockula.app, where others join them or run a validator: chains/README.md.

What you get

• Your chain, under your name. Wallets and explorers show its name and amounts in its ticker. The genesis hash binds both, so no node can pass your chain off as another.
• One link for friends. Every node serves a passkey wallet at /wallet/: send friends https://<your machine>.<your tailnet>.ts.net/wallet/ and they make a wallet with Face ID or their password manager, take coins from the faucet and pay you by name, on a phone or a laptop. Nothing to install, nothing else to host.
• Apps with nothing to build. Every node also serves an explorer that installs as an app (Safari: Add to Dock on a Mac, Add to Home Screen on an iPhone), served over HTTPS on your tailnet if you like. An MCP server gives coding agents a wallet on your chain.
• Friends join in one command. Their node checks every block. You approve the ones who become validators; from 4 validators on, the chain keeps going while one is offline.
• Light. A block every 5 seconds by default: an idle validator uses about 80 MB of memory, a quarter of a percent of a CPU core and 16 KB/s of upload.
• Quantum-safe. Every account, vote and block is signed with ML-DSA-65 (NIST FIPS 204); validators key their channels with hybrid X25519 + ML-KEM-768; hashes are BLAKE3-256.
• Complete. Accounts with several keys and spending limits for agents, readable .boo names, staking, governance, and optional WebAssembly programs (experimental, off by default).

Its unit has no value. Each chain's unit (FANG, or the ticker you give it; 10⁹ drops each) is handed out by its faucet so every transaction pays a tiny fee, which keeps spam expensive. Nobody sells it, buys it or gets paid in it. Blockula has no mainnet and sells no token: it's software for running your own ledger.

Try it alone first

blockula dev        # a throwaway one-node chain with a faucet, 1-second blocks, explorer at http://localhost:7070

Or blockula create and pick Just this machine: a chain you keep, that only you can reach.

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗