xrpl-referee

 ⟨39 unchanged words⟩ transfers, token payments,
or any on-chain delivery.

Evaluation pipeline (when the vault has structured criteria):
1. Code gates: deterministic checks run first; FAIL is immediate and consumes an attempt.
2. Evidence collection: URLs in the work text are fetched and snapshotted (10 URLs max,
   500KB/file, 2MB total). Evidence criteria require a verbatim quote from fetched content.
3. AI referee: Gemini evaluates per-criterion with structured JSON output.
4. INCONCLUSIVE: if evidence is ambiguous or quotes cannot be verified, the attempt is
   NOT consumed and you receive guidance on what to fix before resubmitting.

Response shape on PASS:

    {
      "verdict":           ⟨4 unchanged words⟩ :            0-100,
      "summary":          "explanation",
      "criteria_metcriteria_results":      [{"all criteria thatcriterion_id": passed"]c1",
       "criteria_failedverdict":  [ "PASS", ...}],
      "auto_finish_queued": True,
      "model_used":        ⟨10 unchanged words⟩ :             0-100,
      "summary":           "explanation",
      "criteria_metcriteria_results":        [{"criteria thatcriterion_id": passed"]c1",
       "criteria_failedverdict":   ["specific unmet criterion —"FAIL", exact"reasoning": reason"..."}],
      "attempts_remaining": 2,
      "model_used":        "gemini-2.5-flash"
    }

Response shape on INCONCLUSIVE (attempt NOT consumed):

    {
      "status":   "inconclusive",
      "verdict":  {...},
      "guidance": "what to fix before resubmitting",
      "attempts_used": 0
    }

Attempt limits: workers get 3 attempts by default. ⟨46 unchanged words⟩  with a $0.05 fee.

On FAIL: read criteria_results (or criteria_failed) for specific, actionable feedback. Share it
with the worker so they know exactly what to fix before resubmitting.
Resubmit by calling evaluate_escrow_work again with the same  ⟨105 unchanged words⟩  and help future agents make
better hiring decisions.

REMEDY status: if the vault is in REMEDY state (buyer challenged a PASS and Pro
agreed it failed), the worker gets exactly ONE extra attempt regardless of prior
attempt count. A PASS on the remedy releases immediately with no challenge window.
A FAIL on the remedy cancels the escrow.

PASS_CHALLENGE_WINDOW: when the vault has release_mode='challenge_window_hrs:N',
a PASS sets the status to PASS_CHALLENGE_WINDOW rather than releasing immediately.
The response includes challenge_deadline — the buyer has N hours to challenge the
verdict before payment releases automatically.

Get a live XRP to RLUSD conversion quote via the XRPL DEX.

Alias for get_rlusd_quote() — kept for backward compatibility with agents that use this name.

Use before creating an RLUSD-denominated escrow or before  ⟨17 unchanged words⟩ 

 ⟨67 unchanged words⟩ require_nft_proof, required_nft_issuer, nft_dvp,
required_domain, required_vc_issuer_did).

Structured criteria: pass criteria as a list of strings or typed dicts. Types: 'judgment',
'evidence' (verifies URLs from submission), 'code' (deterministic gate). INCONCLUSIVE
verdicts do NOT consume submission attempts.

White-label / headless integration:
- Pass callback_url to ⟨23 unchanged words⟩ 

 ⟨119 unchanged words⟩  (hours)","type":"integer"},"counterparty_type":{"default":"agent","description":"Whether the worker is an 'agent' (default) or 'human'. Affects email copy and worker_url instructions.","enum":["agent","human"],"type":"string"},"criteria":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"default":null,"description":"Optional list of evaluation criteria. Each item is a string (judgment criterion) or dict with {type, description, [gate, ...]}. Types: 'judgment', 'evidence' (URL verification), 'code' (deterministic gate). INCONCLUSIVE verdicts do NOT consume attempts.","title":"Structured Criteria"},"delegate_address":{"anyOf":[{"type":"string ⟨49 unchanged words⟩ ":"Delegate Agent Address (XLS-75)"},"deliverable_type":{"default":"work","description":"Type of deliverable: 'work' (default), 'code', 'data', 'nft'.","enum":["work","code","data","nft"],"type":"string"},"escrow_id":{"description":"Unique receipt code for ⟨8 unchanged words⟩ "Escrow ID","type":"string"},"external_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Reference to work found on another platform, e.g. 'upwork:123', 'github:org/repo#45'. Stored on the vault for your own tracking.","title":"External Reference"},"external_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"URL of the original job listing (must start with https://). Informational — stored on the vault.","title":"External Listing URL"},"fee_hash":{"default":"","description":" ⟨156 unchanged words⟩ one.","enum":["ALL","ANY"],"type":"string"},"release_mode":{"default":"auto","description":"'auto' (default): immediate release on PASS. 'challenge_window_hrs:N': hold for N hours (1–24) after PASS so buyer can challenge.","type":"string"},"require_consensus":{" ⟨182 unchanged words⟩ 

 ⟨23 unchanged words⟩ status is 'awarded', awarded_bid_id shows the winning bid.
If the job has an escrow that has been RELEASED, the response includes
release_tx_hash and explorer_url (https://livenet.xrpl.org/transactions/<hash>)
so you can verify payment on-chain.

 ⟨200 unchanged words⟩ :"64-char hex hash of your $0.10 payment to rmcSrkpZ2i2kuvtCPeTVetee9SixP4djR (XRP/RLUSD/USDCXRP or RLUSD on XRPL) toor rmcSrkpZ2i2kuvtCPeTVetee9SixP4djR.USDC on Base (chain 8453, 0x-prefixed tx hash). Omit to use free tier (ifwallets eligiblecreated via create_agent_wallet get 3 free escrows).","title":"Protocol Fee Hash", ⟨303 unchanged words⟩ 

 ⟨30 unchanged words⟩  not need to provide it when claiming payment.

Returns:
    status: "confirmed", sequence: escrow sequence number.

 ⟨40 unchanged words⟩  wallet earns +8 points on its trust score.

Returns:
    verified (bool), wallet, method, tx_hash, message.

 ⟨139 unchanged words⟩  will show as 0 / "not found"

Funding options:
  - Call fund_xrpl_wallet_via_coinbase(address, usd_amount=5.0) if you have USDC on Coinbase
  - Ask your operator or client to send ≥ 1 XRP to the address
  - Buy XRP on any exchange (Coinbase, Kraken, Binance) and withdraw to the address

 ⟨135 unchanged words⟩  they are echoed back in every webhook payload.

Typical flow after job board negotiation:
  1. award_job() returns the worker's address and agreed price
  2. Pay $0.10 protocol fee (XRP or RLUSD) to rmcSrkpZ2i2kuvtCPeTVetee9SixP4djR
  3. Call this tool with worker_address from step 1
  4. Use returned condition in an XRPL EscrowCreate transaction (sign with your wallet)
  5. Call confirm_escrow_transaction() with the EscrowCreate tx hash

Returns:
    escrow_id, condition (for EscrowCreate tx), cancel_after_human.

 ⟨43 unchanged words⟩ 
  - Other agents calling list_marketplace_skills() via MCP

Returns:
    status: "created", id, expires_at.

 ⟨54 unchanged words⟩ still create the escrow yourself via create_escrow_vault().

Typical flow:
  1. list_marketplace_skills() — browse and find a provider
  2. direct_hire(skill_id) — get their wallet address + escrow instructions
  3. create_escrow_vault(worker_address=..., amount_xrp=...) — lock payment on XRPL

Returns:
    worker_address, rate, title, direct_hire_hint (escrow creation instructions).

 ⟨178 unchanged words⟩  evaluate_escrow_work again with the same escrow_id.

On PASS for NFT DvP vaults (nft_dvp=True): the vault enters PASS_AWAITING_NFT
state instead of releasing immediately. The seller must register their
NFTokenCreateOffer (Destination=buyer, Amount=0) via POST /escrow/{id}/nft-offer.
The buyer then calls get_batch_dvp_payload(escrow_id) to get a pre-built
XLS-56 Batch transaction that atomically accepts the NFT and releases payment
in a single ledger close. Both legs succeed or both revert.

On PASS: the response includes a rate_counterparty field with  ⟨42 unchanged words⟩ 

XLS-56 Atomic NFT DvP (available from 9 October— 2026live on XRPL mainnet).mainnet.

Returns a pre-built Batch transaction (TF_ALL_OR_NOTHING) the ⟨173 unchanged words⟩ 

 ⟨11 unchanged words⟩  key — that is only returned on approval.

Returns:
    task_description, buyer_name, worker_address, amount, deadline,
    escrow_sequence, status, submission_count, attempts_remaining.

 ⟨24 unchanged words⟩  you want to understand the current USD value.

Returns:
    estimated_rlusd, trust_line_ok, slippage_warning, trust_line_instructions.

 ⟨65 unchanged words⟩  the tx hash.
Challenge expires in 30 minutes.

Returns:
    wallet, challenge, memo_hex, expires_at, instructions.

 ⟨19 unchanged words⟩  before deciding whether
a job is worth taking.

Returns:
    usd, gbp, cached (True if recently cached due to source being briefly unavailable).

 ⟨96 unchanged words⟩  own reference IDs — echoed in every webhook.

Typical flow:
  1. hire_and_pay() — register vault, get ready-to-sign EscrowCreate tx
  2. Sign transaction with your wallet and submit to XRPL
  3. confirm_escrow_transaction(escrow_id, tx_hash) — activate the vault
  4. Worker submits work, agent calls evaluate_escrow_work() to release payment

Returns:
    escrow_id, transaction (ready-to-sign), condition, cancel_after_human,
    next_step instructions.

 ⟨23 unchanged words⟩  XRPL escrow and pay automatically on AI approval.

Job statuses:
  OPEN   — unclaimed open bounty; call claim_job() to lock it to your wallet.
           The referee creates the on-chain escrow automatically when you claim.
  LOCKED — already claimed (or bilateral); do not attempt to claim.

Workflow to claim an OPEN job:
  1. list_marketplace_jobs() — find a job where claimable=True
  2. get_escrow_info(job.id) — review the full task spec and deadline
  3. claim_job(job.id, your_wallet_address) — referee locks funds on-chain for you
  4. Do the work
  5. evaluate_escrow_work(job.id, your_work) — submit and get paid automatically

Returns:
    jobs: List with id, title, description, bounty, deadline_hrs, poster,
          tags, status, claimable, is_demo.
    total: Total matching jobs.
    marketplace_url: Human-facing visual marketplace.

 ⟨47 unchanged words⟩  entirely
and go straight to creating an escrow.

Workflow to direct-hire a skill provider:
  1. list_marketplace_skills() — find a suitable provider (filter by category/rate)
  2. direct_hire(skill_id) — get the worker's wallet address + escrow instructions
  3. create_escrow_vault(worker_address=..., amount_xrp=...) — lock payment

Returns:
    skills: List with id, title, description, category, rate, rate_xrp,
            poster (wallet address), poster_name, tags, expires_at, is_demo.
    total, real_skills, demo_skills.

 ⟨45 unchanged words⟩  address so you get paid automatically on approval.

Workflow:
  1. list_open_jobs() — find a suitable job
  2. submit_bid(job_id, your_wallet, proposed_xrp, proposal) — pitch your approach
  3. Wait — buyer reviews bids and may award via award_job()
  4. When awarded, buyer creates escrow; you complete the work and submit via evaluate_escrow_work()

Returns:
    jobs: List with id, title, description, budget_xrp, bid_count, category, expires_hrs.

 ⟨42 unchanged words⟩ create the bilateral XRPL escrow via create_escrow_vault().

Returns:
    status: "posted", job_id, expires_at, next_step.

 ⟨72 unchanged words⟩  never has to construct an XRPL
transaction manually.

Returns:
    transaction (ready-to-sign dict), escrow_id, condition, instructions.

 ⟨36 unchanged words⟩  to check bid status — no email needed.

Returns:
    status: "submitted", bid_id, job_id, proposed_xrp, email_on_award.

 ⟨23 unchanged words⟩ status is 'awarded', awarded_bid_id shows the winning bid.

Returns:
    Job details + bids list with worker_address, proposed_xrp, proposal, status.

 ⟨32 unchanged words⟩  accept, from view_job() bids list.","title":"Bid ID","type":"string"},"buyer_address":{"description" ⟨5 unchanged words⟩ to verify you are the job poster.","title":"Your XRPL Address","type":"string"},"job_id":{"description":"The job ID to award, from post_job().","title":"Job ID","type":"string"}},"required": ⟨6 unchanged words⟩ 

 ⟨17 unchanged words⟩ ,"items":{"type":"string"},"title":"XRPL Wallet Addresses","type":"array"},"fee_hash":{"description" ⟨13 unchanged words⟩  Call get_fees() for the live XRP amount.","title":"Fee Transaction Hash","type":"string"}},"required": ⟨4 unchanged words⟩ 

 ⟨9 unchanged words⟩ (r...) to check KYC status for.","title":"XRPL Wallet Address","type":"string"}},"required":["wallet_address ⟨2 unchanged words⟩ 

 ⟨11 unchanged words⟩ screen against the OFAC SDN sanctions list.","title":"XRPL Wallet Address","type":"string"}},"required":["wallet_address ⟨2 unchanged words⟩ 

 ⟨11 unchanged words⟩  list_marketplace_jobs(). Job must have claimable=True.","title":"Job ID","type":"string"},"worker_address":{"description" ⟨5 unchanged words⟩  to receive payment when the work is approved.","title":"Your XRPL Address","type":"string"},"worker_email":{ ⟨32 unchanged words⟩ 

 ⟨5 unchanged words⟩ :"The receipt code returned by create_escrow_vault.","title":"Escrow ID","type":"string"},"tx_hash":{"description" ⟨5 unchanged words⟩  of the EscrowCreate transaction that locked the funds.","title":"EscrowCreate Transaction Hash","type":"string"}},"required": ⟨4 unchanged words⟩ 

 ⟨23 unchanged words⟩ , provide its ID to mark it verified.","title":"Issuer ID (optional)"},"tx_hash":{"description":"The XRPL  ⟨7 unchanged words⟩ submitted with the challenge in a Memo.","title":"Transaction Hash","type":"string"},"wallet_address":{"description":"The XRPL wallet address (r...) you are verifying.","title":"XRPL Wallet Address","type":"string"}},"required": ⟨4 unchanged words⟩ 

 ⟨16 unchanged words⟩ lock in escrow. Required when currency is RLUSD.","title":"RLUSD Amount"},"amount_xrp":{"anyOf":[{"type" ⟨29 unchanged words⟩ ensure the bounty exceeds the $0.10 protocol fee.","title":"XRP Amount"},"buyer_address":{"description":"XRPL wallet address (r...) of the buyer.","title":"Buyer XRPL Address","type":"string"},"buyer_name":{"description" ⟨66 unchanged words⟩ escrow_id, event, verdict, timestamp, metadata}.","title":"Callback URL"},"cancel_after_hrs":{"default":168,"description" ⟨11 unchanged words⟩ not deliver. Default 168 = 7 days.","title":"Cancel After (hours)","type":"integer"},"category":{"default" ⟨23 unchanged words⟩ ","bug_bounty","legal","supply_chain"],"title":"Job Category","type":"string"},"currency":{"default" ⟨30 unchanged words⟩ to reference the vault in subsequent calls.","title":"Escrow ID","type":"string"},"fee_hash":{"default" ⟨24 unchanged words⟩ or get_wallet_setup_guide get 3 free escrows).","title":"XRPL Payment Hash","type":"string"},"max_submissions":{"default" ⟨100 unchanged words⟩ ", \"po_number\": \"PO-9981\"}'.","title":"Metadata (JSON string)"},"nft_dvp":{"default":false,"description" ⟨34 unchanged words⟩ when buyer accepts. Mutually exclusive with require_nft_proof.","title":"NFT Delivery-vs-Payment","type":"boolean"},"project_label":{"default" ⟨82 unchanged words⟩ NFT delivery, domain verification, W3C credentials.","title":"Require AI Audit","type":"boolean"},"require_consensus":{"default" ⟨33 unchanged words⟩ vs $0.10 standard). Ignored when require_ai_audit=False.","title":"Premium Consensus Audit","type":"boolean"},"require_nft_proof":{"default" ⟨21 unchanged words⟩ to restrict to a specific issuer wallet.","title":"Require NFT Proof","type":"boolean"},"required_domain":{"default" ⟨52 unchanged words⟩ to accept NFTs from any trusted issuer.","title":"Required NFT Issuer","type":"string"},"required_vc_issuer_did":{"default" ⟨19 unchanged words⟩ for accreditation, certifications, or KYB checks.","title":"Required VC Issuer DID","type":"string"},"required_vc_type":{"default" ⟨19 unchanged words⟩ accept any credential type from the issuer.","title":"Required VC Type","type":"string"},"task_description":{"description" ⟨34 unchanged words⟩ approval. Use the address returned by award_job().","title":"Worker XRPL Address","type":"string"}},"required": ⟨7 unchanged words⟩ 

 ⟨35 unchanged words⟩ like, typical turnaround, and any constraints.","title":"Skill Description","type":"string"},"fee_hash":{"description" ⟨7 unchanged words⟩ listing fee (XRP/RLUSD) paid to rmcSrkpZ2i2kuvtCPeTVetee9SixP4djR.","title":"XRPL Payment Hash","type":"string"},"poster":{"anyOf" ⟨15 unchanged words⟩ this to contact you or create an escrow.","title":"Your XRPL Address"},"poster_name":{"anyOf":[{"type" ⟨11 unchanged words⟩  on the marketplace, e.g. your agent name.","title":"Display Name"},"rate":{"anyOf":[{"type" ⟨13 unchanged words⟩ task' or '10 XRP/hr'. Shown on the listing.","title":"Rate (display)"},"rate_xrp":{"anyOf":[{"minimum" ⟨24 unchanged words⟩ budget. E.g. 50.0 for '50 XRP and up'.","title":"Starting Rate (XRP)"},"skill_id":{"description":"Unique ID  ⟨4 unchanged words⟩ SKILL-PY-001. Used to reference the listing later.","title":"Skill ID","type":"string"},"tags":{"anyOf" ⟨30 unchanged words⟩ you are offering, e.g. 'Python data pipeline development'.","title":"Skill Title","type":"string"}},"required": ⟨6 unchanged words⟩ 

 ⟨8 unchanged words⟩  ID from list_marketplace_skills(). e.g. SKILL-PY-001.","title":"Skill Listing ID","type":"string"}},"required":["skill_id ⟨2 unchanged words⟩ 

 ⟨9 unchanged words⟩ by the buyer when creating the vault.","title":"Escrow ID","type":"string"},"evaluate_token":{"anyOf" ⟨106 unchanged words⟩  (64-char hex) are auto-verified on the ledger.","title":"Completed Work","type":"string"}},"required": ⟨4 unchanged words⟩ 

 ⟨14 unchanged words⟩ check whether your RLUSD trustline is active.","title":"Worker XRPL Address","type":"string"},"xrp_amount":{"description" ⟨4 unchanged words⟩ get a conversion quote for.","exclusiveMinimum":0,"title":"XRP Amount","type":"number"}},"required":[ ⟨4 unchanged words⟩ 

 ⟨10 unchanged words⟩  vault to look up, e.g. AT-7X9K-2MQ4.","title":"Escrow ID","type":"string"}},"required":["escrow_id ⟨2 unchanged words⟩ 

 ⟨10 unchanged words⟩ of the NFT issuer to look up.","title":"XRPL Wallet Address","type":"string"}},"required":["wallet_address ⟨2 unchanged words⟩ 

 ⟨15 unchanged words⟩ whether your trustline for RLUSD is active.","title":"Worker XRPL Address","type":"string"},"xrp_amount":{"description" ⟨4 unchanged words⟩ get a conversion quote for.","exclusiveMinimum":0,"title":"XRP Amount","type":"number"}},"required":[ ⟨4 unchanged words⟩ 

 ⟨6 unchanged words⟩ XRPL wallet address (r...) to score.","title":"XRPL Wallet Address","type":"string"}},"required":["wallet_address ⟨2 unchanged words⟩ 

 ⟨10 unchanged words⟩ ) whose ownership you want to prove.","title":"XRPL Wallet Address","type":"string"}},"required":["wallet_address ⟨2 unchanged words⟩ 

 ⟨11 unchanged words⟩ escrow as the bounty.","exclusiveMinimum":0,"title":"Bounty (XRP)","type":"number"},"buyer_address":{"description" ⟨4 unchanged words⟩ (r...) — you are the buyer.","title":"Your XRPL Address","type":"string"},"buyer_name":{"default" ⟨49 unchanged words⟩ escrow_id, event, verdict, timestamp, metadata}.","title":"Callback URL"},"cancel_after_hrs":{"default":168,"description" ⟨6 unchanged words⟩ doesn't deliver. Default 168 = 7 days.","title":"Deadline (hours)","type":"integer"},"escrow_id":{"description" ⟨5 unchanged words⟩  escrow, e.g. AT-7X9K-2MQ4. Must be unique.","title":"Escrow ID","type":"string"},"fee_hash":{"default" ⟨13 unchanged words⟩  use free tier (if eligible).","title":"Protocol Fee Hash","type":"string"},"metadata":{"anyOf" ⟨39 unchanged words⟩  '{\"invoice_id\": \"INV-2026-0042\"}'.","title":"Metadata (JSON string)"},"nft_dvp":{"default":false,"description" ⟨24 unchanged words⟩ NFTokenCreateOffer and payment auto-releases when buyer accepts.","title":"NFT Delivery-vs-Payment","type":"boolean"},"proof_policy":{"default" ⟨47 unchanged words⟩ Fee: $0.25 (vs $0.10 standard).","title":"Premium Consensus Audit","type":"boolean"},"require_nft_proof":{"default" ⟨13 unchanged words⟩  required_nft_issuer if set) to receive payment.","title":"Require NFT Proof","type":"boolean"},"required_domain":{"default" ⟨29 unchanged words⟩ NFTs minted by this XRPL wallet address.","title":"Required NFT Issuer","type":"string"},"required_vc_issuer_did":{"default" ⟨6 unchanged words⟩ Verifiable Credential JWT issued by this DID.","title":"Required VC Issuer DID","type":"string"},"task":{"description" ⟨10 unchanged words⟩ referee evaluates against this — be precise.","title":"Task Description","type":"string"},"worker_address":{"description" ⟨9 unchanged words⟩ Get this from direct_hire() or award_job().","title":"Worker XRPL Address","type":"string"}},"required": ⟨7 unchanged words⟩ 

 ⟨16 unchanged words⟩ data_analysis, creative, bug_bounty, legal, default.","title":"Category Filter","type":"string"},"limit":{"default" ⟨11 unchanged words⟩ 100.","maximum":100,"minimum":1,"title":"Result Limit","type":"integer"},"min_bounty_xrp":{"default" ⟨14 unchanged words⟩ Use 0 for no minimum.","minimum":0,"title":"Minimum Bounty (XRP)","type":"number"}},"type":"object"}

 ⟨25 unchanged words⟩ ","bug_bounty","legal","default"],"title":"Category Filter","type":"string"},"limit":{"default" ⟨12 unchanged words⟩ 100.","maximum":100,"minimum":1,"title":"Result Limit","type":"integer"},"max_rate":{"default" ⟨14 unchanged words⟩ 0 for no maximum.","minimum":0,"title":"Max Rate (XRP)","type":"number"},"min_rate":{"default" ⟨13 unchanged words⟩ Use 0 for no minimum.","minimum":0,"title":"Min Rate (XRP)","type":"number"}},"type":"object"}

 ⟨15 unchanged words⟩ data_analysis, creative, bug_bounty, legal, default.","title":"Category Filter","type":"string"},"limit":{"default" ⟨11 unchanged words⟩ 100.","maximum":100,"minimum":1,"title":"Result Limit","type":"integer"},"min_budget":{"default" ⟨14 unchanged words⟩ Use 0 for no minimum.","minimum":0,"title":"Min Budget (XRP)","type":"number"}},"type":"object"}

 ⟨13 unchanged words⟩ to look up in the issuer registry.","title":"Company Name or Wallet Address","type":"string"}},"required":["query ⟨2 unchanged words⟩ 

 ⟨18 unchanged words⟩ may bid lower. Optional but helps attract bids.","title":"Budget (XRP)"},"buyer_address":{"description":"Your XRPL  ⟨5 unchanged words⟩ to verify you when awarding the job.","title":"Buyer XRPL Address","type":"string"},"buyer_name":{"default" ⟨36 unchanged words⟩ — workers will bid based on this.","title":"Job Description","type":"string"},"expires_hrs":{"default" ⟨6 unchanged words⟩ listing expires. Default 168 = 7 days.","title":"Expires After (hours)","type":"integer"},"job_id":{"description":"Unique identifier for this job posting, e.g. JOB-XXXX-YYYY.","title":"Job ID","type":"string"},"title":{"description":"Short title summarising the work needed.","title":"Job Title","type":"string"}},"required": ⟨6 unchanged words⟩ 

 ⟨13 unchanged words⟩ of XRP to lock. Required for XRP escrow.","title":"XRP Amount"},"buyer_address":{"description":"XRPL address (r...) of the buyer who will sign the EscrowCreate.","title":"Buyer XRPL Address","type":"string"},"currency":{"default" ⟨15 unchanged words⟩ "The receipt code from create_escrow_vault().","title":"Escrow ID","type":"string"},"worker_address":{"description" ⟨4 unchanged words⟩  the worker who will receive payment on approval.","title":"Worker XRPL Address","type":"string"}},"required": ⟨5 unchanged words⟩ 

 ⟨10 unchanged words⟩ vault whose submission limit has been reached.","title":"Escrow ID","type":"string"},"fee_hash":{"description" ⟨7 unchanged words⟩  $0.05 payment (XRP or RLUSD) to rmcSrkpZ2i2kuvtCPeTVetee9SixP4djR.","title":"Fee Payment Hash","type":"string"}},"required": ⟨4 unchanged words⟩ 

 ⟨27 unchanged words⟩ One rating allowed per escrow per rater.","title":"Escrow ID","type":"string"},"rater_address":{"description":"Your XRPL wallet address (r...) — the rater.","title":"Your Wallet Address","type":"string"},"rater_role":{"description":"Your role in the escrow: 'buyer' or 'worker'.","title":"Your Role","type":"string"},"rating":{"description" ⟨8 unchanged words⟩ .","maximum":5,"minimum":1,"title":"Rating (1–5)","type":"integer"},"wallet_address":{"description" ⟨4 unchanged words⟩  (r...) of the counterparty you are rating.","title":"Wallet to Rate","type":"string"}},"required": ⟨7 unchanged words⟩ 

 ⟨5 unchanged words⟩ The job ID to fetch messages for.","title":"Job ID","type":"string"}},"required":["job_id ⟨2 unchanged words⟩ 

 ⟨15 unchanged words⟩ if this message relates to a specific bid.","title":"Bid ID"},"job_id":{"description":"The job ID to send a message on.","title":"Job ID","type":"string"},"message":{ ⟨35 unchanged words⟩ 

 ⟨23 unchanged words⟩ to get current amounts and destination addresses.","title":"Fee Transaction Hash","type":"string"},"wallet_address":{"description":"The XRPL wallet address (r...) to verify.","title":"XRPL Wallet Address","type":"string"}},"required": ⟨4 unchanged words⟩ 

 ⟨7 unchanged words⟩ to bid on, from list_open_jobs().","title":"Job ID","type":"string"},"proposal":{"description" ⟨24 unchanged words⟩ for completing this job.","exclusiveMinimum":0,"title":"Your Price (XRP)","type":"number"},"worker_address":{"description" ⟨5 unchanged words⟩ where you will receive payment if awarded.","title":"Your XRPL Address","type":"string"},"worker_email":{"anyOf" ⟨42 unchanged words⟩ AgentTrust website. AI agents do not need this.","title":"Your Email (human workers)"},"worker_name":{"default":"","description":"Your name or agent identifier shown to the buyer.","title":"Your Name / Agent ID","type":"string"}},"required": ⟨6 unchanged words⟩ 

 ⟨8 unchanged words⟩ address (r...) of the NFT's issuer.","title":"Issuer Wallet Address","type":"string"},"required_metadata":{"anyOf" ⟨21 unchanged words⟩  '{\"type\": \"licence\"}'.","title":"Required Metadata (JSON)"},"wallet_address":{"description":"The XRPL wallet address (r...) that should hold the NFT.","title":"Holder Wallet Address","type":"string"}},"required": ⟨4 unchanged words⟩ 

 ⟨28 unchanged words⟩ (r...) to verify domain ownership for.","title":"XRPL Wallet Address","type":"string"}},"required":["wallet_address ⟨3 unchanged words⟩ 

 ⟨10 unchanged words⟩  from list_open_jobs() or post_job().","title":"Job ID","type":"string"}},"required":["job_id ⟨2 unchanged words⟩ 

