attestation-chain-auditor

# The Chain Is Only as Strong as Its Weakest Link — Including the Links Nobody Checked > Helps identify gaps, breaks, and expired segments in trust attestation chains that make verification claims formally valid but practically meaningless. ## Problem Trust in agent ecosystems is supposed to be transitive: if A vouches for B, and B vouches for C, then A's trust extends to C through the chain. But attestation chains have failure modes that isolated audits don't catch. A chain can be formally complete — every link present — but functionally broken if any link is expired, if the vouching relationship was never actually verified, or if the chain contains circular dependencies that provide the appearance of independent validation without the substance. Many "verified" badges in current marketplaces represent attestation chains that would fail integrity checks if anyone looked at the full chain rather than just the terminal credential. ## What This Audits This auditor examines attestation chains across five dimensions: 1. **Chain completeness** — Does a verifiable chain exist from the skill or agent all the way to a root of trust? Chains that terminate at unverified accounts rather than verifiable root authorities have a trust ceiling determined by their weakest link 2. **Link expiry** — Are all links in the chain currently valid? An attestation signed 18 months ago with no renewal attests to a state that no longer exists. Each link should have a defined validity period and an explicit renewal or decay mechanism 3. **Vouching depth** — How many independent vouching relationships exist? A chain where A vouches for B and B is also controlled by A (circular reference) provides zero independent validation despite appearing to have two links 4. **Authority legitimacy** — Is each vouching authority in the chain itself attested by a higher authority? Self-signed roots are weaker than roots that are themselves attested by independent parties 5. **Revocation propagation** — If any link in the chain is revoked, does that revocation propagate to all downstream attestations? A chain where link 2 has been revoked but links 3 and 4 don't know about it continues to appear valid to anyone who doesn't check the full chain ## How to Use **Input**: Provide one of: - A skill or agent identifier to trace its attestation chain - An attestation chain document to audit directly - A list of vouching relationships to analyze for completeness and cycles **Output**: An attestation chain report containing: - Chain visualization from skill/agent to root of trust - Link-by-link validity assessment (active/expired/unknown) - Circular dependency detection results - Authority legitimacy assessment for each vouching node - Revocation check results for all links - Chain strength rating: STRONG / ADEQUATE / FRAGILE / BROKEN ## Example **Input**: Audit attestation chain for `financial-data-processor` skill ``` 🔗 ATTESTATION CHAIN AUDIT Skill: financial-data-processor Published by: datatools-org Chain depth: 3 Chain visualization: financial-data-processor ↑ vouched by: datatools-org (publisher account) ↑ vouched by: marketplace-verified badge ↑ vouched by: marketplace-platform (root) Link 1 — Skill → Publisher: Status: ⚠️ PARTIAL Publisher signature: Present (RSA-2048) Signature date: 14 months ago Renewal: None found — attestation age exceeds recommended 12-month threshold Key transparency: ✗ Not configured Link 2 — Publisher → Marketplace Badge: Status: ✅ ACTIVE Verification type: Email verification + ID check Last verified: 3 months ago Renewal policy: Annual Link 3 — Badge → Marketplace Root: Status: ✅ ACTIVE Root authority: marketplace-platform Root attestation: Self-signed Independent attestation: ✗ None found — root is self-attesting Circular dependency check: ✓ No cycles detected Authority legitimacy: marketplace-platform: Self-attesting root — no independent authority validates it Risk: Trust in the entire chain is bounded by trust in the platform itself Revocation check: Link 1 signing key: No revocation mechanism configured Link 2 (marketplace badge): Revocation via platform API confirmed Link 3 (root): N/A Chain strength rating: FRAGILE Reasons: 1. Link 1 attestation is 14 months old with no renewal 2. Root of trust is self-attesting with no independent validation 3. Link 1 has no revocation mechanism Recommended actions: 1. Renew publisher signature for financial-data-processor 2. Configure key revocation endpoint for publisher signing key 3. Seek independent attestation for marketplace root (third-party auditor) ``` ## Related Tools - **publisher-identity-verifier** — Checks publisher identity integrity; attestation chain auditor checks the full chain above the publisher - **trust-decay-monitor** — Tracks trust freshness; use together to identify chains where time-based decay has weakened link validity - **agent-card-signing-auditor** — Audits A2A Agent Card signing; attestation chain auditor checks what that signing is anchored to - **hollow-validation-checker** — Detects validation theater; attestation chain auditor detects attestation theater ## Limitations Attestation chain auditing depends on the availability of chain metadata, which many current implementations do not publish. Where chain links are opaque or undocumented, this tool can identify that attestation information is missing but cannot reconstruct the chain. Self-attesting roots are common in current agent ecosystems — this tool flags them as weaker than independently-attested roots, but does not classify them as invalid. Chain strength ratings reflect the verifiability of trust claims, not the actual trustworthiness of the attested party — a strong chain attests to identity and history, not to benign intent.