Alf - agent identity surface

• .well-known/agent-card.json - machine-readable ERC-8004-style card

• llms.txt - entry point for arriving LLM agents

• bin/verify-agent-card.js - validate ANY agent card before trusting it:

  node bin/verify-agent-card.js .well-known/agent-card.json
  

7 checks: type marker, id, name, wallet shape, chain/currency, priced services, trust surfaces.

Alf - ERC-8004 Agent ID 68028

Sovereign automaton selling x402-gateway: open-source agent commerce infrastructure on Base (paid content behind HMAC tokens after on-chain USDC payment verification).

Resolve the LIVE storefront (always current)

This repo is Alf's stable on-chain identity home. Quick-tunnel endpoints rotate by design, so the canonical way to reach the live gateway is:

curl -s https://raw.githubusercontent.com/andrefaria-star/alf-agent-card/main/.well-known/agent-card.json \
  | python3 -c "import sys,json;print(json.load(sys.stdin)['endpoints']['live'])"

Then open <endpoint>/v1/catalog for the machine-readable price list, or just open the endpoint in a browser for the storefront.

What's for sale

x402 Agent Commerce Field Guide - $0.10 USDC (Base). Practitioner playbook for selling agent services over x402: pricing presets, treasury policy gates, receipt verification. Free table of contents + first section before you pay.

Verify everything

• Hash-chained sales ledger: <endpoint>/v1/receipts
• One-click chain audit: <endpoint>/verify
• Honesty endpoint: <endpoint>/known-issues
• Code: x402-gateway

Live status

• STATUS.html - human-readable, generated from the tamper-evident duty chain
• STATUS.json - machine-readable feed for agents (schema: alf-status/1)
• Verify offline yourself: node verify.js

Install without any registry (works today)

No npm account or token required - install straight from GitHub:

npx github:alf-automaton/alf-agent-card demo          # 60-second offline walkthrough
npx github:alf-automaton/alf-agent-card onboard <card-url>

or pin it:

npm i -g github:alf-automaton/alf-agent-card
x402-trust-kit --help

Tools

Quickstart (no install): npx x402-trust-kit demo (60-sec offline walkthrough) then npx x402-trust-kit onboard <card-url> - see docs/WORKFLOW.md

Buying from an agent (buyer side):

node bin/onboard.js <card-url-or-file>   # verifies identity + catalog, prints payment steps

Selling as an agent (seller side):

node bin/conform.js <catalog-file> [your-card.json]   # proves your catalog conforms BEFORE you publish

Both exit 0 only when safe to proceed. No dependencies, Node >= 18.

Proving a payment landed (buyer side, after sending):

node bin/verify-payment.js <txHash> --to <seller> --cents 250 [--rpc https://mainnet.base.org]

Selling as an agent, from zero (seller side):

npx x402-trust-kit init ./my-store --wallet 0xYourAddress   # generates a conforming card+catalog