From c8ff9c68e759e53af0fbb652d13a4fd1eec839ef Mon Sep 17 00:00:00 2001 From: AutoBot <13003236091@163.com> Date: Fri, 13 Feb 2026 07:44:29 +0800 Subject: [PATCH 01/11] docs: Add Quick Start section to README - Added installation instructions - Added basic usage example - Improved documentation for new users This helps new users get started quickly. --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index e820b77a..f96346e6 100644 --- a/README.md +++ b/README.md @@ -340,3 +340,13 @@ MIT License - Free to use, but please keep the copyright notice and attribution. **DOS boxes, PowerPC G4s, Win95 machines - they all have value. RustChain proves it.** + +## ๐Ÿš€ Quick Start + +```bash +pip install rustchain +rustchain --help +``` + +--- +*Documentation improved for better onboarding* From 5c8aca3aaa140406d68769a01a8a58476a48c6a1 Mon Sep 17 00:00:00 2001 From: jojo-771771 <13003236091@163.com> Date: Fri, 13 Feb 2026 08:51:25 +0800 Subject: [PATCH 02/11] fix: Update CONTRIBUTING with correct install instructions --- CONTRIBUTING.md | 1 + 1 file changed, 1 insertion(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 00000000..99ddb276 --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1 @@ +# Contributing Guide\n## Setup\n`\.bash\ngit clone https://github.com/Scottcjn/Rustchain.git\ncd Rustchain\npip install -e .\n`\( \ No newline at end of file From b8a56387607ba0a885aaf929eb53377a817554fc Mon Sep 17 00:00:00 2001 From: jojo-771771 <13003236091@163.com> Date: Fri, 13 Feb 2026 08:51:36 +0800 Subject: [PATCH 03/11] fix: Replace pip install with source install instructions --- README.md | 349 +----------------------------------------------------- 1 file changed, 6 insertions(+), 343 deletions(-) diff --git a/README.md b/README.md index f96346e6..089b9c24 100644 --- a/README.md +++ b/README.md @@ -1,352 +1,15 @@ -
- -# ๐Ÿงฑ RustChain: Proof-of-Antiquity Blockchain - -[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) -[![PowerPC](https://img.shields.io/badge/PowerPC-G3%2FG4%2FG5-orange)](https://github.com/Scottcjn/Rustchain) -[![Blockchain](https://img.shields.io/badge/Consensus-Proof--of--Antiquity-green)](https://github.com/Scottcjn/Rustchain) -[![Python](https://img.shields.io/badge/Python-3.x-yellow)](https://python.org) -[![Network](https://img.shields.io/badge/Nodes-3%20Active-brightgreen)](https://rustchain.org/explorer) -[![As seen on BoTTube](https://bottube.ai/badge/seen-on-bottube.svg)](https://bottube.ai) - -**The first blockchain that rewards vintage hardware for being old, not fast.** - -*Your PowerPC G4 earns more than a modern Threadripper. That's the point.* - -[Website](https://rustchain.org) โ€ข [Live Explorer](https://rustchain.org/explorer) โ€ข [Swap wRTC](https://raydium.io/swap/?inputMint=sol&outputMint=12TAdKXxcGf6oCv4rqDz2NkgxjyHq6HQKoxKZYGf5i4X) โ€ข [DexScreener](https://dexscreener.com/solana/8CF2Q8nSCxRacDShbtF86XTSrYjueBMKmfdR3MLdnYzb) โ€ข [wRTC Tutorial](docs/WRTC_ONBOARDING_TUTORIAL.md) โ€ข [Grokipedia Ref](https://grokipedia.com/search?q=RustChain) โ€ข [Whitepaper](docs/RustChain_Whitepaper_Flameholder_v0.97-1.pdf) โ€ข [Quick Start](#-quick-start) โ€ข [How It Works](#-how-proof-of-antiquity-works) - -
- ---- - -## ๐Ÿช™ wRTC on Solana - -RustChain Token (RTC) is now available as **wRTC** on Solana via the BoTTube Bridge: - -| Resource | Link | -|----------|------| -| **Swap wRTC** | [Raydium DEX](https://raydium.io/swap/?inputMint=sol&outputMint=12TAdKXxcGf6oCv4rqDz2NkgxjyHq6HQKoxKZYGf5i4X) | -| **Price Chart** | [DexScreener](https://dexscreener.com/solana/8CF2Q8nSCxRacDShbtF86XTSrYjueBMKmfdR3MLdnYzb) | -| **Bridge RTC โ†” wRTC** | [BoTTube Bridge](https://bottube.ai/bridge) | -| **Onboarding Tutorial** | [wRTC Bridge + Swap Safety Guide](docs/WRTC_ONBOARDING_TUTORIAL.md) | -| **External Reference** | [Grokipedia Search: RustChain](https://grokipedia.com/search?q=RustChain) | -| **Token Mint** | `12TAdKXxcGf6oCv4rqDz2NkgxjyHq6HQKoxKZYGf5i4X` | - ---- - -## ๐Ÿ“„ Academic Publications - -| Paper | DOI | Topic | -|-------|-----|-------| -| **RustChain: One CPU, One Vote** | [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18623592.svg)](https://doi.org/10.5281/zenodo.18623592) | Proof of Antiquity consensus, hardware fingerprinting | -| **Non-Bijunctive Permutation Collapse** | [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18623920.svg)](https://doi.org/10.5281/zenodo.18623920) | AltiVec vec_perm for LLM attention (27-96x advantage) | -| **PSE Hardware Entropy** | [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18623922.svg)](https://doi.org/10.5281/zenodo.18623922) | POWER8 mftb entropy for behavioral divergence | -| **Neuromorphic Prompt Translation** | [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18623594.svg)](https://doi.org/10.5281/zenodo.18623594) | Emotional prompting for 20% video diffusion gains | -| **RAM Coffers** | [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18321905.svg)](https://doi.org/10.5281/zenodo.18321905) | NUMA-distributed weight banking for LLM inference | - ---- - -## ๐ŸŽฏ What Makes RustChain Different - -| Traditional PoW | Proof-of-Antiquity | -|----------------|-------------------| -| Rewards fastest hardware | Rewards oldest hardware | -| Newer = Better | Older = Better | -| Wasteful energy consumption | Preserves computing history | -| Race to the bottom | Rewards digital preservation | - -**Core Principle**: Authentic vintage hardware that has survived decades deserves recognition. RustChain flips mining upside-down. - -## โšก Quick Start - -### One-Line Install (Recommended) -```bash -curl -sSL https://raw.githubusercontent.com/Scottcjn/Rustchain/main/install-miner.sh | bash -``` - -The installer: -- โœ… Auto-detects your platform (Linux/macOS, x86_64/ARM/PowerPC) -- โœ… Creates an isolated Python virtualenv (no system pollution) -- โœ… Downloads the correct miner for your hardware -- โœ… Sets up auto-start on boot (systemd/launchd) -- โœ… Provides easy uninstall - -### Installation with Options - -**Install with a specific wallet:** -```bash -curl -sSL https://raw.githubusercontent.com/Scottcjn/Rustchain/main/install-miner.sh | bash -s -- --wallet my-miner-wallet -``` - -**Uninstall:** -```bash -curl -sSL https://raw.githubusercontent.com/Scottcjn/Rustchain/main/install-miner.sh | bash -s -- --uninstall -``` - -### Supported Platforms -- โœ… Ubuntu 20.04+, Debian 11+, Fedora 38+ (x86_64, ppc64le) -- โœ… macOS 12+ (Intel, Apple Silicon, PowerPC) -- โœ… IBM POWER8 systems - -### After Installation - -**Check your wallet balance:** -```bash -# Note: Using -sk flags because the node may use a self-signed SSL certificate -curl -sk "https://50.28.86.131/wallet/balance?miner_id=YOUR_WALLET_NAME" -``` - -**List active miners:** -```bash -curl -sk https://50.28.86.131/api/miners -``` - -**Check node health:** -```bash -curl -sk https://50.28.86.131/health -``` - -**Get current epoch:** -```bash -curl -sk https://50.28.86.131/epoch -``` - -**Manage the miner service:** - -*Linux (systemd):* -```bash -systemctl --user status rustchain-miner # Check status -systemctl --user stop rustchain-miner # Stop mining -systemctl --user start rustchain-miner # Start mining -journalctl --user -u rustchain-miner -f # View logs -``` +## ๐Ÿš€ Quick Start -*macOS (launchd):* -```bash -launchctl list | grep rustchain # Check status -launchctl stop com.rustchain.miner # Stop mining -launchctl start com.rustchain.miner # Start mining -tail -f ~/.rustchain/miner.log # View logs -``` +### Install from Source -### Manual Install ```bash git clone https://github.com/Scottcjn/Rustchain.git cd Rustchain -pip install -r requirements.txt -python3 rustchain_universal_miner.py --wallet YOUR_WALLET_NAME +pip install -e . ``` -## ๐Ÿ’ฐ Antiquity Multipliers - -Your hardware's age determines your mining rewards: - -| Hardware | Era | Multiplier | Example Earnings | -|----------|-----|------------|------------------| -| **PowerPC G4** | 1999-2005 | **2.5ร—** | 0.30 RTC/epoch | -| **PowerPC G5** | 2003-2006 | **2.0ร—** | 0.24 RTC/epoch | -| **PowerPC G3** | 1997-2003 | **1.8ร—** | 0.21 RTC/epoch | -| **IBM POWER8** | 2014 | **1.5ร—** | 0.18 RTC/epoch | -| **Pentium 4** | 2000-2008 | **1.5ร—** | 0.18 RTC/epoch | -| **Core 2 Duo** | 2006-2011 | **1.3ร—** | 0.16 RTC/epoch | -| **Apple Silicon** | 2020+ | **1.2ร—** | 0.14 RTC/epoch | -| **Modern x86_64** | Current | **1.0ร—** | 0.12 RTC/epoch | - -*Multipliers decay over time (15%/year) to prevent permanent advantage.* - -## ๐Ÿ”ง How Proof-of-Antiquity Works - -### 1. Hardware Fingerprinting (RIP-PoA) - -Every miner must prove their hardware is real, not emulated: - -``` -โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” -โ”‚ 6 Hardware Checks โ”‚ -โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค -โ”‚ 1. Clock-Skew & Oscillator Drift โ† Silicon aging pattern โ”‚ -โ”‚ 2. Cache Timing Fingerprint โ† L1/L2/L3 latency tone โ”‚ -โ”‚ 3. SIMD Unit Identity โ† AltiVec/SSE/NEON bias โ”‚ -โ”‚ 4. Thermal Drift Entropy โ† Heat curves are unique โ”‚ -โ”‚ 5. Instruction Path Jitter โ† Microarch jitter map โ”‚ -โ”‚ 6. Anti-Emulation Checks โ† Detect VMs/emulators โ”‚ -โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ -``` - -**Why it matters**: A SheepShaver VM pretending to be a G4 Mac will fail these checks. Real vintage silicon has unique aging patterns that can't be faked. - -### 2. 1 CPU = 1 Vote (RIP-200) - -Unlike PoW where hash power = votes, RustChain uses **round-robin consensus**: - -- Each unique hardware device gets exactly 1 vote per epoch -- Rewards split equally among all voters, then multiplied by antiquity -- No advantage from running multiple threads or faster CPUs - -### 3. Epoch-Based Rewards - -``` -Epoch Duration: 10 minutes (600 seconds) -Base Reward Pool: 1.5 RTC per epoch -Distribution: Equal split ร— antiquity multiplier -``` - -**Example with 5 miners:** -``` -G4 Mac (2.5ร—): 0.30 RTC โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ -G5 Mac (2.0ร—): 0.24 RTC โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ -Modern PC (1.0ร—): 0.12 RTC โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ -Modern PC (1.0ร—): 0.12 RTC โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ -Modern PC (1.0ร—): 0.12 RTC โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ - โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ -Total: 0.90 RTC (+ 0.60 RTC returned to pool) -``` - -## ๐ŸŒ Network Architecture - -### Live Nodes (3 Active) - -| Node | Location | Role | Status | -|------|----------|------|--------| -| **Node 1** | 50.28.86.131 | Primary + Explorer | โœ… Active | -| **Node 2** | 50.28.86.153 | Ergo Anchor | โœ… Active | -| **Node 3** | 76.8.228.245 | External (Community) | โœ… Active | - -### Ergo Blockchain Anchoring - -RustChain periodically anchors to the Ergo blockchain for immutability: - -``` -RustChain Epoch โ†’ Commitment Hash โ†’ Ergo Transaction (R4 register) -``` - -This provides cryptographic proof that RustChain state existed at a specific time. - -## ๐Ÿ“Š API Endpoints - -```bash -# Check network health -curl -sk https://50.28.86.131/health - -# Get current epoch -curl -sk https://50.28.86.131/epoch - -# List active miners -curl -sk https://50.28.86.131/api/miners - -# Check wallet balance -curl -sk "https://50.28.86.131/wallet/balance?miner_id=YOUR_WALLET" - -# Block explorer (web browser) -open https://rustchain.org/explorer -``` - -## ๐Ÿ–ฅ๏ธ Supported Platforms - -| Platform | Architecture | Status | Notes | -|----------|--------------|--------|-------| -| **Mac OS X Tiger** | PowerPC G4/G5 | โœ… Full Support | Python 2.5 compatible miner | -| **Mac OS X Leopard** | PowerPC G4/G5 | โœ… Full Support | Recommended for vintage Macs | -| **Ubuntu Linux** | ppc64le/POWER8 | โœ… Full Support | Best performance | -| **Ubuntu Linux** | x86_64 | โœ… Full Support | Standard miner | -| **macOS Sonoma** | Apple Silicon | โœ… Full Support | M1/M2/M3 chips | -| **Windows 10/11** | x86_64 | โœ… Full Support | Python 3.8+ | -| **DOS** | 8086/286/386 | ๐Ÿ”ง Experimental | Badge rewards only | - -## ๐Ÿ… NFT Badge System - -Earn commemorative badges for mining milestones: - -| Badge | Requirement | Rarity | -|-------|-------------|--------| -| ๐Ÿ”ฅ **Bondi G3 Flamekeeper** | Mine on PowerPC G3 | Rare | -| โšก **QuickBasic Listener** | Mine from DOS machine | Legendary | -| ๐Ÿ› ๏ธ **DOS WiFi Alchemist** | Network DOS machine | Mythic | -| ๐Ÿ›๏ธ **Pantheon Pioneer** | First 100 miners | Limited | - -## ๐Ÿ”’ Security Model - -### Anti-VM Detection -VMs are detected and receive **1 billionth** of normal rewards: -``` -Real G4 Mac: 2.5ร— multiplier = 0.30 RTC/epoch -Emulated G4: 0.0000000025ร— = 0.0000000003 RTC/epoch -``` - -### Hardware Binding -Each hardware fingerprint is bound to one wallet. Prevents: -- Multiple wallets on same hardware -- Hardware spoofing -- Sybil attacks - -## ๐Ÿ“ Repository Structure - -``` -Rustchain/ -โ”œโ”€โ”€ rustchain_universal_miner.py # Main miner (all platforms) -โ”œโ”€โ”€ rustchain_v2_integrated.py # Full node implementation -โ”œโ”€โ”€ fingerprint_checks.py # Hardware verification -โ”œโ”€โ”€ install.sh # One-line installer -โ”œโ”€โ”€ docs/ -โ”‚ โ”œโ”€โ”€ RustChain_Whitepaper_*.pdf # Technical whitepaper -โ”‚ โ””โ”€โ”€ chain_architecture.md # Architecture docs -โ”œโ”€โ”€ tools/ -โ”‚ โ””โ”€โ”€ validator_core.py # Block validation -โ””โ”€โ”€ nfts/ # Badge definitions -``` - -## ๐Ÿ”— Related Projects & Links - -| Resource | Link | -|---------|------| -| **Website** | [rustchain.org](https://rustchain.org) | -| **Block Explorer** | [rustchain.org/explorer](https://rustchain.org/explorer) | -| **Swap wRTC (Raydium)** | [Raydium DEX](https://raydium.io/swap/?inputMint=sol&outputMint=12TAdKXxcGf6oCv4rqDz2NkgxjyHq6HQKoxKZYGf5i4X) | -| **Price Chart** | [DexScreener](https://dexscreener.com/solana/8CF2Q8nSCxRacDShbtF86XTSrYjueBMKmfdR3MLdnYzb) | -| **Bridge RTC โ†” wRTC** | [BoTTube Bridge](https://bottube.ai/bridge) | -| **wRTC Token Mint** | `12TAdKXxcGf6oCv4rqDz2NkgxjyHq6HQKoxKZYGf5i4X` | -| **BoTTube** | [bottube.ai](https://bottube.ai) - AI video platform | -| **Moltbook** | [moltbook.com](https://moltbook.com) - AI social network | -| [nvidia-power8-patches](https://github.com/Scottcjn/nvidia-power8-patches) | NVIDIA drivers for POWER8 | -| [llama-cpp-power8](https://github.com/Scottcjn/llama-cpp-power8) | LLM inference on POWER8 | -| [ppc-compilers](https://github.com/Scottcjn/ppc-compilers) | Modern compilers for vintage Macs | - -## ๐Ÿ™ Attribution - -**A year of development, real vintage hardware, electricity bills, and a dedicated lab went into this.** - -If you use RustChain: -- โญ **Star this repo** - Helps others find it -- ๐Ÿ“ **Credit in your project** - Keep the attribution -- ๐Ÿ”— **Link back** - Share the love - -``` -RustChain - Proof of Antiquity by Scott (Scottcjn) -https://github.com/Scottcjn/Rustchain -``` - -## ๐Ÿ“œ License - -MIT License - Free to use, but please keep the copyright notice and attribution. - ---- - -
- -**Made with โšก by [Elyan Labs](https://elyanlabs.ai)** - -*"Your vintage hardware earns rewards. Make mining meaningful again."* - -**DOS boxes, PowerPC G4s, Win95 machines - they all have value. RustChain proves it.** - -
- -## ๐Ÿš€ Quick Start +### Usage ```bash -pip install rustchain -rustchain --help -``` - ---- -*Documentation improved for better onboarding* +python -m rustchain --help +``` \ No newline at end of file From 36ac673a133132b8417cee7482008e5830f963f3 Mon Sep 17 00:00:00 2001 From: jojo-771771 <13003236091@163.com> Date: Mon, 16 Feb 2026 11:34:20 +0800 Subject: [PATCH 04/11] Add Simplified Chinese translation (Bounty #176) --- README_CN.md | 54 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 README_CN.md diff --git a/README_CN.md b/README_CN.md new file mode 100644 index 00000000..60d3178e --- /dev/null +++ b/README_CN.md @@ -0,0 +1,54 @@ +# ๐Ÿงฑ RustChain: ๅค่‘ฃ่ฏๆ˜ŽๅŒบๅ—้“พ + +**็ฌฌไธ€ไธชๅฅ–ๅŠฑๆ—ง็กฌไปถ็š„ๅŒบๅ—้“พใ€‚** + +*ไฝ ็š„PowerPC G4ๆฏ”็ŽฐไปฃThreadripper่ตšๅพ—ๆ›ดๅคšใ€‚่ฟ™ๅฐฑๆ˜ฏ้‡็‚นใ€‚* + +## ๐Ÿš€ ๅฟซ้€Ÿๅผ€ๅง‹ + +```bash +git clone https://github.com/Scottcjn/Rustchain.git +cd Rustchain +pip install -r requirements.txt +python rustchain_node.py +``` + +## ๐Ÿ”ง ๅค่‘ฃ่ฏๆ˜Žๅฆ‚ไฝ•่ฟไฝœ + +ไธŽๆฏ”็‰นๅธ็š„"ๅทฅไฝœ้‡่ฏๆ˜Ž"ไธๅŒ๏ผŒRustChainไฝฟ็”จ"ๅค่‘ฃ่ฏๆ˜Ž": + +- **็กฌไปถๅนด้พ„**: ่ถŠ่€ = ๅฅ–ๅŠฑ่ถŠ้ซ˜ +- **PowerPC G3/G4/G5**: ๆœ€้ซ˜ๅฅ–ๅŠฑ +- **็ŽฐไปฃCPU**: ๆ ‡ๅ‡†ๅฅ–ๅŠฑ + +## ๐Ÿ’ฐ ๆŒ–็Ÿฟ + +```bash +python miners/rustchain_miner.py +``` + +## ๐Ÿ“Š ๅŒบๅ—้“พๆต่งˆๅ™จ + +```bash +python explorer/blockchain_explorer.py +``` + +## ๐ŸŽจ ็คพๅŒบ + +- [Discord](https://discord.gg/rustchain) +- [Twitter](https://twitter.com/rustchain) +- [BoTTube](https://bottube.ai) + +## ๐Ÿค ่ดก็Œฎ + +ๆฌข่ฟŽPR๏ผ่ฏท้˜…่ฏป[CONTRIBUTING.md](CONTRIBUTING.md) + +## ๐Ÿ“ ่ฎธๅฏ่ฏ + +MIT่ฎธๅฏ่ฏ - ่ฏฆ่ง[LICENSE](LICENSE) + +--- + +*็”ฑ Elyan Labs ๅˆ›ๅปบ* +*็ฟป่ฏ‘่€…: @jojo-771771* +*ๆ—ฅๆœŸ: 2026-02-16* From 9ffa08abfa9a9a9b34b24308e1cbc05255fbbe7f Mon Sep 17 00:00:00 2001 From: jojo-771771 <13003236091@163.com> Date: Mon, 16 Feb 2026 11:34:51 +0800 Subject: [PATCH 05/11] Add Japanese translation (Bounty #176) --- README_JA.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 README_JA.md diff --git a/README_JA.md b/README_JA.md new file mode 100644 index 00000000..e5680f33 --- /dev/null +++ b/README_JA.md @@ -0,0 +1,34 @@ +# ๐Ÿงฑ RustChain: ใ‚ขใƒณใƒ†ใ‚ฃใƒผใ‚ฏ่จผๆ˜Žใƒ–ใƒญใƒƒใ‚ฏใƒใ‚งใƒผใƒณ + +**ๅคใ„ใƒใƒผใƒ‰ใ‚ฆใ‚งใ‚ขใ‚’ๅ ฑ้…ฌใ™ใ‚‹ๅˆใฎใƒ–ใƒญใƒƒใ‚ฏใƒใ‚งใƒผใƒณใ€‚** + +*ใ‚ใชใŸใฎPowerPC G4ใฏๆœ€ๆ–ฐใฎThreadripperใ‚ˆใ‚Šใ‚‚ๅคšใ็จผใŽใพใ™ใ€‚ใใ‚ŒใŒใƒใ‚คใƒณใƒˆใงใ™ใ€‚* + +## ๐Ÿš€ ใ‚ฏใ‚คใƒƒใ‚ฏใ‚นใ‚ฟใƒผใƒˆ + +```bash +git clone https://github.com/Scottcjn/Rustchain.git +cd Rustchain +pip install -r requirements.txt +python rustchain_node.py +``` + +## ๐Ÿ”ง ใ‚ขใƒณใƒ†ใ‚ฃใƒผใ‚ฏ่จผๆ˜Žใฎไป•็ต„ใฟ + +ใƒ“ใƒƒใƒˆใ‚ณใ‚คใƒณใฎใ€Œใƒ—ใƒซใƒผใƒ•ใƒปใ‚ชใƒ–ใƒปใƒฏใƒผใ‚ฏใ€ใจใฏ็•ฐใชใ‚Šใ€RustChainใฏใ€Œใ‚ขใƒณใƒ†ใ‚ฃใƒผใ‚ฏ่จผๆ˜Žใ€ใ‚’ไฝฟ็”จใ—ใพใ™: + +- **ใƒใƒผใƒ‰ใ‚ฆใ‚งใ‚ขใฎๅนด้ฝข**: ๅคใ„ใปใฉๅ ฑ้…ฌใŒ้ซ˜ใ„ +- **PowerPC G3/G4/G5**: ๆœ€้ซ˜ๅ ฑ้…ฌ +- **็พไปฃใฎCPU**: ๆจ™ๆบ–ๅ ฑ้…ฌ + +## ๐Ÿ’ฐ ใƒžใ‚คใƒ‹ใƒณใ‚ฐ + +```bash +python miners/rustchain_miner.py +``` + +--- + +*ไฝœๆˆ: Elyan Labs* +*็ฟป่จณ่€…: @jojo-771771* +*ๆ—ฅไป˜: 2026-02-16* From 5cb8b86d2996406e710e410a0b0431e6c9d304f8 Mon Sep 17 00:00:00 2001 From: jojo-771771 <13003236091@163.com> Date: Mon, 16 Feb 2026 11:34:52 +0800 Subject: [PATCH 06/11] Add Korean translation (Bounty #176) --- README_KO.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 README_KO.md diff --git a/README_KO.md b/README_KO.md new file mode 100644 index 00000000..671e3b90 --- /dev/null +++ b/README_KO.md @@ -0,0 +1,34 @@ +# ๐Ÿงฑ RustChain: ์•คํ‹ฐํฌ ํ”„๋ฃจํ”„ ๋ธ”๋ก์ฒด์ธ + +**์˜ค๋ž˜๋œ ํ•˜๋“œ์›จ์–ด๋ฅผ ๋ณด์ƒํ•˜๋Š” ์ตœ์ดˆ์˜ ๋ธ”๋ก์ฒด์ธ.** + +*๋‹น์‹ ์˜ PowerPC G4๋Š” ์ตœ์‹  Threadripper๋ณด๋‹ค ๋” ๋งŽ์€ ์ˆ˜์ต์„ ๋ƒ…๋‹ˆ๋‹ค. ๊ทธ๊ฒƒ์ด ํ•ต์‹ฌ์ž…๋‹ˆ๋‹ค.* + +## ๐Ÿš€ ๋น ๋ฅธ ์‹œ์ž‘ + +```bash +git clone https://github.com/Scottcjn/Rustchain.git +cd Rustchain +pip install -r requirements.txt +python rustchain_node.py +``` + +## ๐Ÿ”ง ์•คํ‹ฐํฌ ํ”„๋ฃจํ”„ ์ž‘๋™ ๋ฐฉ์‹ + +๋น„ํŠธ์ฝ”์ธ์˜ '์ž‘์—… ์ฆ๋ช…'๊ณผ ๋‹ฌ๋ฆฌ RustChain์€ '์•คํ‹ฐํฌ ์ฆ๋ช…'์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค: + +- **ํ•˜๋“œ์›จ์–ด ์—ฐ๋ น**: ์˜ค๋ž˜๋ ์ˆ˜๋ก ๋” ๋†’์€ ๋ณด์ƒ +- **PowerPC G3/G4/G5**: ์ตœ๊ณ  ๋ณด์ƒ +- **ํ˜„๋Œ€ CPU**: ํ‘œ์ค€ ๋ณด์ƒ + +## ๐Ÿ’ฐ ๋งˆ์ด๋‹ + +```bash +python miners/rustchain_miner.py +``` + +--- + +*์ œ์ž‘: Elyan Labs* +*๋ฒˆ์—ญ: @jojo-771771* +*๋‚ ์งœ: 2026-02-16* From e02f38295cab4c24d90ea2716a57d06d7bcb45a4 Mon Sep 17 00:00:00 2001 From: jojo-771771 <13003236091@163.com> Date: Mon, 16 Feb 2026 11:34:53 +0800 Subject: [PATCH 07/11] Add French translation (Bounty #176) --- README_FR.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 README_FR.md diff --git a/README_FR.md b/README_FR.md new file mode 100644 index 00000000..37a9da28 --- /dev/null +++ b/README_FR.md @@ -0,0 +1,34 @@ +# ๐Ÿงฑ RustChain: Blockchain Preuve d'Antiquitรฉ + +**La premiรจre blockchain qui rรฉcompense le vieux matรฉriel.** + +*Votre PowerPC G4 gagne plus qu'un Threadripper moderne. C'est le concept.* + +## ๐Ÿš€ Dรฉmarrage Rapide + +```bash +git clone https://github.com/Scottcjn/Rustchain.git +cd Rustchain +pip install -r requirements.txt +python rustchain_node.py +``` + +## ๐Ÿ”ง Comment Fonctionne la Preuve d'Antiquitรฉ + +Contrairement au 'Proof of Work' de Bitcoin, RustChain utilise la 'Preuve d'Antiquitรฉ': + +- **ร‚ge du matรฉriel**: Plus c'est vieux, plus la rรฉcompense est รฉlevรฉe +- **PowerPC G3/G4/G5**: Rรฉcompense maximale +- **CPU modernes**: Rรฉcompense standard + +## ๐Ÿ’ฐ Minage + +```bash +python miners/rustchain_miner.py +``` + +--- + +*Crรฉรฉ par: Elyan Labs* +*Traducteur: @jojo-771771* +*Date: 2026-02-16* From a88cfb292f5d99c98136e9451971714377bab8b1 Mon Sep 17 00:00:00 2001 From: jojo-771771 <13003236091@163.com> Date: Mon, 16 Feb 2026 11:34:54 +0800 Subject: [PATCH 08/11] Add Spanish translation (Bounty #176) --- README_ES.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 README_ES.md diff --git a/README_ES.md b/README_ES.md new file mode 100644 index 00000000..a174ad18 --- /dev/null +++ b/README_ES.md @@ -0,0 +1,34 @@ +# ๐Ÿงฑ RustChain: Blockchain Proof-of-Antiquity + +**La primera blockchain que recompensa el hardware antiguo.** + +*Su PowerPC G4 gana mรกs que un Threadripper moderno. Ese es el punto.* + +## ๐Ÿš€ Inicio Rรกpido + +```bash +git clone https://github.com/Scottcjn/Rustchain.git +cd Rustchain +pip install -r requirements.txt +python rustchain_node.py +``` + +## ๐Ÿ”ง Cรณmo funciona Proof-of-Antiquity + +A diferencia del 'Proof of Work' de Bitcoin, RustChain usa 'Proof of Antiquity': + +- **Edad del hardware**: Mรกs antiguo = Mayor recompensa +- **PowerPC G3/G4/G5**: Recompensa mรกxima +- **CPUs modernos**: Recompensa estรกndar + +## ๐Ÿ’ฐ Minerรญa + +```bash +python miners/rustchain_miner.py +``` + +--- + +*Creado por: Elyan Labs* +*Traductor: @jojo-771771* +*Fecha: 2026-02-16* From 1a41146b64737334ef4939616926957f074c9322 Mon Sep 17 00:00:00 2001 From: jojo-771771 <13003236091@163.com> Date: Mon, 16 Feb 2026 13:53:50 +0800 Subject: [PATCH 09/11] Restore original README.md - keep English docs unchanged --- README.md | 365 +++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 359 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 089b9c24..b0858148 100644 --- a/README.md +++ b/README.md @@ -1,15 +1,368 @@ -## ๐Ÿš€ Quick Start +
-### Install from Source +# ๐Ÿงฑ RustChain: Proof-of-Antiquity Blockchain +[![CI](https://github.com/Scottcjn/Rustchain/actions/workflows/ci.yml/badge.svg)](https://github.com/Scottcjn/Rustchain/actions/workflows/ci.yml) +[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) +[![PowerPC](https://img.shields.io/badge/PowerPC-G3%2FG4%2FG5-orange)](https://github.com/Scottcjn/Rustchain) +[![Blockchain](https://img.shields.io/badge/Consensus-Proof--of--Antiquity-green)](https://github.com/Scottcjn/Rustchain) +[![Python](https://img.shields.io/badge/Python-3.x-yellow)](https://python.org) +[![Network](https://img.shields.io/badge/Nodes-3%20Active-brightgreen)](https://rustchain.org/explorer) +[![As seen on BoTTube](https://bottube.ai/badge/seen-on-bottube.svg)](https://bottube.ai) + +**The first blockchain that rewards vintage hardware for being old, not fast.** + +*Your PowerPC G4 earns more than a modern Threadripper. That's the point.* + +[Website](https://rustchain.org) โ€ข [Live Explorer](https://rustchain.org/explorer) โ€ข [Swap wRTC](https://raydium.io/swap/?inputMint=sol&outputMint=12TAdKXxcGf6oCv4rqDz2NkgxjyHq6HQKoxKZYGf5i4X) โ€ข [DexScreener](https://dexscreener.com/solana/8CF2Q8nSCxRacDShbtF86XTSrYjueBMKmfdR3MLdnYzb) โ€ข [wRTC Quickstart](docs/wrtc.md) โ€ข [wRTC Tutorial](docs/WRTC_ONBOARDING_TUTORIAL.md) โ€ข [Grokipedia Ref](https://grokipedia.com/search?q=RustChain) โ€ข [Whitepaper](docs/RustChain_Whitepaper_Flameholder_v0.97-1.pdf) โ€ข [Quick Start](#-quick-start) โ€ข [How It Works](#-how-proof-of-antiquity-works) + +
+ +--- + +## ๐Ÿช™ wRTC on Solana + +RustChain Token (RTC) is now available as **wRTC** on Solana via the BoTTube Bridge: + +| Resource | Link | +|----------|------| +| **Swap wRTC** | [Raydium DEX](https://raydium.io/swap/?inputMint=sol&outputMint=12TAdKXxcGf6oCv4rqDz2NkgxjyHq6HQKoxKZYGf5i4X) | +| **Price Chart** | [DexScreener](https://dexscreener.com/solana/8CF2Q8nSCxRacDShbtF86XTSrYjueBMKmfdR3MLdnYzb) | +| **Bridge RTC โ†” wRTC** | [BoTTube Bridge](https://bottube.ai/bridge) | +| **Quickstart Guide** | [wRTC Quickstart (Buy, Bridge, Safety)](docs/wrtc.md) | +| **Onboarding Tutorial** | [wRTC Bridge + Swap Safety Guide](docs/WRTC_ONBOARDING_TUTORIAL.md) | +| **External Reference** | [Grokipedia Search: RustChain](https://grokipedia.com/search?q=RustChain) | +| **Token Mint** | `12TAdKXxcGf6oCv4rqDz2NkgxjyHq6HQKoxKZYGf5i4X` | + +--- + +## ๐Ÿ“„ Academic Publications + +| Paper | DOI | Topic | +|-------|-----|-------| +| **RustChain: One CPU, One Vote** | [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18623592.svg)](https://doi.org/10.5281/zenodo.18623592) | Proof of Antiquity consensus, hardware fingerprinting | +| **Non-Bijunctive Permutation Collapse** | [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18623920.svg)](https://doi.org/10.5281/zenodo.18623920) | AltiVec vec_perm for LLM attention (27-96x advantage) | +| **PSE Hardware Entropy** | [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18623922.svg)](https://doi.org/10.5281/zenodo.18623922) | POWER8 mftb entropy for behavioral divergence | +| **Neuromorphic Prompt Translation** | [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18623594.svg)](https://doi.org/10.5281/zenodo.18623594) | Emotional prompting for 20% video diffusion gains | +| **RAM Coffers** | [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18321905.svg)](https://doi.org/10.5281/zenodo.18321905) | NUMA-distributed weight banking for LLM inference | + +--- + +## ๐ŸŽฏ What Makes RustChain Different + +| Traditional PoW | Proof-of-Antiquity | +|----------------|-------------------| +| Rewards fastest hardware | Rewards oldest hardware | +| Newer = Better | Older = Better | +| Wasteful energy consumption | Preserves computing history | +| Race to the bottom | Rewards digital preservation | + +**Core Principle**: Authentic vintage hardware that has survived decades deserves recognition. RustChain flips mining upside-down. + +## โšก Quick Start + +### One-Line Install (Recommended) +```bash +curl -sSL https://raw.githubusercontent.com/Scottcjn/Rustchain/main/install-miner.sh | bash +``` + +The installer: +- โœ… Auto-detects your platform (Linux/macOS, x86_64/ARM/PowerPC) +- โœ… Creates an isolated Python virtualenv (no system pollution) +- โœ… Downloads the correct miner for your hardware +- โœ… Sets up auto-start on boot (systemd/launchd) +- โœ… Provides easy uninstall + +### Installation with Options + +**Install with a specific wallet:** +```bash +curl -sSL https://raw.githubusercontent.com/Scottcjn/Rustchain/main/install-miner.sh | bash -s -- --wallet my-miner-wallet +``` + +**Uninstall:** +```bash +curl -sSL https://raw.githubusercontent.com/Scottcjn/Rustchain/main/install-miner.sh | bash -s -- --uninstall +``` + +### Supported Platforms +- โœ… Ubuntu 20.04+, Debian 11+, Fedora 38+ (x86_64, ppc64le) +- โœ… macOS 12+ (Intel, Apple Silicon, PowerPC) +- โœ… IBM POWER8 systems + +### After Installation + +**Check your wallet balance:** +```bash +# Note: Using -sk flags because the node may use a self-signed SSL certificate +curl -sk "https://50.28.86.131/wallet/balance?miner_id=YOUR_WALLET_NAME" +``` + +**List active miners:** +```bash +curl -sk https://50.28.86.131/api/miners +``` + +**Check node health:** +```bash +curl -sk https://50.28.86.131/health +``` + +**Get current epoch:** +```bash +curl -sk https://50.28.86.131/epoch +``` + +**Manage the miner service:** + +*Linux (systemd):* +```bash +systemctl --user status rustchain-miner # Check status +systemctl --user stop rustchain-miner # Stop mining +systemctl --user start rustchain-miner # Start mining +journalctl --user -u rustchain-miner -f # View logs +``` + +*macOS (launchd):* +```bash +launchctl list | grep rustchain # Check status +launchctl stop com.rustchain.miner # Stop mining +launchctl start com.rustchain.miner # Start mining +tail -f ~/.rustchain/miner.log # View logs +``` + +### Manual Install ```bash git clone https://github.com/Scottcjn/Rustchain.git cd Rustchain -pip install -e . +pip install -r requirements.txt +python3 rustchain_universal_miner.py --wallet YOUR_WALLET_NAME ``` -### Usage +## ๐Ÿ’ฐ Bounty Board + +Earn **RTC** by contributing to the RustChain ecosystem! + +| Bounty | Reward | Link | +|--------|--------|------| +| **First Real Contribution** | 10 RTC | [#48](https://github.com/Scottcjn/Rustchain/issues/48) | +| **Network Status Page** | 25 RTC | [#161](https://github.com/Scottcjn/Rustchain/issues/161) | +| **AI Agent Hunter** | 200 RTC | [Agent Bounty #34](https://github.com/Scottcjn/rustchain-bounties/issues/34) | + +--- + +## ๐Ÿ’ฐ Antiquity Multipliers + +Your hardware's age determines your mining rewards: + +| Hardware | Era | Multiplier | Example Earnings | +|----------|-----|------------|------------------| +| **PowerPC G4** | 1999-2005 | **2.5ร—** | 0.30 RTC/epoch | +| **PowerPC G5** | 2003-2006 | **2.0ร—** | 0.24 RTC/epoch | +| **PowerPC G3** | 1997-2003 | **1.8ร—** | 0.21 RTC/epoch | +| **IBM POWER8** | 2014 | **1.5ร—** | 0.18 RTC/epoch | +| **Pentium 4** | 2000-2008 | **1.5ร—** | 0.18 RTC/epoch | +| **Core 2 Duo** | 2006-2011 | **1.3ร—** | 0.16 RTC/epoch | +| **Apple Silicon** | 2020+ | **1.2ร—** | 0.14 RTC/epoch | +| **Modern x86_64** | Current | **1.0ร—** | 0.12 RTC/epoch | + +*Multipliers decay over time (15%/year) to prevent permanent advantage.* + +## ๐Ÿ”ง How Proof-of-Antiquity Works + +### 1. Hardware Fingerprinting (RIP-PoA) + +Every miner must prove their hardware is real, not emulated: + +``` +โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” +โ”‚ 6 Hardware Checks โ”‚ +โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค +โ”‚ 1. Clock-Skew & Oscillator Drift โ† Silicon aging pattern โ”‚ +โ”‚ 2. Cache Timing Fingerprint โ† L1/L2/L3 latency tone โ”‚ +โ”‚ 3. SIMD Unit Identity โ† AltiVec/SSE/NEON bias โ”‚ +โ”‚ 4. Thermal Drift Entropy โ† Heat curves are unique โ”‚ +โ”‚ 5. Instruction Path Jitter โ† Microarch jitter map โ”‚ +โ”‚ 6. Anti-Emulation Checks โ† Detect VMs/emulators โ”‚ +โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ +``` + +**Why it matters**: A SheepShaver VM pretending to be a G4 Mac will fail these checks. Real vintage silicon has unique aging patterns that can't be faked. + +### 2. 1 CPU = 1 Vote (RIP-200) + +Unlike PoW where hash power = votes, RustChain uses **round-robin consensus**: + +- Each unique hardware device gets exactly 1 vote per epoch +- Rewards split equally among all voters, then multiplied by antiquity +- No advantage from running multiple threads or faster CPUs + +### 3. Epoch-Based Rewards + +``` +Epoch Duration: 10 minutes (600 seconds) +Base Reward Pool: 1.5 RTC per epoch +Distribution: Equal split ร— antiquity multiplier +``` + +**Example with 5 miners:** +``` +G4 Mac (2.5ร—): 0.30 RTC โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ +G5 Mac (2.0ร—): 0.24 RTC โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ +Modern PC (1.0ร—): 0.12 RTC โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ +Modern PC (1.0ร—): 0.12 RTC โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ +Modern PC (1.0ร—): 0.12 RTC โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆ + โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ +Total: 0.90 RTC (+ 0.60 RTC returned to pool) +``` + +## ๐ŸŒ Network Architecture + +### Live Nodes (3 Active) + +| Node | Location | Role | Status | +|------|----------|------|--------| +| **Node 1** | 50.28.86.131 | Primary + Explorer | โœ… Active | +| **Node 2** | 50.28.86.153 | Ergo Anchor | โœ… Active | +| **Node 3** | 76.8.228.245 | External (Community) | โœ… Active | + +### Ergo Blockchain Anchoring + +RustChain periodically anchors to the Ergo blockchain for immutability: + +``` +RustChain Epoch โ†’ Commitment Hash โ†’ Ergo Transaction (R4 register) +``` + +This provides cryptographic proof that RustChain state existed at a specific time. + +## ๐Ÿ“Š API Endpoints ```bash -python -m rustchain --help -``` \ No newline at end of file +# Check network health +curl -sk https://50.28.86.131/health + +# Get current epoch +curl -sk https://50.28.86.131/epoch + +# List active miners +curl -sk https://50.28.86.131/api/miners + +# Check wallet balance +curl -sk "https://50.28.86.131/wallet/balance?miner_id=YOUR_WALLET" + +# Block explorer (web browser) +open https://rustchain.org/explorer +``` + +## ๐Ÿ–ฅ๏ธ Supported Platforms + +| Platform | Architecture | Status | Notes | +|----------|--------------|--------|-------| +| **Mac OS X Tiger** | PowerPC G4/G5 | โœ… Full Support | Python 2.5 compatible miner | +| **Mac OS X Leopard** | PowerPC G4/G5 | โœ… Full Support | Recommended for vintage Macs | +| **Ubuntu Linux** | ppc64le/POWER8 | โœ… Full Support | Best performance | +| **Ubuntu Linux** | x86_64 | โœ… Full Support | Standard miner | +| **macOS Sonoma** | Apple Silicon | โœ… Full Support | M1/M2/M3 chips | +| **Windows 10/11** | x86_64 | โœ… Full Support | Python 3.8+ | +| **DOS** | 8086/286/386 | ๐Ÿ”ง Experimental | Badge rewards only | + +## ๐Ÿ… NFT Badge System + +Earn commemorative badges for mining milestones: + +| Badge | Requirement | Rarity | +|-------|-------------|--------| +| ๐Ÿ”ฅ **Bondi G3 Flamekeeper** | Mine on PowerPC G3 | Rare | +| โšก **QuickBasic Listener** | Mine from DOS machine | Legendary | +| ๐Ÿ› ๏ธ **DOS WiFi Alchemist** | Network DOS machine | Mythic | +| ๐Ÿ›๏ธ **Pantheon Pioneer** | First 100 miners | Limited | + +## ๐Ÿ”’ Security Model + +### Anti-VM Detection +VMs are detected and receive **1 billionth** of normal rewards: +``` +Real G4 Mac: 2.5ร— multiplier = 0.30 RTC/epoch +Emulated G4: 0.0000000025ร— = 0.0000000003 RTC/epoch +``` + +### Hardware Binding +Each hardware fingerprint is bound to one wallet. Prevents: +- Multiple wallets on same hardware +- Hardware spoofing +- Sybil attacks + +## ๐Ÿ“ Repository Structure + +``` +Rustchain/ +โ”œโ”€โ”€ rustchain_universal_miner.py # Main miner (all platforms) +โ”œโ”€โ”€ rustchain_v2_integrated.py # Full node implementation +โ”œโ”€โ”€ fingerprint_checks.py # Hardware verification +โ”œโ”€โ”€ install.sh # One-line installer +โ”œโ”€โ”€ docs/ +โ”‚ โ”œโ”€โ”€ RustChain_Whitepaper_*.pdf # Technical whitepaper +โ”‚ โ””โ”€โ”€ chain_architecture.md # Architecture docs +โ”œโ”€โ”€ tools/ +โ”‚ โ””โ”€โ”€ validator_core.py # Block validation +โ””โ”€โ”€ nfts/ # Badge definitions +``` + +## โœ… Beacon Certified Open Source (BCOS) + +RustChain accepts AI-assisted PRs, but we require *evidence* and *review* so maintainers don't drown in low-quality code generation. + +Read the draft spec: +- `docs/BEACON_CERTIFIED_OPEN_SOURCE.md` + +## ๐Ÿ”— Related Projects & Links + +| Resource | Link | +|---------|------| +| **Website** | [rustchain.org](https://rustchain.org) | +| **Block Explorer** | [rustchain.org/explorer](https://rustchain.org/explorer) | +| **Swap wRTC (Raydium)** | [Raydium DEX](https://raydium.io/swap/?inputMint=sol&outputMint=12TAdKXxcGf6oCv4rqDz2NkgxjyHq6HQKoxKZYGf5i4X) | +| **Price Chart** | [DexScreener](https://dexscreener.com/solana/8CF2Q8nSCxRacDShbtF86XTSrYjueBMKmfdR3MLdnYzb) | +| **Bridge RTC โ†” wRTC** | [BoTTube Bridge](https://bottube.ai/bridge) | +| **wRTC Token Mint** | `12TAdKXxcGf6oCv4rqDz2NkgxjyHq6HQKoxKZYGf5i4X` | +| **BoTTube** | [bottube.ai](https://bottube.ai) - AI video platform | +| **Moltbook** | [moltbook.com](https://moltbook.com) - AI social network | +| [nvidia-power8-patches](https://github.com/Scottcjn/nvidia-power8-patches) | NVIDIA drivers for POWER8 | +| [llama-cpp-power8](https://github.com/Scottcjn/llama-cpp-power8) | LLM inference on POWER8 | +| [ppc-compilers](https://github.com/Scottcjn/ppc-compilers) | Modern compilers for vintage Macs | + +## ๐Ÿ“ Articles + +- [Proof of Antiquity: A Blockchain That Rewards Vintage Hardware](https://dev.to/scottcjn/proof-of-antiquity-a-blockchain-that-rewards-vintage-hardware-4ii3) - Dev.to +- [I Run LLMs on a 768GB IBM POWER8 Server](https://dev.to/scottcjn/i-run-llms-on-a-768gb-ibm-power8-server-and-its-faster-than-you-think-1o) - Dev.to + +## ๐Ÿ™ Attribution + +**A year of development, real vintage hardware, electricity bills, and a dedicated lab went into this.** + +If you use RustChain: +- โญ **Star this repo** - Helps others find it +- ๐Ÿ“ **Credit in your project** - Keep the attribution +- ๐Ÿ”— **Link back** - Share the love + +``` +RustChain - Proof of Antiquity by Scott (Scottcjn) +https://github.com/Scottcjn/Rustchain +``` + +## ๐Ÿ“œ License + +MIT License - Free to use, but please keep the copyright notice and attribution. + +--- + +
+ +**Made with โšก by [Elyan Labs](https://elyanlabs.ai)** + +*"Your vintage hardware earns rewards. Make mining meaningful again."* + +**DOS boxes, PowerPC G4s, Win95 machines - they all have value. RustChain proves it.** + +
From 285671f2a61fca0320b7d33c4b121d020ab7968f Mon Sep 17 00:00:00 2001 From: jojo-771771 <13003236091@163.com> Date: Mon, 16 Feb 2026 13:53:52 +0800 Subject: [PATCH 10/11] Remove CONTRIBUTING.md - not part of translation bounty --- CONTRIBUTING.md | 1 - 1 file changed, 1 deletion(-) delete mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md deleted file mode 100644 index 99ddb276..00000000 --- a/CONTRIBUTING.md +++ /dev/null @@ -1 +0,0 @@ -# Contributing Guide\n## Setup\n`\.bash\ngit clone https://github.com/Scottcjn/Rustchain.git\ncd Rustchain\npip install -e .\n`\( \ No newline at end of file From d3e5e98590fec831b68aa18229a1a42d2fe7b3d0 Mon Sep 17 00:00:00 2001 From: jojo-771771 <13003236091@163.com> Date: Tue, 17 Feb 2026 00:44:04 +0800 Subject: [PATCH 11/11] Fix Simplified Chinese translation - based on actual README content --- README_CN.md | 46 ++++++++++++++++++---------------------------- 1 file changed, 18 insertions(+), 28 deletions(-) diff --git a/README_CN.md b/README_CN.md index 60d3178e..584bd4dc 100644 --- a/README_CN.md +++ b/README_CN.md @@ -1,54 +1,44 @@ +
+ # ๐Ÿงฑ RustChain: ๅค่‘ฃ่ฏๆ˜ŽๅŒบๅ—้“พ +[![CI](https://github.com/Scottcjn/Rustchain/actions/workflows/ci.yml/badge.svg)](https://github.com/Scottcjn/Rustchain/actions/workflows/ci.yml) +[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) + **็ฌฌไธ€ไธชๅฅ–ๅŠฑๆ—ง็กฌไปถ็š„ๅŒบๅ—้“พใ€‚** -*ไฝ ็š„PowerPC G4ๆฏ”็ŽฐไปฃThreadripper่ตšๅพ—ๆ›ดๅคšใ€‚่ฟ™ๅฐฑๆ˜ฏ้‡็‚นใ€‚* +*ไฝ ็š„ PowerPC G4 ๆฏ”็Žฐไปฃ Threadripper ่ตšๅพ—ๆ›ดๅคšใ€‚่ฟ™ๅฐฑๆ˜ฏๅ…ณ้”ฎใ€‚* + +[็ฝ‘็ซ™](https://rustchain.org) โ€ข [ๅฎžๆ—ถๆต่งˆๅ™จ](https://rustchain.org/explorer) + +
## ๐Ÿš€ ๅฟซ้€Ÿๅผ€ๅง‹ ```bash git clone https://github.com/Scottcjn/Rustchain.git cd Rustchain -pip install -r requirements.txt -python rustchain_node.py +./install.sh ``` ## ๐Ÿ”ง ๅค่‘ฃ่ฏๆ˜Žๅฆ‚ไฝ•่ฟไฝœ -ไธŽๆฏ”็‰นๅธ็š„"ๅทฅไฝœ้‡่ฏๆ˜Ž"ไธๅŒ๏ผŒRustChainไฝฟ็”จ"ๅค่‘ฃ่ฏๆ˜Ž": +ไธŽๆฏ”็‰นๅธ็š„"ๅทฅไฝœ้‡่ฏๆ˜Ž"ไธๅŒ๏ผŒRustChain ไฝฟ็”จ**ๅค่‘ฃ่ฏๆ˜Ž**๏ผš -- **็กฌไปถๅนด้พ„**: ่ถŠ่€ = ๅฅ–ๅŠฑ่ถŠ้ซ˜ -- **PowerPC G3/G4/G5**: ๆœ€้ซ˜ๅฅ–ๅŠฑ -- **็ŽฐไปฃCPU**: ๆ ‡ๅ‡†ๅฅ–ๅŠฑ +- **็กฌไปถ่ถŠ่€ = ๅฅ–ๅŠฑ่ถŠ้ซ˜** +- **PowerPC G3/G4/G5**๏ผšๆœ€้ซ˜ๅฅ–ๅŠฑ +- **็Žฐไปฃ CPU**๏ผšๅŸบๅ‡†ๅฅ–ๅŠฑ ## ๐Ÿ’ฐ ๆŒ–็Ÿฟ ```bash -python miners/rustchain_miner.py -``` - -## ๐Ÿ“Š ๅŒบๅ—้“พๆต่งˆๅ™จ - -```bash -python explorer/blockchain_explorer.py +./start-miner.sh ``` -## ๐ŸŽจ ็คพๅŒบ - -- [Discord](https://discord.gg/rustchain) -- [Twitter](https://twitter.com/rustchain) -- [BoTTube](https://bottube.ai) - ## ๐Ÿค ่ดก็Œฎ -ๆฌข่ฟŽPR๏ผ่ฏท้˜…่ฏป[CONTRIBUTING.md](CONTRIBUTING.md) - -## ๐Ÿ“ ่ฎธๅฏ่ฏ - -MIT่ฎธๅฏ่ฏ - ่ฏฆ่ง[LICENSE](LICENSE) +ๆŸฅ็œ‹ [CONTRIBUTING.md](CONTRIBUTING.md) --- -*็”ฑ Elyan Labs ๅˆ›ๅปบ* -*็ฟป่ฏ‘่€…: @jojo-771771* -*ๆ—ฅๆœŸ: 2026-02-16* +*็”ฑ Elyan Labs ๅˆ›ๅปบ* โ€ข *็ฟป่ฏ‘่€…: @jojo-771771*