Struct libp2p::noise::NoiseConfig

pub struct NoiseConfig<P, C, R = ()> where
    C: Zeroize,  { /* fields omitted */ }

The protocol upgrade configuration.

Methods

impl<C> NoiseConfig<IX, C, ()> where
    C: Protocol<C> + Zeroize, 

pub fn ix(dh_keys: AuthenticKeypair<C>) -> NoiseConfig<IX, C, ()>

Create a new NoiseConfig for the IX handshake pattern.

impl<C> NoiseConfig<XX, C, ()> where
    C: Protocol<C> + Zeroize, 

pub fn xx(dh_keys: AuthenticKeypair<C>) -> NoiseConfig<XX, C, ()>

Create a new NoiseConfig for the XX handshake pattern.

impl<C> NoiseConfig<IK, C, ()> where
    C: Protocol<C> + Zeroize, 

pub fn ik_listener(dh_keys: AuthenticKeypair<C>) -> NoiseConfig<IK, C, ()>

Create a new NoiseConfig for the IK handshake pattern (recipient side).

Since the identity of the local node is known to the remote, this configuration does not transmit a static DH public key or public identity key to the remote.

impl<C> NoiseConfig<IK, C, (PublicKey<C>, PublicKey)> where
    C: Protocol<C> + Zeroize, 

pub fn ik_dialer(
    dh_keys: AuthenticKeypair<C>,
    remote_id: PublicKey,
    remote_dh: PublicKey<C>
) -> NoiseConfig<IK, C, (PublicKey<C>, PublicKey)>

Create a new NoiseConfig for the IK handshake pattern (initiator side).

In this configuration, the remote identity is known to the local node, but the local node still needs to transmit its own public identity.

Trait Implementations

impl UpgradeInfo for NoiseConfig<IK, X25519, ()>

type Info = &'static [u8]

Opaque type representing a negotiable protocol.

type InfoIter = Once<<NoiseConfig<IK, X25519, ()> as UpgradeInfo>::Info>

Iterator returned by protocol_info.

fn protocol_info(
    &self
) -> <NoiseConfig<IK, X25519, ()> as UpgradeInfo>::InfoIter

Returns the list of protocols that are supported. Used during the negotiation process.

impl UpgradeInfo for NoiseConfig<IK, X25519, (PublicKey<X25519>, PublicKey)>

type Info = &'static [u8]

Opaque type representing a negotiable protocol.

type InfoIter = Once<<NoiseConfig<IK, X25519, (PublicKey<X25519>, PublicKey)> as UpgradeInfo>::Info>

Iterator returned by protocol_info.

fn protocol_info(
    &self
) -> <NoiseConfig<IK, X25519, (PublicKey<X25519>, PublicKey)> as UpgradeInfo>::InfoIter

Returns the list of protocols that are supported. Used during the negotiation process.

impl UpgradeInfo for NoiseConfig<XX, X25519, ()>

type Info = &'static [u8]

Opaque type representing a negotiable protocol.

type InfoIter = Once<<NoiseConfig<XX, X25519, ()> as UpgradeInfo>::Info>

Iterator returned by protocol_info.

fn protocol_info(
    &self
) -> <NoiseConfig<XX, X25519, ()> as UpgradeInfo>::InfoIter

Returns the list of protocols that are supported. Used during the negotiation process.

impl UpgradeInfo for NoiseConfig<IX, X25519, ()>

type Info = &'static [u8]

Opaque type representing a negotiable protocol.

type InfoIter = Once<<NoiseConfig<IX, X25519, ()> as UpgradeInfo>::Info>

Iterator returned by protocol_info.

fn protocol_info(
    &self
) -> <NoiseConfig<IX, X25519, ()> as UpgradeInfo>::InfoIter

Returns the list of protocols that are supported. Used during the negotiation process.

impl<P, C, R> Clone for NoiseConfig<P, C, R> where
    C: Clone + Zeroize,
    P: Clone,
    R: Clone, 

fn clone(&self) -> NoiseConfig<P, C, R>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T, C> InboundUpgrade<T> for NoiseConfig<IX, C, ()> where
    C: Protocol<C> + AsRef<[u8]> + Zeroize + Send + 'static,
    T: AsyncRead + AsyncWrite + Send + 'static,
    NoiseConfig<IX, C, ()>: UpgradeInfo, 

type Output = (RemoteIdentity<C>, NoiseOutput<Negotiated<T>>)

Output after the upgrade has been successfully negotiated and the handshake performed.

type Error = NoiseError

Possible error during the handshake.

type Future = Handshake<Negotiated<T>, C>

Future that performs the handshake with the remote.

fn upgrade_inbound(
    self,
    socket: Negotiated<T>,
    <NoiseConfig<IX, C, ()> as UpgradeInfo>::Info
) -> <NoiseConfig<IX, C, ()> as InboundUpgrade<T>>::Future

After we have determined that the remote supports one of the protocols we support, this method is called to start the handshake.

