logo

Trait libp2p::noise::Protocol

source · [−]
pub trait Protocol<C> {
    fn params_ik() -> ProtocolParams;

    fn params_ix() -> ProtocolParams;

    fn params_xx() -> ProtocolParams;

    fn public_from_bytes(s: &[u8]) -> Result<PublicKey<C>, NoiseError>;

    fn linked(id_pk: &PublicKey, dh_pk: &PublicKey<C>) -> bool { ... }

    fn verify(
        id_pk: &PublicKey, 
        dh_pk: &PublicKey<C>, 
        sig: &Option<Vec<u8, Global>>
    ) -> bool
    where
        C: AsRef<[u8]>,
    { ... }

    fn sign(
        id_keys: &Keypair, 
        dh_pk: &PublicKey<C>
    ) -> Result<Vec<u8, Global>, NoiseError>
    where
        C: AsRef<[u8]>,
    { ... }
}
Expand description

A Noise protocol over DH keys of type C. The choice of C determines the protocol parameters for each handshake pattern.

Required methods

The protocol parameters for the IK handshake pattern.

The protocol parameters for the IX handshake pattern.

The protocol parameters for the XX handshake pattern.

Construct a DH public key from a byte slice.

Provided methods

👎 Deprecated

Determines whether the authenticity of the given DH static public key and public identity key is linked, i.e. that proof of ownership of a secret key for the static DH public key implies that the key is authentic w.r.t. the given public identity key.

The trivial case is when the keys are byte for byte identical.

Verifies that a given static DH public key is authentic w.r.t. a given public identity key in the context of an optional signature.

The given static DH public key is assumed to already be authentic in the sense that possession of a corresponding secret key has been established, as is the case at the end of a Noise handshake involving static DH keys.

If the public keys are linked, verification succeeds without a signature, otherwise a signature over the static DH public key must be given and is verified with the public identity key, establishing the authenticity of the static DH public key w.r.t. the public identity key.

Implementors

Legacy Noise protocol for X25519.

Note: This Protocol provides no configuration that is interoperable with other libp2p implementations. See crate::X25519Spec instead.

Noise protocols for X25519 with libp2p-spec compliant signatures.

Note: Only the XX handshake pattern is currently guaranteed to be interoperable with other libp2p implementations.