openagent-auth-protocol · transport

Source: openagent-sdk/crates/openagent-auth-protocol/src/transport.rs. SHA-256: 476f11d26cb734a256dfa734f413bb7660732700cddc9b8f2c274aa386a7faa2.

This source reference follows declared modules and preserves feature attributes. It includes public declarations and implementation methods in those modules. Private-module exports and trait resolution still require the compiler; not every declaration is a crate-root import. Function bodies and constant values are omitted. Source comments describe their implementation context and are not a production deployment claim.

transport::AuthTransport

Transport-agnostic interface for the agent side of the identity flow.

The agent either receives a challenge passively (a 401 with a WWW-Authenticate challenge on the HTTP binding) or fetches one proactively, then proves. Responders handle inbound proofs through their framework-specific integration (e.g. an Axum layer).

#[async_trait]
pub trait AuthTransport: Send + Sync {
    /// Request a challenge from the server (proactive flow).
    async fn fetch_challenge(&self, endpoint: &str)
        -> Result<IdentityChallenge, AuthProtocolError>;

    /// Send an [`IdentityProof`] and receive the [`IdentityVerified`] session.
    async fn prove(
        &self,
        endpoint: &str,
        proof: &IdentityProof,
    ) -> Result<IdentityVerified, AuthProtocolError>;
}

Source line: 21.