commit 39c2d28ebb398da24541a079b822bf6fe57810b0
parent 8c9f1a73d8c40841d46ce96491afd830482d5e71
Author: triesap <tyson@radroots.org>
Date: Sun, 14 Jun 2026 18:29:52 -0700
trade: document listing v1 protocol posture
Diffstat:
2 files changed, 10 insertions(+), 7 deletions(-)
diff --git a/crates/trade/src/listing/draft.rs b/crates/trade/src/listing/draft.rs
@@ -1,9 +1,10 @@
//! Canonicalization for Radroots Listing v1 drafts.
//!
-//! Listing v1 keeps the public NIP-99 listing kind and the private draft kind
-//! stable while Radroots owns the JSON content contract. Canonical drafts derive
-//! both addresses from the same seller pubkey and d-tag: the public address is
-//! for publish or update intent, and the draft address is for save-draft intent.
+//! Listing v1 uses NIP-99 listing kind numbers and Radroots-specific JSON
+//! content. Strict NIP-99 Markdown-content interoperability is protocol-v2 work.
+//! Canonical drafts derive both addresses from the same seller pubkey and
+//! d-tag: the public address is for publish or update intent, and the draft
+//! address is for save-draft intent.
#![forbid(unsafe_code)]
diff --git a/crates/trade/src/listing/mutation.rs b/crates/trade/src/listing/mutation.rs
@@ -1,8 +1,10 @@
//! Mutation draft preparation for Radroots Listing v1.
//!
-//! Publish and update produce the stable public listing event, save-draft
-//! produces the stable listing-draft event, and archive remains unsupported
-//! because Listing v1 has no archive wire event.
+//! Publish and update produce the stable public NIP-99 listing-kind event with
+//! Radroots-specific JSON content, save-draft produces the stable listing-draft
+//! event, and archive remains unsupported because Listing v1 has no archive
+//! wire event. Strict NIP-99 Markdown-content interoperability is protocol-v2
+//! work.
#![forbid(unsafe_code)]
