Struct TapAgent

pub struct TapAgent {
    pub config: AgentConfig,
    /* private fields */
}

TapAgent implementation using the AgentKeyManager for cryptographic operations.

Fields

config: AgentConfig

Configuration for the agent

Implementations

impl TapAgent

pub fn new(config: AgentConfig, key_manager: Arc<AgentKeyManager>) -> Self

Creates a new TapAgent with the given configuration and AgentKeyManager

pub async fn from_ephemeral_key() -> Result<(Self, String)>

Creates a new TapAgent with an ephemeral key

This function generates a new DID key for temporary use. The key is not persisted to storage and will be lost when the agent is dropped.

Returns

A tuple containing the TapAgent and the DID that was generated

pub async fn from_stored_keys(did: Option<String>, debug: bool) -> Result<Self>

Creates a new TapAgent from stored keys

This function uses the AgentKeyManagerBuilder to load keys from storage

Arguments

• did - Optional DID to use. If None, the default DID from storage is used.
• debug - Whether to enable debug mode

Returns

A Result containing either the created agent or an error if no keys are available

pub async fn from_private_key( private_key: &[u8], key_type: KeyType, debug: bool, ) -> Result<(Self, String)>

Creates a new TapAgent from an existing private key

This function creates a new TapAgent using a provided private key, which can be useful for integrating with external key management systems or when keys are generated outside the TAP agent.

Arguments

• private_key - The private key bytes
• key_type - The type of key (Ed25519, P256, or Secp256k1)
• debug - Whether to enable debug mode

Returns

A Result containing either the created agent or an error

pub async fn send_to_endpoint( &self, packed_message: &str, endpoint: &str, ) -> Result<u16>

Send a message to a specific endpoint

Parameters

• packed_message - The packed message to send
• endpoint - The endpoint URL to send the message to

Returns

The HTTP response status code, or error if the request failed

Trait Implementations

impl Agent for TapAgent

fn get_agent_did(&self) -> &str

Gets the agent’s DID

fn get_service_endpoint<'life0, 'life1, 'async_trait>( &'life0 self, to: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<String>>> + Send + 'async_trait>>

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

Gets the service endpoint URL for a recipient

fn send_message<'life0, 'life1, 'life2, 'async_trait, T>( &'life0 self, message: &'life1 T, to: Vec<&'life2 str>, deliver: bool, ) -> Pin<Box<dyn Future<Output = Result<(String, Vec<DeliveryResult>)>> + Send + 'async_trait>>

where T: 'async_trait + TapMessageBody + Serialize + Send + Sync + Debug + 'static, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Sends a message to one or more recipients

fn receive_message<'life0, 'life1, 'async_trait, T>( &'life0 self, packed_message: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<T>> + Send + 'async_trait>>

where T: 'async_trait + TapMessageBody + DeserializeOwned + Send, Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Receives a message

impl Clone for TapAgent

fn clone(&self) -> TapAgent

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TapAgent

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

Formats the value using the given formatter.