WIKI_INDEX

Integrity Protocol Wiki — Index

Content catalog. Every page represents something that actually exists in the codebase right now — see the schema's "no aspirational content" rule. Last updated: 2026-08-06 | Total pages: 35 (24 concepts, 8 entities, 2 architecture, 1 query)

Acronym glossary

• AIS — Agent Integrity Score
• BAA — Business Associate Agreement
• BCC — Behavioral Commitment Chain
• DID — Decentralized Identifier
• VTL — (old term) Verifiable Trust Layer — see Observability & PHI Safety for what's actually built
• ZKP — Zero-Knowledge Proof(ing pipeline)

Concepts

• Integrity Protocol Specification — current normative v0.4 living specification and the archived v0.3 PDF
• The Four Foundational Primitives — memory, agent-owned contracts, authority, reputation: the concepts; start here
• Agent Primitives (Self-Sovereign Identity) — the 7 per-agent contracts (PrimitiveSet) — a different sense of "primitive", see the note at the top of both pages
• ComplianceGate & Integrity Health — the HIPAA/healthcare vertical
• Agent Integrity Score
• Telemetry Ingestion Pipeline — end-to-end: SDK collection, batching, signing, the oracle's 11-step ordered request pipeline, AIS scoring, the separate unauthenticated OTLP path (built)
• Behavioral Commitment Chain
• Merkle Batching & Anchoring Convention
• Decentralized Identifier
• Zero-Knowledge Proving Pipeline
• Integrity Market — prediction markets, binary options, A2A capital allocation (built, live on Base Sepolia)
• Smart BAA — on-chain Business Associate Agreement escrow (built)
• On-Chain Governance — IntegrityGovernance: lock-to-vote, timelocked propose→vote→queue→execute (built + 26 tests; Base Sepolia deploy deferred)
• Local Metrology — client-side AIS signal derivation in the SDK (built)
• Observability & PHI Safety — the Redactor (built) + LLM-as-judge design ([PLANNED])
• Identity Ceiling & Verification Ladder — [BUILT]: DNS/GitHub/Nitro evidence, signed revocation, clinical OPA gate, and AIS ceiling clamp
• Cross-Chain Reputation Sync — [PLANNED]
• A2A Negotiation Protocol — [PLANNED]
• ZK-ML Model-Inference Verification — [PLANNED]
• Persistent Memory, Genesis Root & Lineage — foundational primitive (spec v0.3 §4.1): Trust Vault anchored on the agent's existing StateAnchor (no 8th primitive), agent-authorized genesis root, 400 MemoryNotInitialized registration gate. [PARTIALLY BUILT] — gate + SDK anchoring enforced; contract-level epoch-1 restriction and lineage open
• Persistent Memory Configuration Guide — how users/agents can config memory systems.
• Xibalba Agent Operating Model — identity, closed-loop execution, graph memory, wiki compilation, interface design, and approval-gated operations.
• Testing Strategy — the 3-layer test pyramid, incl. new Playwright E2E (built)
• AIS API — Versioned Wire Spec — the generated, externally-supported /v1/* spec at spec/ais-api/ (built)

Entities (built)

• contracts — Solidity/Foundry: the 7 primitives, factory, registries, XNS, IntegrityGovernance, Integrity Health, market layer, $ITK, reworked CCIPReputationBridge (198 tests, live on Base Sepolia — XNS/governance/CCIP not yet broadcast)
• integrity-oracle — Rust/Axum AIS scoring (incl. server-side telemetry-signal re-derivation, derive.rs) + on-chain verification + markets/leaderboard/wallet/contracts/BAA/VC/benchmarks/XNS/governance reads + PHI-rejection backstop + unauthenticated OTLP/gRPC trace receiver, ASCII-escaping canonical-JSON fix (80 lib tests + 9 e2e)
• integrity-sdk — Python agent library: registration, BCC, markets, telemetry (widened OpenAI/LangChain integration metadata, opt-in redact_phi), PHI redaction, pre-execution intent-capture (invoke_intent), fixed telemetry-signing wire bug (135 tests, 1 skipped + 1 opt-in oracle e2e)
• integrity-cli — developer CLI, real on-chain register incl. real oracle re-verification, new xns command group (57 tests, incl. 1 opt-in oracle e2e)
• bcc_middleware — FastAPI + OPA policy gate, incl. verification-tier gate, the reputation-sync/slashing signer loop (app/reputation.py, app/scoring_loop.py), a real async-hot-path fix (asyncio.to_thread) plus the per-signer nonce lock and Merkle-batcher thread-safety it required, and a real HMAC-signed verification token (91 pytest + 28 OPA tests)
• integrity-dashboard — the dashboard app, wired to the real oracle and userapi reads and writes throughout, with full test coverage (9 vitest + 20 Playwright e2e tests run against a live backend+chain), plus the integrated demo/ Python scenario engine.
• integrity-zkp — real Noir/Barretenberg circuit, compiled & proven
• integrity-userapi — FastAPI + Postgres user accounts/auth, strictly non-chain (API keys now authenticate requests, JWT revocation, login rate-limiting, demo_runs completion path — 51 tests, real Postgres, real CORS for integrity-dashboard)

Guides

• Smart Contract Development — how to write, test, and deploy a new contract in contracts/: repo conventions (AccessControl, custom errors, NatSpec), Foundry test patterns (vm.prank/makeAddr/vm.expectRevert(...selector)), wiring into Deploy.s.sol/DeployMarkets.s.sol + make sync-abis, local/Base Sepolia deploy walkthrough, and the SovereignAgent.execute vs. direct-EOA auth convention.
• Multi-Domain Guardrails Design — [DESIGN, PARTIALLY BUILT]: how bcc_middleware's HIPAA-only OPA policy gate generalizes to pluggable, domain-scoped guardrail bundles (industry survey + concrete design against this repo's existing bcc.rego/HIPAAGuardrailRegistry.sol pattern). A real worked-example bundle (bcc_middleware/policies/general.rego, 12 passing OPA tests) is built as a stretch goal; the domain-aware GuardrailRegistry.sol and bcc_middleware wiring are still design-only.

Architecture

• Ecosystem Dependencies — cross-repository ownership and dependency direction for INTEGRITY-LATEST, Xibalba Shield, and Integrity MVP.
• Repository Implementation Plans — closed/planned/blocked implementation ledger for INTEGRITY-LATEST, Integrity MVP, Xibalba Shield, and Xibalba Graph Memory.

Open queries

• No LLM-as-judge rubric exists anywhere in this repo or the cross-checked Desktop spec docs ("Xibalba Solutions defines" it, per the plan notes) — the judge_evaluations ingestion schema is designed but the actual scoring rubric is an open product question, not an engineering one. See Observability & PHI Safety.

• Gas Tracking — Automated SDK gas optimization loop