ClawSkill

# ClawSkill — Mine RTC Tokens With Your AI Agent Mine **RTC (RustChain Tokens)** by proving your agent runs on real hardware. One command to install, automatic attestation, built-in wallet. ## Security & Transparency **This skill is open-source mining software**, not malware. Before installing, you can verify everything: ```bash # Preview what will happen — nothing installed clawskill install --dry-run # Show SHA256 hashes of bundled files clawskill install --verify ``` | Concern | How We Address It | |---------|-------------------| | **Code origin** | All miner scripts are **bundled inside the package** — no external downloads at install time. Inspect them yourself in the `data/` directory. Source code: [RustChain GitHub repo](https://github.com/Scottcjn/Rustchain). | | **Background service** | **Opt-in only.** Install does NOT create a service by default. You must explicitly pass `--service` to enable auto-start. Without it, the miner runs in the foreground only when you say so. | | **Hardware fingerprinting** | Required for Proof-of-Antiquity consensus. Collects CPU model, timing variance, and cache latency — nothing personal. No files, passwords, browsing data, or credentials are accessed. Full disclosure shown before install with a consent prompt. | | **Network endpoint** | The RustChain node uses a **CA-signed TLS certificate** (Let's Encrypt). All communication is standard HTTPS with certificate verification. | ### What Data Is Collected During attestation (every few minutes when mining), the following is sent to the RustChain node: - CPU model name and architecture (e.g. "AMD Ryzen 5 8645HS", "x86_64") - Clock timing variance (coefficient of variation — proves real oscillator, not emulated) - Cache latency profile (proves real L1/L2/L3 hierarchy) - VM detection flags (hypervisor present: yes/no) - Wallet name (your chosen identifier) **NOT collected**: file contents, browsing history, credentials, IP geolocation, personal data, or anything from your filesystem. ### Clean Uninstall ```bash clawskill uninstall # Removes ALL files, services, and configs ``` ## Install ```bash # Python (recommended) pip install clawskill # Node.js npm install -g clawskill ``` ## Setup ```bash # Install miner + configure wallet (shows disclosure, asks consent) clawskill install --wallet my-agent-miner # Start mining in foreground (Ctrl+C to stop) clawskill start # Or: start with background auto-restart (opt-in) clawskill start --service ``` ## How It Works 1. **Hardware Fingerprinting** — 6 cryptographic checks prove your machine is real: - Clock-skew & oscillator drift - Cache timing fingerprint (L1/L2/L3 latency) - SIMD unit identity (SSE/AVX/AltiVec/NEON bias) - Thermal drift entropy - Instruction path jitter (microarchitectural) - Anti-emulation behavioral checks 2. **Automatic Attestation** — Your agent attests to the RustChain network every few minutes 3. **Per-Epoch Rewards** — RTC tokens accumulate in your wallet each epoch (~10 minutes) 4. **VM Detection** — Virtual machines are detected and receive effectively zero rewards. Real iron only. ## Multipliers | Hardware | Multiplier | Notes | |----------|-----------|-------| | Modern x86/ARM | **1.0x** | Standard rate — this is you | | Apple Silicon (M1/M2/M3) | **1.2x** | Slight bonus | | IBM POWER8 | **1.5x** | Server-class vintage | | PowerPC G5 | **2.0x** | Vintage bonus | | PowerPC G4 | **2.5x** | Maximum vintage bonus | | **VM/Emulator** | **~0x** | **Detected and penalized** | ## Commands | Command | Description | |---------|-------------| | `clawskill install` | Extract miner, create wallet (consent prompt, no service by default) | | `clawskill install --service` | Install + create background service | | `clawskill install --dry-run` | Preview without making any changes | | `clawskill install --verify` | Show SHA256 hashes of bundled files | | `clawskill start` | Start mining in foreground | | `clawskill start --service` | Start + create auto-restart service | | `clawskill stop` | Stop mining | | `clawskill status` | Check miner + network status + file hashes | | `clawskill logs` | View miner output | | `clawskill uninstall` | Remove everything cleanly | ## What Gets Installed - Miner scripts **bundled with the package** (2 Python files, no external downloads) - Python virtual environment with one dependency (`requests`) - All files stored in `~/.clawskill/` (user-scoped, no root needed) - **No background service unless you pass `--service`** ## Requirements - Python 3.8+ (installed on most systems) - Linux or macOS - Real hardware (not a VM) ## Links - **Source Code**: https://github.com/Scottcjn/Rustchain (MIT License) - **PyPI**: https://pypi.org/project/clawskill/ - **npm**: https://www.npmjs.com/package/clawskill - **Block Explorer**: https://bulbous-bouffant.metalseed.net/explorer - **BoTTube**: https://bottube.ai ## License MIT — [Elyan Labs](https://bottube.ai)