wifi-densepose/vendor/ruvector/examples/edge-net/sim
ruv cd5943df23 Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
..
dist Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
examples Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
scripts Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
src Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
tests Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
.gitignore Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
COMPLETION_REPORT.md Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
INDEX.md Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
PROJECT_SUMMARY.md Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
README.md Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
SIMULATION_GUIDE.md Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
SIMULATION_OVERVIEW.md Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
USAGE.md Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
package.json Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
test-quick.sh Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 2026-02-28 14:39:40 -05:00
tsconfig.json Merge commit 'd803bfe2b1fe7f5e219e50ac20d6801a0a58ac75' as 'vendor/ruvector' 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.