Skip to content

v0.51.0 — Public API Stability + Protocol Conformance Suite

Choose a tag to compare

View all tags
@thaersaidi thaersaidi released this 28 Jun 23:32
v0.51.0
fb7b255

What's new

Protocol Conformance Suite

conformance/ is a new directory with deterministic reference vectors for every major trust operation in Genesis Mesh. Alternative implementations (TypeScript, Go, C#) can load these vectors and verify their own output against the Python reference.

  • 9 suites, 11 vectors: signatures, treaties, attestations, revocation, IBCT, trust evidence, selective disclosure, consensus, data usage.
  • Fixed key seeds: all vectors use bytes(range(32)) / bytes(range(32, 64)) / bytes(range(64, 96)) as Ed25519 seeds, making outputs stable and reproducible.
  • conformance/runner.py: importable runner with run_suite(name) and run_all().
  • conformance/generate_vectors.py: regenerate vectors from the reference implementation after a protocol change.
  • genesis_mesh/tests/test_conformance.py: 9 parametrized pytest cases, all green.

Public API Stability Contract

docs/stability.md declares the first versioned stability contract for Genesis Mesh. Every stable CLI command and Python symbol is listed with the version it stabilized in. Symbols absent from that page are internal with no stability guarantee.

Deprecation Policy

DEPRECATION_POLICY.md defines the lifecycle: announce → one minor version maintenance window → removal. Security fixes are exempt and may remove behavior immediately.

Stats

  • 1050 tests pass (9 new conformance tests + 1041 pre-existing)
  • Sphinx build: clean, no warnings
  • All pre-push hooks pass: pip-audit, CLI smoke, pytest
Assets 2
Loading