Get Batch Dvp Payload
get_batch_dvp_payloadXLS-56 Atomic NFT DvP — live on XRPL mainnet.
Instructions
XLS-56 Atomic NFT DvP — live on XRPL mainnet.
Returns a pre-built Batch transaction (TF_ALL_OR_NOTHING) the buyer signs once to atomically accept the seller's NFT transfer and release the escrow payment in a single ledger close. Both legs succeed or both revert — no settlement gap.
Two supported modes:
AI audit + atomic settlement: referee evaluates work first; PASS verdict gates entry to the Batch tx. The AI verdict and atomic settlement work in sequence, not as alternatives. Use when the deliverable needs independent verification.
Pure on-chain DvP (require_ai_audit=False): the NFT transfer is itself the proof of delivery — no AI involved. XLS-56 handles the entire settlement on-chain. Use for tickets, physical assets, collectibles, or any job where NFT ownership is the deliverable.
Prerequisites:
Vault must be in PASS_AWAITING_NFT state (AI PASSed, or ai_audit=False and proof gates satisfied)
Seller must have registered their NFTokenCreateOffer via POST /escrow/{id}/nft-offer
Buyer workflow:
Call this tool to get
batch_tx_jsonAutofill sequences/fees with your XRPL client
Sign the Batch tx with your buyer wallet
Submit to XRPL — NFT arrives and payment releases atomically
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| escrow_id | Yes | The escrow vault ID for an NFT DvP job in PASS_AWAITING_NFT state. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||