Struct PairingToken 

pub struct PairingToken {
    pub controller_did: String,
    pub endpoint: String,
    pub short_code: String,
    pub ephemeral_pubkey: String,
    pub expires_at: DateTime<Utc>,
    pub capabilities: Vec<String>,
}

A pairing token for initiating cross-device identity linking.

The initiating device generates this token and displays it as a QR code or short code. The responding device scans/enters it and sends back a PairingResponse with its device public key plus X25519 ECDH exchange.

Fields

controller_did: String

Identity DID of the initiator (controller).

endpoint: String

Registry endpoint URL.

short_code: String

6-char alphanumeric short code (no ambiguous chars).

ephemeral_pubkey: String

X25519 ephemeral public key (base64url encoded).

expires_at: DateTime<Utc>

Token expiration time.

capabilities: Vec<String>

Capabilities to grant to the paired device.

Implementations

impl PairingToken

pub fn generate( now: DateTime<Utc>, controller_did: String, endpoint: String, capabilities: Vec<String>, ) -> Result<PairingSession, PairingError>

Generate a new pairing token with a 5-minute expiry.

pub fn generate_with_expiry( now: DateTime<Utc>, controller_did: String, endpoint: String, capabilities: Vec<String>, expiry: Duration, ) -> Result<PairingSession, PairingError>

Generate a new pairing token with custom expiry.

pub fn is_expired(&self, now: DateTime<Utc>) -> bool

Check if the token has expired.

pub fn to_uri(&self) -> String

Convert to an auths:// URI for QR code or deep linking.

Format: auths://pair?d=<did>&e=<endpoint_b64>&k=<pubkey>&sc=<code>&x=<expires>&c=<caps>

pub fn from_uri(uri: &str) -> Result<Self, PairingError>

Parse a pairing token from an auths:// URI.

pub fn ephemeral_pubkey_bytes(&self) -> Result<[u8; 32], PairingError>

Get the ephemeral public key as bytes.

Trait Implementations

impl Clone for PairingToken

fn clone(&self) -> PairingToken

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PairingToken

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PairingToken

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for PairingToken

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

where __S: Serializer,

Serialize this value into the given Serde serializer.