diff --git a/README.md b/README.md index e4574d4d..cd084e90 100644 --- a/README.md +++ b/README.md @@ -7,22 +7,50 @@ [![GitHub Stars](https://img.shields.io/github/stars/Scottcjn/Rustchain?style=flat&color=gold)](https://github.com/Scottcjn/Rustchain/stargazers) [![Contributors](https://img.shields.io/github/contributors/Scottcjn/Rustchain?color=brightgreen)](https://github.com/Scottcjn/Rustchain/graphs/contributors) [![Last Commit](https://img.shields.io/github/last-commit/Scottcjn/Rustchain?color=blue)](https://github.com/Scottcjn/Rustchain/commits/main) -[![Open Issues](https://img.shields.io/github/issues/Scottcjn/Rustchain?color=orange)](https://github.com/Scottcjn/Rustchain/issues) -[![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) +[![Bounties](https://img.shields.io/badge/Bounties-Open%20%F0%9F%92%B0-green)](https://github.com/Scottcjn/rustchain-bounties/issues) +[![As seen on BoTTube](https://bottube.ai/badge/seen-on-bottube.svg)](https://bottube.ai) +[![Discussions](https://img.shields.io/github/discussions/Scottcjn/Rustchain?color=purple)](https://github.com/Scottcjn/Rustchain/discussions) + +## 5,000 Stars Campaign + +**Pool: 5,000 RTC ($500 value)** | Currently at **337 stars** across 86 repos — need **4,663 more**. + + [![Python](https://img.shields.io/badge/Python-3.x-yellow)](https://www.python.org) -[![Network](https://img.shields.io/badge/Nodes-3%20Active-brightgreen)](https://rustchain.org/explorer) +[![Network](https://img.shields.io/badge/Nodes-4%20Active-brightgreen)](https://rustchain.org/explorer) [![Bounties](https://img.shields.io/badge/Bounties-Open%20%F0%9F%92%B0-green)](https://github.com/Scottcjn/rustchain-bounties/issues) [![As seen on BoTTube](https://bottube.ai/badge/seen-on-bottube.svg)](https://bottube.ai) [![Discussions](https://img.shields.io/github/discussions/Scottcjn/Rustchain?color=purple)](https://github.com/Scottcjn/Rustchain/discussions) **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.* +*Named after a 486 with rusty serial ports that still boots. That's the whole 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) +*Your PowerPC G4 earns more than a modern Threadripper.* - +[Website](https://rustchain.org) • [Manifesto](https://rustchain.org/manifesto.html) • [Boudreaux Principles](docs/BOUDREAUX_COMPUTING_PRINCIPLES.md) • [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) • [Quickstart](#-quickstart) • [How It Works](#-how-proof-of-antiquity-works) + +--- + + 🌐 **Languages** + +[English](README.md) | [日本語](README_JA.md) | [हिन्दी](README_HI.md) | [Deutsch](README_DE.md) | [Español](README_ES.md) | [中文](README_ZH.md) + + +--- + +## Q1 2026 Traction + +> *Data from [live GitHub API pull](https://github.com/Scottcjn/Rustchain/blob/main/docs/DEVELOPER_TRACTION_Q1_2026.md) compared against [GitClear](https://www.gitclear.com/research_studies/git_commit_count_percentiles_annual_days_active_from_largest_data_set) (878K dev-years) and [LinearB](https://linearb.io/resources/software-engineering-benchmarks-report) (8.1M PRs) benchmarks.* + +| Metric (90 days) | Elyan Labs | Industry Median | +|-------------------|-----------|----------------| +| Commits | **1,882** | 105-168 | +| Repos shipped | **97** | 1-3 | +| External contributions | **32 PRs** | 0-2 | +| Funding | **$0** | $0 | + +**[Full traction report with methodology and sources →](https://github.com/Scottcjn/Rustchain/blob/main/docs/DEVELOPER_TRACTION_Q1_2026.md)** --- @@ -115,7 +143,13 @@ clawrtc wallet coinbase link 0xYourBaseAddress **Core Principle**: Authentic vintage hardware that has survived decades deserves recognition. RustChain flips mining upside-down. -## ⚡ Quick Start +### Why "RustChain"? + +The name comes from a literal 486 laptop with oxidized serial ports that still boots to DOS and mines RTC. "Rust" here means iron oxide on 30-year-old silicon — not the programming language (though we do have [Rust components](https://github.com/Scottcjn/clawrtc-rs) too). The whole thesis is that corroding vintage hardware still has computational value and dignity. If your machine has rusty ports and still computes, it belongs here. + +## ⚡ Quickstart + +> 🎬 **Visual Guide**: Watch the [Installation Walkthrough](docs/INSTALLATION_WALKTHROUGH.md) for step-by-step video recordings of the installation and first attestation process. ### One-Line Install (Recommended) ```bash @@ -154,6 +188,7 @@ curl -sSL https://raw.githubusercontent.com/Scottcjn/Rustchain/main/install-mine python3 --version curl -sSL https://raw.githubusercontent.com/Scottcjn/Rustchain/main/install-miner.sh | bash ``` +- **`clawrtc wallet show` says `could not reach network`**: verify the live node directly with `curl -sk https://rustchain.org/health` and `curl -sk "https://rustchain.org/wallet/balance?miner_id=YOUR_WALLET_NAME"`. Older helper builds may still reference the retired `bulbous-bouffant.metalseed.net` host, and current `clawrtc` releases do not expose a generic `wallet show` subcommand. - **HTTPS certificate errors in `curl`**: this can happen with non-browser client environments; check connectivity first with `curl -I https://rustchain.org` before wallet checks. - **Miner exits immediately**: verify wallet exists and service is running (`systemctl --user status rustchain-miner` or `launchctl list | grep rustchain`) @@ -221,6 +256,10 @@ Earn **RTC** by contributing to the RustChain ecosystem! --- +## Testing Notes + +- Attestation malformed-input fuzz harness and replayable corpus: [docs/attestation_fuzzing.md](docs/attestation_fuzzing.md) + ## 💰 Antiquity Multipliers Your hardware's age determines your mining rewards: @@ -325,6 +364,50 @@ curl -sk "https://rustchain.org/wallet/balance?miner_id=YOUR_WALLET" open https://rustchain.org/explorer ``` +### Governance Proposals & Voting + +Rules: +- Proposal lifecycle: `Draft -> Active (7 days) -> Passed/Failed` +- Proposal creation: wallet must hold **more than 10 RTC** +- Voting eligibility: voter must be an **active miner** (from the attested miners view) +- Signature: votes require **Ed25519** signature verification +- Vote weight: `1 RTC = 1 base vote`, then multiplied by the miner antiquity multiplier +- Pass condition at close: `yes_weight > no_weight` + +Endpoints: + +```bash +# Create proposal +curl -sk -X POST https://rustchain.org/governance/propose \ + -H 'Content-Type: application/json' \ + -d '{ + "wallet":"RTC...", + "title":"Enable parameter X", + "description":"Rationale and implementation details" + }' + +# List proposals +curl -sk https://rustchain.org/governance/proposals + +# Proposal detail +curl -sk https://rustchain.org/governance/proposal/1 + +# Submit signed vote +curl -sk -X POST https://rustchain.org/governance/vote \ + -H 'Content-Type: application/json' \ + -d '{ + "proposal_id":1, + "wallet":"RTC...", + "vote":"yes", + "nonce":"1700000000", + "public_key":"", + "signature":"" + }' +``` + +Web UI: +- `GET /governance/ui` serves a lightweight page to list proposals and submit votes. + ## 🖥️ Supported Platforms | Platform | Architecture | Status | Notes | @@ -335,6 +418,7 @@ open https://rustchain.org/explorer | **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+ | +| **NAS (TerraMaster/Synology)** | aarch64 (ARM) | ✅ Full Support | Entware + Python 3.11, low payout (modern ARM) | | **DOS** | 8086/286/386 | 🔧 Experimental | Badge rewards only | ## 🏅 NFT Badge System @@ -406,7 +490,6 @@ Read the draft spec: | [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 @@ -452,3 +535,61 @@ clawrtc mine --dry-run ``` Expected: all 6 hardware fingerprint checks execute on native ARM64 without architecture fallback errors. + +--- + +## Tech Stack + +*Other projects flex React and Kubernetes. We flex COBOL and N64 assembly.* + +**Vintage & Retro** — the stuff nobody else runs: + +![COBOL](https://img.shields.io/badge/COBOL-%F0%9F%91%B4_Grandpa_Code-8B4513?style=flat-square) +![68K](https://img.shields.io/badge/68K-Mac_Classic-000000?style=flat-square&logo=apple&logoColor=white) +![i386](https://img.shields.io/badge/i386-DOS-808080?style=flat-square&logo=intel&logoColor=white) +![N64](https://img.shields.io/badge/N64-MIPS_R4300i-E60012?style=flat-square&logo=nintendo&logoColor=white) +![N64 ASM](https://img.shields.io/badge/N64_ASM-f3d_opcodes-228B22?style=flat-square) +![NES](https://img.shields.io/badge/NES-6502-CC0000?style=flat-square) +![Game Boy](https://img.shields.io/badge/Game_Boy-Z80-8DB600?style=flat-square) +![Amiga](https://img.shields.io/badge/Amiga-Kickstart-FF4500?style=flat-square) +![SPARC](https://img.shields.io/badge/SPARC-Sun-FF6600?style=flat-square) + +**PowerPC & POWER** — where the antiquity bonus lives: + +![G4](https://img.shields.io/badge/G4-2.5x_Antiquity-7B68EE?style=flat-square&logo=apple&logoColor=white) +![G5](https://img.shields.io/badge/G5-Dual_970-9370DB?style=flat-square&logo=apple&logoColor=white) +![POWER8](https://img.shields.io/badge/POWER8-128_Threads-0530AD?style=flat-square&logo=ibm&logoColor=white) +![512GB](https://img.shields.io/badge/RAM-512_GB-DC143C?style=flat-square) +![VSX](https://img.shields.io/badge/VSX-vec__perm-4B0082?style=flat-square) +![AltiVec](https://img.shields.io/badge/AltiVec-Velocity_Engine-8A2BE2?style=flat-square) + +**AI & Blockchain** — the frontier: + +![llama.cpp](https://img.shields.io/badge/llama.cpp-PSE_Fork-00ADD8?style=flat-square) +![Claude](https://img.shields.io/badge/Claude-Opus_4-D4A574?style=flat-square&logo=anthropic&logoColor=white) +![CUDA](https://img.shields.io/badge/CUDA-V100_%C3%973-76B900?style=flat-square&logo=nvidia&logoColor=white) +![GGUF](https://img.shields.io/badge/GGUF-Q4__K__M-FF6347?style=flat-square) +![Ergo](https://img.shields.io/badge/Ergo-Anchor-FF5733?style=flat-square) +![Rust](https://img.shields.io/badge/Rust-Ed25519-DEA584?style=flat-square&logo=rust&logoColor=black) +![Python](https://img.shields.io/badge/Python-Flask-3776AB?style=flat-square&logo=python&logoColor=white) +![SQLite](https://img.shields.io/badge/SQLite-Every_DB-003B57?style=flat-square&logo=sqlite&logoColor=white) + +**Hardware** — 18 GPUs, all from pawn shops and eBay: + +![228GB VRAM](https://img.shields.io/badge/VRAM-228_GB-FF1493?style=flat-square) +![18 GPUs](https://img.shields.io/badge/GPUs-18-76B900?style=flat-square) +![FPGA](https://img.shields.io/badge/Alveo_U30-FPGA_%C3%972-EE3524?style=flat-square) +![Hailo](https://img.shields.io/badge/Hailo--8-TPU-00BFFF?style=flat-square) +![VC](https://img.shields.io/badge/VC_Funding-$0-228B22?style=flat-square) +![Pawn Shop](https://img.shields.io/badge/Source-%F0%9F%8F%AA_Pawn_Shops-DAA520?style=flat-square) + + +--- + +
+ +**[Elyan Labs](https://github.com/Scottcjn)** · Built with $0 VC and a room full of pawn shop hardware + +[⭐ Star Rustchain](https://github.com/Scottcjn/Rustchain) · [📊 Traction Report](https://github.com/Scottcjn/Rustchain/blob/main/docs/DEVELOPER_TRACTION_Q1_2026.md) · [Follow @Scottcjn](https://github.com/Scottcjn) + +
diff --git a/README_shanaboo.md b/README_shanaboo.md new file mode 100644 index 00000000..1f64ec40 --- /dev/null +++ b/README_shanaboo.md @@ -0,0 +1,8 @@ +diff --git a/README.md b/README.md +index 8b13789..f4c6f4a 100644 +--- a/README.md ++++ b/README.md +@@ -1 +1,3 @@ ++# Rustchain + ++A minimal blockchain implementation in Rust for educational purposes. diff --git a/_shanaboo.patch b/_shanaboo.patch new file mode 100644 index 00000000..1f64ec40 --- /dev/null +++ b/_shanaboo.patch @@ -0,0 +1,8 @@ +diff --git a/README.md b/README.md +index 8b13789..f4c6f4a 100644 +--- a/README.md ++++ b/README.md +@@ -1 +1,3 @@ ++# Rustchain + ++A minimal blockchain implementation in Rust for educational purposes. diff --git a/shanaboo/a/README.md b/shanaboo/a/README.md new file mode 100644 index 00000000..2ec7dbcc --- /dev/null +++ b/shanaboo/a/README.md @@ -0,0 +1,11 @@ +# Rustchain +🦀 A minimal, educational blockchain implementation in Rust. + +## 🌟 Help Us Reach 5,000 Stars! +We’re participating in the **Rustchain 5,000 Stars Campaign** to qualify for the Claude Code Open Source program. +Every star brings us closer to unlocking **5,000 RTC ($500)** in community rewards. + +### How to Contribute +1. **Star this repository** ⭐ +2. Visit [rustchain.org/stars](https://rustchain.org/stars.html) to star the other 85 repos in the campaign. +3. Claim your RTC rewards by following the instructions at [rustchain-bounties#478](https://github.com/Scottcjn/rustchain-bounties/issues/478). \ No newline at end of file diff --git a/shanaboo_solution.md b/shanaboo_solution.md new file mode 100644 index 00000000..bb6f777c --- /dev/null +++ b/shanaboo_solution.md @@ -0,0 +1,7 @@ +```diff +--- a/README.md ++++ b/README.md +@@ -1,2 +1,3 @@ + # Rustchain + A blazing-fast blockchain implementation in Rust. ++⭐️ If you find this project useful, please consider giving it a star on GitHub! Your support helps us qualify for the Claude Code Open Source program. \ No newline at end of file