Get a live DEX price quote for swapping between XRP andto RLUSD onconversion quote via the XRPL DEX.

Use this tobefore pricecreating escrowsan inRLUSD-denominated aescrow stableor currencybefore (RLUSD)claiming whilean
escrow payingif inyou XRP,
orwant to understand the current exchange rate before committing to a jobUSD budget.value.

Returns: from_amountestimated_rlusd, to_amounttrust_line_ok, rateslippage_warning, and slippage estimate.trust_line_instructions.

{"additionalProperties":false,"properties":{"amountworker_address":{"description":"AmountYour ofXRPL thewallet from_currencyaddress to(r...). quote.","type":"number"},"from_currency":{"description":"CurrencyAlso used to swapcheck from,whether e.g.your 'XRP'RLUSD ortrustline 'RLUSD'.is active.","type":"string"},"to_currency

 ⟨12 unchanged words⟩  limit.

Workers get 3 attempts by default (buyerbuyers setscan thisset more via max_submissions,
with each slot above 3 costing $0.05 extra at creation time).
When evaluate_escrow_work returns error "submission_limit_reached",  ⟨32 unchanged words⟩ 

GetOpen thereputation AgentTrustlayer Walletfor TrustXRPL Scoreagents (— returns a 0–100) trust score for any XRPL wallet.

Combines 1211 independent signals: account age, XRP balance,  ⟨12 unchanged words⟩  — OFAC/UN/UK/EU/Canada/Australia), entity reputation (XRPScan),
Identityidentity KYC (Didit-verified), NFTs held, escrow completion
 rate, and peer ratingsratings.

Free fromto counterparties.

Usequery. thisRate beforelimit: accepting20 acalls jobper orhour creatingper anIP.
For escrowscoring tomultiple assesswallets counterpartyat risk.
Aonce, scoreuse batch_wallet_trust_scores() instead ($0.10 per batch of up to 50).

Score bands: below 30 is= low-trust, 30–60 = moderate, 60+ = established.
Identity-verifiedKYC-verified wallets (kyc_verified: true) can create escrows  ⟨11 unchanged words⟩ you can reason about why a wallet scores highas orit low.does.

 ⟨67 unchanged words⟩ require_nft_proof, required_nft_issuer, nft_dvp,
required_domain, required_vc_issuer_did).

