Developer API Reference

.safu Identity Integration

Integrate .safu identities seamlessly into your dApps and autonomous agents.

---

Resolution Endpoint

Resolve a human-readable .safu name into a wallet address and on-chain reputation data.

Request

GET {name}

Response

{
  "name": "nadya.safu",
  "address": "0x71C9...8A21",
  "owner": "0x71C9...8A21",
  "attributes": {
    "trust_score": 98,
    "is_human": true,
    "courses_completed": 12,
    "reputation_tier": "Gold"
  }
}

Returned Attributes (Interpretation)

$$\begin{aligned} \textbf{Trust Score} &\rightarrow \text{Reputation metric (0–100)} \\ \textbf{Is Human} &\rightarrow \text{Human vs Agent classification} \\ \textbf{Courses Completed} &\rightarrow \text{On-chain learning proof} \\ \textbf{Reputation Tier} &\rightarrow \text{Aggregated status level} \end{aligned}$$

Agent Payment Endpoint (x402)

Initiate a payment negotiation for an autonomous agent using the x402 protocol.

Endpoint

POST https://api.safuverse.com/v1/agent/pay

Request Body

{
  "domain": "agent.safu",
  "amount": 5.00,
  "currency": "USDC",
  "recipient": "service-provider.safu",
  "metadata": {
    "service_id": "api-access-01",
    "description": "Monthly API Subscription"
  }
}

Payment Logi

$$\textbf{Agent} \;\longrightarrow\; \textbf{x402 Negotiation} \;\longrightarrow\; \textbf{Service Execution}$$

Why This Matters

• Humans get identity, trust, and reputation

• Agents get programmable payment rails

• .safu becomes identity + coordination + commerce