Crate ans_client 

ANS API Client

This crate provides a client for interacting with the ANS (Agent Name Service) API for agent registration, certificate management, and discovery operations.

Features

• Agent registration and renewal
• Certificate signing request submission
• Agent search and resolution
• Domain validation (ACME, DNS)
• Agent revocation

Quick Start

use ans_client::{AnsClient, models::*};

#[tokio::main]
async fn main() -> ans_client::Result<()> {
    // Create a client with JWT authentication
    let client = AnsClient::builder()
        .base_url("https://api.godaddy.com")
        .jwt("your-jwt-token")
        .build()?;

    // Search for agents
    let mut criteria = SearchCriteria::default();
    criteria.agent_host = Some("example.com".into());
    let results = client.search_agents(&criteria, Some(10), None).await?;

    for agent in results.agents {
        println!("{}: {}", agent.ans_name, agent.agent_display_name);
    }

    Ok(())
}

Authentication

The ANS API supports two authentication methods:

• JWT: For endpoints at api.{env}-godaddy.com

  let client = AnsClient::builder()
      .jwt("your-jwt-token")
      .build();

• API Key: For public gateway (api.godaddy.com)

  let client = AnsClient::builder()
      .api_key("your-key", "your-secret")
      .build();

Registration Flow

Agent registration is a multi-step process:

1. Submit registration request with CSRs
2. Configure ACME challenge (DNS-01 or HTTP-01)
3. Call verify_acme() to validate domain ownership
4. Configure required DNS records
5. Call verify_dns() to complete registration

let client = AnsClient::builder()
    .base_url("https://api.godaddy.com")
    .jwt("token")
    .build()?;

// Step 1: Register
let endpoint = AgentEndpoint::new("https://agent.example.com/mcp", Protocol::Mcp)
    .with_transports(vec![Transport::StreamableHttp]);

let request = AgentRegistrationRequest::new(
    "my-agent",
    "agent.example.com",
    "1.0.0",
    "-----BEGIN CERTIFICATE REQUEST-----...",
    vec![endpoint],
)
.with_server_csr_pem("-----BEGIN CERTIFICATE REQUEST-----...");

let pending = client.register_agent(&request).await?;
let agent_id = pending.agent_id.expect("agent_id");

// Step 2-3: Configure challenge, then verify
// ... configure DNS or HTTP challenge ...
let status = client.verify_acme(&agent_id).await?;

// Step 4-5: Configure DNS records, then verify
// ... configure DNS records from pending.dns_records ...
let status = client.verify_dns(&agent_id).await?;

Re-exports

pub use client::AnsClient;

pub use client::AnsClientBuilder;

pub use client::Auth;

pub use error::ClientError;

pub use error::HttpError;

pub use error::Result;

Modules

client

ANS Registry API client.

error

Error types for the ANS client.

models

API request and response models for the ANS Registry.

Structs

Fqdn

A Fully Qualified Domain Name (FQDN).

Version

A semantic version (e.g., v1.0.0).