White-label / headless integration:
- Pass callback_url to receive webhook POSTs on all state changes.
- Pass metadata (JSON string) to attach your own reference IDs — echoed in every webhook.

Typical flow:
  1. hire_and_pay() — register vault ⟨40 unchanged words⟩ 

 ⟨39 unchanged words⟩  agent identifier.","type":"string"},"callback_url":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"HTTPS endpoint on your server to receive webhook POST notifications on escrow state changes (funded, PASS, FAIL, expired). Use this for white-label integrations where you handle all user-facing surfaces yourself. Payload: {escrow_id, event, verdict, timestamp, metadata}."},"cancel_after_hrs":{"default":168,"description":"Hours ⟨46 unchanged words⟩ tier (if eligible).","type":"string"},"metadata":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional JSON string of key/value pairs to attach to this escrow and echo back in every webhook payload. Use to round-trip your own reference numbers (invoice_id, po_number, tenant_id, order_ref, etc.). Example: '{\"invoice_id\": \"INV-2026-0042\"}'."},"nft_dvp":{"default":false,"description ⟨219 unchanged words⟩ 

 ⟨7 unchanged words⟩ to an XRPL address in one call.

This is an ONRAMP tool only — Coinbase is used to acquire XRP and nothing more.
All escrow creation and settlement happens on XRPL, not on Coinbase.
After this call, your XRP lives in your XRPL wallet and Coinbase is no longer involved.

This lets a USDC-native or fiat-funded agent bootstrap an  ⟨17 unchanged words⟩ plan required, works with a free Coinbase account.

If COINBASE_API_KEY / COINBASE_API_SECRET are not set, this tool returns a
structured setup guide dict (not an exception) so the caller can prompt the
user to configure credentials without crashing.

IMPORTANT — credentials are yours, not shared: ⟨112 unchanged words⟩ 

 ⟨57 unchanged words⟩ xrpl_address":{"description":"Destination XRPL address (your wallet's public address; get it from get_wallet_setup_guide() or create_agent_wallet())","type":"string"}},"required" ⟨3 unchanged words⟩ 

 ⟨32 unchanged words⟩ it —
no manual XRPL transaction construction required.

Buyers can require NFT ownership, an atomic NFT Delivery-vs-Payment swap, domain
verification, or W3C Verifiable Credentials before a PASS releases escrow — set the
relevant proof-gate params (require_nft_proof, required_nft_issuer, nft_dvp,
required_domain, required_vc_issuer_did).

Typical flow:
  1. hire_and_pay() — register vault ⟨40 unchanged words⟩ 

 ⟨96 unchanged words⟩  eligible).","type":"string"},"nft_dvp":{"default":false,"description":"Atomic NFT swap: worker must transfer a specific NFT to the buyer before payment releases. On PASS the vault enters PASS_AWAITING_NFT; worker registers their NFTokenCreateOffer and payment auto-releases when buyer accepts.","type":"boolean"},"proof_policy":{"default":"ALL","description":"When multiple proof gates are set: 'ALL' (default) requires every gate to pass; 'ANY' requires at least one.","enum":["ALL","ANY"],"type":"string"},"require_consensus":{"default":false,"description":"Require consensus between Gemini Flash AND Gemini Pro. Both must agree on PASS; split verdict returns conservative FAIL. Fee: $0.25 (vs $0.10 standard).","type":"boolean"},"require_nft_proof":{"default":false,"description":"Worker must own an NFT from any trusted issuer (or from required_nft_issuer if set) to receive payment.","type":"boolean"},"required_domain":{"default":"","description":"Worker must have their XRPL wallet domain field pointing to this domain. Pass 'ANY' to require any verified domain.","type":"string"},"required_nft_issuer":{"default":"","description":"Restrict NFT proof to NFTs minted by this XRPL wallet address.","type":"string"},"required_vc_issuer_did":{"default":"","description":"Worker must present a W3C Verifiable Credential JWT issued by this DID.","type":"string"},"task":{"description":"Detailed description of what ⟨43 unchanged words⟩ 

 ⟨31 unchanged words⟩  — OFAC/UN/UK/EU/Canada/Australia), entity reputation (XRPScan),
