Struct ParsedMessage

pub struct ParsedMessage {
    pub source_public_key: PublicKey,
    pub destination_public_key: PublicKey,
    pub received_time: i64,
    pub payload_digest: [u8; 32],
    pub stamp: Stamp,
    pub scheme: EncryptionScheme,
    pub salt: Vec<u8>,
    pub payload_hmac: [u8; 32],
    pub payload_size: u64,
    pub payload: Vec<u8>,
}

Represents a Message post-parsing.

Fields

source_public_key: PublicKey

The source public key.

destination_public_key: PublicKey

The destinations public key.

received_time: i64

Maleable server time.

payload_digest: [u8; 32]

The SHA-256 digest of the payload.

stamp: Stamp

The stamp attached to the message.

scheme: EncryptionScheme

The encryption scheme used on the serialized Payload to produce the payload field.

salt: Vec<u8>

The salt is used to salt both the payload_hmac and the encryption key.

payload_hmac: [u8; 32]

The HMAC of the payload, specifically HMAC(HMAC(sdG, salt), payload_digest)

payload_size: u64

The size, in bytes, of the payload.

payload: Vec<u8>

The encrypted payload.

Implementations

impl ParsedMessage

pub fn into_message(self) -> Message

Convert ParsedMessage into a Message.

impl ParsedMessage

pub fn create_merged_key( &self, private_key: &[u8], ) -> Result<PublicKey, SecpError>

Calculate the merged key from the destination private key.

pub fn create_shared_key( &self, private_key: &[u8], salt: &[u8], ) -> Result<[u8; 32], SecpError>

Create the shared key from the destination private key, a salt, and a list of HKDF info.

pub fn authenticate(&self, shared_key: &[u8; 32]) -> Result<(), InvalidHmac>

Authenticate the HMAC payload and return the merged key.

pub fn verify_stamp(&self) -> Result<Vec<Transaction>, StampError>

Verify the stamp on the message and return the decoded transactions.

pub fn open_in_place(&mut self, private_key: &[u8]) -> Result<Opened, OpenError>

Verify the stamp, authenticate the HMAC payload, and then decrypt and decode the payload.

This is done in-place, replacing the encrypted payload field with the plain text.

pub fn open(&self, private_key: &[u8]) -> Result<Opened, OpenError>

Verify the stamp, authenticate the HMAC payload, and then decrypt and decode the payload.

Trait Implementations

impl Clone for ParsedMessage

fn clone(&self) -> ParsedMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParsedMessage

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

Formats the value using the given formatter.

impl PartialEq for ParsedMessage

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