Struct Key 

pub struct Key { /* private fields */ }

One symmetric key, plus the short identifier that travels with anything it produced.

Implementations

impl Key

pub fn from_bytes(bytes: [u8; 32]) -> Self

A key from exactly KEY_LEN bytes.

pub fn from_base64(encoded: &str) -> Result<Self>

A key from a base64 string, with or without a base64: prefix.

Accepting the prefix means a key generated for a PHP application can be pasted straight in, which matters when the two are being run side by side during a migration.

pub fn generate() -> Self

A fresh key from the OS CSPRNG. What key:generate calls.

pub fn id(&self) -> &str

The key’s short identifier, as it appears in a payload.

Derived from the key rather than configured alongside it, so it cannot be set inconsistently across deployments and cannot be forgotten when a key is added.

pub fn bytes(&self) -> &[u8; 32]

The raw key material.

pub fn to_base64(&self) -> String

The key as base64:…, ready to paste into a .env.

Trait Implementations

impl Clone for Key

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Key

Deliberately opaque: a key that lands in a log line or a panic message is a key that has to be rotated.

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

Formats the value using the given formatter.