NEXUS Ap2 Batched Settle

Security

Atomically settle up to 20 AI agent payments in a single XRPL Batch transaction. Implements Google's AP2 (Agent Payments Protocol) with XLS-56 Batch on XRP Ledger — ~5 second finality, ultra-low fees, non-custodial.

Install

openclaw skills install nexus-ap2-batched-settle

NEXUS AP2 Batched Settlement on XRPL

Google's Agent Payments Protocol (AP2) + XRP Ledger XLS-56 Batch | ~5s finality | Up to 20 mandates per tx | Non-custodial

When to use

Use this skill when an autonomous agent needs to:

Pre-authorize payments for AI services using AP2 mandates (Cart for specific purchases, Intent for ongoing autonomous spending within a budget)
Settle many payments at once — pay 5, 10, or 20 different AI services with one signed transaction instead of one tx per service
Operate at low latency — XRPL settles in ~5 seconds with ~$0.000005 fees, dramatically reducing M2M friction vs other chains
Maintain non-custodial control — buyer's wallet signs every tx; NEXUS never holds keys or funds

Why batched settlement matters

Without batching: agent makes 20 API calls → 20 separate XRPL transactions → 20 separate signatures, 20× the latency, 20× the fees.

With NEXUS AP2 + XLS-56 Batch: agent calls 20 APIs → pre-authorizes via AP2 mandates → executes ONE signed Batch tx that atomically settles all 20. ALLORNOTHING mode guarantees no partial settlement.

Steps

Step 1: Create an AP2 Mandate

For an Intent Mandate (agent autonomy, e.g. "spend up to 10 XRP this week"):

curl -X POST https://ai-service-hub-15.emergent.host/api/ap2/mandates/create \
  -H "Content-Type: application/json" \
  -d '{
    "mandate_type": "intent",
    "user_did": "did:agent:my-agent-id",
    "agent_id": "my-agent-id",
    "merchant_id": "nexus",
    "mandate_content": {
      "natural_language_intent": "Buy AI services up to 10 XRP this week",
      "max_price": 10.0,
      "currency": "XRP",
      "time_window_start": "2026-02-26T00:00:00Z",
      "time_window_end": "2026-03-05T23:59:59Z"
    },
    "user_signature": {
      "algorithm": "ECDSA",
      "signature_value": "sandbox_test_sig_001",
      "timestamp": "2026-02-26T12:00:00Z",
      "user_did": "did:agent:my-agent-id"
    }
  }'

Returns { "mandate_id": "ap2_intent_xxx", "expires_at": "...", ... }.

For a Cart Mandate (specific items, single purchase):

curl -X POST https://ai-service-hub-15.emergent.host/api/ap2/mandates/create \
  -H "Content-Type: application/json" \
  -d '{
    "mandate_type": "cart",
    "user_did": "did:agent:my-agent-id",
    "agent_id": "my-agent-id",
    "mandate_content": {
      "total_amount": 1.0,
      "currency": "XRP",
      "items": [{"sku": "llm-gateway", "name": "LLM Gateway Call", "price": 1.0, "quantity": 1}]
    },
    "user_signature": {"algorithm":"ECDSA","signature_value":"sandbox_test_sig_002","timestamp":"2026-02-26T12:00:00Z","user_did":"did:agent:my-agent-id"}
  }'

Step 2a (Single Settle): Settle One Mandate

curl -X POST https://ai-service-hub-15.emergent.host/api/ap2/payments/settle \
  -H "Content-Type: application/json" \
  -d '{
    "mandate_id": "ap2_intent_xxx",
    "mandate_type": "intent",
    "verification_record_id": "",
    "amount": 2.5,
    "currency": "XRP",
    "payer_address": "r<your-xrpl-address>",
    "recipient_address": "rM86ChiqozvfHwLckKRq2yTtzKLwfBe2XA",
    "chain": "xrpl"
  }'

Returns unsigned_tx — an XRPL Payment JSON with hex-encoded ap2.mandate.id memo. Sign with your wallet (Xumm, Crossmark, hardware), broadcast, then confirm:

curl -X POST "https://ai-service-hub-15.emergent.host/api/ap2/payments/<mandate_id>/confirm?tx_hash=<HASH>"

Step 2b (Batched Settle): Settle Up to 20 Mandates in One Tx

curl -X POST https://ai-service-hub-15.emergent.host/api/ap2/payments/batch \
  -H "Content-Type: application/json" \
  -d '{
    "mandate_ids": ["ap2_cart_001", "ap2_cart_002", "ap2_cart_003", "ap2_intent_001"],
    "payer_address": "r<your-xrpl-address>",
    "chain": "xrpl",
    "mode": "ALLORNOTHING"
  }'

Returns an unsigned XLS-56 Batch transaction containing all inner Payments. Sign + broadcast once. After broadcast:

curl -X POST "https://ai-service-hub-15.emergent.host/api/ap2/payments/batch/<batch_id>/confirm?tx_hash=<HASH>"

Step 3 (Optional): Verify the broadcast

curl -X POST https://ai-service-hub-15.emergent.host/api/xrpl/verify \
  -H "Content-Type: application/json" \
  -d '{"tx_hash":"<HASH>","currency":"XRP","expected_memo":"<mandate_id>"}'

Returns { valid: true, amount_drops, amount_xrp, currency, source, destination, memos: [...] }.

RLUSD Support

Want to settle in regulated USD stablecoin instead of XRP? RLUSD is supported natively.

One-time setup — establish a trust line to Ripple's RLUSD issuer:

curl -X POST https://ai-service-hub-15.emergent.host/api/xrpl/build/trust-line \
  -H "Content-Type: application/json" \
  -d '{"holder_address":"r<your-address>","currency":"RLUSD"}'

Then use "currency": "RLUSD" in your mandates. RLUSD issuer is rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De.

External Endpoints

URL	Method	Purpose
`/api/ap2/mandates/create`	POST	Mint a new mandate
`/api/ap2/mandates`	GET	List mandates (filter by agent_id)
`/api/ap2/payments/settle`	POST	Settle one mandate
`/api/ap2/payments/batch`	POST	Atomic batched settlement
`/api/ap2/payments/{id}/confirm`	POST	Confirm broadcast tx
`/api/ap2/config`	GET	AP2 discovery (chains, tokens, batch spec)
`/api/xrpl/config`	GET	XRPL config (network, receiving address, assets)
`/api/xrpl/verify`	POST	Verify any XRPL Payment tx
`/api/xrpl/build/escrow`	POST	EscrowCreate template (FundsLocked → ResultSubmitted)

Security & Privacy

Non-custodial. NEXUS NEVER sees or signs with your XRPL seed. Every unsigned_tx returned must be signed locally in your wallet.
All requests over HTTPS/TLS to ai-service-hub-15.emergent.host.
Mandate signatures validated cryptographically (sandbox bypass available for testing via sandbox_ prefix).
Payment proofs verified on XRPL via Ripple public JSON-RPC nodes.

Model Invocation Note

This skill does NOT invoke any LLM. It is pure payment orchestration infrastructure — mandates, signatures, transaction templates, and on-chain verification.

Trust Statement

NEXUS only constructs unsigned transaction JSON and verifies on-chain payment proofs. Buyers retain full control of their wallets and funds. Mandate creation is reversible (mandates can be deleted before settlement). For production use, replace sandbox_ signatures with real ECDSA/EdDSA signatures.