SCEP-Simulator

Councils & operators tool for the Symbolic Coherence Exchange Protocol (SCEP). It simulates issuance/burn dynamics, adversaries, and circuit breakers; exports daily history and a parameter snapshot.

Quickstart

# create env
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

# run the Streamlit app
streamlit run simulator/scep_simulator.py

Repo layout

• simulator/scep_simulator.py — main Streamlit app (v0.9, council-ready).
• examples/scep_history.csv — example export from a 730-day run.
• tests/test_smoke.py — minimal load test for CI.
• .github/workflows/ci.yml — lint + test on PRs.
• SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md — governance basics.

Exports

• scep_history.csv — one row per day (price, supply, mint, burn, ROI, P&L, halts, queued_burn).
• scep_params.csv — single-row parameter snapshot (seed, η, η_b, θ, gates, discovery_rate, breaker settings, etc.).

Versioning

Semantic tags: vMAJOR.MINOR.PATCH (e.g., v0.9.0). Simulator shows its version in the UI footer.

License

Apache-2.0 (see LICENSE).