One toolkit. Full agent power.

BOT Chain
Skill Engine

A single-command toolkit that turns Claude Code, Codex, Cursor, and Windsurf into specialized BOT Chain engineering agents — scaffold, compile, deploy, and verify without leaving the prompt.

View source ↗
npx github:manueldezman/botchain-init-toolkit --global

Installs skill files for Claude Code, Codex, and Cursor, writes Windsurf Rules output, and registers a local MCP server for terminal & explorer access.

Skill Introduction

A unified BOT Chain Skill that bundles the full developer workflow — environment health checks, contract scaffolding, compilation bridges, and testnet deployment — enabling any AI coding agent to execute the complete on-chain lifecycle from a single natural-language prompt.

MIT-0 · Free to use, modify, and redistribute. No attribution required.

Capabilities

Nine bundled capabilities cover the path from "write a contract" to "confirmed on explorer," across every supported IDE.

Single-Command Bootstrap

Upgrades a developer's machine into a full BOT Chain workstation via one npx command — no manual file moves or config edits.

Progressive Skill Directory

Drops token-efficient SKILL.md files, references, and asset templates into global registries for Claude Code, Codex, Cursor, and Windsurf.

Environment Doctor

Runs hidden path checks (which forge / npx hardhat) to confirm compiler availability before any build starts.

Auto-Correction Loop

If Foundry or Hardhat is missing, the agent asks for approval, then installs and restores the pipeline automatically.

Compiler Bridge

Executes local compilation frameworks (forge build / forge create) through a safe terminal execution tool.

Live Testnet Deploy

Signs and transmits compiled bytecode straight to the public BOT Chain Testnet using free faucet gas.

Explorer Fetcher

Checks transaction confirmation status and returns the matching BOT Chain explorer link inside the chat.

Agent Identity Template

Ships an optional identity-contract pattern for wallets, blueprint references, and boundary policies. It is a toolkit convention, not a native chain feature.

Gasless Eligibility Check

Checks BOT Chain paymaster sponsorship through the network's pm_isSponsorable RPC method before a transaction is sent.

Documentation

Everything You Need, In One Place

Use the quick links for complete reference material, or resolve the most common setup issues without leaving this page.

01 Toolkit READMEInstallation, supported agents, project layout, and safety notes. 02 MCP Tool ReferenceTool capabilities, side effects, environment variables, and standalone testing. 03 BOT Chain Network ConfigTestnet and mainnet RPCs, chain IDs, explorers, faucet, and known network constraints.
Quick fixes

When Setup Stalls

01 / SKILL NOT FOUND Restart your coding agent

Skills and MCP configuration are loaded when a new Claude Code, Codex, Cursor, or Windsurf session starts.

02 / RPC UNREACHABLE Check the testnet values

Use rpc.bohr.life with chain ID 968. Confirm your network can reach the endpoint before retrying.

03 / COMPILER MISSING Install Foundry or Hardhat

The environment doctor requires Node and either Forge or a locally available Hardhat installation.

04 / CANNOT SIGN Add a funded testnet key

Write operations require BOTCHAIN_PRIVATE_KEY and enough tBOT for gas. Never use a mainnet key for testing.

BOTCHAIN_RPC_URL=https://rpc.bohr.life
BOTCHAIN_CHAIN_ID=968
BOTCHAIN_EXPLORER_API=https://scan.bohr.life
BOTCHAIN_PRIVATE_KEY=<testnet-private-key>
Workflow previews

From Prompt To Result

Expand an example to see the tools, safety checks, and result you can expect from the BOT Chain skill.

01 Query Balance Read only
# Prompt: Check the tBOT balance for 0xAbc...123 1. Select BOT Chain testnet (chain ID 968) 2. Confirm https://rpc.bohr.life is reachable 3. Call check_balance for the supplied wallet 4. Return the balance in tBOT # Result: balance shown in chat; no transaction or gas required
02 Send Native Transfer Approval required
# Prompt: Send 0.0001 tBOT to 0xDef...456 1. Validate the recipient, amount, network, and wallet balance 2. Estimate gas and show the transaction summary 3. Ask for explicit approval before signing 4. Broadcast to BOT Chain testnet after approval 5. Return the transaction hash and scan.bohr.life link
03 Deploy Contract Approval required
# Prompt: Deploy a simple storage contract to BOT Chain testnet 1. Scaffold the Solidity contract from the toolkit template 2. Check Foundry or Hardhat availability and compile locally 3. Show the network and estimated deployment cost 4. Ask for explicit approval before deployment 5. Deploy to chain ID 968 and wait for confirmation 6. Return the contract address, transaction hash, and explorer link
04 Batch Airdrop Approval required
# Prompt: Send 1 tBOT to each address in this three-wallet list 1. Validate every address and calculate the total amount 2. Estimate gas for the complete batch 3. Show the recipient count and total cost for approval 4. Send each transfer after approval 5. Return a per-recipient transaction summary
05 Contract Read - Total Supply Read only
# Prompt: Call totalSupply() on this BOT Chain token contract 1. Validate the supplied contract address and ABI fragment 2. Call totalSupply() with eth_call 3. Read decimals() when available 4. Format the result in human-readable units # Result: contract state returned without a signature or gas
06 Gas Estimation Read only
# Prompt: Estimate gas for this token transfer 1. Validate the sender, recipient, contract, and amount 2. Simulate the call with eth_estimateGas 3. Read the current gas price 4. Return the estimated tBOT cost and any simulation failure
07 Check Transaction Status Read only
# Prompt: Check this BOT Chain testnet transaction hash 1. Validate the transaction hash 2. Query the receipt on BOT Chain testnet 3. Parse confirmation status, block, sender, recipient, and gas used 4. Present the details with a scan.bohr.life link