Struct Unsealer

pub struct Unsealer<R, C: UnsealerConfig> {
    pub version: u16,
    pub header: Header,
    pub pub_id: Policy,
    /* private fields */
}

An Unsealer is used to decrypt and verify data using PostGuard.

Unsealing is a two-step process:

1. First the header is read. This yields information for whom the message is encrypted. Using this information the user can retrieve a user secret key.

2. Then, the user has input the user secret key and the recipient for which decryption should take place.

Fields

version: u16

The version found before the raw header.

header: Header

The parsed header.

pub_id: Policy

The verified public identity which was used to sign the header.

Implementations

impl<R> Unsealer<R, UnsealerStreamConfig>

where R: AsyncRead + Unpin,

pub async fn new(r: R, pk: &VerifyingKey) -> Result<Self, Error>

Create a new Unsealer that starts reading from an AsyncRead.

Errors if the bytestream is not a legitimate PostGuard bytestream.

pub async fn unseal<W: AsyncWrite + Unpin>( self, ident: &str, usk: &UserSecretKey<CGWKV>, w: W, ) -> Result<VerificationResult, Error>

Unseal the remaining data (which is now only payload) into an AsyncWrite.

impl Unsealer<Vec<u8>, UnsealerMemoryConfig>

pub fn new(input: impl AsRef<[u8]>, vk: &VerifyingKey) -> Result<Self, Error>

Create a new Unsealer.

pub fn unseal( self, ident: &str, usk: &UserSecretKey<CGWKV>, ) -> Result<(Vec<u8>, VerificationResult), Error>

Unseals the payload.

impl<R> Unsealer<R, StreamUnsealerConfig>

where R: Stream<Item = Result<JsValue, JsValue>> + Unpin,

pub async fn new(r: R, vk: &VerifyingKey) -> Result<Self, Error>

Create a new Unsealer that starts reading from a Stream<Item = Result<Uint8Array, JsValue>>.

Errors

Errors if the bytestream is not a legitimate PostGuard bytestream. Also errors if the items (of type JsValue) cannot be cast into Uint8Array.

pub async fn unseal<W>( &mut self, ident: &str, usk: &UserSecretKey<CGWKV>, w: W, ) -> Result<VerificationResult, Error>

where W: Sink<JsValue, Error = JsValue> + Unpin,

Unseal into an Sink<Uint8Array, Error = JsValue>.

impl Unsealer<Uint8Array, UnsealerMemoryConfig>

pub fn new(input: &Uint8Array, vk: &VerifyingKey) -> Result<Self, Error>

Create a new Unsealer.

pub async fn unseal( self, ident: &str, usk: &UserSecretKey<CGWKV>, ) -> Result<(Uint8Array, VerificationResult), Error>

Unseals the payload.

Trait Implementations

impl<R: Debug, C: Debug + UnsealerConfig> Debug for Unsealer<R, C>

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

Formats the value using the given formatter.