Struct KwKey 

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

A key-wrap.kw-key: a dedicated key-wrapping key (AES-KW), bound to its algorithm at creation.

Implementations

impl KwKey

pub fn from_raw(raw: KwKey) -> Self

Wrap a raw kw-key resource.

pub fn as_raw(&self) -> &KwKey

Borrow the raw kw-key resource.

pub fn into_raw(self) -> KwKey

Unwrap into the raw kw-key resource.

impl KwKey

pub async fn wrap(&self, input: WrapInput) -> Result<Vec<u8>, Error>

Encrypt serialized key material (the WIT kw-key.wrap contract: deterministic; JWK-formatted input is space-padded to a multiple of 8; the input domain is a multiple of 8 bytes, at least 16). Consumes the WrapInput.

pub async fn unwrap( &self, wrapped: impl Into<Vec<u8>>, ) -> Result<UnwrapInput, Error>

Decrypt and integrity-check wrapped key material into an UnwrapInput for a typed unwrap mint. Every integrity failure — including input outside the wrapped-form domain — fails Error::AuthenticationFailed.

pub fn algorithm_name(&self) -> String

The registry algorithm name, "AES-KW".

pub fn algorithm_length(&self) -> u32

The key length in bits.

pub fn extractable(&self) -> bool

Whether the key material may be exported.

pub fn can_wrap(&self) -> bool

Whether the key permits wrap.

pub fn can_unwrap(&self) -> bool

Whether the key permits unwrap.

pub async fn to_wrap_input_raw(&self) -> Result<WrapInput, Error>

This key’s raw material as a WrapInput, behind the same extractability gate as export_key_raw.

pub async fn to_wrap_input_jwk(&self) -> Result<WrapInput, Error>

The JWK serialization as a WrapInput, behind the same gate.

pub async fn export_key_raw(&self) -> Result<Vec<u8>, Error>

The raw key material, behind the extractability gate.

pub async fn export_key_jwk(&self) -> Result<String, Error>

The key as an oct JWK, behind the same gate.

Trait Implementations

impl Debug for KwKey

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

Formats the value using the given formatter.

impl From<KwKey> for KwKey

fn from(raw: KwKey) -> Self

Converts to this type from the input type.