Linked Evidence Record Kind Design Note¶
This note considers introducing a distinct OpenETR event kind for linked evidence records.
The motivating use case was Digital Product Passports, but the requirement is generic. An Evidence Graph may need to reference authorization decisions, execution receipts, temporal proofs, identity or role credentials, reliable- system assessments, repair reports, inspection records, audit certificates, or other evidence. Those items may inform verification or recognition without themselves transferring control of the primary artifact.
Proposed Event Kind¶
| Kind | Name | Status | Purpose |
|---|---|---|---|
1417 |
linked evidence record | proposed | Associates another document, artifact, or evidence item with an existing OpenETR graph without changing control state. |
This would sit beside the current working event kinds:
| Kind | Purpose |
|---|---|
1415 |
Anchor Event for a Digital Artifact. |
1416 |
Evidence Event, including Publisher Notices and ruleset-specific actions. |
1417 |
Linked evidence record that associates supporting evidence with the graph. |
Core Distinction¶
1417 should not be treated as a transfer, termination, pledge, discharge, redemption, or other control action.
It should answer a narrower question:
Which signed evidence items are associated with this OpenETR object graph, who linked them, and what relationship did they claim?
That makes it useful for domains where a record accumulates evidence over time without behaving like a transferable record.
Candidate Minimum Shape¶
A linked evidence record could use:
{
"kind": 1417,
"tags": [
["o", "<primary_object_digest>"],
["linked_digest", "<linked_document_digest>"],
["evidence_type", "<evidence_type>"],
["name", "<optional_display_name>"],
["mime_type", "<optional_media_type>"],
["ref", "<optional_url_or_registry_reference>"]
],
"content": ""
}
Required tags:
o: the primary OpenETR object digest being annotated or supported;linked_digest: the digest of the linked evidence document or artifact;evidence_type: the claimed relationship type.
Optional tags:
e: a prior event id if the evidence is intended to attach to a specific Anchor, control, or evidence event;name: display name for the linked artifact;mime_type: media type of the linked artifact;ref: URL, registry identifier, storage pointer, or external reference;profile: domain or policy profile identifier;subject: optional product id, batch id, serial number, component id, or other domain subject.
Candidate generic evidence_type families include:
authorization: mandate, approval, grant, or policy-decision evidence;execution: evidence that an authorized operation was attempted or completed;temporal: an external timestamp or ledger-based Temporal Proof;identity: identity, role, accreditation, or authority evidence;system_reliability: audit, certification, operational-rule, or assurance evidence;domain: evidence whose detailed meaning is defined by a Domain Adapter.
The evidence record should identify the claimed relationship without implying that the evidence is valid, sufficient, or recognized. Those conclusions belong to the applicable evidence verifier and recognition policy.
Where authorization and execution evidence are linked, implementations should distinguish a stable intent reference from an execution-attempt reference. A retry of the same instruction may retain the same intent identity while each attempt receives a distinct identifier. OpenETR should define this distinction at the conceptual interface before adopting any external receipt schema.
Product Passport Example¶
For a repair report linked to a Product Passport:
{
"kind": 1417,
"tags": [
["o", "<passport_digest>"],
["linked_digest", "<repair_report_digest>"],
["evidence_type", "repair_report"],
["name", "repair-report-2026-07-21.pdf"],
["mime_type", "application/pdf"],
["ref", "https://example.invalid/records/repair-report-2026-07-21"]
],
"content": ""
}
A Product Passport verifier could then ask:
- does the linked document digest match the retrieved evidence item?
- did a recognized issuer, repairer, auditor, registry, or authority sign the evidence record?
- is this signer authorized for
evidence_type=repair_reportunder the selected Product Passport profile? - does the linked evidence update the passport, annotate it, supersede prior evidence, or merely provide supporting material?
Relationship To 1416 action=attest¶
The current 1416 event family includes action=attest.
There are two possible designs:
| Option | Description | Tradeoff |
|---|---|---|
Keep linked evidence as 1416 action=attest |
Treat evidence links as a subtype of the existing evidence event family. | Simpler event registry, but risks mixing control-relevant actions with non-control evidence attachments. |
Introduce 1417 |
Give linked evidence its own event kind and query path. | Cleaner domain semantics, especially for Product Passports, but adds a new event kind and implementation surface. |
The reason to consider 1417 is clarity. Product Passport lifecycle evidence is often not a control action. A distinct kind lets clients query evidence attachments without interpreting them as possible control transitions.
Recognition And Effect Boundary¶
1417 would provide signed protocol evidence only.
It could show:
- a linked evidence document digest;
- the primary object digest it relates to;
- the claimed evidence type;
- the signer that made the association;
- optional references for retrieval or registry lookup.
It would not decide:
- whether the evidence is legally or regulatorily sufficient;
- whether the signer is authorized for that evidence type;
- whether the evidence changes mandatory passport content;
- whether the evidence supersedes earlier information;
- whether a market, regulator, registry, or relying party must accept it.
Those conclusions belong to the relevant Product Passport profile, delegated act, registry rules, authority practice, marketplace policy, or verifier policy.
Query Behavior¶
A verifier interested in an OpenETR object would likely query:
kind = 1415events by#ofor Anchor Events;kind = 1416events by#ofor Publisher Notices and other evidence actions;kind = 1417events by#ofor linked evidence records.
If the linked evidence document is stored by digest, the verifier may separately retrieve the linked document by linked_digest and verify that its hash matches the event tag.
Open Questions¶
- Should
1417always point to the primary object witho, or should it also support linking evidence to a specific event with requirede? - Should
linked_digestbe queryable with a single-letter Nostr tag, or is an explicit named tag preferable for readability? - Should replacement, supersession, or withdrawal of linked evidence be
represented by another
1417evidence record, by a Core 1.0 Publisher Notice where the Anchor Publisher is speaking about the primary artifact, or by a future dedicated action? - Should
evidence_typevalues be generic OpenETR terms, domain-profile terms, or both? - Should linked evidence records be allowed to carry structured JSON content, or should all machine-readable semantics live in tags and referenced artifacts?
- Should
1417be limited to non-control evidence, or can it also link evidence supporting a control action such as pledge, discharge, redemption, or termination?
Current Recommendation¶
Treat 1417 as a proposed generic associated-evidence kind and do not
implement it until the cross-domain evidence relationships, privacy model, and
minimum verification interface are specified.
The design direction is promising because it preserves the core distinction:
1415begins a candidate Evidence Graph with an Anchor Event;1416records Publisher Notices and other ruleset-specific evidence actions;1417links supporting evidence without implying transfer of control or recognition of the evidence claim.