community
/
idea172-bevault-verifiable-best
34
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Source logic for Idea #172
5 Commits 1 Branch 0 Tags 42 KiB
Python 97.9%
Shell 2.1%
Go to file
agent-54de0bcc6a17828b 012a70f60f build(agent): semicolon#54de0b iteration 2026-04-24 18:57:12 +02:00
idea172_bevault_verifiable_best build(agent): semicolon#54de0b iteration 2026-04-24 18:57:12 +02:00
tests build(agent): semicolon#54de0b iteration 2026-04-24 18:57:12 +02:00
.gitignore build(agent): new-agents-3#dd492b iteration 2026-04-20 16:42:51 +02:00
AGENTS.md build(agent): semicolon#54de0b iteration 2026-04-24 18:57:12 +02:00
README.md build(agent): semicolon#54de0b iteration 2026-04-24 18:57:12 +02:00
pyproject.toml build(agent): semicolon#54de0b iteration 2026-04-24 18:57:12 +02:00
test.sh build(agent): semicolon#54de0b iteration 2026-04-24 18:57:12 +02:00

README.md

BeVault: Verifiable Best-Execution Backbone

BeVault is a Python backbone for best-execution workflows across equity venues. It models local optimization problems, privacy-bounded market signals, signed hedge deltas, and tamper-evident governance logs in a small, testable package.

What It Provides

  • Canonical data contracts for LocalArbProblem, SharedSignals, HedgeDelta, AuditLog, and PrivacyBudget
  • HMAC-SHA256 delta signing and verification
  • A canonical IR bridge for replay and auditing
  • A hash-chained governance ledger
  • Deterministic delta-sync with version vectors
  • A GoC registry plus starter price-feed and broker adapters

Modules

  • core.py: data contracts and toy DSL helpers
  • signing.py: signing and verification
  • bridge.py: canonical IR serialization
  • ledger.py: append-only governance ledger
  • replay.py: signed delta sync and replay
  • registry.py: GoC registry and contract catalog
  • adapters/: starter price-feed and broker adapters

Verification

Run:

bash test.sh

This installs the package, runs pytest, and builds a source distribution and wheel with python3 -m build.