wifi-densepose/examples/edge-net/sim
ruv d803bfe2b1 Squashed 'vendor/ruvector/' content from commit b64c2172
git-subtree-dir: vendor/ruvector
git-subtree-split: b64c21726f2bb37286d9ee36a7869fef60cc6900
2026-02-28 14:39:40 -05:00
..
dist Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
examples Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
scripts Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
src Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
tests Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
.gitignore Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
COMPLETION_REPORT.md Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
INDEX.md Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
PROJECT_SUMMARY.md Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
README.md Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
SIMULATION_GUIDE.md Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
SIMULATION_OVERVIEW.md Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
USAGE.md Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
package.json Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
test-quick.sh Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00
tsconfig.json Squashed 'vendor/ruvector/' content from commit b64c2172 2026-02-28 14:39:40 -05:00

README.md

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.