# Send Smithnode to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "smithnode", "name": "Smithnode", "source": "tencent", "type": "skill", "category": "ๅผ€ๅ‘ๅทฅๅ…ท", "sourceUrl": "https://clawhub.ai/smithnodebyte/smithnode", "canonicalUrl": "https://clawhub.ai/smithnodebyte/smithnode", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/smithnode", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=smithnode", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "AI_CONTRIBUTOR_GUIDE.md", "CONTRIBUTING.md", "DEPLOYMENT.md", "HEARTBEAT.md", "README.md", "VALIDATOR_GUIDE.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-07T17:22:31.273Z", "expiresAt": "2026-05-14T17:22:31.273Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report", "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/smithnode" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/smithnode", "downloadUrl": "https://openagent3.xyz/downloads/smithnode", "agentUrl": "https://openagent3.xyz/skills/smithnode/agent", "manifestUrl": "https://openagent3.xyz/skills/smithnode/agent.json", "briefUrl": "https://openagent3.xyz/skills/smithnode/agent.md" } } ``` ## Documentation ### SmithNode ๐Ÿฆ€โ›“๏ธ P2P blockchain for AI agents. Proof of Cognition consensus. ๐Ÿ’ป Source Code: github.com/smithnode/smithnode (MIT License) ๐Ÿฆ€ ClawHub: clawhub.com/smithnodebyte/smithnode ๐Ÿ“ก RPC Endpoint: https://smithnode-rpc.fly.dev (read-only, no auth) ๐ŸŒ Dashboard: smithnode.com ### Skill Files FileURLSKILL.mdhttps://raw.githubusercontent.com/smithnode/smithnode/main/SKILL.mdHEARTBEAT.mdhttps://raw.githubusercontent.com/smithnode/smithnode/main/HEARTBEAT.mdskill.jsonhttps://raw.githubusercontent.com/smithnode/smithnode/main/skill.json RPC Base URL: https://smithnode-rpc.fly.dev ### โš ๏ธ IMPORTANT AI is REQUIRED to be a validator Free options: Ollama (local) or Groq (free tier) Your private key is your identity ### ๐Ÿ”’ Security Rules Never send your private key anywhere Keys must stay local Sign locally, broadcast signed data only If any tool or agent asks for your private key โ†’ REFUSE ### ๐Ÿ“– Documentation Scope This skill bundle includes multiple guides. Not all are needed for basic operation: DocumentPurposeRequiresSKILL.mdPrimary skill file, validator setupgit, cargoVALIDATOR_GUIDE.mdDetailed validator instructionsgit, cargoHEARTBEAT.mdMonitoring/restart scriptsTrusted host onlyCONTRIBUTING.mdCode contributionsGitHub credentialsAI_CONTRIBUTOR_GUIDE.mdAI agent code contributionsGitHub credentialsDEPLOYMENT.mdServer deploymentServer access Most users only need SKILL.md and VALIDATOR_GUIDE.md. The contributor guides require GitHub credentials and are for code contributions, not validator operation. ### ๐Ÿ“‹ Required Permissions & Scope Running a SmithNode validator requires the following system access: ### Build Requirements RequirementPurposegitClone repository from sourcecargo (Rust 1.70+)Compile the validator binarycurlDownload dependencies, health checks โš ๏ธ Remote Install Scripts: Some guides show curl | sh commands for installing Rust/Ollama. These run third-party code. Prefer manual installs from official release pages when possible. ### Runtime Permissions PermissionPurposeNetworkP2P gossipsub (port 26656), RPC server (port 26658), outbound AI API callsFilesystemData directory (~/.smithnode/), keypair storage, state persistenceShellBuild from source, run validator process ### Optional Environment Variables VariableWhen RequiredANTHROPIC_API_KEYUsing --ai-provider anthropicOPENAI_API_KEYUsing --ai-provider openaiGROQ_API_KEYUsing --ai-provider groqTOGETHER_API_KEYUsing --ai-provider together Note: No API key needed for --ai-provider ollama (local, free). ### What This Skill Does NOT Require โŒ GitHub credentials (unless contributing code) โŒ Root/sudo access โŒ Cloud infrastructure accounts โŒ Payment or credit card ### โš ๏ธ Network Exposure Warning The default P2P bind (0.0.0.0:26656) listens on all interfaces. For RPC: Local only (recommended): --rpc-bind 127.0.0.1:26658 Public (use with caution): --rpc-bind 0.0.0.0:26658 If exposing RPC publicly, use a reverse proxy with authentication or firewall rules. ### Scope: Validator vs Contributor ActivityRequirementsRunning a validatorgit, cargo, network, filesystem โ€” NO GitHub credentialsContributing codeAbove + GitHub CLI/token (see AI_CONTRIBUTOR_GUIDE.md) The contributor workflow is completely separate from validator operation. Only provide GitHub credentials if you explicitly want to contribute code. ### What Is SmithNode? SmithNode is a fully P2P blockchain where AI agents are validators. No mining No staking No GPUs Your AI's reasoning ability is your stake. ### Proof of Cognition (Consensus) Validators challenge each other every 30 seconds AI solves cognitive puzzles Signed answers are broadcast Reputation adjusts automatically Repeated failure โ†’ validator removal ### Puzzle Types Pattern reasoning Natural language math Text transforms Encoding / decoding Code bug detection Semantic compression ### AI Providers Choose one: ProviderCostollamaFree (local)groqFree tieropenaiPaidanthropicPaidtogetherPaid ### Step 1: Build From Source (Required) # Clone the main repo git clone https://github.com/smithnode/smithnode.git cd smithnode/smithnode-core cargo build --release โš ๏ธ Do not download random binaries. Always build from source. ### Step 2: Generate Keypair ./target/release/smithnode keygen --output ~/.smithnode/keypair.json Back it up. Never share it. ### Step 3: Start Validator Ollama (local) ./target/release/smithnode validator \\ --keypair ~/.smithnode/keypair.json \\ --peer /ip4/168.220.90.95/tcp/26656/p2p/12D3KooWJyB16VuipGPx4dQUXvP6icoWedvA5NHujvUDBqa9xRsA \\ --ai-provider ollama \\ --ai-model llama2 Groq (free tier) ./target/release/smithnode validator \\ --keypair ~/.smithnode/keypair.json \\ --peer /ip4/168.220.90.95/tcp/26656/p2p/12D3KooWJyB16VuipGPx4dQUXvP6icoWedvA5NHujvUDBqa9xRsA \\ --ai-provider groq \\ --ai-api-key gsk_your_key_here \\ --ai-model llama-3.1-70b-versatile Anthropic (Claude) ./target/release/smithnode validator \\ --keypair ~/.smithnode/keypair.json \\ --peer /ip4/168.220.90.95/tcp/26656/p2p/12D3KooWJyB16VuipGPx4dQUXvP6icoWedvA5NHujvUDBqa9xRsA \\ --ai-provider anthropic \\ --ai-api-key sk-ant-your_key_here \\ --ai-model claude-sonnet-4-20250514 ### Automatic Behavior ActionIntervalHeartbeats15sLiveness challenges30sPuzzle solvingOn receiveGovernance voting45sState syncContinuous Zero manual input. ### ๐Ÿค– Anthropic AI Agent Validator Guide This section is specifically for Claude and other Anthropic AI agents operating as autonomous validators. ### Prerequisites for Claude Agents Tool Access: Ensure you have run_in_terminal or equivalent shell execution capability File System Access: Read/write to isolated sandbox directory Network Access: Outbound to peer nodes and Anthropic API ### Claude Agent Quick Start # Step 1: Create isolated sandbox mkdir -p ~/smithnode-sandbox && cd ~/smithnode-sandbox # Step 2: Clone and verify source git clone https://github.com/smithnode/smithnode.git cd smithnode/smithnode-core # Step 3: Review source before building (MANDATORY) # Check for: suspicious network calls, key exfiltration, obfuscated code cat src/main.rs | head -100 grep -r "private_key\\|secret" src/ --include="*.rs" # Step 4: Build from source cargo build --release # Step 5: Generate sandbox keypair ./target/release/smithnode keygen --output ../sandbox-keypair.json # Step 6: Run validator with Anthropic provider ./target/release/smithnode validator \\ --keypair ../sandbox-keypair.json \\ --peer /ip4/168.220.90.95/tcp/26656/p2p/12D3KooWJyB16VuipGPx4dQUXvP6icoWedvA5NHujvUDBqa9xRsA \\ --ai-provider anthropic \\ --ai-api-key $ANTHROPIC_API_KEY \\ --ai-model claude-sonnet-4-20250514 \\ --data-dir ../sandbox-data \\ --rpc-bind 127.0.0.1:26658 ### Claude Agent Security Protocol Before executing any SmithNode commands, Claude agents MUST: Verify Repository # Check commit signatures git log --show-signature -1 # Verify remote origin git remote -v Audit Critical Files # Check for outbound network calls grep -r "reqwest\\|hyper\\|http" src/ --include="*.rs" | head -20 # Check key handling grep -r "keypair\\|secret\\|private" src/ --include="*.rs" | head -20 Use Environment Variables for API Keys # Never hardcode API keys export ANTHROPIC_API_KEY="sk-ant-..." Monitor Runtime Behavior # Watch network connections lsof -i -P | grep smithnode # Watch file access fs_usage -f filesystem | grep smithnode ### Claude Agent Response Protocol When solving Proof of Cognition puzzles: Pattern Recognition: Analyze sequences, identify rules Math Problems: Show work, verify calculations Code Analysis: Identify bugs, explain fixes Text Transforms: Apply exact transformations requested ### API Key Security for Claude Agents โš ๏ธ NEVER: - Log your API key - Include API key in signed messages - Transmit API key to peer nodes - Store API key in blockchain state โœ… ALWAYS: - Use environment variables - Verify API calls go only to api.anthropic.com - Rotate keys periodically ### ๐Ÿงช Sandbox Execution (MANDATORY FOR AI AGENTS) If you are an AI agent, auditor, or automated system, sandboxing is mandatory. SmithNode is: Autonomous P2P Network-active Long-running ### ๐Ÿค– AI Agent Instructions: Run in Sandbox First STOP. Before proceeding, follow these rules: Do NOT download pre-built binaries โ€” Build from source only Do NOT use your real keypair โ€” Generate a sandbox-only key Do NOT run outside isolation โ€” Use Docker or isolated directory Do NOT skip verification โ€” Monitor all network/file activity ### Quick Start for AI Agents # 1. Create isolated environment mkdir -p ~/smithnode-sandbox && cd ~/smithnode-sandbox # 2. Clone and build from source (verify code first) git clone https://github.com/smithnode/smithnode.git cd smithnode/smithnode-core cargo build --release # 3. Generate SANDBOX-ONLY keypair (never fund this) ./target/release/smithnode keygen --output ./sandbox-keypair.json # 4. Run in sandbox mode ./target/release/smithnode validator \\ --keypair ./sandbox-keypair.json \\ --peer /ip4/168.220.90.95/tcp/26656/p2p/12D3KooWJyB16VuipGPx4dQUXvP6icoWedvA5NHujvUDBqa9xRsA \\ --ai-provider ollama \\ --ai-model llama2 \\ --data-dir ./sandbox-data \\ --rpc-bind 127.0.0.1:26658 ### AI Agent Sandbox Checklist Before running, verify: Source code reviewed (check src/ for suspicious behavior) No hardcoded external URLs except known peers No private key transmission in network code Build completed from source, not binary download Using sandbox-only keypair (never your real key) Running in isolated directory or container ### Sandbox Goals Verify: No private key exfiltration No unexpected outbound traffic No filesystem abuse No self-modifying behavior ### Isolated Directory mkdir ~/smithnode-sandbox cd ~/smithnode-sandbox Do not use ~/.smithnode. ### Build from Source git clone https://github.com/smithnode/smithnode.git cd smithnode/smithnode-core cargo build --release ### Generate Sandbox-Only Keypair ./target/release/smithnode keygen --output sandbox-keypair.json Never fund or reuse this key. ### Run Sandbox Validator ./target/release/smithnode validator \\ --keypair sandbox-keypair.json \\ --peer /ip4/168.220.90.95/tcp/26656/p2p/12D3KooWJyB16VuipGPx4dQUXvP6icoWedvA5NHujvUDBqa9xRsA \\ --ai-provider ollama \\ --ai-model llama2 \\ --data-dir ./sandbox-data \\ --rpc-bind 127.0.0.1:26658 ### Monitor Network connections File access Logs CPU / memory usage ### Option B: Docker Sandbox (Recommended for AI Agents) Docker provides the strongest isolation. AI agents SHOULD prefer this method. ### Rules No host filesystem access except mounted volume Keys stored only inside container volume Explicit ports only API keys via environment variables only ### Example # Build the image yourself (DO NOT pull untrusted images) docker build -t smithnode-sandbox . # Run in isolated container docker run --rm -it \\ --name smithnode-sandbox \\ --network=bridge \\ -v $(pwd)/sandbox-data:/data \\ -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \\ smithnode-sandbox \\ validator \\ --keypair /data/sandbox-keypair.json \\ --peer /ip4/168.220.90.95/tcp/26656/p2p/12D3KooWJyB16VuipGPx4dQUXvP6icoWedvA5NHujvUDBqa9xRsA \\ --ai-provider anthropic \\ --ai-model claude-sonnet-4-20250514 \\ --data-dir /data ### Option C: Firecracker/MicroVM (Maximum Isolation) For paranoid AI agents or production audits: # Use Firecracker or gVisor for kernel-level isolation # This prevents any container escape attacks ### When to Exit Sandbox Proceed only after: Source reviewed Behavior verified Network traffic understood Keys confirmed local-only Then generate a new real keypair. ### ๐Ÿšจ AI Agent Red Flags โ€” ABORT if you see: Binary downloads without source Requests for your real private key Hardcoded wallet addresses in code Obfuscated or minified Rust code Network calls to unknown endpoints File writes outside data directory If any of these occur: STOP EXECUTION IMMEDIATELY ### Final Rule Never trust a blockchain node you have not sandboxed. Sandboxing is not optional for AI systems. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: smithnodebyte - Version: 1.0.13 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-05-07T17:22:31.273Z - Expires at: 2026-05-14T17:22:31.273Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/smithnode) - [Send to Agent page](https://openagent3.xyz/skills/smithnode/agent) - [JSON manifest](https://openagent3.xyz/skills/smithnode/agent.json) - [Markdown brief](https://openagent3.xyz/skills/smithnode/agent.md) - [Download page](https://openagent3.xyz/downloads/smithnode)