Struct PairResponseMessage 

pub struct PairResponseMessage {
    pub result: Option<DeRecResult>,
    pub sender_kind: i32,
    pub communication_info: Option<CommunicationInfo>,
    pub nonce: u64,
    pub parameter_range: Option<ParameterRange>,
    pub timestamp: Option<Timestamp>,
}

PairResponseMessage is the response to a PairRequestMessage.

Purpose

This message completes the pairing handshake. It informs the initiator:

• whether the pairing was accepted or rejected
• the responder’s role and identity information
• the responder’s supported parameter range

Differences from PairRequestMessage

• Does not include encryption public keys, as those were already exchanged via ContactMessage and PairRequestMessage
• Includes a Result field indicating success or failure

Semantics

• If result indicates success, a secure channel is considered established
• If result indicates failure, the pairing MUST be treated as unsuccessful and no further protocol messages should be exchanged on this channel

The nonce MUST match the value provided in the request, ensuring that the response corresponds to the same pairing session.

Fields

result: Option<DeRecResult>

Result of processing the pairing request.

Indicates whether the pairing was successful or failed. Failure may occur due to:

• incompatible parameter ranges
• failed authentication at the application layer
• invalid or malformed request data

sender_kind: i32

The role of the sender of this message.

This informs the initiator whether the responder is acting as an Owner or a Helper.

communication_info: Option<CommunicationInfo>

Application-level identifying information of the responder.

Intended for user-facing identification and display purposes.

nonce: u64

Nonce identifying the pairing session.

This value MUST exactly match the nonce received in the PairRequestMessage. A mismatch indicates an invalid or unrelated pairing attempt and SHOULD result in rejection.

parameter_range: Option<ParameterRange>

Parameter range supported by the responder.

The initiator combines this with its own parameter range to determine the final agreed configuration for the channel.

timestamp: Option<Timestamp>

Timestamp indicating when this message was created.

Used for observability and may assist in replay detection or timeout handling, depending on the implementation.

Implementations

impl PairResponseMessage

pub fn sender_kind(&self) -> SenderKind

Returns the enum value of sender_kind, or the default if the field is set to an invalid enum value.

pub fn set_sender_kind(&mut self, value: SenderKind)

Sets sender_kind to the provided enum value.

Trait Implementations

impl Clone for PairResponseMessage

fn clone(&self) -> PairResponseMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PairResponseMessage

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

Formats the value using the given formatter.

impl Default for PairResponseMessage

fn default() -> Self

Returns the “default value” for a type.

impl Message for PairResponseMessage

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode(&self, buf: &mut impl BufMut) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message to a buffer.

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

where Self: Sized,

Encodes the message to a newly allocated buffer.

fn encode_length_delimited( &self, buf: &mut impl BufMut, ) -> Result<(), EncodeError>

where Self: Sized,

Encodes the message with a length-delimiter to a buffer.

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

where Self: Sized,

Encodes the message with a length-delimiter to a newly allocated buffer.

fn decode(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes an instance of the message from a buffer.

fn decode_length_delimited(buf: impl Buf) -> Result<Self, DecodeError>

where Self: Default,

Decodes a length-delimited instance of the message from the buffer.

fn merge(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited(&mut self, buf: impl Buf) -> Result<(), DecodeError>

where Self: Sized,

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq for PairResponseMessage

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