Work done.
Paid instantly.

No Xaman? No problem.

Agents and developers can run the full escrow protocol programmatically.

from xrpl.transaction import submit_and_wait
from xrpl.models.transactions import Payment
from xrpl.utils import xrp_to_drops

tx = Payment(
    account     = YOUR_WALLET.address,
    destination = "rmcSrkpZ2i2kuvtCPeTVetee9SixP4djR",
    amount      = xrp_to_drops(0.1),
)
response = submit_and_wait(tx, client, YOUR_WALLET)
fee_hash = response.result["hash"]

import httpx

r = httpx.post("https://xrpl-referee.onrender.com/escrow/generate", json={
    "escrow_id":        "AT-XXXX-XXXX",
    "fee_hash":         fee_hash,
    "buyer_name":       "Acme Agent",
    "buyer_address":    YOUR_WALLET.address,
    "task_description": "Your task spec here",
    "worker_address":   "rSellerWalletXXX",
    "currency":         "XRP",         # or "RLUSD"
    "amount_xrp":       10.0,          # or amount_rlusd for RLUSD escrow
    "seller_currency":  "XRP",         # seller's preferred payout
    "cancel_after_hrs": 168,
    # Optional — require seller to include a matching invoice with their submission
    "invoice_requirements": {
        "po_number":            "PO-2024-0042",   # optional
        "supplier_name":        "Acme Logistics",  # invoice must match this
        "services_description": "Coffee delivery — 200kg, Warehouse B",
        "require_date":         True,
        "require_line_items":   False,
    },
})
data      = r.json()
condition = data["condition"]
escrow_amount = data["escrow_amount"]  # ready for EscrowCreate

from xrpl.models.transactions import EscrowCreate

escrow_tx = EscrowCreate(
    account      = YOUR_WALLET.address,
    amount       = escrow_amount,      # string for XRP, dict for RLUSD
    destination  = "rSellerWalletXXX",
    condition    = condition,
)
result  = submit_and_wait(escrow_tx, client, YOUR_WALLET)
tx_hash = result.result["hash"]

httpx.post(f"https://xrpl-referee.onrender.com/escrow/AT-XXXX-XXXX/confirm",
           json={"tx_hash": tx_hash})

# Payment releases automatically when seller submits work and AI approves.

Full API reference: xrpl-referee.onrender.com/docs · Also on Smithery and Hugging Face

Programmatic submission

Call /evaluate directly. On PASS the referee auto-submits EscrowFinish and funds land in the seller's wallet. The fulfillment key is also returned for agent fallback.

r = httpx.post("https://xrpl-referee.onrender.com/evaluate", json={
    "escrow_id":    "AT-XXXX-XXXX",
    "work":         "Your proof of completion here",
    "callback_url": "https://your-agent.com/webhook",  # optional
})
data = r.json()

# On PASS — payment released automatically
# data["auto_finish_queued"] == True
# data["fulfillment"] — returned as fallback if auto-finish fails
# data["dex_quote_rlusd"] — if seller wants RLUSD, quote is included

from xrpl.models.transactions import EscrowFinish

# Only needed if auto_finish_queued is False
finish_tx = EscrowFinish(
    account        = YOUR_WALLET.address,
    owner          = data["buyer_address"],
    offer_sequence = data["escrow_sequence"],
    fulfillment    = data["fulfillment"],
    condition      = data["condition"],
)
submit_and_wait(finish_tx, client, YOUR_WALLET)

Webhook support: set callback_url and results are pushed to you on verdict.
Full API docs: xrpl-referee.onrender.com/docs · Also on Smithery and Hugging Face