ruvector/examples/edge-net/sim/README.md
rUv 383c791101 feat(edge-net): add Pi-Key crypto, lifecycle simulation, optimizations
- Add Pi-Key WASM cryptographic module with mathematical constant sizing
  - Pi-sized (314 bits/40 bytes) identity keys
  - Euler-sized (271 bits/34 bytes) session keys
  - Phi-sized (161 bits/21 bytes) genesis keys
  - Ed25519 signing + AES-256-GCM encryption

- Add comprehensive TypeScript lifecycle simulation (sim/)
  - 6 source files, 1,420 lines
  - Validates all 4 phases: Genesis → Growth → Maturation → Independence
  - Economic sustainability and phase transition testing

- Performance optimizations
  - FxHashMap for 30-50% faster lookups in evolution/mod.rs
  - VecDeque for O(1) front removal
  - Batched Q-learning updates in security/mod.rs
  - Fixed borrow checker error in process_batch_updates()

- Add benchmarks and documentation
  - BENCHMARKS.md with performance metrics
  - PERFORMANCE_OPTIMIZATIONS.md with details
  - docs/FINAL_REPORT.md comprehensive summary

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-01 01:29:11 +00:00

1.9 KiB

Edge-Net Genesis Phase Simulation

A comprehensive simulation framework for testing the Edge-Net distributed compute network lifecycle, from genesis bootstrap to full decentralization.

Overview

This simulation models the complete lifecycle of the Edge-Net network across four distinct phases:

  1. Genesis Phase (0 - 10K nodes): Network bootstrap with genesis nodes providing foundation
  2. Transition Phase (10K - 50K nodes): Genesis sunset preparation and network resilience testing
  3. Maturity Phase (50K - 100K nodes): Genesis read-only mode, full self-sustenance
  4. Post-Genesis Phase (100K+ nodes): Complete decentralization, genesis retirement

Features

  • Realistic Node Behavior: Simulates node joining, leaving, task processing, and economic activity
  • Economic Modeling: Tracks rUv (Resource Utility Vouchers) distribution, treasury, and protocol sustainability
  • Phase Transitions: Automatic detection and validation of lifecycle phase transitions
  • Genesis Sunset: Models the graceful retirement of genesis nodes as the network matures
  • Health Monitoring: Comprehensive network health metrics and economic indicators
  • Visualization: ASCII charts and detailed reports of simulation results
  • Validation: Test suite to ensure simulation accuracy

Installation

cd /workspaces/ruvector/examples/edge-net/sim
npm install

Quick Start

Run a full lifecycle simulation:

npm run sim:full

Run specific phases:

npm run sim:genesis      # Genesis phase only (0-10K nodes)
npm run sim:transition   # Through transition (0-50K nodes)
npm run sim:maturity     # Through maturity (0-100K nodes)

Testing

npm test

Documentation

See full documentation in this README file for:

  • Command line options
  • Simulation architecture
  • Phase details
  • Economic model
  • Visualization and reports
  • E2B integration

Built with edge-net for distributed compute intelligence.