ArbSphere Prose (Prototype)
==========================

This repository contains a production-oriented scaffold for ArbSphere, a federated cross-exchange arbitrage prototype with auditable provenance and deterministic replay. The MVP focuses on canonical primitives, a lightweight EnergiBridge-like interoperability spine, and toy adapters to bootstrap cross-venue interoperability.

What’s included
- Python package arbsphere with primitives: LocalArbProblem, SharedSignals, PlanDelta, DualVariables, PrivacyBudget, AuditLog, TimeRounds, GoCRegistry
- EnergiBridge-style IR bridge: arbsphere/energi_bridge.py
- Toy adapters: arbsphere/adapters/data_feed_adapter.py and arbsphere/adapters/broker_gateway_adapter.py
- Lightweight tests for primitives and IR round-trips: tests/test_primitives.py
- Test runner: test.sh (pytest + python -m build)
- Packaging: pyproject.toml

How to run
- Install dependencies and run tests
  - bash test.sh
- Inspect the MVP adapters and primitives under arbsphere/

Notes
- This is a focused MVP: extend with additional contracts, privacy budgets, cryptographic attestations, and governance logging as you iterate.
- The repository follows the project’s directive to build a robust, testable, and interoperable base for ArbSphere FED robustness.