EdgeStack Currency

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.

What this repo contains

• 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.

Why this repo exists

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.

Core concepts (from the spec)

• 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_CORRECTION event — never via silent balance edits.
• Edge stacking: multiple simultaneously profitable edges (fee rebate, funding capture, FX spread, latency) are composed at the portfolio level.

Reference implementations

This spec is intended to be implemented inside trading systems such as:

• Harvest
• BrokeBot
• Charm
• or your own trading stack.

When implemented on top of the ARC-Core event spine, the ledger gets tamper-evident receipts and verifiable replay for free.

Part of the ARC ecosystem

• ARC-Core — governed event + receipt spine.
• omnibinary-runtime + Arc-RAR — any-OS portability.
• Portfolio — full project index.

Keywords

event sourcing · trading ledger · multi-currency · fx conversion · execution engine · reconciliation · order management system · quantitative finance spec · immutable audit trail · edge stacking · venue aggregator

License

MIT — see LICENSE. This is a specification and is not financial advice.

---

📖 Official docs

Open the rendered official docs → https://garebear99.github.io/EdgeStack_Currency/official/edge_stacking_system_spec.txt

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.)

🧭 ARC Trading Fleet

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/

Upstream + meta

• 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).

---

💖 Support the fleet

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.