Network Working Group S. Mih Internet-Draft Action State Group, Inc. Intended status: Informational 3 October 2026 Expires: 6 April 2027 Evidence Layer draft-mih-agent-evidence-layer-00 Abstract This document defines the evidence layer: the conformance requirements for a local evidence store that records evidence and the relationships between records, keeps digests committed while payloads are separately referenced, and preserves how each record came to be known well enough that a later reader can tell an observation from a claim. This document defines the record model, typed links between records, disclosure and retention semantics, the three classes of index a store may maintain, and the minimum interface any commitment substrate must supply for a store to conform to this layer. It exists so that a request for evidence can be answered honestly from what a store actually holds, and so that an evidence bundle assembled in response is assembled from committed material rather than assembled and then made to look committed. Conformance to this layer MUST NOT require any particular implementation or commitment substrate: a Checkpointed Local Log is one conforming profile; registration with a SCITT Transparency Service is another; any other append-only transparency log, or an implementer's own authenticated log, also qualifies. This document defines neither evidence sufficiency policy, request routing, settlement, nor any specific host-identity, signing, payload-storage, or replication mechanism. Status of This Memo This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet- Drafts is at https://datatracker.ietf.org/drafts/current/. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." This Internet-Draft will expire on 6 April 2027. Mih Expires 6 April 2027 [Page 1] Internet-Draft Evidence Layer October 2026 Copyright Notice Copyright (c) 2026 IETF Trust and the persons identified as the document authors. All rights reserved. This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/ license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 3 2. Non-Goals . . . . . . . . . . . . . . . . . . . . . . . . . . 3 3. Conventions and Definitions . . . . . . . . . . . . . . . . . 4 4. The Record Model . . . . . . . . . . . . . . . . . . . . . . 5 4.1. Epistemic Type . . . . . . . . . . . . . . . . . . . . . 6 5. Typed Links . . . . . . . . . . . . . . . . . . . . . . . . . 7 6. Record/Payload Separation, Retention, and Disclosure . . . . 9 6.1. Retention States . . . . . . . . . . . . . . . . . . . . 9 6.2. Disclosure Records . . . . . . . . . . . . . . . . . . . 10 7. Index Classes . . . . . . . . . . . . . . . . . . . . . . . . 11 8. The Commitment-Substrate Interface . . . . . . . . . . . . . 11 9. Answering a Request . . . . . . . . . . . . . . . . . . . . . 12 9.1. Three Kinds of "No" . . . . . . . . . . . . . . . . . . . 13 10. Reconcile and Close . . . . . . . . . . . . . . . . . . . . . 14 11. Security Considerations . . . . . . . . . . . . . . . . . . . 15 12. Privacy Considerations . . . . . . . . . . . . . . . . . . . 16 12.1. What a Checkpoint Reveals . . . . . . . . . . . . . . . 16 13. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 18 13.1. Evidence Layer Epistemic Types . . . . . . . . . . . . . 18 13.2. Evidence Layer Link Types . . . . . . . . . . . . . . . 19 14. References . . . . . . . . . . . . . . . . . . . . . . . . . 20 14.1. Normative References . . . . . . . . . . . . . . . . . . 20 14.2. Informative References . . . . . . . . . . . . . . . . . 21 Appendix A. Acknowledgments . . . . . . . . . . . . . . . . . . 22 Author's Address . . . . . . . . . . . . . . . . . . . . . . . . 22 Mih Expires 6 April 2027 [Page 2] Internet-Draft Evidence Layer October 2026 1. Introduction A request for evidence ([I-D.mih-agent-evidence-request]) says how to ask. An evidence bundle ([I-D.mih-zhang-agent-disclosure-bundle]) says what a granting answer looks like. Neither says what a responder must have held, and preserved, beforehand for that answer to be honest rather than assembled to order. A responder that can produce a byte-identical artifact for any requester, refuse with a citable reason, or truthfully report that it has nothing needs a local substrate with specific properties: records that do not change meaning after the fact, a place to say how one record relates to another without editing either, and a way to distinguish "I have never had this" from "I once had this and no longer do" from "I have this and will not show you." This document names that substrate an *evidence store*, defines the *evidence layer* a store must conform to, and states nothing about how a store is implemented beyond that. Conformance to the evidence layer MUST NOT require any particular implementation or commitment substrate: a Checkpointed Local Log ([I-D.mih-scitt-checkpointed-local-log]) is one mechanism satisfying the interface in Section 8; registration with a SCITT Transparency Service [RFC9943] is another; any other append-only transparency log, or an implementer's own authenticated log, also qualifies. 2. Non-Goals This document deliberately does not define: * *Evidence sufficiency, requirements, or verdicts.* Whether a set of records satisfies a requirement, and what a contract requires in the first place, is a policy layer that consumes what a store can produce. It is out of scope here. * *Request routing or transport policy.* How a request reaches a store, and what a store's operator decides to answer, are deployment and policy questions this document does not reach. * *Settlement.* Any obligation, payment, or remedy that follows from a recorded fact is outside this document; a store records that something is true of its own history, never what should happen as a result. Records of a settlement, such as those of [I-D.mih-agent-settlement-records], are ordinary records to a store. Mih Expires 6 April 2027 [Page 3] Internet-Draft Evidence Layer October 2026 * *A host-identity scheme.* What a principal_ref (Section 4) names, and how a party's key relates to any role or standing, is host- or deployment-defined. This document states only what a principal_ref cannot be taken to mean (Section 11). * *A signing, payload-storage, or replication mechanism.* How a record or a checkpoint is signed, how payload bytes are stored and retrieved by digest, and how records travel between stores, delivery intermediaries, or fleets are implementation seams a host plugs in beneath a conforming store. This document does not define any of the three, and a store's conformance to this document does not depend on which implementation of any of them it uses. 3. Conventions and Definitions The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here. *Evidence layer:* the conformance requirements this document defines for a local evidence store — the record model, typed links, disclosure and retention semantics, the index classes, and the commitment-substrate interface. Conformance to the evidence layer MUST NOT require any particular implementation or commitment substrate. *Evidence store (a "store"):* a local store that conforms to the evidence layer: it records evidence and typed links between records (Section 5), keeps a durable, append-ordered commitment to what it has recorded, and can answer a request against that commitment. The subject of this document. *Record:* one committed entry in a store: a header (Section 4) and, optionally, digests referencing payload bytes held or resolved separately (Section 6). A record MAY be an Agent Action Capsule [I-D.mih-scitt-agent-action-capsule]; this document does not require it. *Digest:* unless a deployment's evidence format states otherwise, the lowercase-hexadecimal SHA-256 digest of a value's canonical form — for a JSON [RFC8259] value, UTF8(JCS(value)) per [RFC8785]. *Link:* a typed, directed reference from one record to another, itself part of a committed record and never a mutation of either record it relates (Section 5). Mih Expires 6 April 2027 [Page 4] Internet-Draft Evidence Layer October 2026 *Commitment substrate:* the mechanism a store uses to assign append order to records and to produce checkpoints against which inclusion and consistency are checkable by a party other than the store (Section 8). *Checkpoint:* a value, produced by the commitment substrate, naming one committed state of a store's history at one point in time. *Epistemic type:* a closed value naming how a record's content came to be known or asserted, preserved end to end regardless of what is later signed or checkpointed about the record (Section 4). *Retention state:* a value naming whether, and how, a record's payload can currently be resolved to bytes (Section 6). *Transparency Service, Registration Policy, Receipt:* as defined in [RFC9943]. A Receipt [RFC9942] proves that a statement is included in a Transparency Service's log. It proves nothing else: not consistency between two states of that log, and not that the statement is true. *Witness:* a party other than the store that receives the store's checkpoints and checks that each one extends the previous one it saw. A Transparency Service whose Registration Policy admits a checkpoint only when it is consistent with the previously registered one is one kind of witness. "Witness" is not a term defined by [RFC9943]. *Countersignature:* a signature over a record, or over a set of records, by a party other than its producer, made after that party independently recomputed named checks, in the manner of an Auditor [RFC9943]. It is not a Receipt and not a Transparency Service function. *Self-attested:* signed only by the record's own producer, with neither a witness nor a countersignature. 4. The Record Model A record's durable header carries at least: Mih Expires 6 April 2027 [Page 5] Internet-Draft Evidence Layer October 2026 record: seq: record_id: record_type: epistemic_type: committed_at: