Struct CapabilityRequest 

pub struct CapabilityRequest {
    pub requester_did: String,
    pub requester_pk_hex: String,
    pub requested_capabilities: Vec<String>,
    pub intent_name: String,
    pub ttl_secs: u64,
    pub nonce: String,
    pub timestamp_unix: u64,
    pub signature: String,
}

Available on crate feature negotiate only.

An agent’s request for a delegated capability sub-cert.

Agent A sends a CapabilityRequest to Agent B (or B’s gateway) when it needs authorization to perform a specific action that B can delegate.

Signature

signature is an Ed25519 signature over Blake3(DOMAIN || requester_did || nonce || timestamp || ttl || intent || caps...), proving that the requester controls the private key for requester_pk_hex.

Fields

requester_did: String

did:a1: identifier of the requesting agent.

requester_pk_hex: String

Hex-encoded Ed25519 public key of the requesting agent.

requested_capabilities: Vec<String>

Capabilities the requesting agent needs.

intent_name: String

Name of the specific intent to be authorized.

ttl_secs: u64

Requested delegation lifetime in seconds.

nonce: String

16-byte anti-replay nonce (hex).

timestamp_unix: u64

Unix timestamp when this request was created.

signature: String

Ed25519 signature over the canonical request bytes (hex).

Implementations

impl CapabilityRequest

pub fn build( requester: &dyn Signer, requested_capabilities: Vec<String>, intent_name: impl Into<String>, ttl_secs: u64, timestamp_unix: u64, ) -> Self

Build and sign a capability request.

pub fn verify_signature(&self) -> Result<VerifyingKey, A1Error>

Verify the requester’s signature and return the verifying key.

pub fn verify_freshness( &self, now_unix: u64, max_age_secs: u64, ) -> Result<(), A1Error>

Verify and enforce that the request is not stale.

A request is stale if |now - timestamp| > max_age_secs.

Trait Implementations

impl Clone for CapabilityRequest

fn clone(&self) -> CapabilityRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CapabilityRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CapabilityRequest

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CapabilityRequest

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.