Skip to main content
The AlgoVoi stack is organised in four layers: a canonicalisation substrate at the base, receipt formats above it, verifiers that validate those receipts, and platform services and integrations that produce and consume them. Every arrow in the diagram below is a verifiable, production-deployed dependency.

Architecture layers

1 — Package dependency stack

How the open-source packages depend on each other, from substrate up to the top-of-stack aggregator.

2 — Platform services

How the gateway uses the package layer and feeds the platform services.

3 — Integration layer

What calls the gateway and what the Agent Trust Bench exercises.

Interaction cross-reference

Rows = producer / source. Columns = what it depends on, calls, or feeds.
Package / ServiceDepends onCalls / feedsVerified by
algovoi-substrateReceipt formats, platform gateway, verifiersjcs-conformance-vectors (576/576)
algovoi-substrate-pqcalgovoi-substrate (extends)Future PQC receipt formatsPQC cross-product matrix (48/48)
algovoi-jcs-conformance-vectorsTests substrate across 8 languages
algovoi-settlement-attestationalgovoi-substratealgovoi-pef, composite-trust-query, gatewaysubstrate conformance vectors
algovoi-refund-receiptalgovoi-substratealgovoi-pef, gatewaysubstrate conformance vectors
algovoi-cancellation-receiptalgovoi-substratealgovoi-pef, gateway (via Recurr)substrate conformance vectors
algovoi-pefsettlement-attestation, refund-receipt, cancellation-receiptTop-level receipt container
algovoi-receipt-verifieralgovoi-substrate (JCS, canon_version)composite-trust-query, gateway /v1/receipt/verify13/13 cross-validation vectors, Python 41/41, TypeScript 19/19
algovoi-webhook-verifierTenant webhook consumer (validates X-AlgoVoi-Signature)104/104 cross-validation (8 langs × 13 vectors), Python 47/47, TypeScript 45/45
algovoi-receipt-sentinelwebhook-verifier + receipt-verifier error streamsSliding-window tamper/replay/scan monitor — fires TAMPER_DETECTED, REPLAY_DETECTED, SCAN_DETECTED, BURST_FAILURE104/104 cross-validation (8 langs × 13 vectors), Python 36/36, TypeScript 35/35
algovoi-audit-verifieralgovoi-substrate (JCS + SHA-256)Standalone offline audit103 tests (Python 65, TypeScript 38)
algovoi-rfc9421-verifierInbound request verification (gateway)24/24 cross-implementation agreements
algovoi-rfc9421-signerOutbound signed request creation24/24 cross-implementation agreements
algovoi-composite-trust-queryreceipt-verifier signal, settlement-attestationTop-of-stack TRUSTED / PROVISIONAL / UNTRUSTED verdict
AlgoVoi Gatewaysubstrate, receipt-verifier, rfc9421-verifier, compliance-engineAudit chain, settlement-attestation, refund-receipt, cancellation-receiptATB 128/138, E2E 88/88
Audit ChainGateway feedalgovoi-audit-verifierB2 Object Lock COMPLIANCE 7-year retention
Compliance EngineGateway enforcesWallet screening, KYC/KYBOFSI, OFAC SDN, EU Consolidated + 7 URL/IP threat feeds
Recurr EngineGateway delegatesCancellation receipts, pull executor (7 chains)
Agent Trust BenchProbes gateway + mcp-server166 profiles / 40 categories
algovoi-mcp-serverGateway HTTP API (29 tools)ATB 128/138 pass rate
algovoi-reference-agentalgovoi-substrateGateway (A2A), settlement-attestationEnd-to-end Base chain worked example
algovoi-shopify-appGateway HTTP APIGateway E2E 88/88 (scripts/e2e_external.sh, commit 59ff40f8) — all consumed API endpoints route-tested
algovoi-x402-widgetGateway (x402 protocol)x402 v2 live: all 7 chain test resources return correct 402 envelopes (health-check 2026-05-16) · ATB Phase 8 receipt probes
algovoi-xchain-runtimeGateway + Allbridge + CCTP V2CCTP V2 Solana live (~50s settlement) · Allbridge EVM→Stellar live · both production-deployed
recurr.algovoi.co.ukGateway (MPP subscriptions, Tier 1 + Tier 2 pull executor, 7 chains)MPP subscription external validation 2026-05-16: dual-envelope 402 verified + 4/4 negative-path tests pass (bogus credential → 400, nonexistent resource → 404, wrong tenant → 404, non-subscription via subscription endpoint → 404). Public fixture: api.algovoi.co.uk/mpp/sub/demo/mpp-sub-test-daily-base
AP2 mandate clientGateway (mandate authorisation + on-chain settlement across 7 chains)AP2 open_mandate_hash v0 — 7/7 PASS (confirmed 2026-05-26)
External A2A agentsGateway (A2A agent card, 3 skills: verify-payment, create-checkout, check-status) — only live A2A payment agentAgent card live at api.algovoi.co.uk/.well-known/agent.json · ATB 166 profiles · AlgoVoi-authored RFC 9421 proxy-chain fixture 4/4 OK (submitted to aps-conformance-suite, withdrawn 2026-05-24) · AlgoVoi-authored multi-chain Ed25519 fixture 3/3 OK · cross-extension v0 5/5 PASS (dogfood-B 2026-05-19) · only confirmed live A2A payment agent (2026-04-22)

