25 lines
1.6 KiB
Markdown
25 lines
1.6 KiB
Markdown
# AGENTS
|
|
|
|
- This repository contains a lightweight, test-driven Python prototype for ArbSphere's federated cross-arbitrage primitives.
|
|
- Core concepts provided: LocalArbProblem, SharedSignals, and a deterministic admm_step that outputs a PlanDelta.
|
|
- Tests verify deterministic plan generation and basic structure.
|
|
- How to run:
|
|
- bash test.sh
|
|
- Important: This document is a stub for onboarding agents and does not describe a full production architecture.
|
|
|
|
What to expect in this sprint
|
|
- MVP mapping: canonical ArbSphere primitives (LocalArbProblem, SharedSignals, PlanDelta) and a minimal EnergiBridge translator to a vendor-agnostic IR.
|
|
- A Graph-of-Contracts registry (GoC) to describe adapters and data schemas with per-message metadata for replay protection.
|
|
- Deterministic replay: a CRDT-inspired delta structure to enable replay across reconnects.
|
|
- A two-venue toy MVP to bootstrap interoperability, including data-feed and broker adapters.
|
|
- Phase-wise rollout: protocol skeleton, governance ledger scaffolding, cross-domain demo, and latency/auditability dashboards.
|
|
- Compliance and audit: tamper-evident governance logs and optional cross-firm attestations.
|
|
|
|
Implementation guidance
|
|
- Prefer to implement small, correct changes that improve interoperability and testability.
|
|
- Extend EnergiBridge with additional IR fields and versioning as new adapters are added.
|
|
- Keep the GoC registry lightweight; avoid coupling adapters to internal Python types.
|
|
- Ensure tests remain deterministic and fast.
|
|
|
|
If you want me to push a concrete two-venue toy MVP spec or add toy adapters, I can draft and implement those next.
|