Repository navigation
Commit d2f6b22
docs(nips): make NIP-RS override state durable across coordinates
Close the four findings from Thufir pass 2/3 on PR #2864.
CRITICAL 1 — durability defined over retrievable logical state:
The entry-level pruning exemption could not hold, because a finite
event-level `since` filter, coordinate retirement, or orphan deletion
can remove the only event carrying a tombstone floor. Amendment-aware
clients now MUST fetch without a `since` filter (bounded by instances x
slots, not by time), and no coordinate carrying ov_* entries may be
retired, aged out, or deleted before its componentwise-max — every
tombstone ceiling included — is republished under an active coordinate
and accepted. Scope the accepted-loss and "harmless orphan" claims to
frontier-only state.
CRITICAL 2 — publish-before-retire ordering for rebalancing:
An in-place slot swap removes a group from the relay before its
replacement exists, and a crash makes the gap durable. Add an ordered
transition: merge and canonicalize all active coordinates, allocate
fresh slot IDs (in-place reuse prohibited), persist the union of old
and new coordinates, publish every new slot and confirm acceptance,
then persist the new set and retire the old coordinates.
IMPORTANT 3 — exhausted explicit mark-read:
Refusing only the counter increment left the frontier advance to
"succeed" while the override stayed live. The action now completes only
if the resulting state has override_active == false; otherwise it fails
visibly and the register is unchanged.
IMPORTANT 4 — clear-wins is normative:
The tie verdict is not encoded on the wire, so two conforming clients
using different policies diverge permanently on both the unread verdict
and the canonical wire form. Clear-wins becomes MUST; a selectable
policy would need an encoded policy field and its own interoperability
design. The verification wording still attributes this to
interoperability, not merge safety.
Co-authored-by: Will Pfleger <[email protected]>
Signed-off-by: Will Pfleger <[email protected]>1 parent 6f72e4a commit d2f6b22
1 file changed
Lines changed: 45 additions & 18 deletions
0 commit comments