Struct Offer 

pub struct Offer {
    pub sdp: String,
    pub chain_id: ChainId,
    pub identity_pub_key: PublicKey,
    pub target_peer_id: PeerId,
    pub host: Host,
    pub listen_port: Option<u16>,
}

WebRTC connection offer containing SDP data and peer information.

An Offer represents the initial connection request in the WebRTC signaling process. It contains all necessary information for a peer to evaluate and potentially accept a WebRTC connection, including:

• SDP (Session Description Protocol) data describing the connection capabilities
• Chain ID to ensure peers are on the same blockchain network
• Identity verification through the offerer’s public key
• Target peer identification to ensure the offer reaches the intended recipient
• Signaling server information for connection establishment

Security Considerations

• The chain_id must match between peers to prevent cross-chain connections
• The identity_pub_key is used for cryptographic verification of the offerer
• The target_peer_id prevents offers from being accepted by unintended peers

Example Flow

Peer A creates Offer -> Signaling Method -> Peer B validates Offer

Fields

sdp: String

Session Description Protocol (SDP) data describing the WebRTC connection capabilities, including media formats, network information, and ICE candidates.

chain_id: ChainId

Blockchain network identifier to ensure peers are on the same chain. Prevents accidental connections between different blockchain networks.

identity_pub_key: PublicKey

Offerer’s identity public key for cryptographic authentication. Used to verify the identity of the peer making the connection offer.

target_peer_id: PeerId

Peer ID that the offerer wants to connect to. Ensures offers are only accepted by the intended target peer.

host: Host

Host name or IP address of the signaling server of the offerer. Used for signaling server discovery and connection establishment.

listen_port: Option<u16>

Port number of the signaling server of the offerer. Optional port for signaling server connections.

Implementations

impl Offer

pub fn sdp_hash(&self) -> [u8; 32]

Computes the SHA-256 hash of this offer’s SDP data.

This hash is used for connection authentication and tamper detection during the WebRTC handshake process.

Returns

A 32-byte SHA-256 hash of the offer’s SDP data

pub fn conn_auth(&self, answer: &Answer) -> ConnectionAuth

Creates connection authentication data from this offer and an answer.

This method combines the SDP data from both the offer and answer to create ConnectionAuth credentials used for secure handshake verification. The authentication data ensures both peers have the same view of the connection parameters.

Parameters

• answer - The answer responding to this offer

Returns

ConnectionAuth containing encrypted authentication data derived from both the offer and answer SDP hashes

Trait Implementations

impl Clone for Offer

fn clone(&self) -> Offer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Offer

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Offer

fn deserialize<__D>( __deserializer: __D, ) -> Result<Offer, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl EncryptableType for Offer

type Encrypted = EncryptedOffer

Associates Offer with its encrypted counterpart EncryptedOffer.

impl From<Offer> for Signal

fn from(original: Offer) -> Signal

Converts to this type from the input type.

impl MallocSizeOf for Offer

fn size_of(&self, ops: &mut MallocSizeOfOps) -> usize

Measure the heap usage of all descendant heap-allocated structures, but not the space taken up by the value itself.

impl PartialEq for Offer

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

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 Eq for Offer

impl StructuralPartialEq for Offer