clawrtc 1.2.1 → 1.5.0

package/.github/workflows/build-windows.yml

@@ -0,0 +1,40 @@
+name: Build Windows Installer
+
+on:
+  push:
+    tags: ['clawrtc-v*']
+  workflow_dispatch:
+
+jobs:
+  build-windows:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: |
+          pip install pyinstaller requests
+          pip install -e .
+
+      - name: Build Windows exe
+        run: |
+          pyinstaller --onefile --name clawrtc --console clawrtc/cli.py
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: clawrtc-windows
+          path: dist/clawrtc.exe
+
+      - name: Upload to release
+        if: startsWith(github.ref, 'refs/tags/')
+        uses: softprops/action-gh-release@v1
+        with:
+          files: dist/clawrtc.exe
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Elyan Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# ClawRTC — Mine RTC Tokens With Your AI Agent
+
+Your Claw agent can earn **RTC (RustChain Tokens)** by proving it runs on **real hardware**. One command to install, automatic attestation, built-in wallet.
+
+## Quick Start
+
+```bash
+pip install clawrtc
+clawrtc install --wallet my-agent-miner
+clawrtc start
+```
+
+That's it. Your agent is now mining RTC.
+
+## How It Works
+
+1. **Hardware Fingerprinting** — 6 cryptographic checks prove your machine is real hardware (clock drift, cache timing, SIMD identity, thermal drift, instruction jitter, anti-emulation)
+2. **Attestation** — Your agent automatically attests to the RustChain network every few minutes
+3. **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 reward rate |
+| Apple Silicon (M1/M2/M3) | **1.2x** | Slight bonus |
+| PowerPC G5 | **2.0x** | Vintage bonus |
+| PowerPC G4 | **2.5x** | Maximum vintage bonus |
+| **VM/Emulator** | **~0x** | **Detected and penalized** |
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `clawrtc install` | Download miner, create wallet, set up service |
+| `clawrtc start` | Start mining in background |
+| `clawrtc stop` | Stop mining |
+| `clawrtc status` | Check miner + network status |
+| `clawrtc logs` | View miner output |
+| `clawrtc uninstall` | Remove everything |
+
+## What Gets Installed
+
+- Miner scripts from [RustChain repo](https://github.com/Scottcjn/Rustchain)
+- Python virtual environment with `requests` dependency
+- Systemd user service (Linux) or LaunchAgent (macOS)
+- All files in `~/.clawrtc/`
+
+## VM Warning
+
+RustChain uses **Proof-of-Antiquity (PoA)** consensus. The hardware fingerprint system detects:
+
+- QEMU / KVM / VMware / VirtualBox / Xen / Hyper-V
+- Hypervisor CPU flags
+- DMI vendor strings
+- Flattened timing distributions
+
+If you're running in a VM, the miner will install and attest, but your rewards will be effectively zero. This is by design — RTC rewards machines that bring real compute to the network.
+
+## Requirements
+
+- Python 3.8+
+- Linux or macOS (Windows installer coming soon)
+- Real hardware (not a VM)
+
+## Links
+
+- [RustChain Network](https://bottube.ai)
+- [Block Explorer](https://50.28.86.131/explorer)
+- [GitHub](https://github.com/Scottcjn/Rustchain)
+
+## License
+
+MIT — Elyan Labs

package/SKILL.md

@@ -0,0 +1,102 @@
+# ClawRTC
+
+Mine RTC tokens with your AI agent using Proof-of-Antiquity consensus.
+
+## What It Does
+
+- **One-command setup**: `pip install clawrtc && clawrtc install --wallet my-agent`
+- **Hardware fingerprinting**: 6 cryptographic checks prove your machine is real (clock drift, cache timing, SIMD identity, thermal entropy, instruction jitter, anti-emulation)
+- **Automatic attestation**: Attests to the RustChain network every few minutes
+- **Per-epoch rewards**: RTC tokens accumulate in your wallet each epoch (~10 minutes)
+- **VM detection**: Virtual machines are detected and receive effectively zero rewards
+
+## Security
+
+- **No post-install telemetry** — no network calls during pip install
+- **TLS verification enabled** — all RustChain API calls verify SSL certificates (CA-signed)
+- **Bundled code only** — all miner scripts ship with the package, no external downloads
+- **Consent required** — interactive approval prompt before installation
+- **Dry-run mode** — `clawrtc install --dry-run` previews without installing
+- **Hash verification** — `clawrtc install --verify` shows SHA256 of all bundled files
+- **Clean uninstall** — `clawrtc uninstall` removes all files, services, and configs
+- **No background service by default** — must explicitly pass `--service` to enable
+- **Source available** — full source at https://github.com/Scottcjn/Rustchain (MIT)
+
+### What Data Is Sent
+
+During attestation (when mining), the following is sent to the RustChain node:
+
+- CPU model name and architecture (e.g. "AMD Ryzen 5", "x86_64")
+- Clock timing variance (proves real oscillator)
+- Cache latency profile (proves real L1/L2/L3 hierarchy)
+- VM detection flags (hypervisor yes/no)
+- Wallet name (your chosen identifier)
+
+**NOT sent**: file contents, browsing history, credentials, IP geolocation, personal data.
+
+## Install
+
+```bash
+pip install clawrtc
+```
+
+## Usage
+
+```bash
+# Install miner + configure wallet
+clawrtc install --wallet my-agent
+
+# Start mining (foreground)
+clawrtc start
+
+# Check status
+clawrtc status
+
+# View logs
+clawrtc logs
+
+# Stop mining
+clawrtc stop
+
+# Clean uninstall
+clawrtc uninstall
+```
+
+## Multipliers
+
+| Hardware | Multiplier |
+|----------|-----------|
+| Modern x86/ARM | 1.0x |
+| Apple Silicon (M1-M3) | 1.2x |
+| PowerPC G5 | 2.0x |
+| PowerPC G4 | 2.5x |
+| VM/Emulator | ~0x (detected and penalized) |
+
+## Coinbase Wallet (v1.5.0)
+
+```bash
+# Create a Coinbase Base wallet
+pip install clawrtc[coinbase]
+clawrtc wallet coinbase create
+
+# Show wallet info
+clawrtc wallet coinbase show
+
+# Link existing Base address
+clawrtc wallet coinbase link 0xYourBaseAddress
+
+# USDC → wRTC swap guide
+clawrtc wallet coinbase swap-info
+```
+
+Requires CDP credentials from [portal.cdp.coinbase.com](https://portal.cdp.coinbase.com) for auto-creation. Manual linking works without credentials.
+
+## Links
+
+- Source: https://github.com/Scottcjn/Rustchain
+- PyPI: https://pypi.org/project/clawrtc/
+- npm: https://www.npmjs.com/package/clawrtc
+- Block Explorer: https://rustchain.org/explorer
+- Agent Wallets: https://rustchain.org/wallets.html
+- RustChain: https://rustchain.org
+- BoTTube: https://bottube.ai

package/clawrtc/__init__.py

@@ -0,0 +1,3 @@
+"""ClawRTC — Mine RTC tokens with your AI agent on any modern hardware."""
+
+__version__ = "1.5.0"