Merge pull request #21 from Steake/feature/economic-system-and-rewards

Author: Steake

.github/workflows/benchmarks.yml

@@ -9,7 +9,7 @@ on:
 jobs:
   benchmark:
     name: Run Benchmarks
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest-xl
     steps:
       - uses: actions/checkout@v4
 

.github/workflows/ci.yml

@@ -16,7 +16,7 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
+        os: [ubuntu-latest-xl, macos-latest, windows-latest]
         rust: [stable]
     steps:
       - uses: actions/checkout@v4
@@ -53,7 +53,7 @@ jobs:
 
   fmt:
     name: Rustfmt
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest-xl
     steps:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
@@ -63,7 +63,7 @@ jobs:
 
   clippy:
     name: Clippy
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest-xl
     steps:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
@@ -73,7 +73,7 @@ jobs:
 
   build:
     name: Build
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest-xl
     steps:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
@@ -86,7 +86,7 @@ jobs:
 
   security:
     name: Security Audit
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest-xl
     steps:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
@@ -99,7 +99,7 @@ jobs:
 
   coverage:
     name: Code Coverage
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest-xl
     steps:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable

.github/workflows/release.yml

@@ -19,7 +19,7 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - os: ubuntu-latest
+          - os: ubuntu-latest-xl
             target: x86_64-unknown-linux-gnu
             artifact_name: bitcell-linux-x86_64
           - os: macos-latest
@@ -115,7 +115,7 @@ jobs:
   release:
     name: Upload Release Assets
     needs: build
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-latest-xl
     if: github.event_name == 'release'
     permissions:
       contents: write

README.md

@@ -4,7 +4,7 @@
 
 [![Rust](https://img.shields.io/badge/rust-1.82%2B-orange.svg)](https://www.rust-lang.org/)
 [![License](https://img.shields.io/badge/license-MIT%2FApache--2.0-blue.svg)](LICENSE)
-[![Status](https://img.shields.io/badge/status-alpha-yellow.svg)](https://github.com/Steake/BitCell)
+[![Status](https://img.shields.io/badge/status-RC1-green.svg)](https://github.com/Steake/BitCell)
 
 > _"We don't mine blocks. We cultivate them in a Conway garden where only the fittest gliders survive."_
 
@@ -174,9 +174,14 @@ Three independent circuits:
 **v0.1**: Individual Groth16 proofs  
 **Future**: Recursive aggregation via Plonk/STARK
 
-## Economics (Deterministic Payouts)
+## Economics (Bitcoin-Style Halving)
 
 ```
+Initial block reward: 50 CELL
+Halving interval: 210,000 blocks (~4 years)
+Maximum halvings: 64 (subsidy reaches 0)
+Total supply: ~21 million CELL
+
 block_reward = base_subsidy(h) + tx_fees + contract_fees
 
 Distribution:
@@ -252,13 +257,17 @@ BitCell/
 │   ├── bitcell-ebsl/       # Evidence tracking, trust scores, slashing
 │   ├── bitcell-zkp/        # Groth16 circuits (battle, exec, state)
 │   ├── bitcell-consensus/  # Blocks, tournament protocol, fork choice
-│   ├── bitcell-state/      # State management, bonds, accounts
+│   ├── bitcell-state/      # State management, bonds, accounts (RocksDB)
 │   ├── bitcell-zkvm/       # Private smart contract execution
-│   ├── bitcell-economics/  # Rewards, fees, treasury
-│   ├── bitcell-network/    # P2P, gossip, compact blocks
-│   └── bitcell-node/       # Miner/validator/light client nodes
-├── docs/                   # Architecture, specs, tutorials
-├── benches/                # Performance benchmarks
+│   ├── bitcell-economics/  # Rewards, fees, treasury, halving
+│   ├── bitcell-network/    # libp2p, gossip, DHT, compact blocks
+│   ├── bitcell-node/       # Miner/validator nodes, JSON-RPC, WebSocket
+│   ├── bitcell-wallet/     # CLI wallet
+│   ├── bitcell-wallet-gui/ # GUI wallet with tournament visualization
+│   ├── bitcell-admin/      # Admin console with metrics
+│   └── bitcell-simulation/ # Network simulation and testing
+├── docs/                   # Architecture, specs, release notes
+├── scripts/                # Development and testing scripts
 └── tests/                  # Integration tests
 ```
 
@@ -302,33 +311,38 @@ We're in alpha. Things break. PRs welcome.
 
 ## Roadmap
 
-### v0.1 (Current: Alpha)
+### v0.1 ✅ (Alpha)
 - [x] Core crypto primitives (ECDSA, VRF, ring sigs, commitments)
 - [x] CA engine with battles (1024×1024 grid, Conway rules, energy)
 - [x] EBSL trust scores (evidence tracking, decay, slashing)
-- [ ] ZK circuits (battle verification, execution, state)
-- [ ] Consensus structures (blocks, tournament, fork choice)
-- [ ] P2P networking (gossip, compact blocks)
-- [ ] Local testnet
-
-### v0.2 (Beta)
-- [ ] ZKVM execution
-- [ ] Smart contract deployment
-- [ ] State management
-- [ ] Full validator implementation
-- [ ] Public testnet
-- [ ] Explorer
-
-### v0.3 (Candidate)
+- [x] ZK circuits (battle verification, execution, state constraints)
+- [x] Consensus structures (blocks, tournament, fork choice)
+- [x] P2P networking (libp2p-based gossip, DHT)
+- [x] Local testnet
+
+### v0.2 ✅ (Beta)
+- [x] ZKVM execution framework
+- [x] Smart contract deployment (basic)
+- [x] State management with RocksDB persistence
+- [x] Full validator implementation
+- [x] GUI Wallet with tournament visualization
+- [x] Admin console with metrics
+
+### v0.3 (Current: Release Candidate 1)
+- [x] JSON-RPC and WebSocket APIs
+- [x] Block reward halving mechanism (Bitcoin-style economics)
+- [x] Transaction processing and mempool
+- [x] Comprehensive economic parameters
+- [x] Security improvements (DoS protection, gas limits)
 - [ ] Light clients
 - [ ] Bridge to Ethereum
 - [ ] DeFi primitives
-- [ ] Governance system
-- [ ] Security audit
 
 ### v1.0 (Mainnet)
-- [ ] Production-ready zkSNARKs
-- [ ] Optimized CA performance
+- [ ] Production-ready zkSNARKs (recursive aggregation)
+- [ ] Governance system
+- [ ] Security audit
+- [ ] Optimized CA performance (SIMD/GPU)
 - [ ] Mobile wallets
 - [ ] Full documentation
 - [ ] 🚀 Launch