Nostr event data structure. More...

#include <protocol.hpp>

Inheritance diagram for radix_relay::nostr::protocol::event_data:

Public Member Functions
auto	serialize () const -> std::vector< std::byte >
	Serializes event data to byte array.

auto	is_radix_message () const -> bool
	Checks if event is a Radix-specific message type.

auto	get_kind () const -> std::optional< enum kind >
	Returns the event kind.

Static Public Member Functions
static auto	deserialize (std::span< const std::byte > bytes) -> std::optional< event_data >
	Deserializes event data from byte array.

static auto	deserialize (const std::string &json) -> std::optional< event_data >
	Deserializes event data from JSON string.

static auto	create_identity_announcement (const std::string &sender_pubkey, std::uint64_t timestamp, const std::string &signal_fingerprint, const std::string &capabilities="mesh,nostr") -> event_data
	Creates an identity announcement event.

static auto	create_bundle_announcement (const std::string &sender_pubkey, std::uint64_t timestamp, const std::string &bundle_hex) -> event_data
	Creates a bundle announcement event.

static auto	create_encrypted_message (std::uint64_t timestamp, const std::string &recipient_pubkey, const std::string &encrypted_payload) -> event_data
	Creates an encrypted message event.

static auto	create_session_request (const std::string &sender_pubkey, std::uint64_t timestamp, const std::string &recipient_pubkey, const std::string &prekey_bundle) -> event_data
	Creates a session establishment request event.

Public Attributes
std::string	id
	Event ID (32-byte hex hash)

std::string	pubkey
	Public key of event creator (32-byte hex)

std::uint64_t	created_at {}
	Unix timestamp.

std::vector< std::vector< std::string > >	tags
	Event tags (arbitrary string arrays)

std::string	content
	Event content.

std::string	sig
	Schnorr signature (64-byte hex)

Detailed Description

Nostr event data structure.

Represents a complete Nostr event with all required fields per NIP-01.

Definition at line 43 of file protocol.hpp.

Member Function Documentation

◆ create_bundle_announcement()

static auto radix_relay::nostr::protocol::event_data::create_bundle_announcement	(	const std::string &	sender_pubkey,
		std::uint64_t	timestamp,
		const std::string &	bundle_hex
	)		-> event_data

static

Creates a bundle announcement event.

Parameters

sender_pubkey	Nostr public key of sender
timestamp	Unix timestamp
bundle_hex	Hex-encoded prekey bundle

Returns: Constructed event_data

◆ create_encrypted_message()

static auto radix_relay::nostr::protocol::event_data::create_encrypted_message	(	std::uint64_t	timestamp,
		const std::string &	recipient_pubkey,
		const std::string &	encrypted_payload
	)		-> event_data

static

Creates an encrypted message event.

Parameters

timestamp	Unix timestamp
recipient_pubkey	Nostr public key of recipient
encrypted_payload	Encrypted message content

Returns: Constructed event_data

◆ create_identity_announcement()

static auto radix_relay::nostr::protocol::event_data::create_identity_announcement	(	const std::string &	sender_pubkey,
		std::uint64_t	timestamp,
		const std::string &	signal_fingerprint,
		const std::string &	capabilities = `"mesh,nostr"`
	)		-> event_data

static

Creates an identity announcement event.

Parameters

sender_pubkey	Nostr public key of sender
timestamp	Unix timestamp
signal_fingerprint	RDX fingerprint
capabilities	Comma-separated capability list

Returns: Constructed event_data

◆ create_session_request()

static auto radix_relay::nostr::protocol::event_data::create_session_request	(	const std::string &	sender_pubkey,
		std::uint64_t	timestamp,
		const std::string &	recipient_pubkey,
		const std::string &	prekey_bundle
	)		-> event_data

static

Creates a session establishment request event.

Parameters

sender_pubkey	Nostr public key of sender
timestamp	Unix timestamp
recipient_pubkey	Nostr public key of recipient
prekey_bundle	Prekey bundle data

Returns: Constructed event_data

