From a737004b16155c99c35265a16c1dca6da2dc8d02 Mon Sep 17 00:00:00 2001 From: xngo7993-hue Date: Tue, 3 Feb 2026 09:48:35 +0800 Subject: [PATCH] Add RustChain Protocol Specification v1.1 (RIP-200) --- docs/PROTOCOL_v1.1.md | 70 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 docs/PROTOCOL_v1.1.md diff --git a/docs/PROTOCOL_v1.1.md b/docs/PROTOCOL_v1.1.md new file mode 100644 index 0000000..ec99d0d --- /dev/null +++ b/docs/PROTOCOL_v1.1.md @@ -0,0 +1,70 @@ +# RustChain Protocol Specification v1.1 (RIP-200) + +## 1. Overview +**RustChain** is a Proof-of-Antiquity blockchain designed to validate and reward real vintage hardware. Unlike traditional Proof-of-Work, RustChain does not use hash-based mining. Instead, it utilizes **RIP-200 (RustChain Iterative Protocol)**, a Proof-of-Attestation consensus mechanism where miners prove they are running on specific physical hardware (e.g., PowerPC G4, G5, SPARC) to earn **RTC** tokens. + +Despite the name, the reference implementation is written in **Python** (Flask + SQLite), chosen for its ubiquity on vintage *nix platforms. + +## 2. Consensus: RIP-200 (Proof-of-Attestation) +RIP-200 replaces hash power with hardware identity. The core principle is **1 CPU = 1 Vote**, weighted by the antiquity of the hardware. + +### 2.1 The Attestation Cycle +The network operates in **Epochs** (approx. 24 hours). +1. **Fingerprinting**: A miner runs a client script that performs 6 hardware-level checks (see ยง3). +2. **Submission**: The miner submits this fingerprint + a signed payload to an Attestation Node (`POST /attest/submit`). +3. **Validation**: The node validates the signals against known hardware profiles (e.g., ensuring a G4 has the correct cache timing). +4. **Enrollment**: Valid miners are enrolled in the current Epoch. +5. **Settlement**: At the end of an Epoch, the "Epoch Pot" (1.5 RTC) is distributed among enrolled miners based on their weight. + +## 3. Hardware Fingerprinting +To prevent emulation (VMs) and spoofing, RustChain employs 6 distinct hardware checks. All must pass for a valid attestation. + +| Check | Description | Anti-Emulation Vector | +|-------|-------------|-----------------------| +| **1. Clock-Skew & Drift** | Measures microscopic crystal oscillator imperfections. | VMs use host clock (too perfect/uniform). | +| **2. Cache Timing** | Profiles L1/L2 cache latency curves. | Emulators often flatten cache hierarchy latency. | +| **3. SIMD Identity** | Tests AltiVec/SSE/NEON pipeline biases. | Emulated instructions have different timing profiles. | +| **4. Thermal Entropy** | Measures CPU temp changes under load. | VMs report static or host-passed temps. | +| **5. Instruction Jitter** | Measures execution time variance of specific opcodes. | Real silicon has nanosecond-scale jitter; VMs are cleaner. | +| **6. Behavioral Heuristics** | Checks for hypervisor signatures (MAC OUI, CPUID). | Detects known VM providers (VMware, QEMU). | + +## 4. Token Economics (RTC) +* **Token Symbol**: RTC +* **Total Supply**: 8,000,000 RTC (Capped) +* **Premine**: 75,000 RTC (Dev fund/Bounties) +* **Epoch Pot**: 1.5 RTC distributed every ~24 hours. + +### 4.1 Antiquity Multipliers +Older hardware is weighted heavier to incentivize preservation. + +| Architecture | Multiplier | Example Hardware | +|--------------|------------|------------------| +| **PowerPC G4** | **2.5x** | PowerBook G4, iMac G4 | +| **PowerPC G5** | **2.0x** | PowerMac G5, iMac G5 | +| **PowerPC G3** | **1.8x** | iMac G3, iBook G3 | +| **Retro x86** | **1.4x** | Pentium III/4 (Pre-SSE3) | +| **Apple Silicon**| **1.2x** | M1/M2/M3 (ARM64) | +| **Modern x86** | **1.0x** | Intel Core / AMD Ryzen | +| **Generic ARM**| **0.0001x**| Raspberry Pi / VMs | + +## 5. Network Architecture +### 5.1 Nodes +The network relies on trusted **Attestation Nodes** to validate fingerprints. +* **Primary Node**: `https://50.28.86.131` +* **Ergo Anchor Node**: `https://50.28.86.153` + +### 5.2 Ergo Anchoring +RustChain anchors its state to the **Ergo** layer-1 blockchain for immutability. +* Every epoch settlement hash is written to an Ergo box register (R4-R9). +* This provides an external, tamper-proof timestamp and existence proof for the RustChain ledger. + +## 6. API Reference +### Public Endpoints +* `GET /health`: Node status and version. +* `GET /api/miners`: List of currently active/enrolled miners. +* `GET /epoch`: Details on the current epoch (pot size, enrolled count). +* `GET /wallet/balance?miner_id=`: Check RTC balance. +* `POST /wallet/transfer/signed`: Submit a signed Ed25519 transaction to move RTC. + +--- +*Generated by Shadow Protocol Auditor (EchoDrifter).*