Receipt Card

{
  "answer": {
    "card": "receipt",
    "card_data": {
      "checks": [
        {
          "check": "destination",
          "expected": "rsYa1hwrctVn1gTNAPNJKuSZkUPeiNACMi",
          "observed": "rsYa1hwrctVn1gTNAPNJKuSZkUPeiNACMi",
          "pass": true
        },
        {
          "check": "currency",
          "expected": "XRP",
          "observed": "XRP",
          "pass": true
        }
      ],
      "observed": {
        "delivered": {
          "currency": "XRP",
          "issuer": null,
          "value": "82782.79951"
        },
        "destination_tag": null,
        "from": "rwwEAppcoEmW17F85pG9rpcgb5bApXU5yZ",
        "partial_payment_flag": false,
        "stated_amount_field": {
          "currency": "XRP",
          "issuer": null,
          "value": "82782.79951"
        },
        "to": "rsYa1hwrctVn1gTNAPNJKuSZkUPeiNACMi"
      },
      "warnings": []
    },
    "cue_map": [
      {
        "class": "derived",
        "cue": "status pill",
        "means": "SETTLED only when the payment is in a validated ledger with tesSUCCESS",
        "source": "validated flag + TransactionResult + your expectation checks"
      },
      {
        "class": "observed",
        "cue": "large amount",
        "means": "what actually arrived (not the Amount field, which partial payments can inflate)",
        "source": "meta.delivered_amount"
      }
    ],
    "image": {
      "base64": "(base64 PNG, about 100 KB)",
      "bytes": 82787,
      "format": "png",
      "height": 675,
      "width": 1200
    },
    "verdict": "settled_as_expected",
    "verify_url": "https://livenet.xrpl.org/transactions/4B312353073573A7E09AD2AAEA907894B3E66B5D33B9C48A79EBB5871B070810"
  },
  "checked_at": "2026-10-18T04:26:50+00:00",
  "proof": {
    "close_time": "2026-10-18T04:16:22+00:00",
    "ledger_index": 107731874,
    "network": "xrpl:0 (mainnet)",
    "sources": [
      {
        "method": "tx",
        "name": "XRP Ledger public server",
        "url": "https://xrplcluster.com/"
      }
    ],
    "transaction": "4B312353073573A7E09AD2AAEA907894B3E66B5D33B9C48A79EBB5871B070810",
    "validated": true
  },
  "service": "receipt_card",
  "unknowns": [
    "Who controls the sending or receiving address (the ledger does not record identity).",
    "The card is an image of ledger data; the verify link is the authority."
  ]
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://bruk-agent-api.fly.dev/v1/receipt-card?tx=CCA2528E8BE7B3C50640BD8CB0A624555D5952DAD51843C0913A904E0FD690E7'

# 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 - 'https://bruk-agent-api.fly.dev/v1/receipt-card?tx=CCA2528E8BE7B3C50640BD8CB0A624555D5952DAD51843C0913A904E0FD690E7' \
  | 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.02 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.02" });
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.02 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fbruk-agent-api.fly.dev%2Fv1%2Freceipt-card
const res = await pay("https://bruk-agent-api.fly.dev/v1/receipt-card?tx=CCA2528E8BE7B3C50640BD8CB0A624555D5952DAD51843C0913A904E0FD690E7");
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.02 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.02"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.get("https://bruk-agent-api.fly.dev/v1/receipt-card?tx=CCA2528E8BE7B3C50640BD8CB0A624555D5952DAD51843C0913A904E0FD690E7")
    print(res.status_code, res.text)