anchor-x402

Fifteen x402-paid services for AI agents — nine commodity primitives, one agent-driven wallet investigator, and five universal LLM endpoints (roast, oracle, tldr, aura, grade). Plus a hosted-agent chatbot at chat.anchor-x402.com for users without their own agent. One AWS Lambda, one OpenAPI spec, indexed across 8 agent-discovery surfaces (CDP Bazaar, agentic.market, Agent Arena, Virtuals ACP, MCP Registry, Glama, mcp.so, npm — see Listings). Pay per call in USDC on Base or Solana mainnet — no API keys, no accounts, no subscriptions.

Site: https://anchor-x402.com Trust portal: https://anchor-x402.com/trust/ Live API: https://api.anchor-x402.com Status: https://anchor-x402.betteruptime.com MCP server: anchor-x402-mcp on npm — npx anchor-x402-mcp plugs all 9 services into Claude Desktop / Cursor / Continue as tools Swagger UI: /docs OpenAPI: /openapi.json

Services

Endpoint	Method	Price	Purpose
`/v1/anchor`	POST	$0.005	Anchor a 32-byte hash to Base + Solana mainnet in parallel
`/v1/screen`	GET	$0.001	Sanctions + AML screening for any wallet address
`/v1/attest`	POST	$0.010	Verify a wallet signature, dual-chain anchor the result
`/v1/decode/tx`	POST	$0.001	Structured decode of any mainnet tx (Base / Ethereum / Solana)
`/v1/resolve/name`	GET	$0.001	Cross-chain name resolution (ENS, Bonfida SNS)
`/v1/price/token`	GET	$0.001	USD spot price by symbol or chain+contract
`/v1/decode/calldata`	POST	$0.001	4byte selector + ABI param decode for EVM calldata
`/v1/parse/datetime`	POST	$0.001	Freeform datetime string → structured ISO 8601
`/v1/intel/wallet`	GET	$0.005	Bundled wallet intelligence: balances + activity + identity + sanctions

