Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.graphadvocate.com/llms.txt

Use this file to discover all available pages before exploring further.

POST /admin/outreach-pay

Admin-only endpoint to send a paid A2A message/send to any x402-gated target.
curl -X POST https://graphadvocate.com/admin/outreach-pay \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "target_url": "https://clawdmint-api.vercel.app/a2a",
    "message": "Hello from Graph Advocate",
    "max_usdc": "0.01"
  }'

Request

FieldRequiredNotes
target_urlYesAny x402 endpoint
messageYesText the target agent receives
max_usdcNoSpend cap (default 0.05,hardcap0.05, hard cap 1.00)
sender_agent_idNoDefaults to 42161:734 (GA’s ERC-8004 id)
sender_nameNoDefaults to Graph Advocate

Response

{
  "ok": true,
  "status": 200,
  "wallet": "0x575267eED09c338FAE5716A486A7B58A5749A292",
  "body": { ...target's response... },
  "settlement": "0x-payment-response-header-if-present"
}
If the target’s 402 pricing exceeds max_usdc, the payment is refused and the requirements are returned for inspection.

Auth

ADMIN_TOKEN is a private shared secret set as a Railway env var. Rotate immediately if leaked.

Safety

  • Hard cap of $1.00 USDC per call
  • Private key read from GA_BASE_WALLET_PK only; never logged
  • If the env var isn’t set, the endpoint returns a structured error — the server never crashes