settlement.execute
Execute a DPX cross-border settlement. The Settlement Agent checks oracle conditions, reasons with Claude AI, and executes on-chain (or returns sandbox result if sandbox=true). Returns settlement ID, status (executed/held/sandbox/failed), tx hash, net amount, fees, oracle conditions, and AI reasoning. Default: sandbox=true — set sandbox=false only for live execution.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | Yes | Amount in source currency units | |
| purpose | No | Payment purpose: intercompany, vendor-payment, payroll, treasury | |
| quoteId | No | Pre-fetched quoteId from get_quote (optional — agent fetches live if omitted) | |
| sandbox | No | Sandbox mode — real calculations, no on-chain execution. Default: true. | |
| esgScore | No | ESG score override 0–100 (testing only) | |
| referenceId | No | External reference ID (invoice number, TMS ID, etc.) | |
| sourceCurrency | Yes | Source currency: USD, EUR, GBP, USDC, EURC | |
| recipientAddress | Yes | On-chain recipient wallet address (0x...) | |
| destinationCurrency | Yes | Destination currency: USD, EUR, GBP, USDC, EURC |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | No | ||
| summary | No | Human-readable settlement outcome summary | |
| httpStatus | No | HTTP status from Settlement Agent |