Data-flow by receipt lifecycle

Each payment event produces a structured receipt chain. All receipts share canon_version: jcs-rfc8785-v1 from the substrate.
Payer initiates payment


AlgoVoi Gateway
  ├─► Compliance Engine — screens wallet + URL (OFSI, OFAC, 7 feeds)
  ├─► build_compliance_receipt() [substrate] → compact JWS → Payer
  ├─► Facilitator — on-chain verification (7 chain families)
  ├─► build_settlement_attestation() [substrate] → stored + returned
  ├─► Audit Chain — JCS hash-chained row appended (B2 WORM)
  └─► (on refund) build_refund_receipt() [substrate]
      (on cancellation) build_cancellation_receipt() [substrate]

Recipient verifies receipt
  └─► algovoi-receipt-verifier
        ├─ JWS decode + Ed25519 verify
        ├─ JCS re-canonicalisation check
        └─ Result → algovoi-composite-trust-query → TRUSTED / PROVISIONAL

Auditor verifies chain
  └─► algovoi-audit-verifier
        ├─ Per-row content_hash check
        ├─ hash-chain continuity
        └─ HMAC-SHA256 bundle signature

AI agent calls gateway
  └─► algovoi-mcp-server (29 tools)
        └─► gateway HTTP API
              └─► receipts / compliance / screening

Tenant receives webhook
  └─► algovoi-webhook-verifier
        ├─ Header parse + timestamp check
        ├─ HMAC-SHA256 v1 verify
        ├─ HKDF-SHA256 key derive + HMAC-SHA384 v2 verify
        └─ JSON parse + event-type check → event dict
              │ error_code (on failure)

        algovoi-receipt-sentinel
              ├─ sliding window per source
              ├─ matches TAMPER / REPLAY / SCAN / BURST rules
              └─ SentinelAlert → notify security team (or null)

Package dependency graph (compact)

Dependencies flow upward. Packages at each row depend only on packages at rows below them.
LayerPackagesDepends on
0substrate
0substrate-pqcsubstrate
0jcs-conformance-vectors— (tests substrate)
1settlement-attestation, refund-receipt, cancellation-receiptsubstrate
1pefsettlement-attestation, refund-receipt, cancellation-receipt
2receipt-verifiersubstrate
2audit-verifiersubstrate
2rfc9421-verifier, rfc9421-signer
2composite-trust-queryreceipt-verifier signal, settlement-attestation
3Gatewaysubstrate, receipt-verifier, rfc9421-verifier
3Audit ChainGateway feed
3Recurr EngineGateway
3Agent Trust BenchGateway, mcp-server
4mcp-server, shopify-app, x402-widget, xchain-runtime, reference-agentGateway HTTP API
4webhook-verifierGateway webhook output (X-AlgoVoi-Signature)
4receipt-sentinelwebhook-verifier + receipt-verifier error streams
4recurr.algovoi.co.ukGateway (MPP subscriptions + pull executor)
4AP2 mandate clientGateway (mandate flow + settlement)
4External A2A agentsGateway (A2A v0.3 — agent card + 3 skills)

IETF I-D coverage

Seven Internet-Drafts anchor the formats this stack implements. Each I-D maps to one or more packages.
DraftPackages
draft-hopley-x402-canonicalisation-jcs-v1substrate, substrate-pqc, jcs-conformance-vectors
draft-hopley-x402-compliance-receiptsubstrate (emitter), receipt-verifier
draft-hopley-x402-settlement-attestationsettlement-attestation
draft-hopley-x402-refund-receiptrefund-receipt
draft-hopley-x402-cancellation-receiptcancellation-receipt
draft-hopley-x402-composite-trust-querycomposite-trust-query
draft-hopley-x402-payment-evidence-framepef

See also

  • Package suite — full package listing with install commands and download counts
  • Conformance vectors — 117-vector JCS corpus used to validate substrate implementations
  • Compliance gate — the gateway endpoint that emits the compliance receipts this stack verifies
  • Audit chain — the WORM ledger that algovoi-audit-verifier validates against
  • Agent Trust Bench — Phase 8 ATB profiles exercising the full receipt stack