X402 Agent Commerce Digital Twin

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://api.blockchainmoneymap.com/api/x402/x402-agent-commerce-digital-twin' \
  -H 'content-type: application/json' \
  --data-raw '{"facts":{"agent_card_hash":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","agent_card_url_label":"https://blockchainmoneymap.com/agents","agent_role":"router agent that selects and calls one paid tool","agent_skill_ids":["wallet_snapshot"],"allowed_payees":["BMM configured x402 receiving address label"],"allowed_task":"call only bmm_wallet_snapshot once for 0.01 USD or less","amount_cap":0.01,"buyer_role":"buyer agent with a one-call budget","currency":"USDC","declared_limitations":["public-chain facts only","no legal or compliance approval"],"expected_output":"JSON report with decision, confidence, evidence, and limitations","expiry":"single mission expires after one attempt","facilitator_label":"configured x402 facilitator","human_presence_mode":"human approves before enabling unattended spend","human_return_triggers":["amount changes","receiver label changes","output is missing","receipt is missing"],"idempotency_policy":"dedupe by x402 request id and mission label","intended_outcome":"receive a JSON decision, confidence score, findings, and limitations","known_gaps":"Live settlement verification remains a separate release gate.","max_retries":1,"mcp_tool_name":"bmm_wallet_snapshot","mission_label":"Buyer agent purchases one public wallet snapshot from BMM","network":"base","provider_label":"Blockchain Money Map","receipt_requirement":"x402 receipt hash and delivered output status required","recurrence":"one-time","retry_policy":"do not retry after a receipt; retry only once before payment is settled","rollback_contact":"BMM support owner label","route_path":"/api/x402/wallet-snapshot","seller_role":"BMM paid x402 service","support_path":"BMM support path label","wallet_policy_summary":"buyer wallet allows one 0.01 USD USDC payment to the selected service","x402_amount":0.01,"x402_receiver_label":"BMM configured x402 receiving address label"},"mode":"analyze"}'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - -X POST 'https://api.blockchainmoneymap.com/api/x402/x402-agent-commerce-digital-twin' \
  -H 'content-type: application/json' \
  --data-raw '{"facts":{"agent_card_hash":"sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa","agent_card_url_label":"https://blockchainmoneymap.com/agents","agent_role":"router agent that selects and calls one paid tool","agent_skill_ids":["wallet_snapshot"],"allowed_payees":["BMM configured x402 receiving address label"],"allowed_task":"call only bmm_wallet_snapshot once for 0.01 USD or less","amount_cap":0.01,"buyer_role":"buyer agent with a one-call budget","currency":"USDC","declared_limitations":["public-chain facts only","no legal or compliance approval"],"expected_output":"JSON report with decision, confidence, evidence, and limitations","expiry":"single mission expires after one attempt","facilitator_label":"configured x402 facilitator","human_presence_mode":"human approves before enabling unattended spend","human_return_triggers":["amount changes","receiver label changes","output is missing","receipt is missing"],"idempotency_policy":"dedupe by x402 request id and mission label","intended_outcome":"receive a JSON decision, confidence score, findings, and limitations","known_gaps":"Live settlement verification remains a separate release gate.","max_retries":1,"mcp_tool_name":"bmm_wallet_snapshot","mission_label":"Buyer agent purchases one public wallet snapshot from BMM","network":"base","provider_label":"Blockchain Money Map","receipt_requirement":"x402 receipt hash and delivered output status required","recurrence":"one-time","retry_policy":"do not retry after a receipt; retry only once before payment is settled","rollback_contact":"BMM support owner label","route_path":"/api/x402/wallet-snapshot","seller_role":"BMM paid x402 service","support_path":"BMM support path label","wallet_policy_summary":"buyer wallet allows one 0.01 USD USDC payment to the selected service","x402_amount":0.01,"x402_receiver_label":"BMM configured x402 receiving address label"},"mode":"analyze"}' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.01 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.01" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.01 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.blockchainmoneymap.com%2Fapi%2Fx402%2Fx402-agent-commerce-digital-twin&method=POST
