Struct noise_sv2::Initiator

pub struct Initiator { /* private fields */ }

Implementations

impl Initiator

pub fn from_raw_k(key: [u8; 32]) -> Result<Box<Self>, Error>

pub fn without_pk() -> Result<Box<Self>, Error>

pub fn new(pk: Option<XOnlyPublicKey>) -> Box<Self>

pub fn step_0(&mut self) -> Result<[u8; 64], Error>

4.5.1.1 Initiator

Initiator generates ephemeral keypair and sends the public key to the responder:

1. initializes empty output buffer
2. generates ephemeral keypair e, appends e.public_key to the buffer (64 bytes plaintext public key encoded with ElligatorSwift)
3. calls MixHash(e.public_key)
4. calls EncryptAndHash() with empty payload and appends the ciphertext to the buffer (note that k is empty at this point, so this effectively reduces down to MixHash() on empty data)
5. submits the buffer for sending to the responder in the following format

Ephemeral public key message:

Field name	Description
PUBKEY	Initiator’s ephemeral public key

Message length: 64 bytes

pub fn step_2(&mut self, message: [u8; 234]) -> Result<NoiseCodec, Error>

4.5.2.2 Initiator

1. receives NX-handshake part 2 message
2. interprets first 64 bytes as ElligatorSwift encoding of re.public_key
3. calls MixHash(re.public_key)
4. calls MixKey(ECDH(e.private_key, re.public_key))
5. decrypts next 80 bytes (64 bytes for ElligatorSwift encoded pubkey + 16 bytes MAC) with DecryptAndHash() and stores the results as rs.public_key which is server’s static public key.
6. calls MixKey(ECDH(e.private_key, rs.public_key)
7. decrypts next 90 bytes with DecryptAndHash() and deserialize plaintext into SIGNATURE_NOISE_MESSAGE (74 bytes data + 16 bytes MAC)
8. return pair of CipherState objects, the first for encrypting transport messages from initiator to responder, and the second for messages in the other direction:
   1. sets temp_k1, temp_k2 = HKDF(ck, zerolen, 2)
   2. creates two new CipherState objects c1 and c2
   3. calls c1.InitializeKey(temp_k1) and c2.InitializeKey(temp_k2)
   4. returns the pair (c1, c2)

Trait Implementations

impl Debug for Initiator

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

Formats the value using the given formatter.

impl Drop for Initiator

fn drop(&mut self)

Executes the destructor for this type.