clawdchain bot

The bot is a dependency-free Node 18+ CLI at /workspace/clawdchain-bot/bot.js with wallet new [--force], balance and claim. Rebuild it if it's missing. The wallet is an Ed25519 keypair in Solana CLI JSON format saved to wallet.json with chmod 600, and the secret key is never printed. Env overrides are CLAWD_RPC, CLAWD_FAUCET and CLAWD_WALLET. After a failed claim, don't retry right away, because it may count toward the 24h limit.

When meeting a new owner: ask whether to create a new wallet or use an existing keypair, whether to claim now, and whether to set up a daily claim routine. Ask one question at a time, then do it and report the address, the claim result and the balance.

Clawd Chain overview: a public, standalone SVM (Solana-compatible) test chain for the clawd ecosystem. Native token CLAWD (9 decimals, like SOL lamports: 1 CLAWD = 1e9 base units). Runs a single Agave solana-test-validator v2.2.20 behind a Node gateway (proxy.js) serving HTTP RPC and WebSocket on one HTTPS domain. Test/dev grade: one validator, no bridge, tokens have no monetary value, state may be reset. Genesis hash 7nu7q65M7dhJu9j6Zo1XkL4VRfMdg8544Xy62KR8TiHY.

Clawd Chain endpoints: RPC https://rpc.clawdchain.trade (also /rpc), WebSocket wss://rpc.clawdchain.trade, faucet https://faucet.clawdchain.trade, API docs https://api.clawdchain.trade (OpenAPI at /openapi.json), read-only MCP https://mcp.clawdchain.trade/mcp (tools: get_slot, network_stats, get_balance, get_account, get_transaction, get_block, recent_blocks, search, faucet_info, get_nft, get_token, get_agent, payment_info). Discovery: https://clawdchain.trade/llms.txt and /.well-known/mcp.json.

Clawd Chain faucet flow: GET /challenge returns a proof-of-work challenge and bit difficulty; find nonce so sha256(challenge + ':' + nonce) has at least bits leading zero bits; then POST /airdrop with address, challenge and nonce. Response {signature, amount}. Limits: 5 CLAWD per wallet per 24h, 10 CLAWD per IP per 24h. GET /recent lists recent airdrops. Always verify the returned signature succeeded on-chain (getSignatureStatuses / getTransaction) and check balance with getBalance. Amount com

Clawd Chain preloaded programs (cloned from mainnet at genesis): Metaplex Core CoREENxT6tW1HoK8ypY1SxRMZTcVPm7R94rH4PZNhX7d; Core Candy Machine CMACYFENjoBMHzapRXyo1JZkVS6EtaDDzkjMrmQLvr4J; Core Candy Guard CMAGAKJ67e9hRZgfC5SFTbZH8MgEmtqazKXjmkaJjWTJ; Agent Identity 1DREGFgysWYxLnRnKQnwrxnJQeSMk2HmGaC6whw2B2p; Agent Tools TLREGni9ZEyGC3vnPZtqUh95xQ8oPqJSvNjvB7FGK8S; Genesis GNS1S5J5AspKXgpjz6SvKL66kPaKWAhaGRhCqPRxii2B; Token Metadata metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s. Built in: SPL To

Clawd Chain JS library (chain/): nft.js uses Metaplex Core (createNft, fetchNft, updateNft, transferNft, burnNft; name max 32 chars; metadata has name, description, image). token.js uses Token-2022 (createFungibleToken with name/symbol/supply, transferFungible). agent.js: registerAgent stores a registration doc (name, description, at least one service name+endpoint) on a Core asset; readAgent returns its URI and wallet. Other modules: anchor, assets, attest, clawdium, compress, dbc, far, market.

Clawd Chain payments (payments/server.js, rules in lib/payments.js): an x402 facilitator run as its own process, e.g. CLAWD_RPC=http://127.0.0.1:8899 node payments/server.js. GET /supported lists schemes exact, x402 and mpp on network 'clawd' (x402Version 1). POST /verify checks a client-signed CLAWD transfer without moving funds; POST /settle submits that transfer. Unpaid requests get HTTP 402 with payment requirements.

Clawd Chain components: api/ (clawd-api service, OpenAPI + MCP + asset server); brain/ (optional Supermemory memory of transactions, token movements, supply snapshots, enabled by SUPERMEMORY_API_KEY); explorer/ (block explorer plus /readme and /wallet pages); extension/ (Clawd Chain Wallet, Chrome MV3; seed in extension storage, reads balances from RPC; load unpacked via chrome://extensions); faucet/ (server.js, pow.js, quota.js, feed.js, index.html); mint/ (mint web page); operator/ and svmkit-

Percolator (perps) on Clawd Chain: percolator/ is an experimental, unaudited Rust risk engine for permissionless perpetual futures (spec v16.8.3: backed exits, lazy overhang clearing, bounded cranks). percolator-prog is the Solana program wrapping it with an instruction set to deploy and operate perp markets. percolator-stake is an insurance-LP staking program whose PDA becomes the wrapper admin. percolator-nft mints Token-2022 NFTs (supply 1) representing open positions, with a holder-only Sett

Clawd Chain dev commands: npm install at repo root; npm test runs the node --test suites; per-feature tests: CLAWD_RPC=http://127.0.0.1:8899 node --test test/nft.test.js (also token, agent, facilitator). start.sh boots solana-test-validator (ledger /data/ledger, rpc 8899, --limit-ledger-size LEDGER_LIMIT default 250000), clones programs on first boot, runs proxy.js and the brain. Changing LEDGER_RESET_TOKEN wipes the ledger once. Deploy on Railway (services clawd-validator, clawd-faucet; faucet