Struct Comment 

pub struct Comment {
    pub root: CommentScope,
    pub root_kind: Option<Kind>,
    pub root_author: Option<PublicKey>,
    pub parent: CommentScope,
    pub parent_kind: Option<Kind>,
    pub parent_author: Option<PublicKey>,
    pub content: String,
}

A NIP-22 kind: 1111 comment ready to be turned into an Event.

Both root and parent are mandatory; if the comment replies directly to the root, set both fields to the same scope.

Spec note on K / P tags

NIP-22 declares that the K (root kind) and P (root pubkey) tags “MUST be” present alongside an E/A root scope. The crate stores them as Options for two practical reasons:

• the CommentScope::External flavour has no inherent kind or author (the comment targets a URL, podcast, or NIP-73 identifier),
• real-world events from Coracle, Damus and others sometimes ship a comment without the K/P columns, and the lenient parser would otherwise reject them.

Authors writing new NIP-22 events targeting CommentScope::Event / CommentScope::Address roots SHOULD set Self::root_kind (and the matching parent kind / author hints) so downstream relays can index the comment correctly.

Fields

root: CommentScope

Top of the conversation.

root_kind: Option<Kind>

Optional kind hint for the root.

root_author: Option<PublicKey>

Optional author hint for the root.

parent: CommentScope

Direct parent (the message being replied to).

parent_kind: Option<Kind>

Optional kind hint for the parent.

parent_author: Option<PublicKey>

Optional author hint for the parent.

content: String

Free-form comment text.

Implementations

impl Comment

pub fn top_level(root: CommentScope, content: impl Into<String>) -> Self

Construct a comment whose parent equals its root.

pub const fn with_root_kind(self, kind: Kind) -> Self

Set the root kind hint.

pub const fn with_root_author(self, author: PublicKey) -> Self

Set the root author hint.

pub const fn with_parent_kind(self, kind: Kind) -> Self

Set the parent kind hint.

pub const fn with_parent_author(self, author: PublicKey) -> Self

Set the parent author hint.

pub fn with_parent(self, parent: CommentScope) -> Self

Override the parent scope (use when the parent differs from the root).

pub fn to_tags(&self) -> Vec<Tag>

Render the comment as the Tags that go into its kind: 1111 event.

pub fn from_event(event: &Event) -> Result<Self, CommentError>

Reconstruct a Comment from a kind: 1111 Event.

Errors

Returns the matching CommentError when the event is the wrong kind, missing one of the required scope tags, or carries malformed values.

Trait Implementations

impl Clone for Comment

fn clone(&self) -> Comment

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Comment

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Comment

impl PartialEq for Comment

fn eq(&self, other: &Comment) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Comment