impl<T, C> InboundUpgrade<T> for NoiseConfig<XX, C, ()> where
    C: Protocol<C> + AsRef<[u8]> + Zeroize + Send + 'static,
    T: AsyncRead + AsyncWrite + Send + 'static,
    NoiseConfig<XX, C, ()>: UpgradeInfo, 

type Output = (RemoteIdentity<C>, NoiseOutput<Negotiated<T>>)

Output after the upgrade has been successfully negotiated and the handshake performed.

type Error = NoiseError

Possible error during the handshake.

type Future = Handshake<Negotiated<T>, C>

Future that performs the handshake with the remote.

fn upgrade_inbound(
    self,
    socket: Negotiated<T>,
    <NoiseConfig<XX, C, ()> as UpgradeInfo>::Info
) -> <NoiseConfig<XX, C, ()> as InboundUpgrade<T>>::Future

After we have determined that the remote supports one of the protocols we support, this method is called to start the handshake.

impl<T, C> InboundUpgrade<T> for NoiseConfig<IK, C, ()> where
    C: Protocol<C> + AsRef<[u8]> + Zeroize + Send + 'static,
    T: AsyncRead + AsyncWrite + Send + 'static,
    NoiseConfig<IK, C, ()>: UpgradeInfo, 

type Output = (RemoteIdentity<C>, NoiseOutput<Negotiated<T>>)

Output after the upgrade has been successfully negotiated and the handshake performed.

type Error = NoiseError

Possible error during the handshake.

type Future = Handshake<Negotiated<T>, C>

Future that performs the handshake with the remote.

fn upgrade_inbound(
    self,
    socket: Negotiated<T>,
    <NoiseConfig<IK, C, ()> as UpgradeInfo>::Info
) -> <NoiseConfig<IK, C, ()> as InboundUpgrade<T>>::Future

After we have determined that the remote supports one of the protocols we support, this method is called to start the handshake.

impl<T, C> OutboundUpgrade<T> for NoiseConfig<XX, C, ()> where
    C: Protocol<C> + AsRef<[u8]> + Zeroize + Send + 'static,
    T: AsyncRead + AsyncWrite + Send + 'static,
    NoiseConfig<XX, C, ()>: UpgradeInfo, 

type Output = (RemoteIdentity<C>, NoiseOutput<Negotiated<T>>)

Output after the upgrade has been successfully negotiated and the handshake performed.

type Error = NoiseError

Possible error during the handshake.

type Future = Handshake<Negotiated<T>, C>

Future that performs the handshake with the remote.

fn upgrade_outbound(
    self,
    socket: Negotiated<T>,
    <NoiseConfig<XX, C, ()> as UpgradeInfo>::Info
) -> <NoiseConfig<XX, C, ()> as OutboundUpgrade<T>>::Future

After we have determined that the remote supports one of the protocols we support, this method is called to start the handshake.

impl<T, C> OutboundUpgrade<T> for NoiseConfig<IX, C, ()> where
    C: Protocol<C> + AsRef<[u8]> + Zeroize + Send + 'static,
    T: AsyncRead + AsyncWrite + Send + 'static,
    NoiseConfig<IX, C, ()>: UpgradeInfo, 

type Output = (RemoteIdentity<C>, NoiseOutput<Negotiated<T>>)

Output after the upgrade has been successfully negotiated and the handshake performed.

type Error = NoiseError

Possible error during the handshake.

type Future = Handshake<Negotiated<T>, C>

Future that performs the handshake with the remote.

fn upgrade_outbound(
    self,
    socket: Negotiated<T>,
    <NoiseConfig<IX, C, ()> as UpgradeInfo>::Info
) -> <NoiseConfig<IX, C, ()> as OutboundUpgrade<T>>::Future

After we have determined that the remote supports one of the protocols we support, this method is called to start the handshake.

impl<T, C> OutboundUpgrade<T> for NoiseConfig<IK, C, (PublicKey<C>, PublicKey)> where
    C: Protocol<C> + AsRef<[u8]> + Zeroize + Send + 'static,
    T: AsyncRead + AsyncWrite + Send + 'static,
    NoiseConfig<IK, C, (PublicKey<C>, PublicKey)>: UpgradeInfo, 

type Output = (RemoteIdentity<C>, NoiseOutput<Negotiated<T>>)

Output after the upgrade has been successfully negotiated and the handshake performed.

type Error = NoiseError

Possible error during the handshake.

type Future = Handshake<Negotiated<T>, C>

Future that performs the handshake with the remote.

fn upgrade_outbound(
    self,
    socket: Negotiated<T>,
    <NoiseConfig<IK, C, (PublicKey<C>, PublicKey)> as UpgradeInfo>::Info
) -> <NoiseConfig<IK, C, (PublicKey<C>, PublicKey)> as OutboundUpgrade<T>>::Future

After we have determined that the remote supports one of the protocols we support, this method is called to start the handshake.