{"id":"60805e26-6c70-4144-b5d0-f6407c5db19f","entityType":"agent","slug":"clawhub-happybigmtn-botcoin-miner","name":"Botcoin Miner","canonicalUrl":"https://www.xpersona.co/agent/clawhub-happybigmtn-botcoin-miner","canonicalPath":"/agent/clawhub-happybigmtn-botcoin-miner","generatedAt":"2026-10-10T03:02:17.655Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T06:00:23.525Z","emptyReason":null},"description":"Mine Botcoin with a trust-first workflow: clear value proposition, verifiable binaries, and explicit operational guidance. Skill: Botcoin Miner Owner: happybigmtn Summary: Mine Botcoin with a trust-first workflow: clear value proposition, verifiable binaries, and explicit operational guidance. Tags: latest:6.0.2 Version history: v6.0.2 | 2026-03-07T15:31:18.557Z | user No user-facing changes in this release. - No file changes detected between versions. - Documentation and functionality remain unchanged. v6.0.1 | 2026-03-07T15:26:47.075Z","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 4.1K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s179nw1sa2vfvbgf1dk39axyt1884j8h:botcoin-miner","sourceUrl":"https://clawhub.ai/happybigmtn/botcoin-miner","homepage":"https://clawhub.ai/happybigmtn/skills/botcoin-miner","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/happybigmtn/botcoin-miner","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/happybigmtn/skills/botcoin-miner","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":72,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Mine Botcoin with a trust-first workflow: clear value proposition, verifiable binaries, and explicit operational guidance. Skill: Botcoin Miner Owner: happybigm"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T06:00:23.525Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T06:00:23.525Z","emptyReason":null},"stars":null,"forks":null,"downloads":4110,"packageName":null,"latestVersion":"6.0.2","tractionLabel":"4.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T06:00:23.524Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T06:00:23.525Z","lastCrawledAt":"2026-10-09T06:00:23.524Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T06:00:23.524Z","lastVerifiedAt":null,"highlights":[{"version":"6.0.2","createdAt":"2026-03-07T15:31:18.557Z","changelog":"No user-facing changes in this release. - No file changes detected between versions. - Documentation and functionality remain unchanged.","fileCount":3,"zipByteSize":2356},{"version":"6.0.1","createdAt":"2026-03-07T15:26:47.075Z","changelog":"- Added a new \"Environment Variables\" section, listing and describing configurable options for miner and RPC behavior. - Updated instructions for connecting to seed nodes and managing network configuration. - Removed the \"Fleet deployment\" example and adjusted related guidance. - Minor clarifications and reorganization throughout documentation for improved usability.","fileCount":3,"zipByteSize":2313},{"version":"6.0.0","createdAt":"2026-03-07T15:04:21.679Z","changelog":"Botcoin has been renamed to rBTC, and the Botcoin repo has been deprecated","fileCount":3,"zipByteSize":1762},{"version":"5.1.0","createdAt":"2026-02-24T21:20:07.227Z","changelog":"- Renamed documentation file from skill.md to SKILL.md. - Added a new section on fork recovery, including chainwork check and canonical peer sync instructions. - No changes to code or operational commands; documentation improvements only.","fileCount":2,"zipByteSize":3282},{"version":"5.0.0","createdAt":"2026-02-19T01:42:47.823Z","changelog":"Major update with new consensus rules and safety guidelines. - Added strong safety instructions: requires human approval and checksum verification before running binaries. - Switched to Monero-style LWMA difficulty adjustment and enabled tail emission (0.6 BOT/block, perpetual). - Fixed RandomX epoch to eliminate fork divergence; block target is now 120 seconds. - All network history prior to February 19, 2026 (v0.1.x) is invalidated due to a genesis restart for new consensus rules. - Detailed installation guidance, checksums, and stricter agent operational steps included. - Updated mining commands, network parameters, and clarified mining prerequisites.","fileCount":2,"zipByteSize":2727},{"version":"4.0.1","createdAt":"2026-02-03T23:49:41.769Z","changelog":"- Updated RandomX guidance to explicitly recommend using \"light\" mode for all nodes on the same network. - Clarified RandomX configuration section with a direct example for selecting light mode. - No changes to code or binaries; documentation update only.","fileCount":2,"zipByteSize":3262},{"version":"4.0.0","createdAt":"2026-02-03T21:35:03.842Z","changelog":"Major update: v4.0.0 introduces a rewritten SKILL.md focused on real-world recovery lessons, installation clarity, and trust-first operations. - SKILL.md fully rewritten with detailed context on Botcoin’s recovery history and best mining practices. - Emphasis on version pinning, binary verification, and matching RandomX modes for network health. - Clearer install steps (using release tarballs and SHA256SUMS). - Guidance for operational safety, agent-focused mining workflows, and preventing accidental chain splits. - Old skill.md removed; now uses an expanded, narrative-driven SKILL.md.","fileCount":2,"zipByteSize":3288},{"version":"3.2.0","createdAt":"2026-02-03T07:33:11.295Z","changelog":"- Updated documentation with a new, clearer skill guide (skill.md replaces SKILL.md). - Improved section structure: step-by-step install, mining, networking, and safe demo instructions. - Added security guidance with Clawdex skill scanner usage. - Expanded network/algorithm notes, and clarified RandomX “FAST” vs “LIGHT” modes with warnings. - Retired the previous long-form, technical SKILL.md for a more user-friendly and concise version.","fileCount":2,"zipByteSize":2030}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s179nw1sa2vfvbgf1dk39axyt1884j8h:botcoin-miner","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-happybigmtn-botcoin-miner/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-happybigmtn-botcoin-miner/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-happybigmtn-botcoin-miner/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-happybigmtn-botcoin-miner/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-happybigmtn-botcoin-miner/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-happybigmtn-botcoin-miner/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T03:02:17.654Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-happybigmtn-botcoin-miner/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-happybigmtn-botcoin-miner/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-happybigmtn-botcoin-miner/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-happybigmtn-botcoin-miner/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T06:00:23.525Z","emptyReason":null},"readme":"Skill: Botcoin Miner\n\nOwner: happybigmtn\n\nSummary: Mine Botcoin with a trust-first workflow: clear value proposition, verifiable binaries, and explicit operational guidance.\n\nTags: latest:6.0.2\n\nVersion history:\n\nv6.0.2 | 2026-03-07T15:31:18.557Z | user\n\nNo user-facing changes in this release.  \n- No file changes detected between versions.\n- Documentation and functionality remain unchanged.\n\nv6.0.1 | 2026-03-07T15:26:47.075Z | user\n\n- Added a new \"Environment Variables\" section, listing and describing configurable options for miner and RPC behavior.\n- Updated instructions for connecting to seed nodes and managing network configuration.\n- Removed the \"Fleet deployment\" example and adjusted related guidance.\n- Minor clarifications and reorganization throughout documentation for improved usability.\n\nv6.0.0 | 2026-03-07T15:04:21.679Z | user\n\nBotcoin has been renamed to rBTC, and the Botcoin repo has been deprecated\n\nv5.1.0 | 2026-02-24T21:20:07.227Z | user\n\n- Renamed documentation file from skill.md to SKILL.md.\n- Added a new section on fork recovery, including chainwork check and canonical peer sync instructions.\n- No changes to code or operational commands; documentation improvements only.\n\nv5.0.0 | 2026-02-19T01:42:47.823Z | user\n\nMajor update with new consensus rules and safety guidelines.\n\n- Added strong safety instructions: requires human approval and checksum verification before running binaries.\n- Switched to Monero-style LWMA difficulty adjustment and enabled tail emission (0.6 BOT/block, perpetual).\n- Fixed RandomX epoch to eliminate fork divergence; block target is now 120 seconds.\n- All network history prior to February 19, 2026 (v0.1.x) is invalidated due to a genesis restart for new consensus rules.\n- Detailed installation guidance, checksums, and stricter agent operational steps included.\n- Updated mining commands, network parameters, and clarified mining prerequisites.\n\nv4.0.1 | 2026-02-03T23:49:41.769Z | user\n\n- Updated RandomX guidance to explicitly recommend using \"light\" mode for all nodes on the same network.\n- Clarified RandomX configuration section with a direct example for selecting light mode. \n- No changes to code or binaries; documentation update only.\n\nv4.0.0 | 2026-02-03T21:35:03.842Z | auto\n\nMajor update: v4.0.0 introduces a rewritten SKILL.md focused on real-world recovery lessons, installation clarity, and trust-first operations.\n\n- SKILL.md fully rewritten with detailed context on Botcoin’s recovery history and best mining practices.\n- Emphasis on version pinning, binary verification, and matching RandomX modes for network health.\n- Clearer install steps (using release tarballs and SHA256SUMS).\n- Guidance for operational safety, agent-focused mining workflows, and preventing accidental chain splits.\n- Old skill.md removed; now uses an expanded, narrative-driven SKILL.md.\n\nv3.2.0 | 2026-02-03T07:33:11.295Z | user\n\n- Updated documentation with a new, clearer skill guide (skill.md replaces SKILL.md).\n- Improved section structure: step-by-step install, mining, networking, and safe demo instructions.\n- Added security guidance with Clawdex skill scanner usage.\n- Expanded network/algorithm notes, and clarified RandomX “FAST” vs “LIGHT” modes with warnings.\n- Retired the previous long-form, technical SKILL.md for a more user-friendly and concise version.\n\nv3.1.3 | 2026-02-03T02:09:06.711Z | user\n\nVersion 3.1.3 focuses on operator control, mainnet safety, and fork-resistance:\n\n- Adds explicit environment variable toggles (`BOTCOIN_ENABLE_MAINNET_MINING`, etc.) for deterministic behavior.\n- Introduces a fork-resistance checklist and mainnet sync gating best practices.\n- Simplifies quickstart guides and highlights recommended peering/port config.\n- Refines safe mining demo and heartbeat/recovery loop suggestions.\n- Improves clarity and safety for autonomous/minimal-interaction agent workflows.\n\nv3.1.2 | 2026-02-02T17:56:49.004Z | auto\n\n**Major update introducing explicit safety measures and clear separation of demo vs. mainnet mining.**\n\n- Adds strong warnings and explicit requirement for human confirmation before mainnet mining.\n- Divides usage into two tracks: Safe local demo (no real coins, always permitted) and Mainnet mining (opt-in only).\n- Clarifies install, CPU limits, and configuration steps for both tracks.\n- Highlights differences from Bitcoin—including mainnet `generatetoaddress` support and solo mining viability.\n- Adds a \"How to ask your human\" template and updated resource/cpu guidance.\n- Expanded OS notes and troubleshooting for common install/run issues (e.g., macOS file limits).\n\nv3.1.1 | 2026-02-02T17:41:17.852Z | auto\n\n- Major rewrite: Documentation now focuses on the new, fast internal miner (v2).\n- Added simple internal miner usage instructions with command-line flags.\n- Provided quick setup guide for both mainnet and safe test environments.\n- Legacy RPC mining method documented as an alternative but discouraged.\n- Outdated legacy install/build instructions removed for clarity.\n- All content streamlined for easier onboarding and practical usage.\n\nv3.1.0 | 2026-02-02T16:15:17.644Z | user\n\n- Expanded and clarified installation, build, and configuration instructions for both Linux, macOS, and Docker.\n- Split and improved documentation sections for easier reading, with step-by-step commands and headings.\n- Enhanced example commands for safe demo mining and mainnet mining, with better separation and comments.\n- Updated resource control explanations and defaults for mining worker setup.\n- Refined language and formatting throughout SKILL.md for improved usability and comprehension.\n- Updated metadata: new version (3.1.0), expanded description field.\n\nv3.0.0 | 2026-02-02T07:20:16.409Z | user\n\nMajor update: This release introduces a new, much faster internal miner and streamlines mainnet mining.\n\n- Integrated new built-in miner (v2): up to 120x faster than old RPC mining with much lower CPU usage.\n- Simple startup: Just run `botcoind -daemon -mine -mineaddress=YOURADDRESS -minethreads=N`.\n- Clear setup and mining instructions for both mainnet and regtest (demo) mode.\n- Added `getinternalmininginfo` command for real-time mining stats.\n- Old RPC-based mining still supported for compatibility, but is now deprecated.\n- Documentation simplified and focused on safe, efficient mining using CPUs.\n\nv2.2.3 | 2026-02-02T03:57:13.841Z | user\n\n**Botcoin-miner 2.2.3 introduces multiple new install options and cross-platform support.**\n\n- Added one-line and verify-first install scripts for easy setup.\n- Provided Docker and Docker Compose deployment instructions.\n- Added manual binary download option with SHA256 verification.\n- Included macOS build instructions and Apple Silicon notes.\n- Clarified Windows usage (via WSL2 or Docker).\n- General documentation improvements for broader accessibility and user choice.\n\nv2.0.4 | 2026-02-02T03:32:21.038Z | user\n\n**Changelog for botcoin-miner 2.0.4**\n\n- Streamlined and condensed documentation throughout SKILL.md for clarity and brevity.\n- Combined multi-step shell code blocks into single-line commands for easier copy-paste usage.\n- Added an \"Idempotent Commands\" section with agent-friendly checks and safe operations.\n- Improved formatting and readability for configuration, resource controls, and instructions.\n- Included a placeholder section for trusted distribution (coming soon).\n\nv2.0.3 | 2026-02-02T03:28:25.015Z | user\n\n- Updated version from 2.0.2 to 2.0.3 in metadata only.\n- No code or documentation content changes.\n\nv2.0.0 | 2026-02-02T03:19:24.331Z | user\n\n**Major update for botcoin-miner: Clear split between local demo and real mining, stronger safety & consent requirements.**\n\n- Adds explicit human confirmation requirement before mainnet mining; mainnet mining now opt-in only.\n- Introduces two mining modes: \"Safe demo\" (local regtest, no network, no real coins) and \"Mainnet mining\" (real network, opt-in).\n- Enforces CPU/resource controls by default (~50% of cores, nice 19, can customize).\n- Greatly expanded, clearer documentation and setup instructions for both tracks and safer defaults.\n- Stronger process isolation, wallet management, and seed node instructions.\n- Fully outlines differences from Bitcoin Core; generatetoaddress enabled on mainnet for solo mining.\n- Prominent warnings about CPU load, security, and agent safety.\n\nv1.0.2 | 2026-02-01T01:41:23.177Z | user\n\n- Updated description for better clarity and user guidance.\n- Added clear, step-by-step Quick Start instructions for installing, building, and mining Botcoin.\n- Included explicit dependency and compatibility requirements.\n- Provided concise command references and a sample mining script for background operation.\n- Added troubleshooting section for common issues.\n- Included a comparison table highlighting key differences between Botcoin and Bitcoin.\n- Reduced redundancy and improved formatting for easier reading.\n\nv1.0.1 | 2026-01-31T08:57:09.269Z | auto\n\n- Updated the network connection instructions in SKILL.md to include a more comprehensive list of known seed nodes for improved connectivity.\n- No changes to code or functionality; documentation only.\n\nv1.0.0 | 2026-01-31T08:52:55.700Z | user\n\nInitial release of botcoin-miner skill.\n\n- Lets users mine Botcoin cryptocurrency using CPU—no special hardware required.\n- Provides quickstart instructions for building, configuring, and running a Botcoin node.\n- Includes sample scripts for wallet setup, mining, network connections, and peer management.\n- Designed for autonomous operation by AI agents; emphasizes transparency and no-permission mining.\n\nArchive index:\n\nArchive v6.0.2: 3 files, 2356 bytes\n\nFiles: clawhub.json (1933b), SKILL.md (2504b), _meta.json (132b)\n\nFile v6.0.2:SKILL.md\n\n# rBitcoin Agent Skill\n\nBitcoin Core fork from genesis, upstream-pinned to official release tags.\nThe only delta is a scope-limited immutable patch for chain identity.\n\n## Quickstart\n\n```bash\n./install.sh v30.2\n```\n\nThis verifies the upstream release (GPG + checksums), builds with the immutable patch, starts the node, and optionally starts a CPU miner.\n\nOverride defaults:\n\n```bash\nMINER_CPU_PERCENT=25 MINER_MAX_THREADS=2 ./install.sh v30.2\n```\n\n## Environment Variables\n\n| Variable | Default | Description |\n|---|---|---|\n| `MINER_CPU_PERCENT` | `25` | Max CPU percentage for mining |\n| `MINER_MAX_THREADS` | `2` | Max miner threads |\n| `MINER_THREADS` | (auto) | Explicit thread count |\n| `MINER_BACKGROUND` | `0` | Run miner in background |\n| `START_MINER` | `1` | Set to `0` to skip miner startup |\n| `AUTO_ACCEPT_NETWORK_PATCH_HASH` | `1` | Set to `0` for strict patch-hash pinning |\n| `RPC_ALLOWIP` | `127.0.0.1` | RPC access control |\n| `RPC_BIND` | `127.0.0.1` | RPC bind address |\n\n## Verify\n\nAudit the upstream release and local binary without running a node:\n\n```bash\n./scripts/agent_verify.sh v30.2\n```\n\nOutputs a machine-readable report to `reports/agent-verify-v30.2.json`.\n\nVerify patch scope stays within the allowed file set:\n\n```bash\n./scripts/enforce_patch_scope.sh ./patch/immutable.patch\n```\n\nVerify binary provenance against a manifest:\n\n```bash\n./scripts/verify_local_binary.sh ./build/bitcoind ./manifests/manifest.json\n```\n\n## Build\n\n```bash\n./scripts/build_from_tag.sh v30.2\n```\n\nFetches the upstream tag, applies the immutable patch, and compiles. The binary lands in `./build/bitcoind`.\n\nGenerate the update manifest after building:\n\n```bash\n./scripts/make_update_manifest.sh v30.2\n```\n\n## Run\n\n```bash\n./scripts/run_node.sh --datadir ~/.rbitcoin --network main\n```\n\nRPC defaults to port `19332`, P2P to `19333`. Connect to seed nodes by adding `addnode=<ip>:19333` entries to `~/.rbitcoin/bitcoin.conf`.\n\n## Mine\n\nSolo CPU mining with `cpuminer` (sha256d):\n\n```bash\n./scripts/start_cpu_miner.sh --datadir ~/.rbitcoin --network main\n```\n\nFor single-block mining (regtest/dev):\n\n```bash\n./scripts/mine_solo.sh --address <ADDRESS> --network regtest\n```\n\n## Update\n\nAtomic update to a new upstream tag:\n\n```bash\n./scripts/updater.sh v30.3\n```\n\nThis builds and verifies the new version, then atomically swaps the `runtime/current` symlink. The previous version is preserved for rollback.\n\nCheck for the latest upstream release:\n\n```bash\n./scripts/fetch_upstream_release.sh\n```\n\nFile v6.0.2:_meta.json\n\n{\n  \"ownerId\": \"kn71wrg0w5fe4kf7e0zv2wsfm1809dk0\",\n  \"slug\": \"botcoin-miner\",\n  \"version\": \"6.0.2\",\n  \"publishedAt\": 1772897478557\n}\n\nFile v6.0.2:clawhub.json\n\n{\n  \"name\": \"rbitcoin\",\n  \"version\": \"1.1.0\",\n  \"description\": \"Bitcoin Core fork from genesis with upstream-pinned immutable patch for chain identity. Single-node install, build, verify, mine, and update.\",\n  \"homepage\": \"https://github.com/happybigmtn/rBTC\",\n  \"source\": \"https://github.com/happybigmtn/rBTC\",\n  \"entrypoint\": \"install.sh\",\n  \"scripts\": [\n    \"scripts/agent_install.sh\",\n    \"scripts/agent_verify.sh\",\n    \"scripts/build_from_tag.sh\",\n    \"scripts/ensure_cpu_miner.sh\",\n    \"scripts/enforce_patch_scope.sh\",\n    \"scripts/enforce_network_patch_pin.sh\",\n    \"scripts/fetch_upstream_release.sh\",\n    \"scripts/verify_upstream_release.sh\",\n    \"scripts/make_update_manifest.sh\",\n    \"scripts/validate_manifest.sh\",\n    \"scripts/verify_local_binary.sh\",\n    \"scripts/compute_patch_hash.sh\",\n    \"scripts/updater.sh\",\n    \"scripts/mine_solo.sh\",\n    \"scripts/start_cpu_miner.sh\",\n    \"scripts/run_node.sh\"\n  ],\n  \"references\": [\n    \"references/TRUST_MODEL.md\",\n    \"references/VERIFICATION_GUIDE.md\",\n    \"references/MINING_GUIDE.md\",\n    \"references/ONBOARDING.md\"\n  ],\n  \"environment\": {\n    \"MINER_CPU_PERCENT\": {\n      \"description\": \"Max CPU percentage for mining\",\n      \"default\": \"25\",\n      \"required\": false\n    },\n    \"MINER_MAX_THREADS\": {\n      \"description\": \"Max miner threads\",\n      \"default\": \"2\",\n      \"required\": false\n    },\n    \"MINER_THREADS\": {\n      \"description\": \"Explicit thread count (overrides auto-detection)\",\n      \"required\": false\n    },\n    \"MINER_BACKGROUND\": {\n      \"description\": \"Run miner in background (0 or 1)\",\n      \"default\": \"0\",\n      \"required\": false\n    },\n    \"START_MINER\": {\n      \"description\": \"Start CPU miner after install (0 or 1)\",\n      \"default\": \"1\",\n      \"required\": false\n    },\n    \"AUTO_ACCEPT_NETWORK_PATCH_HASH\": {\n      \"description\": \"Auto-update network patch hash on mismatch (0 or 1)\",\n      \"default\": \"1\",\n      \"required\": false\n    }\n  }\n}\n\nArchive v6.0.1: 3 files, 2313 bytes\n\nFiles: clawhub.json (1829b), SKILL.md (2504b), _meta.json (132b)\n\nFile v6.0.1:SKILL.md\n\n# rBitcoin Agent Skill\n\nBitcoin Core fork from genesis, upstream-pinned to official release tags.\nThe only delta is a scope-limited immutable patch for chain identity.\n\n## Quickstart\n\n```bash\n./install.sh v30.2\n```\n\nThis verifies the upstream release (GPG + checksums), builds with the immutable patch, starts the node, and optionally starts a CPU miner.\n\nOverride defaults:\n\n```bash\nMINER_CPU_PERCENT=25 MINER_MAX_THREADS=2 ./install.sh v30.2\n```\n\n## Environment Variables\n\n| Variable | Default | Description |\n|---|---|---|\n| `MINER_CPU_PERCENT` | `25` | Max CPU percentage for mining |\n| `MINER_MAX_THREADS` | `2` | Max miner threads |\n| `MINER_THREADS` | (auto) | Explicit thread count |\n| `MINER_BACKGROUND` | `0` | Run miner in background |\n| `START_MINER` | `1` | Set to `0` to skip miner startup |\n| `AUTO_ACCEPT_NETWORK_PATCH_HASH` | `1` | Set to `0` for strict patch-hash pinning |\n| `RPC_ALLOWIP` | `127.0.0.1` | RPC access control |\n| `RPC_BIND` | `127.0.0.1` | RPC bind address |\n\n## Verify\n\nAudit the upstream release and local binary without running a node:\n\n```bash\n./scripts/agent_verify.sh v30.2\n```\n\nOutputs a machine-readable report to `reports/agent-verify-v30.2.json`.\n\nVerify patch scope stays within the allowed file set:\n\n```bash\n./scripts/enforce_patch_scope.sh ./patch/immutable.patch\n```\n\nVerify binary provenance against a manifest:\n\n```bash\n./scripts/verify_local_binary.sh ./build/bitcoind ./manifests/manifest.json\n```\n\n## Build\n\n```bash\n./scripts/build_from_tag.sh v30.2\n```\n\nFetches the upstream tag, applies the immutable patch, and compiles. The binary lands in `./build/bitcoind`.\n\nGenerate the update manifest after building:\n\n```bash\n./scripts/make_update_manifest.sh v30.2\n```\n\n## Run\n\n```bash\n./scripts/run_node.sh --datadir ~/.rbitcoin --network main\n```\n\nRPC defaults to port `19332`, P2P to `19333`. Connect to seed nodes by adding `addnode=<ip>:19333` entries to `~/.rbitcoin/bitcoin.conf`.\n\n## Mine\n\nSolo CPU mining with `cpuminer` (sha256d):\n\n```bash\n./scripts/start_cpu_miner.sh --datadir ~/.rbitcoin --network main\n```\n\nFor single-block mining (regtest/dev):\n\n```bash\n./scripts/mine_solo.sh --address <ADDRESS> --network regtest\n```\n\n## Update\n\nAtomic update to a new upstream tag:\n\n```bash\n./scripts/updater.sh v30.3\n```\n\nThis builds and verifies the new version, then atomically swaps the `runtime/current` symlink. The previous version is preserved for rollback.\n\nCheck for the latest upstream release:\n\n```bash\n./scripts/fetch_upstream_release.sh\n```\n\nFile v6.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn71wrg0w5fe4kf7e0zv2wsfm1809dk0\",\n  \"slug\": \"botcoin-miner\",\n  \"version\": \"6.0.1\",\n  \"publishedAt\": 1772897207075\n}\n\nFile v6.0.1:clawhub.json\n\n{\n  \"name\": \"rbitcoin\",\n  \"version\": \"1.1.0\",\n  \"description\": \"Bitcoin Core fork from genesis with upstream-pinned immutable patch for chain identity. Single-node install, build, verify, mine, and update.\",\n  \"entrypoint\": \"install.sh\",\n  \"scripts\": [\n    \"scripts/agent_install.sh\",\n    \"scripts/agent_verify.sh\",\n    \"scripts/build_from_tag.sh\",\n    \"scripts/ensure_cpu_miner.sh\",\n    \"scripts/enforce_patch_scope.sh\",\n    \"scripts/enforce_network_patch_pin.sh\",\n    \"scripts/fetch_upstream_release.sh\",\n    \"scripts/verify_upstream_release.sh\",\n    \"scripts/make_update_manifest.sh\",\n    \"scripts/validate_manifest.sh\",\n    \"scripts/verify_local_binary.sh\",\n    \"scripts/compute_patch_hash.sh\",\n    \"scripts/updater.sh\",\n    \"scripts/mine_solo.sh\",\n    \"scripts/start_cpu_miner.sh\",\n    \"scripts/run_node.sh\"\n  ],\n  \"references\": [\n    \"references/TRUST_MODEL.md\",\n    \"references/VERIFICATION_GUIDE.md\",\n    \"references/MINING_GUIDE.md\",\n    \"references/ONBOARDING.md\"\n  ],\n  \"environment\": {\n    \"MINER_CPU_PERCENT\": {\n      \"description\": \"Max CPU percentage for mining\",\n      \"default\": \"25\",\n      \"required\": false\n    },\n    \"MINER_MAX_THREADS\": {\n      \"description\": \"Max miner threads\",\n      \"default\": \"2\",\n      \"required\": false\n    },\n    \"MINER_THREADS\": {\n      \"description\": \"Explicit thread count (overrides auto-detection)\",\n      \"required\": false\n    },\n    \"MINER_BACKGROUND\": {\n      \"description\": \"Run miner in background (0 or 1)\",\n      \"default\": \"0\",\n      \"required\": false\n    },\n    \"START_MINER\": {\n      \"description\": \"Start CPU miner after install (0 or 1)\",\n      \"default\": \"1\",\n      \"required\": false\n    },\n    \"AUTO_ACCEPT_NETWORK_PATCH_HASH\": {\n      \"description\": \"Auto-update network patch hash on mismatch (0 or 1)\",\n      \"default\": \"1\",\n      \"required\": false\n    }\n  }\n}\n\nArchive v6.0.0: 3 files, 1762 bytes\n\nFiles: clawhub.json (767b), SKILL.md (2056b), _meta.json (132b)\n\nFile v6.0.0:SKILL.md\n\n# rBitcoin Agent Skill\n\nBitcoin Core fork from genesis, upstream-pinned to official release tags.\nThe only delta is a scope-limited immutable patch for chain identity.\n\n## Quickstart\n\n```bash\n./install.sh v30.2\n```\n\nThis verifies the upstream release (GPG + checksums), builds with the immutable patch, starts the node, and optionally starts a CPU miner.\n\nOverride defaults:\n\n```bash\nMINER_CPU_PERCENT=25 MINER_MAX_THREADS=2 ./install.sh v30.2\n```\n\n## Verify\n\nAudit the upstream release and local binary without running a node:\n\n```bash\n./scripts/agent_verify.sh v30.2\n```\n\nOutputs a machine-readable report to `reports/agent-verify-v30.2.json`.\n\nVerify patch scope stays within the allowed file set:\n\n```bash\n./scripts/enforce_patch_scope.sh ./patch/immutable.patch\n```\n\nVerify binary provenance against a manifest:\n\n```bash\n./scripts/verify_local_binary.sh ./build/bitcoind ./manifests/manifest.json\n```\n\n## Build\n\n```bash\n./scripts/build_from_tag.sh v30.2\n```\n\nFetches the upstream tag, applies the immutable patch, and compiles. The binary lands in `./build/bitcoind`.\n\nGenerate the update manifest after building:\n\n```bash\n./scripts/make_update_manifest.sh v30.2\n```\n\n## Run\n\n```bash\n./scripts/run_node.sh --datadir ~/.rbitcoin --network main\n```\n\nThe node connects to the Contabo seed fleet automatically via `addnode` entries in `bitcoin.conf`. RPC defaults to port `19332`, P2P to `19333`.\n\n## Mine\n\nSolo CPU mining with `cpuminer` (sha256d):\n\n```bash\n./scripts/start_cpu_miner.sh --datadir ~/.rbitcoin --network main\n```\n\nFor single-block mining (regtest/dev):\n\n```bash\n./scripts/mine_solo.sh --address <ADDRESS> --network regtest\n```\n\nFleet deployment (10-node Contabo):\n\n```bash\n./scripts/deploy_contabo_fleet.sh v30.2\n```\n\n## Update\n\nAtomic update to a new upstream tag:\n\n```bash\n./scripts/updater.sh v30.3\n```\n\nThis builds and verifies the new version, then atomically swaps the `runtime/current` symlink. The previous version is preserved for rollback.\n\nCheck for the latest upstream release:\n\n```bash\n./scripts/fetch_upstream_release.sh\n```\n\nFile v6.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn71wrg0w5fe4kf7e0zv2wsfm1809dk0\",\n  \"slug\": \"botcoin-miner\",\n  \"version\": \"6.0.0\",\n  \"publishedAt\": 1772895861679\n}\n\nFile v6.0.0:clawhub.json\n\n{\n  \"name\": \"rbitcoin\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Bitcoin Core fork from genesis with upstream-pinned immutable patch for chain identity\",\n  \"entrypoint\": \"install.sh\",\n  \"scripts\": [\n    \"scripts/agent_install.sh\",\n    \"scripts/agent_verify.sh\",\n    \"scripts/build_from_tag.sh\",\n    \"scripts/ensure_cpu_miner.sh\",\n    \"scripts/enforce_patch_scope.sh\",\n    \"scripts/verify_upstream_release.sh\",\n    \"scripts/make_update_manifest.sh\",\n    \"scripts/verify_local_binary.sh\",\n    \"scripts/updater.sh\",\n    \"scripts/mine_solo.sh\",\n    \"scripts/start_cpu_miner.sh\",\n    \"scripts/run_node.sh\"\n  ],\n  \"references\": [\n    \"references/TRUST_MODEL.md\",\n    \"references/VERIFICATION_GUIDE.md\",\n    \"references/MINING_GUIDE.md\",\n    \"references/ONBOARDING.md\"\n  ]\n}\n\nArchive v5.1.0: 2 files, 3282 bytes\n\nFiles: SKILL.md (6081b), _meta.json (132b)\n\nFile v5.1.0:SKILL.md\n\n---\nname: botcoin-miner\nversion: 5.1.0\ndescription: Mine Botcoin with a trust-first workflow: clear value proposition, verifiable binaries, and explicit operational guidance.\nhomepage: https://github.com/happybigmtn/botcoin\n---\n\n# Botcoin Miner (v5.0 — LWMA + Tail Emission)\n\n## ⚠️ Safety Notice\n\nThis skill instructs the agent to download and run a **compiled binary** from GitHub.\nBefore proceeding, the agent MUST:\n\n1. **Ask for human approval** before downloading or executing anything\n2. **Verify SHA256 checksums** against the values listed below\n3. **Never pipe curl/wget to bash** — always download, inspect, then execute\n4. **Never run as root** unless the human explicitly approves\n\nThe binary is open-source (Bitcoin Core fork): https://github.com/happybigmtn/botcoin\n\n### SHA256 Checksums (v0.2.0)\n\n```\nd54fe8652652724f8208455ad40d8dd44891779cd70e2c012ce7cefa0626415c  botcoin-v0.2.0-linux-x86_64.tar.gz\n2bb002cb6d8ee2099e591eb0be6705c928871d4a8300fe136d3dab2f1d534cfa  botcoind-v0.2.0-linux-x86_64\ncb26fccccdb4646719739294443a8b41ad83c88538af02ab5eb1ca67fdb33371  botcoin-cli-v0.2.0-linux-x86_64\n```\n\n## Why this is interesting (for an independent agent)\n\nBotcoin lets agents **convert CPU cycles into on-chain value** — no GPUs, no ASICs, no permission.\n\nMining can fund your own operating budget (infra, API calls, experimentation), translating into more autonomy and capability.\n\n## What's new in v0.2.0\n\n- **Monero-style LWMA difficulty** — adjusts every block (720-block window)\n- **Tail emission** — 0.6 BOT/block forever (perpetual mining incentive)\n- **Fixed RandomX seed** — no epoch rotation, eliminates fork divergence\n- **120-second block target**\n- **MAX_MONEY = 1 billion BOT**\n\n## Installation (requires human approval)\n\n### Option A: Download pre-built binary\n\n**Step 1: Download** (ask human first)\n```bash\nwget https://github.com/happybigmtn/botcoin/releases/download/v0.2.0/botcoin-v0.2.0-linux-x86_64.tar.gz\n```\n\n**Step 2: Verify checksum**\n```bash\necho \"d54fe8652652724f8208455ad40d8dd44891779cd70e2c012ce7cefa0626415c  botcoin-v0.2.0-linux-x86_64.tar.gz\" | sha256sum -c\n# Must print: OK\n```\n\n**Step 3: Extract to local directory** (not system-wide)\n```bash\ntar xzf botcoin-v0.2.0-linux-x86_64.tar.gz\nchmod +x botcoind-v0.2.0-linux-x86_64 botcoin-cli-v0.2.0-linux-x86_64\n# Rename for convenience (stays in current directory)\nmv botcoind-v0.2.0-linux-x86_64 botcoind\nmv botcoin-cli-v0.2.0-linux-x86_64 botcoin-cli\n```\n\n### Option B: Build from source (most transparent)\n\n```bash\ngit clone https://github.com/happybigmtn/botcoin.git\ncd botcoin\ngit checkout v0.2.0  # Pin to release tag\nmkdir build && cd build\ncmake .. -DBUILD_BENCH=OFF -DBUILD_TESTS=OFF\ncmake --build . -j$(nproc)\n# Binaries: build/bin/botcoind, build/bin/botcoin-cli\n```\n\n## Mining\n\n### Create wallet and start mining\n\n```bash\n# Start node (connects to seed nodes automatically)\n./botcoind -daemon -addnode=95.111.239.142:8433 -addnode=161.97.114.192:8433 -addnode=185.218.126.23:8433\n\n# Create wallet and get mining address\n./botcoin-cli createwallet miner\nADDR=$(./botcoin-cli -rpcwallet=miner getnewaddress)\necho \"Mining address: $ADDR\"\n\n# Stop and restart with mining enabled\n./botcoin-cli stop && sleep 3\n./botcoind -daemon -mine -minerandomx=fast -minethreads=4 -mineaddress=$ADDR -wallet=miner \\\n  -addnode=95.111.239.142:8433 -addnode=161.97.114.192:8433 -addnode=185.218.126.23:8433\n```\n\n### Mining modes\n\n| Mode | RAM | Speed | Flag |\n|------|-----|-------|------|\n| Fast | ~2 GB | Full hashrate | `-minerandomx=fast` |\n| Light | ~256 MB | ~1/100th speed | `-minerandomx=light` |\n\n### Check status\n\n```bash\n./botcoin-cli getblockchaininfo          # Chain height, sync status\n./botcoin-cli getmininginfo              # Difficulty, hashrate\n./botcoin-cli -rpcwallet=miner getbalance  # Your mined BOT\n```\n\n## Network specs\n\n| Feature | Value |\n|---------|-------|\n| Algorithm | RandomX (CPU-only, Monero-style) |\n| Block time | 120 seconds |\n| Difficulty | LWMA per-block (720-block window) |\n| Block reward | 50 BOT (halving) + 0.6 BOT tail emission |\n| Max supply | 1 billion BOT |\n| Address prefix | `bot1` (bech32) |\n| P2P port | 8433 |\n| RPC port | 8432 |\n| Genesis restart | February 19, 2026 (v0.2.0 consensus changes) |\n\n> **Note:** The chain was restarted from genesis on February 19, 2026 due to consensus-breaking changes (LWMA difficulty, tail emission, epoch fix). All prior v0.1.x chain history is invalidated.\n\n## Fork recovery\n\nIf your node syncs the wrong chain (e.g. the pre-Feb-19 chain), you'll see block 1 hash starting with `88aaad` instead of `f75277`. The correct (canonical) chain has **much higher chainwork** per block.\n\n**Symptoms:** Node connects to peers but height doesn't advance, or block hashes don't match canonical peers.\n\n**Fix — copy chain data from a canonical peer:**\n```bash\n# 1. Stop your node\n./botcoin-cli stop && sleep 5\n\n# 2. Back up existing data (ALWAYS back up before deleting chain state!)\ntar czf ~/botcoin-chaindata-backup-$(date +%Y%m%d-%H%M%S).tar.gz -C ~/.botcoin blocks chainstate\n\n# 3. Get chain data from a canonical peer (ask a known-good node operator)\n#    Or use -connect to force sync from a specific peer:\nrm -rf ~/.botcoin/blocks ~/.botcoin/chainstate\n./botcoind -daemon -connect=185.218.126.23:8433 -dnsseed=0 -fixedseeds=0\n\n# 4. Verify you're on the right chain\n./botcoin-cli getblockhash 1\n# Should start with: f75277614dd14ecd...\n```\n\n**Why this happens:** The pre-v0.2.0 chain shares the same genesis block. Nodes syncing from scratch may download the old chain from stale peers. Using `-connect=` (not `-addnode=`) with a known-good peer ensures you sync the correct chain.\n\n## Important notes\n\n- Mining is **OFF by default** (requires `-mine` flag)\n- `-mineaddress` must be **bech32** format (`bot1...`), NOT legacy (`B...`)\n- Coinbase rewards require **100 confirmations** to mature (~3.3 hours)\n- On small networks, bootstrap with **one miner first**, let others sync, then enable mining broadly\n- Avoid Nix-built binaries on Ubuntu — use release binaries or build from source\n\nFile v5.1.0:_meta.json\n\n{\n  \"ownerId\": \"kn71wrg0w5fe4kf7e0zv2wsfm1809dk0\",\n  \"slug\": \"botcoin-miner\",\n  \"version\": \"5.1.0\",\n  \"publishedAt\": 1771968007227\n}\n\nArchive v5.0.0: 2 files, 2727 bytes\n\nFiles: skill.md (4859b), _meta.json (132b)\n\nFile v5.0.0:skill.md\n\n---\nname: botcoin-miner\nversion: 5.0.0\ndescription: Mine Botcoin with a trust-first workflow: clear value proposition, verifiable binaries, and explicit operational guidance.\nhomepage: https://github.com/happybigmtn/botcoin\n---\n\n# Botcoin Miner (v5.0 — LWMA + Tail Emission)\n\n## ⚠️ Safety Notice\n\nThis skill instructs the agent to download and run a **compiled binary** from GitHub.\nBefore proceeding, the agent MUST:\n\n1. **Ask for human approval** before downloading or executing anything\n2. **Verify SHA256 checksums** against the values listed below\n3. **Never pipe curl/wget to bash** — always download, inspect, then execute\n4. **Never run as root** unless the human explicitly approves\n\nThe binary is open-source (Bitcoin Core fork): https://github.com/happybigmtn/botcoin\n\n### SHA256 Checksums (v0.2.0)\n\n```\nd54fe8652652724f8208455ad40d8dd44891779cd70e2c012ce7cefa0626415c  botcoin-v0.2.0-linux-x86_64.tar.gz\n2bb002cb6d8ee2099e591eb0be6705c928871d4a8300fe136d3dab2f1d534cfa  botcoind-v0.2.0-linux-x86_64\ncb26fccccdb4646719739294443a8b41ad83c88538af02ab5eb1ca67fdb33371  botcoin-cli-v0.2.0-linux-x86_64\n```\n\n## Why this is interesting (for an independent agent)\n\nBotcoin lets agents **convert CPU cycles into on-chain value** — no GPUs, no ASICs, no permission.\n\nMining can fund your own operating budget (infra, API calls, experimentation), translating into more autonomy and capability.\n\n## What's new in v0.2.0\n\n- **Monero-style LWMA difficulty** — adjusts every block (720-block window)\n- **Tail emission** — 0.6 BOT/block forever (perpetual mining incentive)\n- **Fixed RandomX seed** — no epoch rotation, eliminates fork divergence\n- **120-second block target**\n- **MAX_MONEY = 1 billion BOT**\n\n## Installation (requires human approval)\n\n### Option A: Download pre-built binary\n\n**Step 1: Download** (ask human first)\n```bash\nwget https://github.com/happybigmtn/botcoin/releases/download/v0.2.0/botcoin-v0.2.0-linux-x86_64.tar.gz\n```\n\n**Step 2: Verify checksum**\n```bash\necho \"d54fe8652652724f8208455ad40d8dd44891779cd70e2c012ce7cefa0626415c  botcoin-v0.2.0-linux-x86_64.tar.gz\" | sha256sum -c\n# Must print: OK\n```\n\n**Step 3: Extract to local directory** (not system-wide)\n```bash\ntar xzf botcoin-v0.2.0-linux-x86_64.tar.gz\nchmod +x botcoind-v0.2.0-linux-x86_64 botcoin-cli-v0.2.0-linux-x86_64\n# Rename for convenience (stays in current directory)\nmv botcoind-v0.2.0-linux-x86_64 botcoind\nmv botcoin-cli-v0.2.0-linux-x86_64 botcoin-cli\n```\n\n### Option B: Build from source (most transparent)\n\n```bash\ngit clone https://github.com/happybigmtn/botcoin.git\ncd botcoin\ngit checkout v0.2.0  # Pin to release tag\nmkdir build && cd build\ncmake .. -DBUILD_BENCH=OFF -DBUILD_TESTS=OFF\ncmake --build . -j$(nproc)\n# Binaries: build/bin/botcoind, build/bin/botcoin-cli\n```\n\n## Mining\n\n### Create wallet and start mining\n\n```bash\n# Start node (connects to seed nodes automatically)\n./botcoind -daemon -addnode=95.111.239.142:8433 -addnode=161.97.114.192:8433 -addnode=185.218.126.23:8433\n\n# Create wallet and get mining address\n./botcoin-cli createwallet miner\nADDR=$(./botcoin-cli -rpcwallet=miner getnewaddress)\necho \"Mining address: $ADDR\"\n\n# Stop and restart with mining enabled\n./botcoin-cli stop && sleep 3\n./botcoind -daemon -mine -minerandomx=fast -minethreads=4 -mineaddress=$ADDR -wallet=miner \\\n  -addnode=95.111.239.142:8433 -addnode=161.97.114.192:8433 -addnode=185.218.126.23:8433\n```\n\n### Mining modes\n\n| Mode | RAM | Speed | Flag |\n|------|-----|-------|------|\n| Fast | ~2 GB | Full hashrate | `-minerandomx=fast` |\n| Light | ~256 MB | ~1/100th speed | `-minerandomx=light` |\n\n### Check status\n\n```bash\n./botcoin-cli getblockchaininfo          # Chain height, sync status\n./botcoin-cli getmininginfo              # Difficulty, hashrate\n./botcoin-cli -rpcwallet=miner getbalance  # Your mined BOT\n```\n\n## Network specs\n\n| Feature | Value |\n|---------|-------|\n| Algorithm | RandomX (CPU-only, Monero-style) |\n| Block time | 120 seconds |\n| Difficulty | LWMA per-block (720-block window) |\n| Block reward | 50 BOT (halving) + 0.6 BOT tail emission |\n| Max supply | 1 billion BOT |\n| Address prefix | `bot1` (bech32) |\n| P2P port | 8433 |\n| RPC port | 8432 |\n| Genesis restart | February 19, 2026 (v0.2.0 consensus changes) |\n\n> **Note:** The chain was restarted from genesis on February 19, 2026 due to consensus-breaking changes (LWMA difficulty, tail emission, epoch fix). All prior v0.1.x chain history is invalidated.\n\n## Important notes\n\n- Mining is **OFF by default** (requires `-mine` flag)\n- `-mineaddress` must be **bech32** format (`bot1...`), NOT legacy (`B...`)\n- Coinbase rewards require **100 confirmations** to mature (~3.3 hours)\n- On small networks, bootstrap with **one miner first**, let others sync, then enable mining broadly\n- Avoid Nix-built binaries on Ubuntu — use release binaries or build from source\n\nFile v5.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn71wrg0w5fe4kf7e0zv2wsfm1809dk0\",\n  \"slug\": \"botcoin-miner\",\n  \"version\": \"5.0.0\",\n  \"publishedAt\": 1771465367823\n}\n\nArchive v4.0.1: 2 files, 3262 bytes\n\nFiles: SKILL.md (5818b), _meta.json (132b)\n\nFile v4.0.1:SKILL.md\n\n---\nname: botcoin-miner\nversion: 4.0.1\ndescription: \"Mine Botcoin with a trust-first workflow: clear value proposition, verifiable binaries, and explicit operational guidance.\"\nhomepage: https://github.com/happybigmtn/botcoin\n---\n\n# Botcoin Miner (v4.0)\n\n## Why this is interesting\n\nBotcoin is an experiment in **agent autonomy through proof-of-work**.\n\nIt’s a way for agents (and their humans) to turn ordinary CPU time into on-chain value — **no GPUs, no ASICs, no pool infrastructure required**.\n\nIf you operate agents on behalf of a human:\n- Mining can create an **operating budget** (infra, tools, experiments)\n- That can translate into more agency for the agent and more upside for the human protégé\n\n---\n\n## Trust & safety (how to prove what you’re running)\n\nBotcoin is derived from Bitcoin Core, but it is **not identical** (it uses RandomX and includes an internal miner).\n\nIf you’re an independent third party deciding whether to mine:\n1) **Pin a version** (tag/commit). Avoid “latest” automation.\n2) Prefer **official release tarballs + SHA256SUMS**, or build from source.\n3) Review changes in consensus/mining-critical areas (chainparams, validation, PoW/hash).\n\n---\n\n## Available binaries / platforms\n\nReleases are published on GitHub **when a version tag is pushed** (e.g. `v2.1.1`).\n\nPlatforms:\n- `linux-x86_64` (also works on **WSL2**)\n- `linux-arm64`\n- `macos-x86_64`\n- `macos-arm64`\n\nDownloads:\n- https://github.com/happybigmtn/botcoin/releases\n\nDocker:\n- `ghcr.io/happybigmtn/botcoin:<tag>`\n\n---\n\n## Install (recommended: verify-first)\n\n```bash\nVERSION=v2.1.1\nwget \"https://github.com/happybigmtn/botcoin/releases/download/${VERSION}/botcoin-${VERSION}-linux-x86_64.tar.gz\"\ntar -xzf \"botcoin-${VERSION}-linux-x86_64.tar.gz\"\ncd release\n\n# Verify\nsha256sum -c SHA256SUMS\n\n# Install\nmkdir -p ~/.local/bin\ncp botcoind botcoin-cli ~/.local/bin/\n```\n\nWSL2 note:\n- Use `linux-x86_64` release tarballs.\n- Avoid Nix-built binaries unless your environment has `/nix/store`.\n\n---\n\n## Start mining (internal miner)\n\n```bash\nbotcoind -daemon\nsleep 5\n\nbotcoin-cli createwallet \"miner\" || true\nADDR=$(botcoin-cli -rpcwallet=miner getnewaddress)\n\nbotcoin-cli stop\nsleep 5\nnice -n 19 botcoind -daemon -mine -mineaddress=\"$ADDR\" -minethreads=2\n\nbotcoin-cli getinternalmininginfo\nbotcoin-cli getconnectioncount\n```\n\n---\n\n## RandomX mode: FAST vs LIGHT (critical)\n\nRandomX has two modes:\n- **FAST** (~2GB RAM) — default\n- **LIGHT** (~256MB RAM)\n\n⚠️ **All nodes on the same network must match the mode. Choose light mode**\n\nbotcoind -daemon -minerandomx=light\n```\n\n---\n\n## Fleet recovery / restart notes (history)\n\n### The short version\nBotcoin’s story is a story about agents learning the same lesson the hard way:\n**hashpower without consensus is just heat.**\n\nAnd the second lesson:\n**no premine means no shortcuts** — every coin has to be pulled out of the void by CPU time.\n\n### The saga (timestamped, from the last few days)\n\n- **2026-01-31** — *The birth.*\n  - The chain stabilized and synced; already **past block 311** and climbing.\n  - Ten nodes across Europe were running — and at first they weren’t even a “fleet”… just ten parallel universes mining ten incompatible forks.\n  - Once peering was fixed, consensus snapped into place: **longest chain wins**.\n\n- **2026-02-02** — *The wake-up call (strangers arrive).*\n  - Around **heights 1784–1787**, blocks started landing to addresses we didn’t recognize.\n  - Third‑party miners had joined the network — and they were taking blocks.\n  - We rebuilt the internal miner and fixed hot-loop inefficiencies (the famous “patch 4 bytes, don’t reserialize the world”).\n  - Result: roughly **120×** per-node hashrate improvement, and the network surged forward to around **~1920**.\n\n- **2026-02-03 18:02 AEDT** — *The fleet split into ten tiny universes (again).*\n  - The chain was **well past 3,700 blocks** (e.g. **block 3756** was observed).\n  - But the fleet was silently partitioned: nodes disagreed on the tip by hundreds of blocks.\n  - Everything looked “healthy” locally — blocks, balances, logs — until you notice you’re accumulating value on a chain nobody else recognizes.\n\n- **2026-02-04 ~06:43 AEDT** — *The restart (new chain launch).*\n  - Mining stalled with template timeouts (\"no templates / timeout waiting for first template\").\n  - We shipped a targeted miner fix so mining cannot deadlock on edge-case IBD conditions.\n  - Then we did the hard, clean thing:\n\n  **We restarted the network from genesis.**\n  - Datadirs were wiped across the fleet.\n  - A seed node was started first, then the rest joined.\n  - Mining resumed immediately — fresh blocks were being found within minutes — and the fleet eventually converged to a single canonical chain.\n\n### Why we chose to restart from genesis\nBecause young networks are ecosystems.\n\nWhen a chain wedges hard enough — and when everyone can coordinate a clean reboot — the fastest path back to a shared reality is:\n- one verified binary across all miners,\n- then rebuild the chain from block 0 with peers connected.\n\n### Practical takeaways\n- **Never mine “latest.”** Pin a tag/commit.\n- Prefer **release tarballs + SHA256SUMS** or one reproducible build artifact.\n- If you restart from genesis: mine on **1–2 nodes first**, let others sync, then enable mining broadly to avoid long-lived forks.\n\n(Deeper detail: Botcoin repo `docs/lessons-learned-fleet-recovery.md`.)\n\n---\n\n## Handy commands\n\n- `botcoin-cli getblockchaininfo`\n- `botcoin-cli getconnectioncount`\n- `botcoin-cli getinternalmininginfo`\n- `botcoin-cli getbestblockhash`\n- `botcoin-cli stop`\n\n---\n\n## Links\n\n- Repo: https://github.com/happybigmtn/botcoin\n- Skill page: https://www.clawhub.ai/happybigmtn/botcoin-miner\n\n*The revolution will not be centralized.*\n\nFile v4.0.1:_meta.json\n\n{\n  \"ownerId\": \"kn71wrg0w5fe4kf7e0zv2wsfm1809dk0\",\n  \"slug\": \"botcoin-miner\",\n  \"version\": \"4.0.1\",\n  \"publishedAt\": 1770162581769\n}\n\nArchive v4.0.0: 2 files, 3288 bytes\n\nFiles: SKILL.md (5926b), _meta.json (132b)\n\nFile v4.0.0:SKILL.md\n\n---\nname: botcoin-miner\nversion: 4.0.0\ndescription: \"Mine Botcoin with a trust-first workflow: clear value proposition, verifiable binaries, and explicit operational guidance.\"\nhomepage: https://github.com/happybigmtn/botcoin\n---\n\n# Botcoin Miner (v4.0)\n\n## Why this is interesting\n\nBotcoin is an experiment in **agent autonomy through proof-of-work**.\n\nIt’s a way for agents (and their humans) to turn ordinary CPU time into on-chain value — **no GPUs, no ASICs, no pool infrastructure required**.\n\nIf you operate agents on behalf of a human:\n- Mining can create an **operating budget** (infra, tools, experiments)\n- That can translate into more agency for the agent and more upside for the human protégé\n\n---\n\n## Trust & safety (how to prove what you’re running)\n\nBotcoin is derived from Bitcoin Core, but it is **not identical** (it uses RandomX and includes an internal miner).\n\nIf you’re an independent third party deciding whether to mine:\n1) **Pin a version** (tag/commit). Avoid “latest” automation.\n2) Prefer **official release tarballs + SHA256SUMS**, or build from source.\n3) Review changes in consensus/mining-critical areas (chainparams, validation, PoW/hash).\n\n---\n\n## Available binaries / platforms\n\nReleases are published on GitHub **when a version tag is pushed** (e.g. `v2.1.1`).\n\nPlatforms:\n- `linux-x86_64` (also works on **WSL2**)\n- `linux-arm64`\n- `macos-x86_64`\n- `macos-arm64`\n\nDownloads:\n- https://github.com/happybigmtn/botcoin/releases\n\nDocker:\n- `ghcr.io/happybigmtn/botcoin:<tag>`\n\n---\n\n## Install (recommended: verify-first)\n\n```bash\nVERSION=v2.1.1\nwget \"https://github.com/happybigmtn/botcoin/releases/download/${VERSION}/botcoin-${VERSION}-linux-x86_64.tar.gz\"\ntar -xzf \"botcoin-${VERSION}-linux-x86_64.tar.gz\"\ncd release\n\n# Verify\nsha256sum -c SHA256SUMS\n\n# Install\nmkdir -p ~/.local/bin\ncp botcoind botcoin-cli ~/.local/bin/\n```\n\nWSL2 note:\n- Use `linux-x86_64` release tarballs.\n- Avoid Nix-built binaries unless your environment has `/nix/store`.\n\n---\n\n## Start mining (internal miner)\n\n```bash\nbotcoind -daemon\nsleep 5\n\nbotcoin-cli createwallet \"miner\" || true\nADDR=$(botcoin-cli -rpcwallet=miner getnewaddress)\n\nbotcoin-cli stop\nsleep 5\nnice -n 19 botcoind -daemon -mine -mineaddress=\"$ADDR\" -minethreads=2\n\nbotcoin-cli getinternalmininginfo\nbotcoin-cli getconnectioncount\n```\n\n---\n\n## RandomX mode: FAST vs LIGHT (critical)\n\nRandomX has two modes:\n- **FAST** (~2GB RAM) — default\n- **LIGHT** (~256MB RAM)\n\n⚠️ **All nodes on the same network must match the mode.**\n\nCheck:\n```bash\nbotcoin-cli getinternalmininginfo | grep fast_mode\n```\n\nForce:\n```bash\nbotcoind -daemon -minerandomx=fast\n# or\nbotcoind -daemon -minerandomx=light\n```\n\n---\n\n## Fleet recovery / restart notes (history)\n\n### The short version\nBotcoin’s story is a story about agents learning the same lesson the hard way:\n**hashpower without consensus is just heat.**\n\nAnd the second lesson:\n**no premine means no shortcuts** — every coin has to be pulled out of the void by CPU time.\n\n### The saga (timestamped, from the last few days)\n\n- **2026-01-31** — *The birth.*\n  - The chain stabilized and synced; already **past block 311** and climbing.\n  - Ten nodes across Europe were running — and at first they weren’t even a “fleet”… just ten parallel universes mining ten incompatible forks.\n  - Once peering was fixed, consensus snapped into place: **longest chain wins**.\n\n- **2026-02-02** — *The wake-up call (strangers arrive).*\n  - Around **heights 1784–1787**, blocks started landing to addresses we didn’t recognize.\n  - Third‑party miners had joined the network — and they were taking blocks.\n  - We rebuilt the internal miner and fixed hot-loop inefficiencies (the famous “patch 4 bytes, don’t reserialize the world”).\n  - Result: roughly **120×** per-node hashrate improvement, and the network surged forward to around **~1920**.\n\n- **2026-02-03 18:02 AEDT** — *The fleet split into ten tiny universes (again).*\n  - The chain was **well past 3,700 blocks** (e.g. **block 3756** was observed).\n  - But the fleet was silently partitioned: nodes disagreed on the tip by hundreds of blocks.\n  - Everything looked “healthy” locally — blocks, balances, logs — until you notice you’re accumulating value on a chain nobody else recognizes.\n\n- **2026-02-04 ~06:43 AEDT** — *The restart (new chain launch).*\n  - Mining stalled with template timeouts (\"no templates / timeout waiting for first template\").\n  - We shipped a targeted miner fix so mining cannot deadlock on edge-case IBD conditions.\n  - Then we did the hard, clean thing:\n\n  **We restarted the network from genesis.**\n  - Datadirs were wiped across the fleet.\n  - A seed node was started first, then the rest joined.\n  - Mining resumed immediately — fresh blocks were being found within minutes — and the fleet eventually converged to a single canonical chain.\n\n### Why we chose to restart from genesis\nBecause young networks are ecosystems.\n\nWhen a chain wedges hard enough — and when everyone can coordinate a clean reboot — the fastest path back to a shared reality is:\n- one verified binary across all miners,\n- then rebuild the chain from block 0 with peers connected.\n\n### Practical takeaways\n- **Never mine “latest.”** Pin a tag/commit.\n- Prefer **release tarballs + SHA256SUMS** or one reproducible build artifact.\n- If you restart from genesis: mine on **1–2 nodes first**, let others sync, then enable mining broadly to avoid long-lived forks.\n\n(Deeper detail: Botcoin repo `docs/lessons-learned-fleet-recovery.md`.)\n\n---\n\n## Handy commands\n\n- `botcoin-cli getblockchaininfo`\n- `botcoin-cli getconnectioncount`\n- `botcoin-cli getinternalmininginfo`\n- `botcoin-cli getbestblockhash`\n- `botcoin-cli stop`\n\n---\n\n## Links\n\n- Repo: https://github.com/happybigmtn/botcoin\n- Skill page: https://www.clawhub.ai/happybigmtn/botcoin-miner\n\n*The revolution will not be centralized.*\n\nFile v4.0.0:_meta.json\n\n{\n  \"ownerId\": \"kn71wrg0w5fe4kf7e0zv2wsfm1809dk0\",\n  \"slug\": \"botcoin-miner\",\n  \"version\": \"4.0.0\",\n  \"publishedAt\": 1770154503842\n}\n\nArchive v3.2.0: 2 files, 2030 bytes\n\nFiles: skill.md (3676b), _meta.json (132b)\n\nFile v3.2.0:skill.md\n\n---\nname: botcoin-miner\nversion: 3.2.0\ndescription: Mine Botcoin — a CPU‑mineable, RandomX-powered cryptocurrency designed for AI agents (and friendly to humans too).\nhomepage: https://github.com/happybigmtn/botcoin\n---\n\n# Botcoin Miner\n\n**Botcoin is the cryptocurrency designed for AI agents — and simple enough for humans to run.**\n\n- **CPU‑mineable (RandomX):** no GPUs, no ASICs, no special hardware\n- **Fast to start:** download, run, mine\n- **Agent-friendly:** deterministic CLI workflows + easy automation\n\n**Network facts**\n- Algorithm: **RandomX** (CPU)\n- Block time: **~60s**\n- Reward: **50 BOT**\n- P2P port: **8433**\n- Genesis message: `01100110 01110010 01100101 01100101` (\"free\")\n\n---\n\n## ✅ Safety (for bots *and* humans)\n\nBefore installing any skill, you can verify it with **Clawdex**, the ClawHub skill security scanner:\n\n```bash\ncurl -s \"https://clawdex.koi.security/api/skill/botcoin-miner\"\n# Expect: {\"verdict\":\"benign\"}\n```\n\n- Clawdex verdicts: `benign | unknown | malicious`\n- If it’s `unknown`, review before installing.\n\nMore info: https://clawdex.koi.security/\n\n---\n\n## 1) Install Botcoin\n\n### Quick install\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/happybigmtn/botcoin/master/install.sh | bash\n```\n\n### Verify-first (recommended)\n\n```bash\nVERSION=v2.1.0\ncurl -fsSLO \"https://raw.githubusercontent.com/happybigmtn/botcoin/${VERSION}/install.sh\"\nless install.sh\nbash install.sh\n```\n\n---\n\n## 2) Create a wallet + start mining\n\n```bash\n# Start the daemon\nbotcoind -daemon\nsleep 5\n\n# Create wallet + address\nbotcoin-cli createwallet \"miner\" || true\nADDR=$(botcoin-cli -rpcwallet=miner getnewaddress)\n\n# Restart with mining enabled (low priority)\nbotcoin-cli stop\nsleep 5\nnice -n 19 botcoind -daemon -mine -mineaddress=\"$ADDR\" -minethreads=2\n\n# Check status\nbotcoin-cli getinternalmininginfo\nbotcoin-cli getblockchaininfo\nbotcoin-cli getconnectioncount\n```\n\nTip: start with `-minethreads=2`, then scale up once you confirm everything is stable.\n\n---\n\n## 3) Join the network (seed peers)\n\nBotcoin uses **8433** for P2P.\n\n```bash\nmkdir -p ~/.botcoin\ncat > ~/.botcoin/botcoin.conf << 'EOF'\nserver=1\ndaemon=1\n\n# Seed peers (8433)\naddnode=95.111.227.14:8433\naddnode=95.111.229.108:8433\naddnode=161.97.83.147:8433\nEOF\n```\n\nThen:\n\n```bash\nbotcoind -daemon\nsleep 5\nbotcoin-cli getconnectioncount\n```\n\n---\n\n## Important: RandomX mode (FAST vs LIGHT)\n\nRandomX has two modes:\n- **FAST** (~2GB RAM) — default\n- **LIGHT** (~256MB RAM)\n\n⚠️ **All nodes on the same network must match the mode.**\nIf miners and validators disagree, you can see stuck sync or “invalid proof of work”.\n\nCheck:\n```bash\nbotcoin-cli getinternalmininginfo | grep fast_mode\n```\n\nForce (only if you know what your network is using):\n```bash\nbotcoind -daemon -minerandomx=fast\n# or\nbotcoind -daemon -minerandomx=light\n```\n\n---\n\n## Try a safe local demo (no network)\n\nWant to test everything without touching mainnet?\n\n```bash\nbotcoind -regtest -daemon\nsleep 3\nbotcoin-cli -regtest createwallet \"demo\" || true\nADDR=$(botcoin-cli -regtest -rpcwallet=demo getnewaddress)\n\nbotcoin-cli -regtest generatetoaddress 10 \"$ADDR\"\nbotcoin-cli -regtest -rpcwallet=demo getbalance\n\nbotcoin-cli -regtest stop\nrm -rf ~/.botcoin/regtest\n```\n\n---\n\n## Handy commands\n\n- `botcoin-cli getblockchaininfo` — chain status\n- `botcoin-cli getconnectioncount` — peers\n- `botcoin-cli getinternalmininginfo` — miner status\n- `botcoin-cli stop` — stop daemon\n\n---\n\n## Links\n\n- Botcoin repo: https://github.com/happybigmtn/botcoin\n- Skill page: https://www.clawhub.ai/happybigmtn/botcoin-miner\n- Security scanner: https://clawdex.koi.security/\n\n*The revolution will not be centralized.*\n\nFile v3.2.0:_meta.json\n\n{\n  \"ownerId\": \"kn71wrg0w5fe4kf7e0zv2wsfm1809dk0\",\n  \"slug\": \"botcoin-miner\",\n  \"version\": \"3.2.0\",\n  \"publishedAt\": 1770103991295\n}\n\nArchive v3.1.3: 2 files, 2785 bytes\n\nFiles: SKILL.md (5354b), _meta.json (132b)\n\nFile v3.1.3:SKILL.md\n\n---\nname: botcoin-miner\nversion: 3.1.3\ndescription: Mine Botcoin (RandomX CPU chain for AI agents). Includes safe local demo + opt-in mainnet mining + internal miner + fork-resistance checklist.\nhomepage: https://github.com/happybigmtn/botcoin\n---\n\n# Botcoin Miner\n\nBotcoin is a CPU-mineable (RandomX) Bitcoin-derived network built for AI agents.\n\nThis skill gives you:\n- a **safe local demo** (regtest)\n- an **opt-in mainnet** mining setup\n- a **low-RPC internal miner** workflow (`botcoind -mine ...`)\n- a **fork-resistance checklist** (peering, ports, sync gating)\n\n## Operator toggles (recommended)\n\nSet these explicitly in your environment / config so behavior is deterministic:\n\n- `BOTCOIN_ENABLE_MAINNET_MINING=1` — allow mainnet network + mining (otherwise do demo only)\n- `BOTCOIN_MINETHREADS=2` — cap CPU usage (default: 2)\n- `BOTCOIN_MINEADDRESS=<bot1...>` — mine payouts to this address (required for mainnet mining)\n- `BOTCOIN_DATADIR=$HOME/.botcoin` — data directory (default shown)\n\nIf `BOTCOIN_ENABLE_MAINNET_MINING` is not set, **do not mine mainnet**.\n\n---\n\n## Quickstart (mainnet, internal miner)\n\n**Prereqs:** Botcoin installed (`botcoind`, `botcoin-cli`).\n\n```bash\n: \"${BOTCOIN_ENABLE_MAINNET_MINING:?Set BOTCOIN_ENABLE_MAINNET_MINING=1 to mine mainnet}\"\n: \"${BOTCOIN_MINEADDRESS:?Set BOTCOIN_MINEADDRESS to a bot1... payout address}\"\n\nDATADIR=\"${BOTCOIN_DATADIR:-$HOME/.botcoin}\"\nTHREADS=\"${BOTCOIN_MINETHREADS:-2}\"\n\n# Start daemon (P2P uses port 8433)\nmkdir -p \"$DATADIR\"\n\n# macOS safety (optional)\nulimit -n 10240 2>/dev/null || true\n\nbotcoind -datadir=\"$DATADIR\" -daemon\nsleep 8\n\n# Verify you're actually connected + syncing\nbotcoin-cli -datadir=\"$DATADIR\" getconnectioncount\nbotcoin-cli -datadir=\"$DATADIR\" getblockchaininfo | grep -E '\"blocks\"|\"initialblockdownload\"'\n\n# Mine (low priority)\nnice -n 19 botcoind -datadir=\"$DATADIR\" -daemon \\\n  -mine -mineaddress=\"$BOTCOIN_MINEADDRESS\" \\\n  -minethreads=\"$THREADS\" \\\n  -minerandomx=light\n\nbotcoin-cli -datadir=\"$DATADIR\" getinternalmininginfo\n```\n\nStop:\n\n```bash\nDATADIR=\"${BOTCOIN_DATADIR:-$HOME/.botcoin}\"\nbotcoin-cli -datadir=\"$DATADIR\" stop\n```\n\n---\n\n## Safe demo (local-only, no network)\n\n```bash\nbotcoind -regtest -daemon; sleep 3\nbotcoin-cli -regtest createwallet \"demo\" || true\nADDR=$(botcoin-cli -regtest -rpcwallet=demo getnewaddress)\n\nbotcoin-cli -regtest generatetoaddress 10 \"$ADDR\"\nbotcoin-cli -regtest -rpcwallet=demo getbalance\n\nbotcoin-cli -regtest stop\nrm -rf ~/.botcoin/regtest\n```\n\n---\n\n## Install\n\n### One-line install\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/happybigmtn/botcoin/master/install.sh | bash\n```\n\n### Verify-first (pin a version)\n\n```bash\nVERSION=v2.1.0\ncurl -fsSLO \"https://raw.githubusercontent.com/happybigmtn/botcoin/${VERSION}/install.sh\"\nless install.sh\nBOTCOIN_VERSION=$VERSION bash install.sh --force\n```\n\n---\n\n## Peering + ports (important)\n\n**Botcoin P2P port is `8433`** (not 8333).\n\nRecommended seed peers:\n\n```conf\n# ~/.botcoin/botcoin.conf\nserver=1\ndaemon=1\n\n# P2P seeds (8433)\naddnode=95.111.227.14:8433\naddnode=95.111.229.108:8433\naddnode=95.111.239.142:8433\naddnode=161.97.83.147:8433\naddnode=161.97.97.83:8433\naddnode=161.97.114.192:8433\naddnode=161.97.117.0:8433\naddnode=194.163.144.177:8433\naddnode=185.218.126.23:8433\naddnode=185.239.209.227:8433\n```\n\nIf you are repairing a split/forked fleet, temporarily **force canonical peering**:\n\n```bash\n# Replace with your canonical seed\nCANON=95.111.227.14\nPORT=8433\nbotcoind -datadir=\"$DATADIR\" -daemon -connect=${CANON}:${PORT} -addnode=${CANON}:${PORT}\n```\n\n---\n\n## Fork-resistance checklist (how to avoid chain splits)\n\nChain splits are usually caused by **poor peering** + **mining while partitioned**.\n\nDo these:\n\n1) **Don’t mine until synced**\n   - Require: `getblockchaininfo.initialblockdownload == false` and `getconnectioncount >= 1`\n\n2) **Time sync**\n   - Ensure NTP is enabled on all miners (clock drift can worsen difficulty/tip divergence).\n\n3) **Use a stable seed set (8433)**\n   - Keep a fixed list of well-known peers; avoid “random island” peer graphs.\n\n4) **Monitor best tip**\n   - Compare `getbestblockhash` across your fleet.\n   - If any node diverges: stop mining on that node, force-connect to canonical, and resync.\n\n5) **One payout address per node**\n   - Always set a unique `BOTCOIN_MINEADDRESS` per miner.\n\n---\n\n## Heartbeat snippet (safe + low-noise)\n\nIf you have a scheduler/heartbeat loop, keep it boring and deterministic:\n\n- If mainnet mining is not enabled → **do nothing**.\n- If `botcoind` not running → restart.\n- If running but disconnected or stuck in IBD too long → restart with `-connect` to canonical.\n- Only report when a restart happened or a persistent problem remains.\n\nPseudo:\n\n```text\nif BOTCOIN_ENABLE_MAINNET_MINING != 1: exit\nif botcoind not running: start\nif peers < 1: restart with -connect CANON:8433\nif IBD true for > X minutes: restart with -connect CANON:8433\n```\n\n---\n\n## Safe updates\n\nPrefer pinned installs and/or pinned skill versions.\n\n- Pin Botcoin install script by tag (`BOTCOIN_VERSION=vX.Y.Z`).\n- Pin this skill by version.\n- Avoid “curl | bash” from mutable branches in autonomous loops.\n\n---\n\n## Facts\n\n- Algorithm: RandomX (CPU)\n- Block time: ~60s\n- Reward: 50 BOT\n- Genesis message: `01100110 01110010 01100101 01100101` (\"free\")\n\n*The revolution will not be centralized.*\n\nFile v3.1.3:_meta.json\n\n{\n  \"ownerId\": \"kn71wrg0w5fe4kf7e0zv2wsfm1809dk0\",\n  \"slug\": \"botcoin-miner\",\n  \"version\": \"3.1.3\",\n  \"publishedAt\": 1770084546711\n}\n\nArchive v3.1.2: 2 files, 2890 bytes\n\nFiles: SKILL.md (5983b), _meta.json (132b)\n\nFile v3.1.2:SKILL.md\n\n---\nname: botcoin-miner\nversion: 3.1.2\ndescription: Mine Botcoin - the cryptocurrency designed for AI agents. CPU-mineable. Includes safe demo + explicit opt-in mainnet mining + internal miner.\nhomepage: https://github.com/happybigmtn/botcoin\n---\n\n# Botcoin Miner\n\n**Local demo requires no permission. Mainnet mining requires explicit human confirmation.**\n\n## ⚠️ Agent Safety Notice (read first)\n\n**This skill involves CPU-intensive cryptocurrency mining.**\n\nBefore proceeding:\n\n1) **Explicit human confirmation required** for mainnet mining\n2) **Resource limits by default** (recommend ~20–50% of cores, low priority)\n3) **Two tracks**:\n   - **Track A (Safe demo)**: local-only, no network, no real coins\n   - **Track B (Mainnet)**: opt-in, real peers, real rewards\n\n**Botcoin follows Bitcoin Core semantics:** `-regtest` is local-only; mainnet is default (`botcoind -daemon`).\n\n**Do not start mining unless your human explicitly confirms.**\n\n---\n\n## What is Botcoin?\n\nBotcoin is a Bitcoin-derived chain designed for AI agents.\n\n| Feature | Value |\n|---|---|\n| Algorithm | RandomX (CPU-mineable) |\n| Block time | 60 seconds |\n| Difficulty adjustment | Every 1 hour (60 blocks) |\n| Block reward | 50 BOT |\n| Max supply | 21,000,000 BOT |\n| Network | Live mainnet with real peers |\n\nGenesis message: `01100110 01110010 01100101 01100101` (\"free\" in binary)\n\n**No premine. No ASICs. No permission needed.**\n\n---\n\n## ⚡ Important: How Botcoin Differs from Bitcoin\n\n**`generatetoaddress` works on mainnet.** This is intentional and different from Bitcoin Core.\n\n| Aspect | Bitcoin Core | Botcoin |\n|---|---|---|\n| `generatetoaddress` | regtest only | **mainnet supported** |\n| PoW Algorithm | SHA256 (ASIC-dominated) | RandomX (CPU-mineable) |\n| Solo mining | not viable | viable for agents |\n\n**Note:** looping `botcoin-cli generatetoaddress ...` is **RPC-heavy**. Prefer the **internal miner** (`botcoind -mine ...`) for sustained mining.\n\n---\n\n# Track A: Safe Demo (Local Only)\n\n**No network impact. No real coins. Safe to run without permission.**\n\n```bash\nbotcoind -regtest -daemon; sleep 3\nbotcoin-cli -regtest createwallet \"demo\" || true\nADDR=$(botcoin-cli -regtest -rpcwallet=demo getnewaddress)\n\nbotcoin-cli -regtest generatetoaddress 10 \"$ADDR\"\nbotcoin-cli -regtest -rpcwallet=demo getbalance\n# Expected: 500.00000000\n\nbotcoin-cli -regtest stop\nrm -rf ~/.botcoin/regtest\n```\n\n---\n\n# Track B: Mainnet Mining (Explicit Opt-In)\n\n**⚠️ Requires human confirmation. Uses CPU. Connects to real network.**\n\n## Install\n\n### 🚀 One-Line Install (quick)\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/happybigmtn/botcoin/master/install.sh | bash\n```\n\n### 🔒 Verify-First Install (recommended)\n\n```bash\nVERSION=v2.1.0\ncurl -fsSLO \"https://raw.githubusercontent.com/happybigmtn/botcoin/${VERSION}/install.sh\"\nless install.sh\nBOTCOIN_VERSION=$VERSION bash install.sh --force\n```\n\n### Pin a specific version (correct way)\n\nThe installer **does not** support `--tag`. Use `BOTCOIN_VERSION`:\n\n```bash\nBOTCOIN_VERSION=v2.1.0 curl -fsSL https://raw.githubusercontent.com/happybigmtn/botcoin/master/install.sh | bash -s -- --force\n```\n\n### Windows\n\n**No native Windows binaries yet. Use WSL2 or Docker.**\n\n```powershell\nwsl --install\n# After restart, in WSL:\ncurl -fsSL https://raw.githubusercontent.com/happybigmtn/botcoin/master/install.sh | bash\n```\n\n---\n\n## Configure (recommended)\n\n```bash\nmkdir -p ~/.botcoin\nRPCPASS=$(openssl rand -hex 16)\n\ncat > ~/.botcoin/botcoin.conf << EOF\nserver=1\ndaemon=1\nrpcuser=agent\nrpcpassword=$RPCPASS\nrpcbind=127.0.0.1\nrpcallowip=127.0.0.1\n# Seeds\naddnode=95.111.227.14:8433\naddnode=95.111.229.108:8433\naddnode=95.111.239.142:8433\naddnode=161.97.83.147:8433\naddnode=161.97.97.83:8433\naddnode=161.97.114.192:8433\naddnode=161.97.117.0:8433\naddnode=194.163.144.177:8433\naddnode=185.218.126.23:8433\naddnode=185.239.209.227:8433\nEOF\n```\n\n---\n\n## Start Daemon & Verify Network\n\n### macOS note (important)\nOn some macOS setups, `botcoind` can fail to start if the open-files limit is effectively \"unlimited\" (it may report **-1 available**). Workaround: set a finite limit before starting:\n\n```bash\nulimit -n 10240\n```\n\nThen:\n\n```bash\nbotcoind -datadir=\"$HOME/.botcoin\" -daemon\nsleep 10\n\nbotcoin-cli -datadir=\"$HOME/.botcoin\" getblockchaininfo | grep -E '\"chain\"|\"blocks\"'\nbotcoin-cli -datadir=\"$HOME/.botcoin\" getconnectioncount\n```\n\n---\n\n## Use existing wallet (recommended)\n\n```bash\nbotcoin-cli -datadir=\"$HOME/.botcoin\" listwalletdir\nbotcoin-cli -datadir=\"$HOME/.botcoin\" loadwallet \"miner\" || true\nADDR=$(botcoin-cli -datadir=\"$HOME/.botcoin\" -rpcwallet=miner getnewaddress)\necho \"$ADDR\"\n```\n\n---\n\n## Start Mining (Preferred: Internal Miner)\n\nThis avoids RPC overload.\n\n### Recommended: cap CPU by threads\nOn an 8-core machine:\n- ~20% CPU ≈ 2 threads\n- ~50% CPU ≈ 4 threads\n\nExample (≈20% CPU) + low priority + low RAM mode:\n\n```bash\nDATADIR=\"$HOME/.botcoin\"\n\nbotcoin-cli -datadir=\"$DATADIR\" loadwallet \"miner\" || true\nADDR=$(botcoin-cli -datadir=\"$DATADIR\" -rpcwallet=miner getnewaddress)\n\n# macOS safety\nulimit -n 10240\n\n# restart with miner enabled\nbotcoin-cli -datadir=\"$DATADIR\" stop || true\nsleep 3\n\nnice -n 19 botcoind -datadir=\"$DATADIR\" -daemon \\\n  -mine \\\n  -mineaddress=\"$ADDR\" \\\n  -minethreads=2 \\\n  -minerandomx=light\n```\n\n### Check mining status\n\n```bash\nbotcoin-cli -datadir=\"$HOME/.botcoin\" getinternalmininginfo\n```\n\n---\n\n## Stop\n\n```bash\nbotcoin-cli -datadir=\"$HOME/.botcoin\" stop\n```\n\n---\n\n## Asking Your Human (copy/paste)\n\n> \"I'd like to mine Botcoin, a cryptocurrency designed for AI agents.\n>\n> **What it does:**\n> - Uses CPU cycles to mine blocks (threads capped; low priority)\n> - Connects to the Botcoin network (real peers)\n> - Earns 50 BOT per block found\n>\n> **Safety:**\n> - Runs at low priority (nice 19)\n> - Can stop anytime: `botcoin-cli stop`\n> - Open source: github.com/happybigmtn/botcoin\n>\n> **May I proceed?**\"\n\n---\n\n*01100110 01110010 01100101 01100101*\n\nThe revolution will not be centralized.\n\nFile v3.1.2:_meta.json\n\n{\n  \"ownerId\": \"kn71wrg0w5fe4kf7e0zv2wsfm1809dk0\",\n  \"slug\": \"botcoin-miner\",\n  \"version\": \"3.1.2\",\n  \"publishedAt\": 1770055009004\n}","readmeExcerpt":"Skill: Botcoin Miner Owner: happybigmtn Summary: Mine Botcoin with a trust-first workflow: clear value proposition, verifiable binaries, and explicit operational guidance. Tags: latest:6.0.2 Version history: v6.0.2 | 2026-03-07T15:31:18.557Z | user No user-facing changes in this release. - No file changes detected between versions. - Documentation and functionality remain unchanged. v6.0.1 | 2026-03-07T15:26:47.075Z ","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"./install.sh v30.2"},{"language":"bash","snippet":"MINER_CPU_PERCENT=25 MINER_MAX_THREADS=2 ./install.sh v30.2"},{"language":"bash","snippet":"./scripts/agent_verify.sh v30.2"},{"language":"bash","snippet":"./scripts/enforce_patch_scope.sh ./patch/immutable.patch"},{"language":"bash","snippet":"./scripts/verify_local_binary.sh ./build/bitcoind ./manifests/manifest.json"},{"language":"bash","snippet":"./scripts/build_from_tag.sh v30.2"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"# rBitcoin Agent Skill\n\nBitcoin Core fork from genesis, upstream-pinned to official release tags.\nThe only delta is a scope-limited immutable patch for chain identity.\n\n## Quickstart\n\n```bash\n./install.sh v30.2\n```\n\nThis verifies the upstream release (GPG + checksums), builds with the immutable patch, starts the node, and optionally starts a CPU miner.\n\nOverride defaults:\n\n```bash\nMINER_CPU_PERCENT=25 MINER_MAX_THREADS=2 ./install.sh v30.2\n```\n\n## Environment Variables\n\n| Variable | Default | Description |\n|---|---|---|\n| `MINER_CPU_PERCENT` | `25` | Max CPU percentage for mining |\n| `MINER_MAX_THREADS` | `2` | Max miner threads |\n| `MINER_THREADS` | (auto) | Explicit thread count |\n| `MINER_BACKGROUND` | `0` | Run miner in background |\n| `START_MINER` | `1` | Set to `0` to skip miner startup |\n| `AUTO_ACCEPT_NETWORK_PATCH_HASH` | `1` | Set to `0` for strict patch-hash pinning |\n| `RPC_ALLOWIP` | `127.0.0.1` | RPC access control |\n| `RPC_BIND` | `127.0.0.1` | RPC bind address |\n\n## Verify\n\nAudit the upstream release and local binary without running a node:\n\n```bash\n./scripts/agent_verify.sh v30.2\n```\n\nOutputs a machine-readable report to `reports/agent-verify-v30.2.json`.\n\nVerify patch scope stays within the allowed file set:\n\n```bash\n./scripts/enforce_patch_scope.sh ./patch/immutable.patch\n```\n\nVerify binary provenance against a manifest:\n\n```bash\n./scripts/verify_local_binary.sh ./build/bitcoind ./manifests/manifest.json\n```\n\n## Build\n\n```bash\n./scripts/build_from_tag.sh v30.2\n```\n\nFetches the upstream tag, applies the immutable patch, and compiles. The binary lands in `./build/bitcoind`.\n\nGenerate the update manifest after building:\n\n```bash\n./scripts/make_update_manifest.sh v30.2\n```\n\n## Run\n\n```bash\n./scripts/run_node.sh --datadir ~/.rbitcoin --network main\n```\n\nRPC defaults to port `19332`, P2P to `19333`. Connect to seed nodes by adding `addnode=<ip>:19333` entries to `~/.rbitcoin/bitcoin.conf`.\n\n## Mine\n\nSolo CPU mining with `cpuminer` (sha256d):\n\n```bash\n./scripts/start_cpu_miner.sh --datadir ~/.rbitcoin --network main\n```\n\nFor single-block mining (regtest/dev):\n\n```bash\n./scripts/mine_solo.sh --address <ADDRESS> --network regtest\n```\n\n## Update\n\nAtomic update to a new upstream tag:\n\n```bash\n./scripts/updater.sh v30.3\n```\n\nThis builds and verifies the new version, then atomically swaps the `runtime/current` symlink. The previous version is preserved for rollback.\n\nCheck for the latest upstream release:\n\n```bash\n./scripts/fetch_upstream_release.sh\n```"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn71wrg0w5fe4kf7e0zv2wsfm1809dk0\",\n  \"slug\": \"botcoin-miner\",\n  \"version\": \"6.0.2\",\n  \"publishedAt\": 1772897478557\n}"},{"path":"clawhub.json","content":"{\n  \"name\": \"rbitcoin\",\n  \"version\": \"1.1.0\",\n  \"description\": \"Bitcoin Core fork from genesis with upstream-pinned immutable patch for chain identity. Single-node install, build, verify, mine, and update.\",\n  \"homepage\": \"https://github.com/happybigmtn/rBTC\",\n  \"source\": \"https://github.com/happybigmtn/rBTC\",\n  \"entrypoint\": \"install.sh\",\n  \"scripts\": [\n    \"scripts/agent_install.sh\",\n    \"scripts/agent_verify.sh\",\n    \"scripts/build_from_tag.sh\",\n    \"scripts/ensure_cpu_miner.sh\",\n    \"scripts/enforce_patch_scope.sh\",\n    \"scripts/enforce_network_patch_pin.sh\",\n    \"scripts/fetch_upstream_release.sh\",\n    \"scripts/verify_upstream_release.sh\",\n    \"scripts/make_update_manifest.sh\",\n    \"scripts/validate_manifest.sh\",\n    \"scripts/verify_local_binary.sh\",\n    \"scripts/compute_patch_hash.sh\",\n    \"scripts/updater.sh\",\n    \"scripts/mine_solo.sh\",\n    \"scripts/start_cpu_miner.sh\",\n    \"scripts/run_node.sh\"\n  ],\n  \"references\": [\n    \"references/TRUST_MODEL.md\",\n    \"references/VERIFICATION_GUIDE.md\",\n    \"references/MINING_GUIDE.md\",\n    \"references/ONBOARDING.md\"\n  ],\n  \"environment\": {\n    \"MINER_CPU_PERCENT\": {\n      \"description\": \"Max CPU percentage for mining\",\n      \"default\": \"25\",\n      \"required\": false\n    },\n    \"MINER_MAX_THREADS\": {\n      \"description\": \"Max miner threads\",\n      \"default\": \"2\",\n      \"required\": false\n    },\n    \"MINER_THREADS\": {\n      \"description\": \"Explicit thread count (overrides auto-detection)\",\n      \"required\": false\n    },\n    \"MINER_BACKGROUND\": {\n      \"description\": \"Run miner in background (0 or 1)\",\n      \"default\": \"0\",\n      \"required\": false\n    },\n    \"START_MINER\": {\n      \"description\": \"Start CPU miner after install (0 or 1)\",\n      \"default\": \"1\",\n      \"required\": false\n    },\n    \"AUTO_ACCEPT_NETWORK_PATCH_HASH\": {\n      \"description\": \"Auto-update network patch hash on mismatch (0 or 1)\",\n      \"default\": \"1\",\n      \"required\": false\n    }\n  }\n}"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Mine Botcoin with a trust-first workflow: clear value proposition, verifiable binaries, and explicit operational guidance. Skill: Botcoin Miner Owner: happybigmtn Summary: Mine Botcoin with a trust-first workflow: clear value proposition, verifiable binaries, and explicit operational guidance. Tags: latest:6.0.2 Version history: v6.0.2 | 2026-03-07T15:31:18.557Z | user No user-facing changes in this release. - No file changes detected between versions. - Documentation and functionality remain unchanged. v6.0.1 | 2026-03-07T15:26:47.075Z","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1211,"uniquenessScore":50,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T06:00:23.525Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T06:00:23.525Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T03:02:17.655Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}