◆ deserialize() [1/2]

static auto radix_relay::nostr::protocol::event_data::deserialize ( const std::string & json ) -> std::optional< event_data >

static

Deserializes event data from JSON string.

Parameters

json	JSON string

Returns: Parsed event_data or std::nullopt on failure

◆ deserialize() [2/2]

static auto radix_relay::nostr::protocol::event_data::deserialize ( std::span< const std::byte > bytes ) -> std::optional< event_data >

static

Deserializes event data from byte array.

Parameters

bytes Raw bytes containing JSON event data

Returns: Parsed event_data or std::nullopt on failure

◆ get_kind()

auto radix_relay::nostr::protocol::event_data::get_kind ( ) const -> std::optional< enum kind >

Returns the event kind.

Returns: Event kind or std::nullopt if invalid

◆ is_radix_message()

auto radix_relay::nostr::protocol::event_data::is_radix_message ( ) const -> bool

Checks if event is a Radix-specific message type.

Returns: true if kind is 40001-40004, false otherwise

◆ serialize()

auto radix_relay::nostr::protocol::event_data::serialize ( ) const -> std::vector< std::byte >

Serializes event data to byte array.

Returns: Serialized event as byte vector

Member Data Documentation

◆ content

std::string radix_relay::nostr::protocol::event_data::content

Event content.

Definition at line 50 of file protocol.hpp.

Referenced by radix_relay::nostr::message_handler< Bridge >::handle(), radix_relay::nostr::message_handler< Bridge >::handle(), and radix_relay::nostr::message_handler< Bridge >::handle().

◆ created_at

std::uint64_t radix_relay::nostr::protocol::event_data::created_at {}

Unix timestamp.

Definition at line 47 of file protocol.hpp.

Referenced by radix_relay::nostr::message_handler< Bridge >::handle(), radix_relay::nostr::message_handler< Bridge >::handle(), and radix_relay::nostr::message_handler< Bridge >::handle().

◆ id

std::string radix_relay::nostr::protocol::event_data::id

Event ID (32-byte hex hash)

Definition at line 45 of file protocol.hpp.

Referenced by radix_relay::nostr::message_handler< Bridge >::handle(), radix_relay::nostr::message_handler< Bridge >::handle(), and radix_relay::nostr::message_handler< Bridge >::handle().

◆ pubkey

std::string radix_relay::nostr::protocol::event_data::pubkey

Public key of event creator (32-byte hex)

Definition at line 46 of file protocol.hpp.

Referenced by radix_relay::nostr::message_handler< Bridge >::handle(), radix_relay::nostr::message_handler< Bridge >::handle(), and radix_relay::nostr::message_handler< Bridge >::handle().

◆ sig

std::string radix_relay::nostr::protocol::event_data::sig

Schnorr signature (64-byte hex)

Definition at line 51 of file protocol.hpp.

Referenced by radix_relay::nostr::message_handler< Bridge >::handle(), radix_relay::nostr::message_handler< Bridge >::handle(), and radix_relay::nostr::message_handler< Bridge >::handle().

◆ tags

std::vector<std::vector<std::string> > radix_relay::nostr::protocol::event_data::tags

Event tags (arbitrary string arrays)

Definition at line 49 of file protocol.hpp.

Referenced by radix_relay::nostr::message_handler< Bridge >::handle(), radix_relay::nostr::message_handler< Bridge >::handle(), and radix_relay::nostr::message_handler< Bridge >::handle().

The documentation for this struct was generated from the following file:

lib/nostr/include/nostr/protocol.hpp

Public Member Functions

Static Public Member Functions

Public Attributes

Detailed Description

Member Function Documentation

◆ create_bundle_announcement()

◆ create_encrypted_message()

◆ create_identity_announcement()

◆ create_session_request()

◆ deserialize() [1/2]

◆ deserialize() [2/2]

◆ get_kind()

◆ is_radix_message()

◆ serialize()

Member Data Documentation

◆ content

◆ created_at

◆ id

◆ pubkey

◆ sig

◆ tags