Regular Event Kind Decision Note¶
Status¶
Implemented.
OpenETR Anchor Events and Evidence Events use regular Nostr event kinds:
| Kind | Purpose |
|---|---|
1415 |
Anchor Event beginning a candidate Evidence Graph |
1416 |
Evidence Event extending or relating to a candidate Evidence Graph |
The reference component, CLI, web application, and current specifications use only these kinds for Evidence Graphs.
Decision¶
OpenETR Evidence Graph nodes shall be regular events. They shall not use addressable or replaceable event semantics.
The current graph grammar uses:
| Element | Purpose |
|---|---|
o |
Digital Artifact digest and object-centric query anchor |
e |
exact prior-event reference and graph edge |
p |
participant key where participant lookup is required |
action |
semantic subtype |
The d tag is not part of the current Evidence Graph grammar.
Rationale¶
Every e link commits to an exact prior event id. A graph node must remain the
same signed record whenever another record references it. Replaceable semantics
are incompatible with that requirement because a newer event at the same
addressable coordinate would have a different event id and could cause a relay
to stop returning the referenced record.
Regular events preserve the intended model:
- an Anchor Event begins a candidate Evidence Graph;
- each later Evidence Event identifies the same Digital Artifact through
o; - each graph edge identifies an exact prior record through
e; - a verifier validates the supplied Evidence Graph;
- defined rules derive Consequential State; and
- recognition determines what external effect follows.
Retrieval And Preservation¶
Regular event status does not guarantee indefinite availability from every relay. Implementations should use relay diversity, local stores, archives, exports, or other preservation arrangements appropriate to the domain.
A verifier shall report a missing record referenced by e as incomplete or
broken graph continuity. It shall not silently substitute another event.
Configuration Events¶
This decision applies to Evidence Graph records. OpenETR may still use replaceable or addressable events for information that is naturally mutable, including:
- profile metadata;
- relay lists;
- configuration records;
- summaries;
- indexes; and
- derived views.
Those records do not become Evidence Graph nodes merely because they are used by an OpenETR implementation.
Implementation Consequences¶
- publishers emit only kinds
1415and1416for Evidence Graph records; - object retrieval queries
#o; - graph traversal follows exact
ereferences; - event builders do not produce a
daction slot; - verifier policy does not include legacy-kind compatibility; and
- documentation and user interfaces describe only the regular-event model.