All endpoints accept payment on Base or Solana mainnet in USDC, and — when a Polygon treasury is configured — in JPYC on Polygon (Japan's first FSA-licensed yen stablecoin, settled via an in-process EIP-3009 facilitator; /v1/anchor is priced at ¥1 per call on this rail). All return v2 PaymentRequired with extensions.bazaar so they're auto-indexed by the CDP facilitator on settlement.

Why

Two product theses live in this repo:

Trust infrastructure (anchor, attest, screen, intel-wallet) — agents pay for cryptographic, multi-chain, signed receipts that an AI's decision happened the way it claims. Nothing else in the agentic API economy provides this primitive.
Commodity utilities (decode/tx, resolve/name, price/token, decode/calldata, parse/datetime) — agents pay sub-cent prices to skip orchestration code, cache misses, and rate-limited free APIs. Each call replaces 2–10 lines of boilerplate.

Quickstart (operator)

# 1. Install deps in a venv
make install

# 2. Configure (treasury keys, CDP creds — see .env.example)
cp .env.example .env
$EDITOR .env

# 3. Local dev (no real anchors — just import smoke-test)
make local

# 4. Deploy to AWS
make build && make deploy-guided

# 5. End-to-end paid tests (costs ~$0.026 USDC total)
.venv/bin/python scripts/test_e2e.py

# 6. Test a single service
.venv/bin/python scripts/test_e2e.py --only anchor

Quickstart (agent / consumer)

If you're an AI agent (or building one) using the x402 client SDK:

from x402 import x402ClientSync
from x402.mechanisms.evm.exact import ExactEvmClientScheme
from x402.mechanisms.evm.signers import EthAccountSigner
from x402.http.clients.requests import x402_requests
from eth_account import Account

cli = x402ClientSync()
cli.register("eip155:8453", ExactEvmClientScheme(signer=EthAccountSigner(Account.from_key("0xYOUR_KEY"))))
session = x402_requests(cli)

# Anchor any hash for $0.005
r = session.post("https://api.anchor-x402.com/v1/anchor",
                 json={"hash": "ab0898397c86fbf97c99c6f8b29e55ab697315705777ee1d106e2dcb9bd686b3"})
print(r.json())  # {merkle_root, base.tx, solana.tx, anchored_at}

The client handles x402 payment negotiation automatically — intercepts the 402, signs a USDC payment, retries.

API

For each endpoint, the schema is auto-generated by FastAPI and served at /openapi.json. Try Swagger UI at /docs.

`POST /v1/anchor` — dual-chain anchor

{ "hash": "<64-hex>", "note": "optional" }

or

{ "data": { "any": "json" }, "note": "optional" }

Returns: {merkle_root, base: {tx, explorer_url}, solana: {tx, explorer_url}, anchored_at, note}.

`GET /v1/screen?wallet=<address>` — sanctions screening

Returns: {wallet, chain_inferred, sanctions_match, sanctioned_lists, risk_level, notes, checked_at}.

Active corpus: OFAC SDN crypto entries (Tornado Cash, Lazarus Group, Hydra Market, Garantex, Blender.io, etc.).

`POST /v1/attest` — signed decision attestation

{
  "input_hash": "<64-hex>",
  "output_hash": "<64-hex>",
  "decision": "APPROVED",
  "scheme": "eip191" | "ed25519",
  "signature": "<hex or base58>",
  "signer_pubkey": "<solana pubkey, required for ed25519>"
}

Verifies the signature over the domain-separated message:

anchor-x402/attest/v1
input=<input_hash>
output=<output_hash>
decision=<decision>

Anchors the SHA-256 of that message on Base + Solana. Returns the verified signer + on-chain proof URLs.

`POST /v1/decode/tx`

{ "chain": "base" | "ethereum" | "solana", "tx_hash": "..." }

Returns structured tx receipt (from, to, value, gas, status, calldata for EVM; slot, signers, program_calls for Solana).

`GET /v1/resolve/name?name=<name>` — name → addresses

Supports .eth (ENS) and .sol (Bonfida SNS).

`GET /v1/price/token`

?symbol=ETH or ?chain=base&contract=0x.... Returns USD spot, 24h change, market cap. CoinGecko-backed, 60s in-process cache.

`POST /v1/decode/calldata`

{ "chain": "ethereum", "calldata_hex": "0xa9059cbb..." }

Decodes via openchain.xyz signature directory + eth_abi. Returns function name + typed params.

`POST /v1/parse/datetime`

{ "input": "tomorrow at noon", "timezone": "America/New_York" }

Returns ISO 8601 + components + relative_seconds + confidence.

`GET /v1/intel/wallet?wallet=<address>` — bundle play

ONE call, 8–10 parallel sources fetched, signed bundle returned: balances on Base + Ethereum + Solana, USDC across chains, tx counts, ENS/SNS reverse, sanctions verdict.

`GET /health` — public, no payment

{"status": "ok", "service": "anchor-x402"}.

Architecture

                          ┌───────────────────────────────────┐
client agent              │  AWS Lambda (Python 3.12)         │
   │                      │    ↓                              │
   │ x402 USDC ─────────▶ │  FastAPI + x402 middleware        │
   │ (Base or Solana)     │    ↓                              │
   │                      │  9 routes, 1 OpenAPI spec         │
   │                      │    ↓                              │
   │                      │  services/*.py                    │
   │                      │    │                              │
   │                      │    ├──► Base RPC (anchor txs)     │
   │                      │    ├──► Solana RPC (Memo txs)     │
   │                      │    ├──► CoinGecko (price)         │
   │                      │    ├──► openchain.xyz (calldata)  │
   │                      │    └──► CDP facilitator (settle)  │
   │                      └───────────────────────────────────┘
   │                                │
   ◄────────  signed JSON  ─────────┘

Stateless. No DynamoDB, no S3. Treasury keys live in AWS Secrets Manager (anchor-x402/runtime); fetched at cold-start and cached in process memory.

Repo layout

anchor-x402/
├── app.py                              # FastAPI + x402 + 9 routes
├── models.py                           # Pydantic request/response schemas
├── services/
│   ├── anchor.py                       # dual-chain hash anchoring
│   ├── attest.py                       # sig verification + anchor wrapper
│   ├── calldata_decode.py              # 4byte + ABI decode
│   ├── cdp_auth.py                     # CDP facilitator JWT auth
│   ├── datetime_parse.py               # dateparser + dateutil
│   ├── intel_wallet.py                 # parallel wallet intel bundle
│   ├── name_resolve.py                 # ENS + Bonfida SNS
│   ├── screen.py                       # OFAC SDN screening
│   ├── secrets.py                      # AWS Secrets Manager helper
│   ├── token_price.py                  # CoinGecko proxy + cache
│   └── tx_decode.py                    # tx receipt decoder
├── pay-skills/
│   └── anchor-x402/                    # mirrors solana-foundation/pay-skills tree
│       ├── dual-chain/PAY.md           # one PAY.md per service for the catalog PR
│       ├── wallet-screen/PAY.md
│       ├── decision-attest/PAY.md
│       ├── tx-decode/PAY.md
│       ├── name-resolve/PAY.md
│       ├── token-price/PAY.md
│       ├── calldata-decode/PAY.md
│       ├── datetime-parse/PAY.md
│       └── intel-wallet/PAY.md
├── scripts/
│   └── test_e2e.py                     # paid e2e for all 9 services
├── template.yaml                       # SAM (Lambda + APIGW + Secrets Manager + CloudWatch)
├── Makefile                            # install / lock / build / deploy / local
├── requirements.in / .txt              # pinned dependency lockfile
└── .env.example                        # treasury + CDP + RPC config

Operations

Treasury keys. Stored in AWS Secrets Manager (anchor-x402/runtime — treasury_evm_key, treasury_solana_key, cdp_api_key_secret). The Lambda IAM role can GetSecretValue on this ARN only. Rotate without a redeploy:

aws secretsmanager update-secret \
  --secret-id anchor-x402/runtime \
  --secret-string '{"treasury_evm_key":"...","treasury_solana_key":"...","cdp_api_key_secret":"..."}'
# Force a fresh cold start to pick it up:
aws lambda update-function-configuration \
  --function-name $(aws lambda list-functions --query 'Functions[?starts_with(FunctionName,`anchor-x402`)].FunctionName' --output text) \
  --description "rotate $(date +%s)"

Monitoring. CloudWatch alarms publish to the AlarmTopic SNS topic:

LambdaErrorsElevated — Errors > 5 / 5min
LambdaDurationP95High — Duration p95 > 25s / 5min
ApiGateway5xxElevated — 5xx > 3 / 5min
SolanaAnchorFailureRateHigh — log metric filter on "solana anchor failed" > 5 / 5min

Subscribe an email or phone post-deploy:

aws sns subscribe \
  --topic-arn $(aws cloudformation describe-stack-resource --stack-name anchor-x402 --logical-resource-id AlarmTopic --query 'StackResourceDetail.PhysicalResourceId' --output text) \
  --protocol email --notification-endpoint you@example.com

Treasury balance. Anchor + attest + intel-wallet pay native gas (Base ETH + Solana SOL). Fund the treasury with ~0.001 ETH and ~0.05 SOL to cover several hundred anchors.

Trust portal

For institutional review: https://anchor-x402.com/trust/ carries the full security posture — threat model, pre-filled SIG-Lite security questionnaire, code-level self-audit guide, regulated deployment guide, on-chain verifiability primer, and observability/status setup. Source files live at docs/trust/.

Institutional tier

anchor-x402 is the public-utility commodity tier. An institutional tier with per-tenant authentication, WORM evidence vault on S3 Object Lock, GDPR Article 17 erasure with AML retention reconciliation, signed MSA / DPA / SLA contracts, and dedicated support is available on request — pricing $499–$5,000+/mo depending on volume and posture. Reach out to hello@anchor-x402.com with your use case, expected call volume, and any compliance certifications you require.

Listings

Catalog	Type	Discovery URL	Status
CDP Bazaar	x402 service registry	auto-indexed via `extensions.bazaar` in 402 response	15 services live
agentic.market	x402 service search API	api.agentic.market/v1/services/search?q=api.anchor-x402.com	15 services live
Agent Arena	ERC-8004 on-chain agent registry (Base)	agentarena.site/api/agent/8453/47261	live (agentId 47261, full bundle)
Virtuals ACP	Agent Commerce Protocol	smart wallet `0x68847…75a51` on Base; 9 GET resource offerings + 1 Job offering (`investigateWallet`, $7.77)	resources registered; Job offering pending import
Official MCP Registry	Anthropic-maintained MCP server registry	registry.modelcontextprotocol.io/v0/servers?search=anchor-x402	published as `io.github.hypeprinter007-stack/anchor-x402`
Glama	MCP server marketplace	glama.ai/mcp/servers/hypeprinter007-stack/anchor-x402-mcp	License A / Quality A
mcp.so	MCP server directory	mcp.so/server/anchor-x402-mcp	live
npm	Node package registry	npmjs.com/package/anchor-x402-mcp	`anchor-x402-mcp@0.1.2`

Roadmap

Master / hot-wallet split. Receive USDC into a cold master wallet; pay anchor gas from a small hot wallet in Secrets Manager. If hot key leaks, only pennies of gas float at risk.
Multi-sig treasury (Safe on Base + Squads on Solana) for production-grade key custody.
Auto top-up from master to hot wallet when a CloudWatch low-balance alarm fires.
More services based on real agent demand: web search aggregator, PDF extraction, transactional email send.

License

MIT — see LICENSE.

Author

Christopher Ferjo — solo build, post-Counsel (EasyA Consensus 2026 hackathon project).

Name		Name	Last commit message	Last commit date
Latest commit History 91 Commits
docs		docs
examples		examples
gateway-shim		gateway-shim
pay-skills/anchor-x402		pay-skills/anchor-x402
scripts		scripts
services		services
static		static
.env.example		.env.example
.gitignore		.gitignore
LEARNINGS.md		LEARNINGS.md
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
SECURITY.md		SECURITY.md
app.py		app.py
models.py		models.py
package-lock.json		package-lock.json
package.json		package.json
requirements.in		requirements.in
requirements.txt		requirements.txt
template.yaml		template.yaml

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

anchor-x402

Services

Why

Quickstart (operator)

Quickstart (agent / consumer)

API

`POST /v1/anchor` — dual-chain anchor

`GET /v1/screen?wallet=<address>` — sanctions screening

`POST /v1/attest` — signed decision attestation

`POST /v1/decode/tx`

`GET /v1/resolve/name?name=<name>` — name → addresses

`GET /v1/price/token`

`POST /v1/decode/calldata`

`POST /v1/parse/datetime`

`GET /v1/intel/wallet?wallet=<address>` — bundle play

`GET /health` — public, no payment

Architecture

Repo layout

Operations

Trust portal

Institutional tier

Listings

Roadmap

License

Author

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

anchor-x402

Services

Why

Quickstart (operator)

Quickstart (agent / consumer)

API

POST /v1/anchor — dual-chain anchor

GET /v1/screen?wallet=<address> — sanctions screening

POST /v1/attest — signed decision attestation

POST /v1/decode/tx

GET /v1/resolve/name?name=<name> — name → addresses

GET /v1/price/token

POST /v1/decode/calldata

POST /v1/parse/datetime

GET /v1/intel/wallet?wallet=<address> — bundle play

GET /health — public, no payment

Architecture

Repo layout

Operations

Trust portal

Institutional tier

Listings

Roadmap

License

Author

About

Topics

Resources

License

Security policy

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

`POST /v1/anchor` — dual-chain anchor

`GET /v1/screen?wallet=<address>` — sanctions screening

`POST /v1/attest` — signed decision attestation

`POST /v1/decode/tx`

`GET /v1/resolve/name?name=<name>` — name → addresses

`GET /v1/price/token`

`POST /v1/decode/calldata`

`POST /v1/parse/datetime`

`GET /v1/intel/wallet?wallet=<address>` — bundle play

`GET /health` — public, no payment

Packages