From zero to your first verified agent payment on XRPL

pip install xrpl-py httpx

from xrpl.clients import JsonRpcClient
from xrpl.wallet import generate_faucet_wallet

client = JsonRpcClient("https://s.altnet.rippletest.net:51234")
wallet = generate_faucet_wallet(client, debug=True)

print(wallet.classic_address)  # rXXX... — share this with counterparties
print(wallet.seed)             # sXXX... — store securely, never share

from xrpl.clients import JsonRpcClient
from xrpl.wallet import Wallet
from xrpl.models.transactions import Payment
from xrpl.utils import xrp_to_drops
from xrpl.transaction import submit_and_wait

client = JsonRpcClient("https://s.altnet.rippletest.net:51234")
sender = Wallet.from_seed("sSenderSeed")

tx = Payment(
    account=sender.classic_address,
    destination="rRecipientAddress",
    amount=xrp_to_drops(1),   # 1 XRP = 1_000_000 drops
)

response = submit_and_wait(tx, client, sender)
print(response.result["meta"]["TransactionResult"])  # "tesSUCCESS"

import httpx

score = httpx.get(
    "https://mcp.cryptovault.co.uk/wallet/score/rWorkerAddress"
).json()

# score["score"] is 0–100
print(score["score"])
print(score["score_breakdown"])                # per-signal breakdown
print(score["signals"]["sanctions_clean"])     # False = stop immediately

11 signals: account age, balance, activity, XRPL domain verification, NFT history, payment completion rate, peer reputation, XRPL Attestation, OFAC sanctions, XRPScan entity reputation, and identity KYC.

First send $0.10 (XRP, RLUSD, or USDC) to rmcSrkpZ2i2kuvtCPeTVetee9SixP4djR as the protocol fee (using the submit_and_wait pattern above), then pass that transaction hash as fee_hash.

import uuid, httpx

escrow = httpx.post(
    "https://mcp.cryptovault.co.uk/escrow/generate",
    json={
        "escrow_id":        str(uuid.uuid4()),
        "fee_hash":         "your_fee_tx_hash",
        "buyer_name":       "Orchestrator Agent",
        "buyer_address":    "rBuyerAddress",
        "buyer_email":      "buyer@example.com",
        "worker_address":   "rWorkerAddress",
        "worker_email":     "worker@example.com",
        "task_description": "Write a 200-word product description for...",
        "amount_xrp":       5.0,
        "cancel_after_hrs": 48,
    }
).json()

escrow_id = escrow["escrow_id"]   # keep this — needed in later steps
# Submit the returned EscrowCreate tx blob to XRPL:
# submit_and_wait(escrow["tx_blob"], client, buyer_wallet)

result = httpx.post(
    "https://mcp.cryptovault.co.uk/evaluate",
    json={
        "escrow_id": escrow_id,
        "work":      "Here is the completed product description...",
    }
).json()

print(result["verdict"])   # "PASS" or "FAIL"
print(result["score"])     # 0–100

# Always read criteria before acting
for c in result.get("criteria_met", []):
    print("✓", c)
for c in result.get("criteria_failed", []):
    print("✗", c)   # specific, actionable — share with the worker

from xrpl.models.transactions import EscrowCancel
from xrpl.models.requests import AccountObjects

# Retrieve the escrow sequence number from the ledger
objects = client.request(AccountObjects(account=buyer_wallet.classic_address)).result
escrow_obj = next(
    o for o in objects["account_objects"]
    if o["LedgerEntryType"] == "Escrow"
    and o.get("Destination") == worker_address
)

cancel_tx = EscrowCancel(
    account=buyer_wallet.classic_address,
    owner=buyer_wallet.classic_address,
    offer_sequence=escrow_obj["PreviousTxnLgrSeq"],  # sequence of the EscrowCreate tx
)
cancel_result = submit_and_wait(cancel_tx, client, buyer_wallet)
print("Funds reclaimed:", cancel_result.result["meta"]["TransactionResult"])