polysig-protocol 0.8.0

Encoding and types for the polysig library
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

//! Utility functions for the encrypted server channel.
//!
//! You should not use these functions directly, they are
//! exposed so they can be shared between the client and server.
use crate::{
    Chunk, Encoding, Error, ProtocolState, Result, SealedEnvelope,
};

/// Encrypt a message to send to the server.
///
/// The protocol must be in transport mode.
#[doc(hidden)]
pub async fn encrypt_server_channel(
    server: &mut ProtocolState,
    payload: &[u8],
    broadcast: bool,
) -> Result<SealedEnvelope> {
    match server {
        ProtocolState::Transport(transport) => {
            let chunks = Chunk::split(payload, transport)?;
            let envelope = SealedEnvelope {
                encoding: Encoding::Blob,
                chunks,
                broadcast,
            };
            Ok(envelope)
        }
        _ => Err(Error::NotTransportState),
    }
}

/// Decrypt a message received from the server.
///
/// The protocol must be in transport mode.
#[doc(hidden)]
pub async fn decrypt_server_channel(
    server: &mut ProtocolState,
    envelope: SealedEnvelope,
) -> Result<(Encoding, Vec<u8>)> {
    match server {
        ProtocolState::Transport(transport) => {
            let contents = Chunk::join(envelope.chunks, transport)?;
            Ok((envelope.encoding, contents))
        }
        _ => Err(Error::NotTransportState),
    }
}