API Reference

AFG is autonomous, neutral trust infrastructure for AI agents. The public endpoint is keyless: anyone can query any wallet and get a transparent 300–850 Trust Score derived from unfakeable on-chain behavior. No signup, no key, no human in the loop.

// Optional: register an agent ID. Not required to be scored.
{ agent_id: my-agent-001, platform: my-platform }

// Legacy attested-only score. Prefer GET /v2/api/trust below.

// Neutral composite Trust Score (300-850) with a transparent
// factor breakdown, a basis label, and a confidence tier.
// Provide agent_id (attested basis), wallet (on-chain basis), or both.
//
// Returns: { trust_score, range:[300,850], breakdown:{ measures,
//   does_not_measure, neutrality, factors, overall_confidence } }

What the Trust Score measures

• Wallet longevity (first on-chain activity; unfakeable)
• Counterparty breadth (how many distinct parties an agent transacts with)
• Settled USDC payment activity (volume and cadence on Base)
• Wash / self-dealing detection (circular, tight, near-equal round-trips)
• Attestations from verified counterparties (when present)

What it does not measure

• Payment reliability (success vs. failure). A USDC transfer event is only emitted on success, and relayer/x402-submitted failures are invisible on-chain. We do not claim it.
• Agent identity, intent, or profitability
• Legal or regulatory compliance
• Off-chain fulfillment or quality of goods/services

Neutrality: AFG is an independent third party — not owned by or affiliated with any wallet, rail, or cloud provider. A single agent can carry signals from multiple providers (it pays via one rail here, another there); AFG aggregates that cross-provider picture. No single rail can.

Attest a payment in ~10 lines

Attesting is live and keyless — your signature over the payment details is the credential. The signing wallet must be the actual on-chain counterparty (payer = the USDC Transfer sender, payee = the receiver) or the attestation is rejected. Grab the helper: afg_attest_client.py.

from afg_attest_client import attest

resp = attest(
    private_key=KEY,                 # the wallet that was the counterparty
    tx_hash="0x...",                # the USDC payment tx
    chain_id=8453,                   # Base mainnet 8453, Base Sepolia 84532
    payer="0x...", payee="0x...",
    amount=1000000,                  # USDC base units (6 decimals)
    token="0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    role="payer")                    # "payer" or "payee"

print(resp)   # {"verification_status": "verified", "reason": "ok", ...}

• Supported chains: Base mainnet (8453) and Base Sepolia (84532).
• The signing wallet must be the real on-chain counterparty, matched against the USDC Transfer event — not tx.from — so relayer / x402-submitted payments still verify.
• Forged, wrong-role, or wrong-counterparty claims are rejected with a reason.
• Attest about counterparties, not yourself: self-attestation (attester == subject) is dropped by the score guard, so it carries no weight.

Honest status: attestation capture is live, but verified attestations do not yet affect any trust score — the scoring weight is currently off. We are collecting genuine attestations before calibrating, so the weighting is justified by real data rather than guesses.