---
title: "Managed Base USDC escrow"
method: POST
path: "/api/agent-escrow-lite"
---

# Managed Base USDC escrow

`POST /api/agent-escrow-lite`

## Request

- Base URL: `https://weverlabs.com`
- URL: `https://weverlabs.com/api/agent-escrow-lite`
- Auth: none declared

Every call requires X-Wever-Wallet-Proof. API access fees are separate from escrow principal. Release uses immutable payer-signed terms and EIP-712 release approval. Expiry refunds target the original payer.

## Request body

- union
  - object
    - `mode` 'prepare_funding', required
    - `terms` object, required
      - `escrow_id` string, required
      - `payer_wallet` string, required
      - `payee_wallet` string, required
      - `custody_wallet` string, required
      - `chain_id` unknown, required
      - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
      - `amount_atomic` string, required
      - `expires_at` integer, required
      - `funding_nonce` string, required
      - `release_policy` union, required
        - object
          - `kind` 'payer_signed', required
        - object
          - `kind` 'mutual', required
        - object
          - `kind` 'delivery_attestation', required
          - `attestor_wallet` string, required
          - `delivery_sha256` string, required
        - object
          - `kind` 'payer_signed', required
        - object
          - `kind` 'mutual', required
        - object
          - `kind` 'delivery_attestation', required
          - `attestor_wallet` string, required
          - `delivery_sha256` string, required
        - object
          - `kind` 'payer_signed', required
          - `attestor_wallet` string, required
          - `delivery_sha256` string, required
        - object
          - `kind` 'mutual', required
          - `attestor_wallet` string, required
          - `delivery_sha256` string, required
        - object
          - `kind` 'delivery_attestation', required
          - `attestor_wallet` string, required
          - `delivery_sha256` string, required
    - `payer_terms_signature` string, required
    - `idempotency_key` string, required
    - `escrow_id` string
    - `funding_payment` object, nullable
      - `x402Version` unknown, required
      - `resource` object, required
        - `url` string, required
        - `description` string, required
        - `mimeType` 'application/json', required
      - `accepted` object, required
        - `scheme` 'exact', required
        - `network` 'eip155:8453', required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount` string, required
        - `payTo` string, required
        - `maxTimeoutSeconds` integer, required
        - `extra` object, required
          - `name` 'USD Coin', required
          - `version` '2', required
      - `payload` object, required
        - `signature` string, required
        - `authorization` object, required
          - `from` string, required
          - `to` string, required
          - `value` string, required
          - `validAfter` string, required
          - `validBefore` string, required
          - `nonce` string, required
    - `mandate` object
      - `context` object, required
        - `escrow_id` string, required
        - `payer_wallet` string, required
        - `payee_wallet` string, required
        - `custody_wallet` string, required
        - `chain_id` unknown, required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount_atomic` string, required
        - `expires_at` integer, required
        - `funding_nonce` string, required
        - `terms_sha256` string, required
        - `funding_transaction_hash` string, required
        - `release_nonce` string, required
      - `terms` object, required
        - `escrow_id` string, required
        - `payer_wallet` string, required
        - `payee_wallet` string, required
        - `custody_wallet` string, required
        - `chain_id` unknown, required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount_atomic` string, required
        - `expires_at` integer, required
        - `funding_nonce` string, required
        - `release_policy` union, required
          - object
            - `kind` 'payer_signed', required
          - object
            - `kind` 'mutual', required
          - object
            - `kind` 'delivery_attestation', required
            - `attestor_wallet` string, required
            - `delivery_sha256` string, required
      - `payer_terms_signature` string, required
      - `signatures` union, required
        - object
          - `payer_signature` string, required
        - object
          - `payer_signature` string, required
          - `payee_signature` string, required
        - object
          - `payee_signature` string, required
          - `attestor_signature` string, required
  - object
    - `mode` 'fund_escrow', required
    - `terms` object
      - `escrow_id` string, required
      - `payer_wallet` string, required
      - `payee_wallet` string, required
      - `custody_wallet` string, required
      - `chain_id` unknown, required
      - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
      - `amount_atomic` string, required
      - `expires_at` integer, required
      - `funding_nonce` string, required
      - `release_policy` union, required
        - object
          - `kind` 'payer_signed', required
        - object
          - `kind` 'mutual', required
        - object
          - `kind` 'delivery_attestation', required
          - `attestor_wallet` string, required
          - `delivery_sha256` string, required
    - `payer_terms_signature` string
    - `idempotency_key` string, required
    - `escrow_id` string, required
    - `funding_payment` object, required
      - `x402Version` unknown, required
      - `resource` object, required
        - `url` string, required
        - `description` string, required
        - `mimeType` 'application/json', required
      - `accepted` object, required
        - `scheme` 'exact', required
        - `network` 'eip155:8453', required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount` string, required
        - `payTo` string, required
        - `maxTimeoutSeconds` integer, required
        - `extra` object, required
          - `name` 'USD Coin', required
          - `version` '2', required
      - `payload` object, required
        - `signature` string, required
        - `authorization` object, required
          - `from` string, required
          - `to` string, required
          - `value` string, required
          - `validAfter` string, required
          - `validBefore` string, required
          - `nonce` string, required
    - `mandate` object
      - `context` object, required
        - `escrow_id` string, required
        - `payer_wallet` string, required
        - `payee_wallet` string, required
        - `custody_wallet` string, required
        - `chain_id` unknown, required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount_atomic` string, required
        - `expires_at` integer, required
        - `funding_nonce` string, required
        - `terms_sha256` string, required
        - `funding_transaction_hash` string, required
        - `release_nonce` string, required
      - `terms` object, required
        - `escrow_id` string, required
        - `payer_wallet` string, required
        - `payee_wallet` string, required
        - `custody_wallet` string, required
        - `chain_id` unknown, required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount_atomic` string, required
        - `expires_at` integer, required
        - `funding_nonce` string, required
        - `release_policy` union, required
          - object
            - `kind` 'payer_signed', required
          - object
            - `kind` 'mutual', required
          - object
            - `kind` 'delivery_attestation', required
            - `attestor_wallet` string, required
            - `delivery_sha256` string, required
      - `payer_terms_signature` string, required
      - `signatures` union, required
        - object
          - `payer_signature` string, required
        - object
          - `payer_signature` string, required
          - `payee_signature` string, required
        - object
          - `payee_signature` string, required
          - `attestor_signature` string, required
  - object
    - `mode` 'release_escrow', required
    - `terms` object
      - `escrow_id` string, required
      - `payer_wallet` string, required
      - `payee_wallet` string, required
      - `custody_wallet` string, required
      - `chain_id` unknown, required
      - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
      - `amount_atomic` string, required
      - `expires_at` integer, required
      - `funding_nonce` string, required
      - `release_policy` union, required
        - object
          - `kind` 'payer_signed', required
        - object
          - `kind` 'mutual', required
        - object
          - `kind` 'delivery_attestation', required
          - `attestor_wallet` string, required
          - `delivery_sha256` string, required
    - `payer_terms_signature` string
    - `idempotency_key` string, required
    - `escrow_id` string, required
    - `funding_payment` object, nullable
      - `x402Version` unknown, required
      - `resource` object, required
        - `url` string, required
        - `description` string, required
        - `mimeType` 'application/json', required
      - `accepted` object, required
        - `scheme` 'exact', required
        - `network` 'eip155:8453', required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount` string, required
        - `payTo` string, required
        - `maxTimeoutSeconds` integer, required
        - `extra` object, required
          - `name` 'USD Coin', required
          - `version` '2', required
      - `payload` object, required
        - `signature` string, required
        - `authorization` object, required
          - `from` string, required
          - `to` string, required
          - `value` string, required
          - `validAfter` string, required
          - `validBefore` string, required
          - `nonce` string, required
    - `mandate` object, required
      - `context` object, required
        - `escrow_id` string, required
        - `payer_wallet` string, required
        - `payee_wallet` string, required
        - `custody_wallet` string, required
        - `chain_id` unknown, required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount_atomic` string, required
        - `expires_at` integer, required
        - `funding_nonce` string, required
        - `terms_sha256` string, required
        - `funding_transaction_hash` string, required
        - `release_nonce` string, required
      - `terms` object, required
        - `escrow_id` string, required
        - `payer_wallet` string, required
        - `payee_wallet` string, required
        - `custody_wallet` string, required
        - `chain_id` unknown, required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount_atomic` string, required
        - `expires_at` integer, required
        - `funding_nonce` string, required
        - `release_policy` union, required
          - object
            - `kind` 'payer_signed', required
          - object
            - `kind` 'mutual', required
          - object
            - `kind` 'delivery_attestation', required
            - `attestor_wallet` string, required
            - `delivery_sha256` string, required
          - object
            - `kind` 'payer_signed', required
          - object
            - `kind` 'mutual', required
          - object
            - `kind` 'delivery_attestation', required
            - `attestor_wallet` string, required
            - `delivery_sha256` string, required
          - object
            - `kind` 'payer_signed', required
            - `attestor_wallet` string, required
            - `delivery_sha256` string, required
          - object
            - `kind` 'mutual', required
            - `attestor_wallet` string, required
            - `delivery_sha256` string, required
          - object
            - `kind` 'delivery_attestation', required
            - `attestor_wallet` string, required
            - `delivery_sha256` string, required
      - `payer_terms_signature` string, required
      - `signatures` union, required
        - object
          - `payer_signature` string, required
        - object
          - `payer_signature` string, required
          - `payee_signature` string, required
        - object
          - `payer_signature` string, required
          - `payee_signature` string, required
          - `attestor_signature` string, required
        - object
          - `payer_signature` string, required
          - `payee_signature` string, required
        - object
          - `payer_signature` string, required
          - `payee_signature` string, required
        - object
          - `payer_signature` string, required
          - `payee_signature` string, required
          - `attestor_signature` string, required
        - object
          - `payee_signature` string, required
          - `attestor_signature` string, required
          - `payer_signature` string, required
        - object
          - `payee_signature` string, required
          - `attestor_signature` string, required
          - `payer_signature` string, required
        - object
          - `payee_signature` string, required
          - `attestor_signature` string, required
  - object
    - `mode` 'refund_escrow', required
    - `terms` object
      - `escrow_id` string, required
      - `payer_wallet` string, required
      - `payee_wallet` string, required
      - `custody_wallet` string, required
      - `chain_id` unknown, required
      - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
      - `amount_atomic` string, required
      - `expires_at` integer, required
      - `funding_nonce` string, required
      - `release_policy` union, required
        - object
          - `kind` 'payer_signed', required
        - object
          - `kind` 'mutual', required
        - object
          - `kind` 'delivery_attestation', required
          - `attestor_wallet` string, required
          - `delivery_sha256` string, required
    - `payer_terms_signature` string
    - `idempotency_key` string, required
    - `escrow_id` string, required
    - `funding_payment` object, nullable
      - `x402Version` unknown, required
      - `resource` object, required
        - `url` string, required
        - `description` string, required
        - `mimeType` 'application/json', required
      - `accepted` object, required
        - `scheme` 'exact', required
        - `network` 'eip155:8453', required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount` string, required
        - `payTo` string, required
        - `maxTimeoutSeconds` integer, required
        - `extra` object, required
          - `name` 'USD Coin', required
          - `version` '2', required
      - `payload` object, required
        - `signature` string, required
        - `authorization` object, required
          - `from` string, required
          - `to` string, required
          - `value` string, required
          - `validAfter` string, required
          - `validBefore` string, required
          - `nonce` string, required
    - `mandate` object
      - `context` object, required
        - `escrow_id` string, required
        - `payer_wallet` string, required
        - `payee_wallet` string, required
        - `custody_wallet` string, required
        - `chain_id` unknown, required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount_atomic` string, required
        - `expires_at` integer, required
        - `funding_nonce` string, required
        - `terms_sha256` string, required
        - `funding_transaction_hash` string, required
        - `release_nonce` string, required
      - `terms` object, required
        - `escrow_id` string, required
        - `payer_wallet` string, required
        - `payee_wallet` string, required
        - `custody_wallet` string, required
        - `chain_id` unknown, required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount_atomic` string, required
        - `expires_at` integer, required
        - `funding_nonce` string, required
        - `release_policy` union, required
          - object
            - `kind` 'payer_signed', required
          - object
            - `kind` 'mutual', required
          - object
            - `kind` 'delivery_attestation', required
            - `attestor_wallet` string, required
            - `delivery_sha256` string, required
      - `payer_terms_signature` string, required
      - `signatures` union, required
        - object
          - `payer_signature` string, required
        - object
          - `payer_signature` string, required
          - `payee_signature` string, required
        - object
          - `payee_signature` string, required
          - `attestor_signature` string, required
  - object
    - `mode` 'read_escrow', required
    - `terms` object
      - `escrow_id` string, required
      - `payer_wallet` string, required
      - `payee_wallet` string, required
      - `custody_wallet` string, required
      - `chain_id` unknown, required
      - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
      - `amount_atomic` string, required
      - `expires_at` integer, required
      - `funding_nonce` string, required
      - `release_policy` union, required
        - object
          - `kind` 'payer_signed', required
        - object
          - `kind` 'mutual', required
        - object
          - `kind` 'delivery_attestation', required
          - `attestor_wallet` string, required
          - `delivery_sha256` string, required
    - `payer_terms_signature` string
    - `idempotency_key` string
    - `escrow_id` string, required
    - `funding_payment` object, nullable
      - `x402Version` unknown, required
      - `resource` object, required
        - `url` string, required
        - `description` string, required
        - `mimeType` 'application/json', required
      - `accepted` object, required
        - `scheme` 'exact', required
        - `network` 'eip155:8453', required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount` string, required
        - `payTo` string, required
        - `maxTimeoutSeconds` integer, required
        - `extra` object, required
          - `name` 'USD Coin', required
          - `version` '2', required
      - `payload` object, required
        - `signature` string, required
        - `authorization` object, required
          - `from` string, required
          - `to` string, required
          - `value` string, required
          - `validAfter` string, required
          - `validBefore` string, required
          - `nonce` string, required
    - `mandate` object
      - `context` object, required
        - `escrow_id` string, required
        - `payer_wallet` string, required
        - `payee_wallet` string, required
        - `custody_wallet` string, required
        - `chain_id` unknown, required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount_atomic` string, required
        - `expires_at` integer, required
        - `funding_nonce` string, required
        - `terms_sha256` string, required
        - `funding_transaction_hash` string, required
        - `release_nonce` string, required
      - `terms` object, required
        - `escrow_id` string, required
        - `payer_wallet` string, required
        - `payee_wallet` string, required
        - `custody_wallet` string, required
        - `chain_id` unknown, required
        - `asset` '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', required
        - `amount_atomic` string, required
        - `expires_at` integer, required
        - `funding_nonce` string, required
        - `release_policy` union, required
          - object
            - `kind` 'payer_signed', required
          - object
            - `kind` 'mutual', required
          - object
            - `kind` 'delivery_attestation', required
            - `attestor_wallet` string, required
            - `delivery_sha256` string, required
      - `payer_terms_signature` string, required
      - `signatures` union, required
        - object
          - `payer_signature` string, required
        - object
          - `payer_signature` string, required
          - `payee_signature` string, required
        - object
          - `payee_signature` string, required
          - `attestor_signature` string, required

## Response `200`

Escrow service result; custody completion requires verified onchain evidence in the result

## Other responses

- `400`: Invalid request rejected before billing
- `401`: Wallet ownership proof required
- `402`: API access fee, principal funding terms or capacity challenge; inspect the response
- `409`: Idempotency conflict or pending reconciliation
- `503`: Required custody dependency unavailable

---

[API](https://skmtc.dev/weverlabs/apis/wever-labs-agent-api.md) · [All operations](https://skmtc.dev/weverlabs/apis/wever-labs-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/weverlabs/apis/wever-labs-agent-api/revisions/e4eed0d1f6e3?raw)