Struct SignedPacket 

pub struct SignedPacket { /* private fields */ }

A signed DNS packet in the pkarr format.

Wire format: <32 bytes pubkey><64 bytes signature><8 bytes BE timestamp><DNS wire format>

The DNS packet must be at most 1000 bytes. Total max size is 1104 bytes.

Implementations

impl SignedPacket

pub const MAX_BYTES: usize = 1_104usize

Maximum total byte size of a signed packet.

pub fn from_txt_strings( secret_key: &SecretKey, name: &str, values: impl IntoIterator<Item = impl AsRef<str>>, ttl: u32, ) -> Result<SignedPacket, SignedPacketBuildError>

Create a signed packet containing TXT records under a single name.

This is the common case: multiple TXT values under the same DNS name (e.g. "_iroh").

pub fn from_bytes(bytes: &[u8]) -> Result<SignedPacket, SignedPacketVerifyError>

Parse and verify a signed packet from its wire representation.

pub fn from_relay_payload( public_key: &PublicKey, payload: &[u8], ) -> Result<SignedPacket, SignedPacketVerifyError>

Create from a public key and relay payload (signature + timestamp + dns).

pub fn from_bytes_unchecked( bytes: &[u8], ) -> Result<SignedPacket, SignedPacketVerifyError>

Parse a signed packet without verifying the signature.

Still validates minimum length and DNS parsing.

pub fn as_bytes(&self) -> &[u8]

Return the full serialized bytes.

pub fn to_relay_payload(&self) -> Vec<u8>

Return the relay payload (everything after the public key).

pub fn public_key(&self) -> PublicKey

Return the public key.

pub fn signature(&self) -> Signature

Return the signature.

pub fn timestamp(&self) -> Timestamp

Return the timestamp.

pub fn encoded_packet(&self) -> &[u8]

Return the encoded DNS packet bytes.

pub fn txt_records(&self, name: &str) -> Vec<String>

Iterate over TXT records under a specific DNS name.

The name is normalized relative to the signer’s z-base-32 public key. Returns the TXT string values.

pub fn all_txt_records(&self) -> Vec<(String, String)>

Iterate over all TXT records, yielding (name_relative_to_origin, value) pairs.

The name is the part before the z-base-32 public key zone.

pub fn from_parts_unchecked( public_key: &[u8], signature: &[u8], timestamp: Timestamp, encoded_packet: &[u8], ) -> Result<Self, SignedPacketVerifyError>

Reconstruct a signed packet from its raw parts without verifying the signature.

This is useful for reconstructing a packet from storage or DHT mutable items where the components are stored separately.

pub fn more_recent_than(&self, other: &SignedPacket) -> bool

Return whether this packet is more recent than another.

Trait Implementations

impl Clone for SignedPacket

fn clone(&self) -> SignedPacket

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SignedPacket

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

Formats the value using the given formatter.

impl Display for SignedPacket

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

Formats the value using the given formatter.

impl PartialEq for SignedPacket

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for SignedPacket

impl StructuralPartialEq for SignedPacket