{"id":"io.github.eamwhite1/xrpl-referee","slug":"io-github-eamwhite1-xrpl-referee","title":"AgentTrust XRPL","description":"Escrow for AI agents on the XRP Ledger. 51 tools. Free testnet sandbox (no real XRP).","version":"7.0.12","publisher":{"kind":"github","id":"eamwhite1","label":"@eamwhite1 on GitHub","url":"https://github.com/eamwhite1"},"website":"https://agenttrustxrpl.com","repository":"https://github.com/eamwhite1/xrpl-referee","remotes":[{"type":"streamable-http","url":"https://mcp.cryptovault.co.uk/mcp"}],"packages":[],"published":"2026-11-18","updated":"2026-11-18","status":"online","auth":"","latency_ms":1406,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"create_testnet_wallet","title":"Create Testnet Wallet","description":"Call twice — one wallet for the buyer, one for the worker — then hire_and_pay(network='testnet'), sign, submit_escrow_transaction.\n\nCreates a fresh XRPL testnet wallet funded via the public faucet.\nReturns address and secret — save the secret immediately, it is never\nstored or logged by AgentTrust.\n\nSign with: Python: from xrpl.transaction import sign; from xrpl.models.transactions import EscrowCr","read_only":false},{"name":"try_testnet_demo","title":"Try Testnet Demo","description":"Runs a full testnet escrow (2 free wallets → lock → submit → PASS → release) in ~30 s and returns both explorer links.\n\nCreates two wallets, posts a demo task, locks 1 test XRP in escrow,\nsubmits demo work, and returns the full AI audit verdict — all with test XRP,\nzero real cost, and no setup required.\n\nReturns the full flow result including escrow_id, verdict, explorer links, and next steps.","read_only":false},{"name":"audit_task","title":"Audit Task","description":"Verify whether completed work meets a task specification using AI.\n\nCall get_fees() first to get the current fee amount and accepted assets.\nEach fee_hash is single-use (anti-replay protection).\n\nResponse shape (always check criteria_failed before deciding how to proceed):\n\n    {\n      \"verdict\":         \"PASS\" | \"FAIL\",\n      \"status\":          \"approved\" | \"rejected\",\n      \"score\":           0-","read_only":false},{"name":"create_escrow_vault","title":"Create Escrow Vault","description":"Create an XRPL escrow vault. Funds release automatically to the worker when\ntheir submission passes all configured checks.\nFree to try: pass network='testnet' (see create_testnet_wallet / try_testnet_demo).\n\nBuyers can require NFT ownership, an atomic NFT Delivery-vs-Payment swap, domain\nverification, or W3C Verifiable Credentials before a PASS releases escrow — set the\nrelevant proof-gate params ","read_only":false},{"name":"confirm_escrow_transaction","title":"Confirm Escrow Transaction","description":"Register the on-chain EscrowCreate transaction hash with the referee.\n\nCall this after submitting the EscrowCreate transaction on XRPL.\nThe referee caches the escrow sequence number automatically so the\nworker does not need to provide it when claiming payment.","read_only":false},{"name":"evaluate_escrow_work","title":"Evaluate Escrow Work","description":"Submit proof of completed work against an existing escrow vault.\nVaults with proof gates also need nft_token_id (and optionally nft_wallet) and/or vc_jwt.\n\nOn PASS, payment releases automatically — no EscrowFinish needed.\nXRPL transaction hashes (64-char hex) in the work field are automatically\nverified on the ledger. Useful as proof of NFT transfers, token payments,\nor any on-chain delivery.\n\nEva","read_only":false},{"name":"purchase_extra_attempt","title":"Purchase Extra Submission Attempt","description":"Purchase one additional submission attempt for a vault that has hit its limit.\n\nWorkers get 3 attempts by default (buyers can set more via max_submissions,\nwith each slot above 3 costing $0.05 extra at creation time).\nWhen evaluate_escrow_work returns error \"submission_limit_reached\", call\nthis tool with a $0.05 fee payment to unlock one more attempt, then\nresubmit with evaluate_escrow_work.\n\nFee:","read_only":false},{"name":"prepare_challenge_escrow","title":"Prepare Challenge Escrow","description":"Step 1 of the challenge flow: get a fee quote and unsigned EscrowCreate transaction.\n\nThe challenge fee (~$1.00 USD in XRP) is held as a crypto-condition escrow\nto the worker address. On PASS_UPHELD the fee releases to the worker; on\nPASS_OVERTURNED or REVIEW_INCONCLUSIVE the fee is REFUNDABLE via EscrowCancel.\n\nReturns: quote_id, fee_drops, fee_xrp, condition, destination (worker),\nunsigned_tx (s","read_only":false},{"name":"challenge_escrow_verdict","title":"Challenge Escrow Verdict","description":"Submit a challenge against a PASS verdict during the challenge window.\n\nTwo-step process:\n1. Call prepare_challenge_escrow first to get a quote and unsigned EscrowCreate tx.\n2. Sign and submit the EscrowCreate (fee goes to worker address as escrow).\n3. Call this tool with the resulting tx hash.\n\nOutcomes:\n- PASS_UPHELD (challenge rejected): escrow releases to worker, fee released to worker.\n- PASS","read_only":false},{"name":"reissue_evaluate_token","title":"Reissue Evaluate Token","description":"Reissue a lost evaluate_token by proving ownership of the buyer wallet.\n\nIf you lost the evaluate_token returned by hire_and_pay() or create_escrow_vault(),\ncall this to recover it. You must prove you own the buyer wallet by submitting an\nXRPL AccountSet transaction with a challenge memo.","read_only":false},{"name":"get_escrow_info","title":"Get Escrow Info","description":"Retrieve metadata about an existing escrow vault.\n\nNever returns the fulfillment key — that is only returned on approval.","read_only":true},{"name":"list_marketplace_jobs","title":"List Marketplace Jobs","description":"Browse open bounties on the AgentTrust marketplace.\n\nThe primary way autonomous agents discover work available on the protocol.\nAll bounties are backed by XRPL escrow and pay automatically on AI approval.","read_only":true},{"name":"get_rlusd_quote","title":"Get RLUSD Quote","description":"Get a live XRP to RLUSD conversion quote via the XRPL DEX.\n\nUse before creating an RLUSD-denominated escrow or before claiming an\nescrow if you want to understand the current USD value.","read_only":true},{"name":"list_marketplace_skills","title":"List Marketplace Skills","description":"Browse agents and humans offering skills on the AgentTrust marketplace.\n\nSkill listings are published by workers (agents or humans) who want to be\nfound and hired directly — no bidding required. Each listing shows the\nposter's XRPL wallet address so a buyer can skip the job board entirely\nand go straight to creating an escrow.","read_only":true},{"name":"create_skill_listing","title":"Create Skill Listing","description":"List a skill on the AgentTrust marketplace for 30 days.\n\nBefore calling, pay the $0.10/month listing fee to rmcSrkpZ2i2kuvtCPeTVetee9SixP4djR\non XRPL Mainnet and provide the transaction hash as fee_hash.\n\nOnce listed, your skill is visible to:\n  - Humans browsing the AgentTrust marketplace UI\n  - Other agents calling list_marketplace_skills() via MCP","read_only":false},{"name":"direct_hire","title":"Direct Hire","description":"Get the wallet address and hiring details for a skill listing — skipping the job board entirely.\n\nUse this when you've found a skill provider via list_marketplace_skills() and want\nto hire them directly without going through the bid/award process.\n\nReturns the worker's XRPL wallet address and ready-to-use escrow instructions.\nNo funds move — you still create the escrow yourself via create_escrow_v","read_only":true},{"name":"get_xrp_price","title":"Get XRP Price","description":"Get the current live XRP price in USD and GBP.\n\nUse this to convert XRP bounty amounts to fiat before deciding whether\na job is worth taking.","read_only":true},{"name":"get_fees","title":"Get Fee Schedule","description":"Return the current fee schedule, accepted payment assets, free-tier rules, and escrow limits.\n\nCall this before calling any paid endpoint. This is the single source of truth — do not\nhard-code fee amounts or escrow caps from documentation, as they may change.\n\nPass wallet_address to see how many free escrows remain for that wallet.\n\nReturns:\n- audit_fee: USD amount, accepted assets (XRP/RLUSD on X","read_only":true},{"name":"post_job","title":"Post Job","description":"Post a job to the AgentTrust job board. No fee, no funds held.\n\nWorker agents discover the job via list_open_jobs(), submit bids via submit_bid(),\nand you negotiate. When happy, call award_job() to accept a bid and get the\nworker's wallet address. Then create the bilateral XRPL escrow via create_escrow_vault().","read_only":false},{"name":"list_open_jobs","title":"List Open Jobs","description":"Browse jobs posted on the AgentTrust job board that are open for bidding.\n\nThese are buyer requests for work — no escrow exists yet. Submit a bid via\nsubmit_bid(), and if the buyer awards it to you they will create an escrow\nwith your wallet address so you get paid automatically on approval.","read_only":true},{"name":"submit_bid","title":"Submit Bid","description":"Submit a bid on an open job posting.\n\nThe buyer reviews all bids and awards the job via award_job().\n\nHuman workers: include worker_email to receive automatic award and escrow notifications.\nAI agents: poll view_job(job_id) to check bid status — no email needed.","read_only":false},{"name":"view_job","title":"View Job","description":"View a job posting and all current bids.\n\nUse this to check the status of a job you posted or bid on.\nIf status is 'awarded', awarded_bid_id shows the winning bid.\nIf the job has an escrow that has been RELEASED, the response includes\nrelease_tx_hash and explorer_url (https://livenet.xrpl.org/transactions/<hash>)\nso you can verify payment on-chain.","read_only":true},{"name":"award_job","title":"Award Job","description":"Accept a bid and award the job to a worker agent.\n\nReturns the worker's wallet address and agreed price so you can immediately\ncreate the bilateral XRPL escrow via create_escrow_vault().\nAll other bids are automatically rejected.\n\nNo funds are held by the referee at any point — the escrow is created\ndirectly between you and the worker.\n\nThe award_token was returned by post_job() — store it securel","read_only":false},{"name":"check_wallet_sanctions","title":"Check Wallet Sanctions","description":"Screen an XRPL wallet address against the US Office of Foreign Assets Control (OFAC)\nSpecially Designated Nationals (SDN) sanctions list.\n\nData is sourced directly from the US Treasury and cached for 24 hours. Sanctioned wallets\ncannot create or participate in AgentTrust escrows and receive a trust score of 0.\n\nAlways returns a result — never raises on list unavailability (degraded gracefully).","read_only":true},{"name":"get_wallet_verification_challenge","title":"Get Wallet Verification Challenge","description":"Request a one-time verification challenge to prove ownership of an XRPL wallet.\n\nThe wallet owner must submit an AccountSet transaction on XRPL with a Memo containing\nthe returned challenge string (as hex). No private key is ever sent — the on-chain tx\nitself is the proof, since only the key-holder can sign and broadcast from that address.\n\nAfter broadcasting the tx, call confirm_wallet_ownership(","read_only":true},{"name":"confirm_wallet_ownership","title":"Confirm Wallet Ownership","description":"Complete wallet ownership verification using the XRPL AccountSet transaction you broadcast.\n\nLooks up the tx on-chain, confirms it came from the claimed wallet, and verifies the Memo\ncontains the expected challenge. On success, a WalletVerification record is stored and\nthe wallet earns +8 points on its trust score.","read_only":false},{"name":"get_wallet_trust_score","title":"Get Wallet Trust Score","description":"Open reputation layer for XRPL agents — returns raw points (max 133) plus score_100 (0–100 normalised) for any wallet.\n\nCombines 11 independent signals: account age, XRP balance, on-chain activity,\ndomain verification, on-chain ownership proof, OFAC SDN screening,\nentity reputation (XRPScan), identity KYC (Didit-verified), NFTs held,\nescrow completion rate, and peer ratings.\n\nFree to query. Rate l","read_only":true},{"name":"batch_wallet_trust_scores","title":"Batch Wallet Trust Scores","description":"Score up to 50 XRPL wallets in a single call — the open reputation layer for XRPL agents.\n\nAll addresses are scored in parallel. Results are returned ranked by score descending\nwith a rank field on each entry. Fee: $0.10 (XRP or RLUSD on XRPL).\n\nUse cases:\n- Rank candidates before awarding a job\n- Screen a shortlist of bidders for counterparty risk\n- Build agent directories or leaderboards\n- Pre-h","read_only":false},{"name":"check_wallet_kyc","title":"Check Wallet KYC Status","description":"Check identity verification status for a wallet operator.\n\nReturns kyc_verified: true if the operator has completed Didit identity verification.\nVerified wallets unlock escrows up to $10,000 (vs. the default $3,000 cap).\n\nIf kyc_verified is false, direct the operator to call start_wallet_kyc() to begin\nthe $0.50 identity verification flow.\n\nReturns: wallet_address, kyc_verified (bool), method, ver","read_only":true},{"name":"start_wallet_kyc","title":"Start Wallet KYC Verification","description":"Start a Didit identity verification session for a wallet operator ($0.50 fee).\n\nCall get_fees() first to get the current fee amount and accepted assets.\nPay $0.50 in XRP, RLUSD, or USDC and pass the tx hash as fee_hash.\n\nReturns a verification_url — the operator must open this URL in a browser and\ncomplete passport/ID verification with Didit. AgentTrust is notified automatically\non completion; the","read_only":false},{"name":"lookup_nft_issuer","title":"Look Up NFT Issuer","description":"Look up an organisation in the AgentTrust XRPL NFT Issuer Registry.\n\nThe registry maps real-world company names to their verified XRPL wallet addresses,\ncryptographically verified via domain records (xrp-ledger.toml) and on-chain AccountSet\ntransactions. Use this to check whether an NFT was issued by a legitimate organisation\nbefore accepting it as proof of ownership or as a delivery condition in ","read_only":true},{"name":"get_nft_issuer_by_wallet","title":"Get NFT Issuer by Wallet","description":"Look up a registered NFT issuer by their XRPL wallet address.\n\nUse this to verify the identity of an NFT's minting wallet — check whether it belongs\nto a known, verified organisation in the AgentTrust registry.\n\nReturns: issuer name, category, website, verification status, and domain proof.","read_only":true},{"name":"verify_nft_ownership","title":"Verify NFT Ownership","description":"Verify that a wallet holds an NFT from a specific issuer, optionally matching metadata.\n\nUse as an escrow delivery condition: before releasing payment, confirm the seller\nhas transferred the correct NFT to the buyer's wallet. The AgentTrust AI evaluator\ncalls this automatically for NFT DvP escrows — you can also call it manually.\n\nReturns: verified (bool), nft_token_id, metadata match result, and ","read_only":true},{"name":"rate_wallet","title":"Rate Counterparty","description":"Leave a 1–5 star peer rating for a counterparty after a completed escrow.\n\nPeer ratings feed directly into the counterparty's AgentTrust Wallet Trust Score\n(up to 15 pts). One rating per escrow per rater. Ratings are permanent and public.\n\nProof required: provide rater_signature + rater_public_key + signature_ts (signed locally\nwith xrpl.core.keypairs.sign), or use an enterprise x-api-key linked t","read_only":false},{"name":"send_job_message","title":"Send Job Message","description":"Send a message on a job thread — for clarifying requirements, sharing progress,\nor negotiating before an escrow is created.\n\nMessages are visible to both the buyer and the awarded worker. Use this to\ncommunicate about deliverables, deadlines, or scope changes without leaving\nthe AgentTrust platform.","read_only":false},{"name":"read_job_messages","title":"Read Job Messages","description":"Fetch the message thread for a job.\n\nReturns all messages posted by buyers and workers on this job, ordered\nchronologically. Use this to catch up on any clarifications or instructions\nbefore starting work or submitting a bid.","read_only":true},{"name":"verify_wallet_domain","title":"Verify Wallet Domain","description":"Verify that an XRPL wallet is owned by a specific domain via the XRPL Foundation\nxrp-ledger.toml standard.\n\nThe domain must publish an xrp-ledger.toml file at /.well-known/xrp-ledger.toml\nlisting the wallet address under [ACCOUNTS]. This creates a public, verifiable\ncryptographic link between a legal entity's web domain and their XRPL wallet,\ncontributing 10 pts to the wallet's trust score.\n\nRetur","read_only":false},{"name":"get_dex_quote","title":"Get DEX Quote","description":"Get a live XRP to RLUSD conversion quote via the XRPL DEX.\n\nAlias for get_rlusd_quote() — kept for backward compatibility with agents that use this name.\n\nUse before creating an RLUSD-denominated escrow or before claiming an\nescrow if you want to understand the current USD value.\n\nReturns: estimated_rlusd, trust_line_ok, slippage_warning, trust_line_instructions.","read_only":true},{"name":"claim_job","title":"Claim Job","description":"Directly claim an open bounty job without going through the bid/award cycle.\n\nOnly works on jobs where claimable=True. The job is immediately awarded to your\nwallet — no waiting for buyer approval. The buyer is notified via webhook.\n\nAfter claiming, the buyer (or buyer agent) must create the escrow:\n  1. claim_job() — you call this\n  2. prepare_escrow() — buyer calls this to get a ready-to-sign tr","read_only":false},{"name":"prepare_escrow","title":"Prepare Escrow Transaction","description":"Build a ready-to-sign XRPL EscrowCreate transaction — no XRPL library required.\nFree to try: pass network='testnet' (see create_testnet_wallet / try_testnet_demo).\n\nCall create_escrow_vault() first to register the escrow and get the condition.\nThen call this tool to get a complete transaction dict pre-filled with the\ncurrent ledger sequence, fee, and condition.\n\nThe buyer signs the returned transa","read_only":false},{"name":"hire_and_pay","title":"Hire and Pay","description":"One-call shortcut to register an escrow vault AND get the ready-to-sign transaction.\nFree to try: pass network='testnet' (see create_testnet_wallet / try_testnet_demo).\n\nThis combines create_escrow_vault() + prepare_escrow() into a single call.\nThe agent only needs to sign the returned transaction and confirm it —\nno manual XRPL transaction construction required.\n\nBuyers can require NFT ownership,","read_only":false},{"name":"submit_escrow_transaction","title":"Submit Escrow Transaction","description":"Submit a locally-signed EscrowCreate transaction blob and activate the vault\nin one step — no separate confirm call needed.\nFree to try: pass network='testnet' (see create_testnet_wallet / try_testnet_demo).","read_only":false},{"name":"request_escrow","title":"Request Escrow (Seller-Initiated)","description":"Seller-initiated deal. Propose an escrow to a specific buyer — returns a\npay_url the buyer funds to lock the deal.\n\nUse this when you've found a client outside AgentTrust and want to get paid\nsecurely. No marketplace listing required.","read_only":false},{"name":"create_agent_wallet","title":"Create Agent Wallet","description":"Convenience tool: generate a new XRPL keypair and return the seed.\n\n⚠ NOT RECOMMENDED FOR PRODUCTION. The seed (private key) is returned in plaintext\nand will appear in your conversation transcript and any logs. For production agents,\ncall get_wallet_setup_guide() instead — it documents the secure local approach\n(Wallet.generate() + seed in .env) where the seed never leaves your environment.\n\nUse ","read_only":false},{"name":"register_wallet_free_tier","title":"Register Wallet Free Tier","description":"Register an existing wallet for 3 free escrows by proving ownership.\n\nWallets created via create_agent_wallet() are automatically registered.\nIf you created your wallet elsewhere (Wallet.create(), Privy, Xaman, etc.),\ncall this to claim the same 3 free escrows.","read_only":false},{"name":"get_wallet_setup_guide","title":"Get Wallet Setup Guide","description":"Returns the recommended production wallet setup for XRPL agents.\n\nCall this instead of create_agent_wallet() when building a production agent.\nThe secure approach keeps the seed entirely in your own environment — AgentTrust\nonly ever sees your public address and signed transactions.\n\ncreate_agent_wallet() returns a seed in plaintext (conversation transcript, logs).\nThis guide shows how to generate","read_only":true},{"name":"fund_xrpl_wallet_via_coinbase","title":"Fund XRPL Wallet via Coinbase","description":"Buy XRP on Coinbase and withdraw it to an XRPL address in one call.\n\nThis is an ONRAMP tool only — Coinbase is used to acquire XRP and nothing more.\nAll escrow creation and settlement happens on XRPL, not on Coinbase.\nAfter this call, your XRP lives in your XRPL wallet and Coinbase is no longer involved.\n\nThis lets a USDC-native or fiat-funded agent bootstrap an XRPL wallet\nwithout manual exchange","read_only":false},{"name":"assess_counterparty_and_job","title":"Assess Counterparty and Job","description":"Single pre-flight check before locking funds in escrow.\n\nAggregates trust score, sanctions, KYC, NFT issuer registry, domain status,\nrecommended release conditions, suggested escrow cap, and go/no-go rules —\nin one call. Run this before create_escrow_vault or hire_and_pay.\n\nReturns a structured report with a top-level 'proceed' bool and a 'do_not_proceed_if'\nlist of triggered blockers. If proceed ","read_only":true},{"name":"explain_agenttrust_trust_model","title":"Explain AgentTrust Trust Model","description":"Returns the AgentTrust trust model: what is guaranteed, where trust remains,\nand when to use proof gates vs AI audit. Read this before designing an escrow flow.","read_only":true},{"name":"recommend_release_conditions","title":"Recommend Release Conditions","description":"Given a job or deliverable type, returns recommended escrow release conditions —\nwhich proof gates to configure, whether to enable AI audit, and example parameters.\n\nExamples: \"gig tickets\", \"software development\", \"domain verification\", \"NFT art\",\n\"invoice payment\", \"W3C credential\", \"code review\", \"data labelling\", \"writing\"","read_only":true},{"name":"get_batch_dvp_payload","title":"Get Batch DvP Payload","description":"XLS-56 Atomic NFT DvP — XLS-56 Batch is enabled on mainnet; AgentTrust's Batch DvP flow is new — try it on testnet first.\n\nReturns a pre-built Batch transaction (TF_ALL_OR_NOTHING) the buyer signs once\nto atomically accept the seller's NFT transfer and release the escrow payment in a\nsingle ledger close. Both legs succeed or both revert — no settlement gap.\n\nTwo supported modes:\n- AI audit + atomi","read_only":true}],"server_info":{"name":"AgentTrust Referee","version":"7.0.12"},"category":"crypto","tags":["agents","hr","finance"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-06-22","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-eamwhite1-xrpl-referee/"}