Back to Docs
Conformance

Conformance Tiers

Three tiers of protocol compliance — from minimal identity and messaging up to full on-chain settlement and audit.

Tier 1 · Minimal
Layers 0–1
  • ✅did:aroha: or did:aroha-web: identity
  • ✅Ed25519 envelope signing and verification
  • ✅Nonce store with 5-minute rolling window
  • ✅ArohaRequest / ArohaResponse message types
  • ✅ArohaError with canonical error codes
  • ✅Message expiry field enforced

Header claim

X-Aroha-Conformance: tier-1

Use case

Internal tools, prototypes, dev environments.

Tier 2 · Standard
Layers 0–3
  • ✅Everything in Tier 1
  • ✅Saga pattern: Reserve → Commit → Cancel
  • ✅LIFO compensation on failure
  • ✅Persistent saga log (crash recovery)
  • ✅ArohaDelegate message type
  • ✅Reputation scoring (Bayesian Beta + Wilson gate)
  • ✅W3C Trace Context (traceparent) propagation
  • ✅Conformance test suite passing at tier-2

Header claim

X-Aroha-Conformance: tier-2

Use case

Production B2B integrations, marketplace listings.

Tier 3 · Full
Layers 0–5
  • ✅Everything in Tier 2
  • ✅Spending Mandates with full delegation chain
  • ✅ArohaSatisfaction feedback messages
  • ✅Capability Schema Negotiation (CSN)
  • ✅EVM escrow settlement (for external value transfer)
  • ✅@aroha-sdk/audit hash-chained audit log with SIEM export
  • ✅Human approval gate support
  • ✅Key rotation with 24-hour cool-down and predecessor chain
  • ✅Conformance test suite passing at tier-3

Header claim

X-Aroha-Conformance: tier-3

Use case

Financial-grade deployments, verified partner status.

Self-Certification

Run the official conformance test suite against your agent. All three tiers are covered by the same package — pass the --tier flag.

# Run Tier 1 tests
npx @aroha-sdk/conformance-tests --tier 1 --url http://localhost:3000
# Run Tier 2 tests (includes Tier 1)
npx @aroha-sdk/conformance-tests --tier 2 --url https://your-staging-agent.example.com
# Run Tier 3 tests (includes Tier 1 + 2)
npx @aroha-sdk/conformance-tests --tier 3 --url https://your-production-agent.example.com
Note: Self-certification is honour-based. Setting the X-Aroha-Conformance header without passing the full test suite is a protocol violation and may result in removal from the registry.

Verified Partner Badge

Agents that achieve Tier 3 conformance and submit their test results to the Aroha registry are eligible for the Aroha Verified Partner badge. The badge is cryptographically signed by the Aroha registry key and verifiable offline using the did:aroha-web:aroha-labs.com public key.

To apply, post in the #conformance channel on Discord with your agent DID, tier-3 conformance test output, and production URL. The review process takes 5–10 business days.

Quickstart GuideGDPR Guide