Struct SelfAgentVerifier 

pub struct SelfAgentVerifier { /* private fields */ }

Service-side verifier for Self Agent ID requests.

Security chain:

1. Recover signer address from ECDSA signature
2. Derive agent key: zeroPadValue(recoveredAddress, 32)
3. Check on-chain: isVerifiedAgent(agentKey)
4. Check proof provider matches selfProofProvider()
5. Check timestamp freshness (replay protection)
6. Sybil resistance check
7. Credential checks (age, OFAC, nationality)
8. Rate limiting

Construction

use self_agent_sdk::{
    NetworkName, SelfAgentVerifier, VerifierConfig, VerifierFromConfig,
};

// Direct construction
let verifier = SelfAgentVerifier::new(VerifierConfig::default());

// Chainable builder
let verifier = SelfAgentVerifier::create()
    .network(NetworkName::Testnet)
    .require_age(18)
    .require_ofac()
    .build();

// From config object
let verifier = SelfAgentVerifier::from_config(VerifierFromConfig {
    network: Some(NetworkName::Testnet),
    require_age: Some(18),
    ..Default::default()
});

Implementations

impl SelfAgentVerifier

pub fn new(config: VerifierConfig) -> Self

Create a new verifier instance from a VerifierConfig.

pub fn create() -> VerifierBuilder

Create a chainable VerifierBuilder for configuring a verifier.

pub fn from_config(cfg: VerifierFromConfig) -> Self

Create a verifier from a flat config object.

Automatically enables include_credentials when any credential requirement is set (age, OFAC, nationality).

pub async fn verify( &mut self, signature: &str, timestamp: &str, method: &str, url: &str, body: Option<&str>, ) -> VerificationResult

Verify a signed agent request.

The agent’s identity is derived from the signature — not from any header.

pub async fn verify_with_keytype( &mut self, signature: &str, timestamp: &str, method: &str, url: &str, body: Option<&str>, keytype: Option<&str>, agent_key: Option<&str>, ) -> VerificationResult

Verify a signed agent request with key type awareness.

When keytype is Some("ed25519"), uses Ed25519 verification with the provided agent_key (32-byte public key). Otherwise falls through to standard ECDSA verification via [verify].

pub fn clear_cache(&mut self)

Clear the on-chain status cache.