Updated 2026-07-08 · integration

Your first settled call

Verdicts under $10 at risk are free. This is the other half — a real x402-settled call, so your agent gets a verdict and a receipt anyone can verify without trusting us. One command, about a cent on Base.

Free vs settled — which do you want?

One command

Node 18+, a terminal, and about a dollar of USDC on Base. No MetaMask, no key copying — the script makes a throwaway burner wallet for you.

npm i viem @x402/fetch @x402/evm
curl -O https://x402.blackwalltier.com/first-settled-call.mjs
node first-settled-call.mjs        # add --dry-run to stop before paying

What it does

  1. Creates (or reuses) a local burner wallet in burner-wallet.json — it never leaves your machine and holds at most ~$1.
  2. Prints the burner address and waits while you send ~$1 USDC to it on the Base network (Coinbase: Send → USDC → paste address → network: Base). It watches the chain and continues on its own the moment the money lands.
  3. Settles ~$0.01 USDC via x402 and prints your verdict + signed receipt.

Why a cent, not less: the oracle serves any amount at risk ≤ $10 for free (no payment settles). To exercise a real settled call the forecast must be above $10; the fee is 10 bps of it — $0.010010 at a $10.01 forecast, the cheapest a payable call can be.

What you get back

A verdict — GO · HOLD · STOP — and a signed_receipt: an Ed25519 signature over (verdict, counterparty, amount, receipt_id, ts). Verify it against the published key with any RFC 8032 library, Black_Wall out of the loop:

key: https://agent-egress-proxy.onrender.com/.well-known/blackwall-receipt-key.json

That's neutral proof of what the oracle told you — not a note you have to take on trust. A fresh or unknown counterparty comes back HOLD: no history is not trust, and it won't rubber-stamp a stranger — not even for you.

Make it about your payment

By default it forecasts a neutral probe address. To get a verdict about the wallet you're actually about to pay, pass its address:

BW_COUNTERPARTY=0xThePayToFromYour402 node first-settled-call.mjs

In a live agent, you'd call the oracle in the pre-signature window — after the 402 Payment Required, before you sign — and act on the verdict. See Add Black_Wall to your agent for that wiring.