Canonical system specification for an event-sourced multi-currency execution and edge-stacking engine. An immutable append-only ledger of deposits, orders, fills, fees, FX conversions, transfers, settlement adjustments, and reconciliation corrections — designed to be auditable, replayable, and multi-venue.
edge_stacking_system_spec.txt— the canonical design document. Covers: core philosophy, global non-negotiables, system architecture, the event-sourced ledger, event schema, event type taxonomy, and reconciliation rules.AI_CANONICAL_IMPLEMENTATION_PROMPT.txt— an implementation prompt that compresses the spec into instructions an AI implementer can consume without drift.
Implementation trends toward drift. A crisp, version-controlled, prose-first specification is the only reliable root-of-truth for a multi-currency trading backbone. Any language, any runtime, any venue — everyone implements from the same document, not from someone's memory.
- Event-sourced ledger: every balance change is an immutable event. No direct balance edits. Current state is a fold over events.
- Event schema:
(event_id, timestamp, venue, currency, delta_available, delta_reserved, delta_pending, reference_id, event_type, notes). - Event taxonomy:
DEPOSIT,WITHDRAWAL,ORDER_PLACED,FILL_PARTIAL,FILL_COMPLETE,FEE,FX_CONVERSION,TRANSFER_INTERNAL,SETTLEMENT_ADJUSTMENT,RECONCILIATION_CORRECTION. - Reconciliation discipline: every venue discrepancy is resolved via a
named
RECONCILIATION_CORRECTIONevent — never via silent balance edits. - Edge stacking: multiple simultaneously profitable edges (fee rebate, funding capture, FX spread, latency) are composed at the portfolio level.
This spec is intended to be implemented inside trading systems such as:
When implemented on top of the ARC-Core event spine, the ledger gets tamper-evident receipts and verifiable replay for free.
- ARC-Core — governed event + receipt spine.
- omnibinary-runtime + Arc-RAR — any-OS portability.
- Portfolio — full project index.
event sourcing · trading ledger · multi-currency · fx conversion ·
execution engine · reconciliation · order management system ·
quantitative finance spec · immutable audit trail ·
edge stacking · venue aggregator
MIT — see LICENSE. This is a specification and is not financial advice.
Also available under docs/official/ in-tree, and through the Pages landing at https://garebear99.github.io/EdgeStack_Currency/. (Plain-text spec; the AI-implementation prompt is at official/AI_CANONICAL_IMPLEMENTATION_PROMPT.txt.)
Six sibling repositories. Same ARC event-and-receipt doctrine. Each has its own live GitHub Pages docs site, source, and README.
| Repo | One-liner | Source | Docs site |
|---|---|---|---|
| BrokeBot | TRON Funding-Rate Arbitrage (CEX, Python) | source | https://garebear99.github.io/BrokeBot/ |
| Charm | Uniswap v3 Spot Bot on Base (Node.js) | source | https://garebear99.github.io/Charm/ |
| Harvest | Multi-Timeframe Crypto Research Platform (Python) | source | https://garebear99.github.io/Harvest/ |
| One-Shot-Multi-Shot | Binary-Options 3-Hearts Engine (JS) | source | https://garebear99.github.io/One-Shot-Multi-Shot/ |
| DecaGrid | Capital-Ladder Grid Trading Docs Pack | source | https://garebear99.github.io/DecaGrid/ |
| EdgeStack Currency (you are here) | Event-Sourced Multi-Currency Execution Spec | source | https://garebear99.github.io/EdgeStack_Currency/ |
- ARC-Core — governed event + receipt spine the fleet plugs into.
- omnibinary-runtime + Arc-RAR — any-OS portability for deployment.
- Portfolio — full project index (audio plugins, games, simulators, AI runtimes, robotics, trading).
If this repo helps you, the maintainer runs the entire ARC ecosystem solo. Any of the following keep the lights on:
- GitHub Sponsors: https://github.com/sponsors/GareBear99
- Buy Me a Coffee: https://www.buymeacoffee.com/garebear99
- Ko-fi: https://ko-fi.com/garebear99
Every dollar funds hardening across ARC-Core + the 15 consumer repos + the four roadmap repos. One author, one funding pool.