Struct DidKeyProvider 

pub struct DidKeyProvider { /* private fields */ }

Provider for did:key identities.

Holds the agent’s own signing key (so it can sign()) and an in-memory cache of peer Ed25519 keys decoded from did:key strings. Cache exists only to avoid re-running base58 decode on every verify; cache misses fall back to decoding the input agent_id on the spot.

Implementations

impl DidKeyProvider

pub fn from_signing_key(signing_key: SigningKey) -> Result<Self>

Build a provider from an existing Ed25519 signing key. The agent_id is derived deterministically from the corresponding public key.

pub fn generate() -> Result<Self>

Generate a fresh did:key identity from system entropy.

pub fn decode_pubkey(agent_id: &AgentId) -> Result<VerifyingKey>

Decode a did:key:z... string into its Ed25519 verifying key.

Returns an error if the input is not a did:key, if the multibase prefix is not z (base58btc), if the multicodec prefix is not Ed25519, or if the key length is wrong.

pub async fn register_peer(&self, peer_id: AgentId, pubkey: VerifyingKey)

Register a peer’s public key. Useful when the caller has already decoded a peer’s did:key and wants to avoid repeated decoding.

Trait Implementations

impl IdentityProvider for DidKeyProvider

fn agent_id(&self) -> &AgentId

The agent this provider represents (i.e., the identity that sign() will produce signatures for).

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

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

Sign an arbitrary byte string with the agent’s private key.

fn verify_peer<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, peer_id: &'life1 AgentId, message: &'life2 [u8], signature: &'life3 Signature, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

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

Verify that signature was produced by peer_id over message.

fn trust_metadata<'life0, 'life1, 'async_trait>( &'life0 self, _peer_id: &'life1 AgentId, ) -> Pin<Box<dyn Future<Output = Option<TrustMetadata>> + Send + 'async_trait>>

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

Optional: fetch trust metadata about a peer (reputation, verification level, capabilities). Returns None if this provider does not support trust metadata — callers must handle that gracefully.