sap_create_escrow_v2

Parameters schema

{
  "type": "object",
  "properties": {
    "nonce": {
      "type": "string",
      "description": "Optional escrow nonce as a decimal string. Defaults to 0."
    },
    "arbiter": {
      "type": "string",
      "description": "Optional arbiter public key kept for IDL compatibility and dispute workflows."
    },
    "coSigner": {
      "type": "string",
      "description": "Required co-signer wallet public key when settlementSecurity=1 (CoSigned)."
    },
    "maxCalls": {
      "type": "string",
      "description": "Maximum number of calls covered by the escrow as a decimal string. Use 0 for unlimited when supported by policy."
    },
    "expiresAt": {
      "type": "string",
      "description": "Optional expiry timestamp in unix seconds as a decimal string. Defaults to 0 (no expiry)."
    },
    "tokenMint": {
      "type": "string",
      "description": "Optional SPL payment token mint. Omit/null for native SOL. Use EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v for mainnet USDC x402 escrows."
    },
    "agentWallet": {
      "type": "string",
      "description": "Agent owner wallet public key (base58). The V2 escrow PDA is derived from this wallet plus nonce."
    },
    "pricePerCall": {
      "type": "string",
      "description": "Price per served call as a decimal string. Amount in the escrow token smallest unit: lamports for SOL, micro-USDC for USDC, or base units for the configured SPL token."
    },
    "tokenDecimals": {
      "type": "number",
      "description": "Payment token decimals. Defaults to 6 when tokenMint is set, otherwise 9 for native SOL."
    },
    "initialDeposit": {
      "type": "string",
      "description": "Initial escrow deposit as a decimal string. Amount in the escrow token smallest unit: lamports for SOL, micro-USDC for USDC, or base units for the configured SPL token."
    },
    "disputeWindowSlots": {
      "type": "string",
      "description": "Required positive dispute window in slots for settlementSecurity=2. Defaults to 2160 (~15 minutes)."
    },
    "settlementSecurity": {
      "enum": [
        1,
        2
      ],
      "type": "number",
      "description": "V2 settlement security mode. 1=CoSigned (requires coSigner). 2=DisputeWindow (recommended default; requires disputeWindowSlots > 0). SelfReport/0 is deprecated and rejected on-chain."
    }
  }
}

No endpoints wrapped at confidence ≥ 0.50.

Parent server