const res = await pay("https://api.blockchainmoneymap.com/api/x402/x402-agent-commerce-digital-twin", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "facts": {
      "agent_card_hash": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "agent_card_url_label": "https://blockchainmoneymap.com/agents",
      "agent_role": "router agent that selects and calls one paid tool",
      "agent_skill_ids": [
        "wallet_snapshot"
      ],
      "allowed_payees": [
        "BMM configured x402 receiving address label"
      ],
      "allowed_task": "call only bmm_wallet_snapshot once for 0.01 USD or less",
      "amount_cap": 0.01,
      "buyer_role": "buyer agent with a one-call budget",
      "currency": "USDC",
      "declared_limitations": [
        "public-chain facts only",
        "no legal or compliance approval"
      ],
      "expected_output": "JSON report with decision, confidence, evidence, and limitations",
      "expiry": "single mission expires after one attempt",
      "facilitator_label": "configured x402 facilitator",
      "human_presence_mode": "human approves before enabling unattended spend",
      "human_return_triggers": [
        "amount changes",
        "receiver label changes",
        "output is missing",
        "receipt is missing"
      ],
      "idempotency_policy": "dedupe by x402 request id and mission label",
      "intended_outcome": "receive a JSON decision, confidence score, findings, and limitations",
      "known_gaps": "Live settlement verification remains a separate release gate.",
      "max_retries": 1,
      "mcp_tool_name": "bmm_wallet_snapshot",
      "mission_label": "Buyer agent purchases one public wallet snapshot from BMM",
      "network": "base",
      "provider_label": "Blockchain Money Map",
      "receipt_requirement": "x402 receipt hash and delivered output status required",
      "recurrence": "one-time",
      "retry_policy": "do not retry after a receipt; retry only once before payment is settled",
      "rollback_contact": "BMM support owner label",
      "route_path": "/api/x402/wallet-snapshot",
      "seller_role": "BMM paid x402 service",
      "support_path": "BMM support path label",
      "wallet_policy_summary": "buyer wallet allows one 0.01 USD USDC payment to the selected service",
      "x402_amount": 0.01,
      "x402_receiver_label": "BMM configured x402 receiving address label"
    },
    "mode": "analyze"
  }),
});
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.01 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.01"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.post(
        "https://api.blockchainmoneymap.com/api/x402/x402-agent-commerce-digital-twin",
        json={
            "facts": {
                "agent_card_hash": "sha256:aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                "agent_card_url_label": "https://blockchainmoneymap.com/agents",
                "agent_role": "router agent that selects and calls one paid tool",
                "agent_skill_ids": [
                    "wallet_snapshot",
                ],
                "allowed_payees": [
                    "BMM configured x402 receiving address label",
                ],
                "allowed_task": "call only bmm_wallet_snapshot once for 0.01 USD or less",
                "amount_cap": 0.01,
                "buyer_role": "buyer agent with a one-call budget",
                "currency": "USDC",
                "declared_limitations": [
                    "public-chain facts only",
                    "no legal or compliance approval",
                ],
                "expected_output": "JSON report with decision, confidence, evidence, and limitations",
                "expiry": "single mission expires after one attempt",
                "facilitator_label": "configured x402 facilitator",
                "human_presence_mode": "human approves before enabling unattended spend",
                "human_return_triggers": [
                    "amount changes",
                    "receiver label changes",
                    "output is missing",
                    "receipt is missing",
                ],
                "idempotency_policy": "dedupe by x402 request id and mission label",
                "intended_outcome": "receive a JSON decision, confidence score, findings, and limitations",
                "known_gaps": "Live settlement verification remains a separate release gate.",
                "max_retries": 1,
                "mcp_tool_name": "bmm_wallet_snapshot",
                "mission_label": "Buyer agent purchases one public wallet snapshot from BMM",
                "network": "base",
                "provider_label": "Blockchain Money Map",
                "receipt_requirement": "x402 receipt hash and delivered output status required",
                "recurrence": "one-time",
                "retry_policy": "do not retry after a receipt; retry only once before payment is settled",
                "rollback_contact": "BMM support owner label",
                "route_path": "/api/x402/wallet-snapshot",
                "seller_role": "BMM paid x402 service",
                "support_path": "BMM support path label",
                "wallet_policy_summary": "buyer wallet allows one 0.01 USD USDC payment to the selected service",
                "x402_amount": 0.01,
                "x402_receiver_label": "BMM configured x402 receiving address label",
            },
            "mode": "analyze",
        },
    )
    print(res.status_code, res.text)