Struct NodeTicket

pub struct NodeTicket { /* private fields */ }

A token containing information for establishing a connection to a node.

Contains

• The NodeId of the node to connect to (a 32-byte ed25519 public key).
• If used, the [’RelayUrl`] of on which the node can be reached.
• Any direct addresses on which the node might be reachable.

This allows establishing a connection to the node in most circumstances where it is possible to do so.

This NodeTicket is a single item which can be easily serialized and deserialized and implements the Ticket trait. The Display and FromStr traits can also be used to round-trip the ticket to string.

Implementations

impl NodeTicket

pub fn new(node: NodeAddr) -> NodeTicket

Creates a new ticket.

pub fn node_addr(&self) -> &NodeAddr

The NodeAddr of the provider for this ticket.

Trait Implementations

impl Clone for NodeTicket

fn clone(&self) -> NodeTicket

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NodeTicket

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for NodeTicket

fn deserialize<D>( deserializer: D, ) -> Result<NodeTicket, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for NodeTicket

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

Formats the value using the given formatter.

impl From<NodeAddr> for NodeTicket

fn from(addr: NodeAddr) -> NodeTicket

Creates a ticket from given addressing info.

impl From<NodeTicket> for NodeAddr

fn from(ticket: NodeTicket) -> NodeAddr

Returns the addressing info from given ticket.

impl FromStr for NodeTicket

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<NodeTicket, <NodeTicket as FromStr>::Err>

Parses a string s to return a value of this type.

impl PartialEq for NodeTicket

fn eq(&self, other: &NodeTicket) -> 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 Serialize for NodeTicket

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Ticket for NodeTicket

const KIND: &'static str = "node"

String prefix describing the kind of iroh ticket.

fn to_bytes(&self) -> Vec<u8>

Serialize to bytes used in the base32 string representation.

fn from_bytes(bytes: &[u8]) -> Result<NodeTicket, Error>

Deserialize from the base32 string representation bytes.

fn serialize(&self) -> String

Serialize to string.

fn deserialize(str: &str) -> Result<Self, Error>

Deserialize from a string.

impl Eq for NodeTicket

impl StructuralPartialEq for NodeTicket