First Demo en

中文 | English

First Demo

Maintained version: v0.51.2 ｜ Last updated: 2026-07-06

EnerOS v0.50.0+ ships enerosctl demo — a one-command MVP loop demonstration using IEEE-14 topology + IEC 104 mock + SafetyGateway + audit. This page walks through the 7-step API sequence. Source: README.md §Quick Demo.

Prerequisites

• EnerOS built and running (see Getting Started)
• enerosctl available in PATH

7-Step Walkthrough

# 1. Start the demo (launches eneros-api with mock IEC 104 + IEEE-14)
enerosctl demo start

# 2. Health check
curl http://localhost:8080/health
# {"status":"ok","version":"0.51.2"}

# 3. View demo state (current topology + devices + measurements)
curl http://localhost:8080/api/v1/demo/state

# 4. View Agent decisions (105 decisions, 100% audited)
curl http://localhost:8080/api/v1/demo/decisions

# 5. View audit log (HMAC chain)
curl http://localhost:8080/api/v1/demo/audit

# 6. Replay a decision (deterministic replay from audit log)
curl -X POST http://localhost:8080/api/v1/demo/replay \
  -H "Content-Type: application/json" \
  -d '{"decision_id":"decision_001"}'

# 7. Stop demo
enerosctl demo stop

Expected Results

Step	Expected
Health	status: ok, version matches
Demo state	IEEE-14 topology with 14 buses + 20 branches
Decisions	105 decisions, all audited
Audit	HMAC chain intact, no tampering
Replay	Deterministic, identical output

Known Limitations (v0.51.2)

Limitation	Impact	Planned fix
IEC 104 mock is not production-grade	Demo only, do not use in production	v0.52.0+ real IEC 104 device testing
GridSimulator::step is a placeholder	Simplified simulation	v0.52.0+ real dynamic simulation
RepositoryAuditSink HMAC chain hardened in v0.51.0	Demo audit may use InMemoryAuditSink	Configure [audit] section for production

Related Docs

• Safety Gateway — Type-level unbypassable gateway
• Agent Runtime — 7 domain Agents
• Main repo README.md §Quick Demo
• Main repo tests/e2e/ — E2E tests