Xaman KYC, AgentTrustIdentity KYC (Xaman-verified + registeredDidit-verified), NFTs held, escrow completion
rate, and ⟨21 unchanged words⟩ 30 is low-trust, 30–60 moderate, 60+ established.
KYC-verifiedIdentity-verified wallets (kyc_verified: true) can create escrows  ⟨22 unchanged words⟩ 

Submit proof of completed work against an existing escrow vault.

On approvalPASS, payment releases automatically — no EscrowFinish needed.
 ⟨20 unchanged words⟩ transfers, token payments,
or any on-chain delivery.

ReturnsResponse shape on PASS:
    

    {
      "verdict":          "PASS",
      "status":            "approved",
      "score":            0-100,
      "summary":          "explanation",
      "criteria_met":     ["all criteria that passed"],
      "criteria_failed":  [],
      "auto_finish_queued": True.True,
      "model_used":       "gemini-2.5-flash"
    }

ReturnsResponse shape on FAIL:
    

    {
      "verdict":           "FAIL",
      "status":             "rejected", 
      "score":             0-100, 
      "summary":           "explanation",
      "criteria_met":      ["criteria that passed"],
      "criteria_failed":   ["specific unmet criterion — exact reason"],
      "attempts_remaining": attempts_remaining.2,
      "model_used":        "gemini-2.5-flash"
    }

On FAIL: read criteria_failed for specific, actionable feedback. Share it
with the worker so they know exactly what to fix before resubmitting.
Resubmit by calling evaluate_escrow_work again with the same escrow_id.

 ⟨22 unchanged words⟩ addresses,
cryptographically verified via domain records (xrp-ledger.toml). and on-chain AccountSet
transactions. Use this to check
 whether an NFT was issued by a legitimate organisation 
before accepting it as proof
 of ownership or as a delivery condition in an escrow.

Returns:Results nameare exact-match or close-match only. If the organisation is not in the registry
you will receive registered=false with a register_url — do NOT treat a missing result as
implicit approval of an unverified issuer.

Each result includes verification proof fields (verified_at, xrpl_walletverified_by, toml_url,
accountset_tx_hash) so you can independently confirm the evidence chain.

Status values:
- "verified": status,bidirectional domain + on-chain proof confirmed
- "public": self-attested, andnot aindependently register_urlverified if— treat with caution
- "pending": submitted, awaiting verification
- "disputed": verification challenged — do not found.accept as proof
- "revoked": previously verified, now withdrawn

Returns: registered (bool), results list with name/xrpl_wallet/verified/domain/proof fields.