Struct LocalAgentKey

pub struct LocalAgentKey {
    pub secret: Secret,
    /* private fields */
}

A local implementation of the AgentKey that stores the key material directly

Fields

secret: Secret

The secret containing the key material

Implementations

impl LocalAgentKey

pub async fn verify_jws(&self, jws: &Jws) -> Result<Vec<u8>>

Verify a JWS against this key

pub async fn decrypt_jwe(&self, jwe: &Jwe) -> Result<Vec<u8>>

Unwrap a JWE to retrieve the plaintext

pub async fn verify(&self, payload: &[u8], signature: &[u8]) -> Result<()>

Verify a signature against this key

pub async fn encrypt_to_jwk( &self, plaintext: &[u8], _recipient_jwk: &Value, protected_header: Option<JweProtected>, ) -> Result<Jwe>

Encrypt data to a JWK recipient

pub fn new(secret: Secret, key_type: KeyType) -> Self

Create a new LocalAgentKey from a Secret and key type

pub fn generate_ed25519(kid: &str) -> Result<Self>

Generate a new Ed25519 key with the given key ID

pub fn generate_p256(kid: &str) -> Result<Self>

Generate a new P-256 key with the given key ID

pub fn generate_secp256k1(kid: &str) -> Result<Self>

Generate a new secp256k1 key with the given key ID

pub fn to_jwk(&self) -> Result<Value>

Convert the key to a complete JWK (including private key)

Trait Implementations

impl AgentKey for LocalAgentKey

fn key_id(&self) -> &str

Returns the unique identifier for this key

fn public_key_jwk(&self) -> Result<Value>

Exports the public key material as a JWK

fn did(&self) -> &str

Returns the DID associated with this key

fn key_type(&self) -> &str

Returns the key type (e.g., Ed25519, P-256, secp256k1)

impl Clone for LocalAgentKey

fn clone(&self) -> LocalAgentKey

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for LocalAgentKey

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

Formats the value using the given formatter.

impl DecryptionKey for LocalAgentKey

fn decrypt<'life0, 'life1, 'life2, 'life3, 'life4, 'life5, 'life6, 'async_trait>( &'life0 self, ciphertext: &'life1 [u8], encrypted_key: &'life2 [u8], iv: &'life3 [u8], tag: &'life4 [u8], aad: Option<&'life5 [u8]>, _sender_key: Option<&'life6 dyn VerificationKey>, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, 'life4: 'async_trait, 'life5: 'async_trait, 'life6: 'async_trait,

Decrypts the provided ciphertext

fn unwrap_jwe<'life0, 'life1, 'async_trait>( &'life0 self, jwe: &'life1 Jwe, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Unwraps a JWE to retrieve the plaintext

impl EncryptionKey for LocalAgentKey

fn encrypt<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, plaintext: &'life1 [u8], aad: Option<&'life2 [u8]>, _recipient_public_key: &'life3 dyn VerificationKey, ) -> Pin<Box<dyn Future<Output = Result<(Vec<u8>, Vec<u8>, Vec<u8>)>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Encrypts plaintext data for a specific recipient

fn recommended_jwe_alg_enc(&self) -> (JweAlgorithm, JweEncryption)

Returns the recommended JWE algorithm and encryption for this key

fn create_jwe<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, plaintext: &'life1 [u8], recipients: &'life2 [Arc<dyn VerificationKey>], protected_header: Option<JweProtected>, ) -> Pin<Box<dyn Future<Output = Result<Jwe>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Creates a JWE for multiple recipients

impl SigningKey for LocalAgentKey

fn sign<'life0, 'life1, 'async_trait>( &'life0 self, data: &'life1 [u8], ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Signs the provided data using this key

fn recommended_jws_alg(&self) -> JwsAlgorithm

Returns the recommended JWS algorithm for this key

fn create_jws<'life0, 'life1, 'async_trait>( &'life0 self, payload: &'life1 [u8], protected_header: Option<JwsProtected>, ) -> Pin<Box<dyn Future<Output = Result<Jws>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Signs and creates a JWS with the provided payload

impl VerificationKey for LocalAgentKey

fn key_id(&self) -> &str

The key ID associated with this verification key

fn public_key_jwk(&self) -> Result<Value>

Exports the public key material as a JWK

fn verify_signature<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, payload: &'life1 [u8], signature: &'life2 [u8], protected_header: &'life3 JwsProtected, ) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Verifies the provided signature against the payload and protected header