Struct SharedKey 

pub struct SharedKey(/* private fields */);

Shared ECDH secret between two parties’ trade (or admin) keys.

Internally a Keys instance whose secret is the 32-byte ECDH output of (local_secret, counterparty_pubkey). Prefer SharedKey::chat_keys for the on-the-wire K_conv / K_sign pair.

Implementations

impl SharedKey

pub fn derive( secret: &SecretKey, counterparty: &PublicKey, ) -> Result<Self, MostroError>

Derive the ECDH shared secret from a local secret key and the counterparty’s public key.

Both peers obtain the same SharedKey by swapping arguments (A.derive(a_sk, b_pk) == B.derive(b_sk, a_pk)).

pub fn from_keys(keys: Keys) -> Self

Build a SharedKey from an already-derived Keys value.

pub fn keys(&self) -> &Keys

Borrow the underlying ECDH Keys (IKM as a keypair).

For gift-wrap dual-read decrypt only. New envelopes use Self::chat_keys.

pub fn public_key(&self) -> PublicKey

Public key of the raw ECDH secret interpreted as a keypair.

This was the GiftWrap p tag under the superseded envelope. The new envelope uses pub(K_conv) from Self::chat_keys instead.

pub fn secret_key(&self) -> &SecretKey

Borrow the underlying ECDH secret key.

pub fn chat_keys(&self) -> Result<(Keys, Keys), MostroError>

Derive (K_conv, K_sign) from this ECDH secret.

pub fn to_hex(&self) -> String

Serialize the ECDH secret as lower-case hex for client persistence.

pub fn from_hex(hex: &str) -> Result<Self, MostroError>

Rebuild from hex previously produced by SharedKey::to_hex.

Trait Implementations

impl Clone for SharedKey

fn clone(&self) -> SharedKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SharedKey

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

Formats the value using the given formatter.