How achyutranaut/voltmesh works
VoltMesh is an energy-exchange application spanning a web terminal and services for metering, market clearing, and attestations. The user-facing flow presents meter data, matching, verification, settlement, and certificates through operational views and a staged pipeline; backend components support ingestion, clearing, and epoch construction. The 3D exchange engine is an explanatory interface, not evidence of a live transaction pipeline. Connections reflect imports and calls shown in excerpts or the SOURCE INDEX; unsampled service wiring and external integrations are not inferred.
Main entry points: App.tsx Application shell · app.ts Attestation endpoint · canonical.ts Attestation primitives · index.ts Shared domain types
Components 25
Web application
- Application shell
apps/web/src/App.tsx - Pipeline state
apps/web/src/context/PipelineContext.tsx - Wallet context
apps/web/src/context/WalletContext.tsx - Market terminal
apps/web/src/components/market/MarketTerminalView.tsx - Meter views
apps/web/src/components/energy/EnergyMetersView.tsx - Oracle epochs
apps/web/src/components/oracle/OracleEpochsView.tsx - Merkle proofs
apps/web/src/components/oracle/CanonicalMerkleTree.tsx - Settlement view
apps/web/src/components/settlement/SettlementView.tsx - Certificates
apps/web/src/components/certificates/CertificatesView.tsx - Exchange engine
apps/web/src/components/energy-exchange-engine/EnergyExchangeEngine.tsx - 3D scene
apps/web/src/components/energy-exchange-engine/EnergyEngineScene.tsx - Station definitions
apps/web/src/components/energy-exchange-engine/EnergyEngineStation.tsx - Engine controls
apps/web/src/components/energy-exchange-engine/EnergyEngineControls.tsx
Meter ingestion
- Attestation endpoint
services/ingest-gateway/src/app.ts - Attestation validator
services/ingest-gateway/src/validator.ts - Reading storage
services/ingest-gateway/src/storage.ts - PostgreSQL
Market services
- Exchange API
services/api/src/app.ts - Order matcher
services/matcher/src/matcher.ts - Epoch builder
services/epoch-builder/src/builder.ts
Domain packages
- Clearing logic
packages/clearing/src/clearing.ts - Attestation primitives
packages/attestation/src/canonical.ts - Shared domain types
packages/types/src/index.ts
Simulation
- Meter simulator
simulators/meter-sim/src/simulator.ts
Other components
- Participant
Connections 30
- Participant → Application shell: uses
apps/web/src/App.tsx - Application shell → Pipeline state: uses state
apps/web/src/App.tsx - Application shell → Wallet context: uses context
apps/web/src/main.tsx - Application shell → Market terminal: renders
apps/web/src/App.tsx - Application shell → Meter views: renders
apps/web/src/App.tsx - Application shell → Oracle epochs: renders
apps/web/src/App.tsx - Application shell → Merkle proofs: renders
apps/web/src/App.tsx - Application shell → Settlement view: renders
apps/web/src/App.tsx - Application shell → Certificates: renders
apps/web/src/App.tsx - Application shell → Exchange engine: renders
- Exchange engine → 3D scene: initializes
apps/web/src/components/energy-exchange-engine/EnergyExchangeEngine.tsx - 3D scene → Station definitions: uses definitions
apps/web/src/components/energy-exchange-engine/EnergyEngineScene.tsx - Exchange engine → Engine controls: renders controls
apps/web/src/components/energy-exchange-engine/EnergyExchangeEngine.tsx - Participant → Attestation endpoint: submits readings
- Attestation endpoint → Attestation validator: validates
services/ingest-gateway/src/app.ts - Attestation endpoint → Reading storage: stores and reads
services/ingest-gateway/src/app.ts - Reading storage → PostgreSQL: queries
services/ingest-gateway/src/storage.ts - Exchange API → Clearing logic: calls
services/api/src/app.ts - Exchange API → Attestation primitives: uses primitives
services/api/src/app.ts - Order matcher → Clearing logic: uses clearing
services/matcher/src/matcher.ts - Epoch builder → Attestation primitives: uses primitives
services/epoch-builder/src/builder.ts - Attestation endpoint → Attestation primitives: hashes readings
services/ingest-gateway/src/app.ts - Attestation endpoint → Shared domain types: uses types
services/ingest-gateway/src/app.ts - Exchange API → Shared domain types: uses types
services/api/src/app.ts - Clearing logic → Attestation primitives: uses primitives
packages/clearing/src/clearing.ts - Order matcher → Shared domain types: uses types
services/matcher/src/matcher.ts - Epoch builder → Shared domain types: uses types
services/epoch-builder/src/builder.ts - Meter simulator → Shared domain types: uses types
simulators/meter-sim/src/simulator.ts - Meter simulator → Attestation primitives: uses primitives
simulators/meter-sim/src/simulator.ts - Application shell → Meter simulator: simulates readings
apps/web/src/App.tsx