Struct DiscoveryRecordV1 

pub struct DiscoveryRecordV1 {
    pub v: u8,
    pub username: Username,
    pub address: Address,
    pub pubkey: Vec<u8>,
    pub nostr_author: Vec<u8>,
    pub issued_at_ms: i64,
    pub sig: Vec<u8>,
}

A signed claim that a username points at an address.

Serialized as JSON inside a sealed relay record. The byte-level contract is Self::signing_payload, not this struct’s JSON: two implementations must agree on the signed bytes, and may disagree on JSON key order.

Fields

v: u8

Format version. Always DISCOVERY_VERSION in this build.

username: Username

The claimed name, in normalized form.

Typed, so a record naming an unnormalized username fails to deserialize rather than being compared against a queried name it can never equal.

address: Address

The address the claim points at.

pubkey: Vec<u8>

The Ed25519 identity key. derive_address(pubkey) must equal address.

nostr_author: Vec<u8>

The x-only Nostr key this record is valid when published under.

See the module docs: this is what stops a third party from keeping a retracted claim alive.

issued_at_ms: i64

Signing time, in milliseconds since the Unix epoch.

Advisory only. See verify_discovery_record.

sig: Vec<u8>

Ed25519 signature by pubkey over Self::signing_payload.

Implementations

impl DiscoveryRecordV1

pub fn signing_payload( username: &Username, address: &Address, pubkey: &[u8], nostr_author: &[u8], issued_at_ms: i64, ) -> Result<Vec<u8>>

Builds the payload the signature is taken over.

domain ‖ u32be‖bytes over [v, username, address, pubkey, nostr_author, issued_at_ms], in that fixed order. issued_at_ms is encoded as its 8-byte big-endian form, not as a decimal string, so two implementations cannot disagree about leading zeroes or a sign.

pub fn unsigned( username: Username, address: Address, pubkey: Vec<u8>, nostr_author: Vec<u8>, issued_at_ms: i64, ) -> Self

Builds an unsigned record, ready for Self::sign_with.

pub fn sign_with<F>(self, signer: F) -> Result<Self>

where F: FnOnce(&[u8]) -> Result<Vec<u8>>,

Signs the record with signer, which must be the private half of self.pubkey.

Taking a closure keeps the private key where it lives (the engine’s MLS manager) rather than passing key material into this module.

Trait Implementations

impl Clone for DiscoveryRecordV1

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DiscoveryRecordV1

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DiscoveryRecordV1

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for DiscoveryRecordV1

impl PartialEq for DiscoveryRecordV1

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for DiscoveryRecordV1

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DiscoveryRecordV1