Create Escrow Vault
create_escrow_vaultCreate an XRPL escrow vault. Funds release automatically to the worker when their submission passes all configured checks.
Instructions
Create an XRPL escrow vault. Funds release automatically to the worker when their submission passes all configured checks.
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 below.
Two release modes:
AI audit (default): worker submits text/files; AI referee scores against task_description.
Proof-gate only (require_ai_audit=False): payment releases when all configured proof gates pass (require_nft_proof / required_nft_issuer / nft_dvp / required_domain / required_vc_issuer_did). No AI call. Requires at least one proof gate.
White-label / headless integration:
Pass callback_url to receive webhook POSTs on all state changes. AgentTrust operates as a silent settlement rail; your platform handles all user-facing surfaces.
Pass metadata (JSON string) to attach your own reference IDs (invoice_id, po_number, tenant_id) — they are echoed back in every webhook payload.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nft_dvp | No | Atomic NFT swap: worker must transfer a specific NFT to the buyer before payment releases. On PASS the vault enters PASS_AWAITING_NFT; worker then registers their NFTokenCreateOffer via POST /escrow/{id}/nft-offer and payment auto-releases when buyer accepts. Mutually exclusive with require_nft_proof. | |
| category | No | Marketplace category for this job. One of: default, creative, code, data, data_analysis, bug_bounty, legal, supply_chain. | default |
| currency | No | Currency to lock. Use "XRP" (no trustline needed) or "RLUSD" (USD-pegged stablecoin). | XRP |
| fee_hash | No | 64-character hex transaction hash of the $0.10 payment (XRP/RLUSD) to rmcSrkpZ2i2kuvtCPeTVetee9SixP4djR. Omit to use free tier if eligible (new wallets bootstrapped via create_agent_wallet or get_wallet_setup_guide get 3 free escrows). | |
| metadata | No | 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.) without storing them on AgentTrust's side. Example: '{"invoice_id": "INV-2026-0042", "po_number": "PO-9981"}'. | |
| escrow_id | Yes | Unique receipt code for this vault, e.g. AT-7X9K-2MQ4. Used to reference the vault in subsequent calls. | |
| amount_xrp | No | Amount of XRP to lock in escrow. Required when currency is XRP. Minimum: 0.000001 XRP (1 drop — XRPL EscrowCreate minimum). Practically, ensure the bounty exceeds the $0.10 protocol fee. | |
| buyer_name | Yes | Name or identifier of the buyer posting the job. | |
| amount_rlusd | No | Amount of RLUSD to lock in escrow. Required when currency is RLUSD. | |
| callback_url | No | 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 — emails, status pages, UI — and AgentTrust operates invisibly as the settlement rail. Payload: {escrow_id, event, verdict, timestamp, metadata}. | |
| proof_policy | No | When multiple proof gates are set: 'ALL' (default) requires every gate to pass; 'ANY' requires at least one gate to pass. | ALL |
| buyer_address | Yes | XRPL wallet address (r...) of the buyer. | |
| project_label | No | Optional human-readable label for the job, shown in the marketplace. | |
| worker_address | Yes | XRPL wallet address (r...) of the worker who will receive payment on approval. Use the address returned by award_job(). | |
| max_submissions | No | Number of work submission attempts the worker is allowed before the vault is locked. Default 3 (included in the $0.10 creation fee). Each slot above 3 costs an extra $0.05 at creation time (e.g. max_submissions=5 → $0.10 + 2×$0.05 = $0.20). Range 1–10. | |
| required_domain | No | Worker must have their XRPL wallet domain field pointing to this domain (verified via xrp-ledger.toml). Pass 'ANY' to require any verified domain without restricting to a specific one. | |
| cancel_after_hrs | No | Hours until the buyer can reclaim funds if the worker does not deliver. Default 168 = 7 days. | |
| require_ai_audit | No | Default True. Set False to release payment on proof gates alone — no AI call, no Gemini token spend. Requires at least one proof gate (require_nft_proof, required_nft_issuer, required_domain, or required_vc_issuer_did). Use for machine-verifiable deliverables: NFT delivery, domain verification, W3C credentials. | |
| required_vc_type | No | If set alongside required_vc_issuer_did, the VC must also have this credential type (e.g. 'CertifiedDeveloper'). Leave blank to accept any credential type from the issuer. | |
| task_description | Yes | Detailed specification the worker must fulfil to be paid. Be precise — the AI referee evaluates against this. | |
| require_consensus | No | Require consensus between Gemini Flash AND Gemini Pro before a PASS is issued. Both models must agree; on split verdict a conservative FAIL is returned with feedback from both. Fee: $0.25 (vs $0.10 standard). Ignored when require_ai_audit=False. | |
| require_nft_proof | No | Worker must own an NFT from any verified issuer (or from required_nft_issuer if set) to receive payment. Set required_nft_issuer to restrict to a specific issuer wallet. | |
| required_nft_issuer | No | Restrict NFT proof to NFTs minted by this XRPL wallet address. Also implicitly sets require_nft_proof=True. Leave blank to accept NFTs from any trusted issuer. | |
| required_vc_issuer_did | No | Worker must present a W3C Verifiable Credential JWT issued by this DID (e.g. did:web:issuer.example.com). Used for accreditation, certifications, or KYB checks. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||