@stridge/openapi 0.4.0 → 0.5.0

package/dist/openapi.json

@@ -3,8 +3,8 @@
   "info": {
     "title": "Stridge API",
     "version": "1.0.0",
-    "summary": "Public REST API for Stridge Universal Deposit Addresses (UDA).",
-    "description": "The Stridge API lets you allocate **Universal Deposit Addresses (UDA)** — cross-chain deposit addresses that route any incoming deposit to a destination you control — fetch indicative cross-chain/cross-asset quotes, and track the settlements those deposits produce.\n\n## Authentication\n\nAuthenticate by sending your secret API key in the `X-API-Key` header on every request. Two endpoints are public and need no key: `GET /uda/quote` and `GET /uda/supported-assets`. All other endpoints require a key.\n\n``` X-API-Key: sk_live_8f3c2b1a9d4e5f60718293a4b5c6d7e8 ```\n\nKeep your secret key on the server. Never embed it in a browser bundle, mobile app, or any client you ship to users.\n\n## Base URLs\n\n| Environment | Base URL | | --- | --- | | Production | `https://api.stridge.com/v1` | | Sandbox | `https://api.stridge.dev/v1` |\n\nAll paths in this reference are relative to the selected base URL — e.g. `POST /uda` is `POST https://api.stridge.com/v1/uda`.\n\n## Conventions\n\nAmounts are integer strings in the asset's smallest unit (e.g. `wei`, USDC `\"1000000\"` = 1 USDC). List endpoints paginate with `limit` (default 50, max 200) and `offset`, and return a `pagination` object. Errors return a consistent JSON envelope (see the `Error` schema).\n",
+    "summary": "Public REST API for Stridge: Universal Deposit Addresses (UDA), vaults and payouts, gas stations, routing policies, and the sandbox test helpers.",
+    "description": "The Stridge API lets you allocate **Universal Deposit Addresses (UDA)** — cross-chain deposit addresses that route any incoming deposit to a destination you control — fetch indicative cross-chain/cross-asset quotes, track the settlements those deposits produce, read your vaults and send payouts from them, read your gas stations and routing policies, and, in a sandbox, simulate deposits and payouts with the test helpers.\n\n## Authentication\n\nAuthenticate by sending your secret API key in the `X-API-Key` header on every request. Two endpoints are public and need no key: `GET /uda/quote` and `GET /uda/supported-assets`. All other endpoints require a key.\n\n``` X-API-Key: sk_live_8f3c2b1a9d4e5f60718293a4b5c6d7e8 ```\n\nA missing, unknown, revoked or expired key is answered `401`. A key whose scopes do not cover the operation is answered `403` with `Insufficient permissions`; a key restricted to an IP allowlist or referrers is answered `403` from anywhere else.\n\n## Live and sandbox keys\n\nEvery key belongs to exactly one environment, and the key alone decides which. New live keys start `sk_live_`; sandbox keys start `sk_sbx_` and act on simulated chains with no real funds. Live keys issued before sandbox keys existed have no prefix and stay valid in live. The environment is a property of the key, and no header, parameter or URL changes it. Stridge reads the prefix to route your request (see Base URL); your code should not, and should read `livemode` on the response instead. A keyed request that also sends `X-Stridge-Environment` is refused with `400` and `environment header not accepted`; every keyed operation lists that `400`.\n\nEvery object a keyed request answers with carries `livemode`, so a stored payload says which environment it came from. Webhook deliveries carry `livemode` and `environment_id` in the signed envelope, and sandbox deliveries also carry `reset_epoch` (see Webhooks).\n\nThe gateway (`X-Gateway-Key`, which the Gateway Kit, its SDK and the onramp use) serves live keys only: a sandbox key is answered `403` with `Sandbox API keys cannot be used with the gateway`. While a sandbox is being reset from the dashboard, every request made with its keys is answered `409` with `environment resetting`; retry once the reset is done.\n\nKeep your secret key on the server. Never embed it in a browser bundle, mobile app, or any client you ship to users.\n\n## No step-up for API keys\n\nA request made with an API key is never asked for a step-up: no TOTP code or other second factor, on any operation, in live or in sandbox. Step-up applies only to people signed in to the Stridge dashboard, who confirm a fresh second factor before sensitive live actions such as creating a payout or creating or widening a live key. What a key may do is fixed by the scopes it was created with.\n\n## Test helpers\n\nIn a sandbox, the `/test_helpers` operations simulate what the outside world would do — a deposit to a UDA or vault, how a settlement ends, whether a payout's transaction confirms — so you can exercise your integration end to end, webhooks included. Call them with a sandbox key; a live key is answered `404` with `not a sandbox environment`. Every helper call that pulls a lever requires an `Idempotency-Key` and spends one unit of the sandbox's simulation budget (600 per hour).\n\nThe sandbox simulates Ethereum, Arbitrum, Base, BNB Smart Chain, Optimism, Polygon, Bitcoin, Solana and Tron. Tempo is live only: it is not simulated in the sandbox.\n\n## Base URL\n\nLive and sandbox keys use the same base URL, `https://api.stridge.com/v1`. The key decides where a request is served: Stridge routes a request whose `X-API-Key` starts `sk_sbx_` to your sandbox and every other request to live. Send the key unchanged in `X-API-Key`, never in `Authorization`; a key sent anywhere else reaches live. A key that reaches the other environment's API is refused with `401`, and the error names the key's environment and the fix, so a misroute never acts in the wrong environment. Switching between sandbox and live is changing the key, and nothing else.\n\nAll paths in this reference are relative to the base URL — e.g. `POST /uda` is `POST https://api.stridge.com/v1/uda`.\n\n## Idempotency\n\nEvery keyed `POST` accepts an optional `Idempotency-Key` header; the test helpers require one. Keys are scoped to your workspace and the key's environment, so every API key of one environment shares them (a retry with a rotated key still replays) and a sandbox never replays a live answer. A repeat of the same request with the same key within 24 hours is answered the first response again, refusals included, with `Idempotency-Replay: true`, and is not carried out twice. The same key sent with a different body to the same operation is answered `409` with `Idempotency key reused with different request`. Requests made without a key are never deduplicated.\n\n## Errors and rate limits\n\nErrors return one JSON envelope (see the `Error` schema): `success: false`, the HTTP status in `code`, a message in `error`, and, on the few refusals that need it, a `details` object to act on.\n\n| Status | Meaning |\n| --- | --- |\n| `400` | Malformed request, failed validation, or `environment header not accepted`. |\n| `401` | Missing or invalid key, or a key that reached the other environment's API. |\n| `403` | The key lacks the scope, IP or referrer, or a sandbox key on a live-only surface. |\n| `404` | Not found; on `/test_helpers`, `not a sandbox environment` for a live key. |\n| `409` | A conflict (duplicate `reference_id`, reused `Idempotency-Key`), or `environment resetting`. |\n| `422` | A request the operation cannot carry out. |\n| `429` | Rate limit (`Too many requests`) or the sandbox's simulation budget. |\n| `5xx` | A server error. |\n\nEvery operation is rate limited per API key (per client address on the public endpoints) over a one-minute window. Responses carry `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset` (a Unix timestamp in seconds); a `429` adds `Retry-After` in seconds.\n\n## Webhooks\n\nStridge POSTs each event to your webhook endpoints as a signed JSON envelope (see the `webhook-event` webhook): `id`, `version`, `type`, `time`, `livemode`, `environment_id`, `reset_epoch` on sandbox deliveries only, and the event's `payload`. The `webhook-signature` header is the hex HMAC-SHA256 of `webhook-timestamp + \".\" + raw body` with the endpoint's signing secret; verify it over the raw bytes, before parsing.\n\n## Conventions\n\nAmounts are integer strings in the asset's smallest unit (e.g. `wei`, USDC `\"1000000\"` = 1 USDC) unless an operation says otherwise; payouts take and return decimal amounts (e.g. `\"100.50\"`). UDA and settlement lists paginate with `limit` and `offset` and return a `pagination` object; payout, gas-station, routing-policy and simulation lists paginate with `page` and `limit` and return page-based `pagination`.\n\nNetworks are identified by SLIP-44-style `network_id` (e.g. `60` Ethereum, `195` Tron, `501` Solana, `0` Bitcoin, `4217` Tempo) and, where a slug is asked for, by `network_symbol` (e.g. `ethereum`, `tron`, `tempo`). Tempo is an EVM network with no native gas coin: its fees are paid in a USD stablecoin, and a Tempo payout of USDC, USDT or OUSD pays its fee out of the amount sent.\n",
     "contact": {
       "name": "Stridge Developer Support",
       "url": "https://stridge.com"
@@ -13,11 +13,7 @@
   "servers": [
     {
       "url": "https://api.stridge.com/v1",
-      "description": "Production"
-    },
-    {
-      "url": "https://api.stridge.dev/v1",
-      "description": "Sandbox"
+      "description": "Production (live and sandbox keys)"
     }
   ],
   "tags": [
@@ -36,6 +32,14 @@
     {
       "name": "Gas Stations",
       "description": "Native-gas wallets that fund payout transactions. Stridge refills a vault wallet from a gas station automatically before a transfer when it is short on gas.\n"
+    },
+    {
+      "name": "Test Helpers",
+      "description": "**Sandbox only.** Levers that make the simulated world do what a real one would: pay a UDA or a vault, decide how a settlement ends, and choose whether a payout's transaction confirms, fails or is held for you to release or fail. Each call answers a simulation you can read back and wait on; the deposits, settlements, payouts and webhooks it causes are ordinary sandbox objects. Call them with a sandbox key (`sk_sbx_`); a live key is answered `404` with `not a sandbox environment`. Every operation here is marked `x-sandbox-only`.\n"
+    },
+    {
+      "name": "Webhooks",
+      "description": "The signed envelope Stridge POSTs to your webhook endpoints for every event, in live and in sandbox. Endpoints are managed in the dashboard.\n"
     }
   ],
   "paths": {
@@ -121,6 +125,15 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -138,6 +151,11 @@
             "ApiKeyAuth": []
           }
         ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/IdempotencyKeyOptional"
+          }
+        ],
         "requestBody": {
           "required": true,
           "description": "UDA address configuration.",
@@ -175,6 +193,15 @@
           },
           "401": {
             "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
           }
         }
       }
@@ -241,9 +268,11 @@
           {
             "name": "from_address",
             "in": "query",
-            "description": "Source (signer) EOA; required for an executable quote.",
+            "required": true,
+            "description": "Source (signer) address. Required: without it the quote providers cannot price the route and the API answers `503`.\n",
             "schema": {
-              "type": "string"
+              "type": "string",
+              "example": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD18"
             }
           },
           {
@@ -281,6 +310,9 @@
           "400": {
             "$ref": "#/components/responses/BadRequest"
           },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -306,6 +338,9 @@
               }
             }
           },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -353,9 +388,21 @@
               }
             }
           },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -397,11 +444,23 @@
               }
             }
           },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
           "404": {
             "$ref": "#/components/responses/NotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
           }
         }
       }
@@ -447,6 +506,15 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -477,9 +545,21 @@
               }
             }
           },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -521,9 +601,18 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
           "404": {
             "$ref": "#/components/responses/NotFound"
           },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -551,7 +640,7 @@
             "name": "network",
             "in": "path",
             "required": true,
-            "description": "Network name (e.g. `ethereum`, `tron`).",
+            "description": "Network slug (e.g. `ethereum`, `tron`, `tempo`).",
             "schema": {
               "type": "string"
             }
@@ -574,9 +663,18 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
           "404": {
             "$ref": "#/components/responses/NotFound"
           },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -634,9 +732,18 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
           "404": {
             "$ref": "#/components/responses/NotFound"
           },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -686,9 +793,18 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
           "404": {
             "$ref": "#/components/responses/NotFound"
           },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -737,7 +853,7 @@
             }
           },
           "400": {
-            "description": "Missing `vault_id` or invalid filters.",
+            "description": "Missing `vault_id` or invalid filters, or the request also sent `X-Stridge-Environment`.\n",
             "content": {
               "application/json": {
                 "schema": {
@@ -749,6 +865,15 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -766,6 +891,11 @@
             "ApiKeyAuth": []
           }
         ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/IdempotencyKeyOptional"
+          }
+        ],
         "requestBody": {
           "required": true,
           "description": "Create payout request.",
@@ -789,7 +919,7 @@
             }
           },
           "400": {
-            "description": "Validation error or insufficient balance.",
+            "description": "Validation error or insufficient balance, or the request also sent `X-Stridge-Environment`.\n",
             "content": {
               "application/json": {
                 "schema": {
@@ -801,11 +931,38 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
           "404": {
             "$ref": "#/components/responses/NotFound"
           },
           "409": {
-            "description": "Duplicate `reference_id`.",
+            "description": "The vault already has a payout with this `reference_id`: the body is that payout, at `409`, with `success: true` and `Payout already exists for this reference_id`. Also `duplicate reference_id for this vault` (an error body) when the existing payout cannot be read, or `environment resetting` while the key's sandbox is being reset.\n",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "oneOf": [
+                    {
+                      "allOf": [
+                        {
+                          "$ref": "#/components/schemas/SuccessEnvelope"
+                        },
+                        {
+                          "$ref": "#/components/schemas/PayoutResponse"
+                        }
+                      ]
+                    },
+                    {
+                      "$ref": "#/components/schemas/Error"
+                    }
+                  ]
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "The body failed validation (a missing required field, an invalid `to_address` for the network, or an amount with more decimals than the asset has).\n",
             "content": {
               "application/json": {
                 "schema": {
@@ -814,6 +971,9 @@
               }
             }
           },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -862,7 +1022,7 @@
             }
           },
           "400": {
-            "description": "Missing `vault_id` or invalid filters.",
+            "description": "Missing `vault_id` or invalid filters, or the request also sent `X-Stridge-Environment`.\n",
             "content": {
               "application/json": {
                 "schema": {
@@ -874,6 +1034,15 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -915,12 +1084,24 @@
               }
             }
           },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
           "404": {
             "$ref": "#/components/responses/NotFound"
           },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -941,6 +1122,9 @@
           }
         ],
         "parameters": [
+          {
+            "$ref": "#/components/parameters/IdempotencyKeyOptional"
+          },
           {
             "name": "id",
             "in": "path",
@@ -962,14 +1146,20 @@
               }
             }
           },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
           "404": {
             "$ref": "#/components/responses/NotFound"
           },
           "409": {
-            "description": "The payout is already final or past pending.",
+            "description": "`payout is already in a final state`, or `environment resetting` while the key's sandbox is being reset.\n",
             "content": {
               "application/json": {
                 "schema": {
@@ -978,6 +1168,9 @@
               }
             }
           },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -1025,9 +1218,18 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
           "404": {
             "$ref": "#/components/responses/NotFound"
           },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -1075,9 +1277,18 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
           "404": {
             "$ref": "#/components/responses/NotFound"
           },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -1155,9 +1366,18 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
           "404": {
             "$ref": "#/components/responses/NotFound"
           },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -1171,7 +1391,7 @@
           "Routing Policies"
         ],
         "summary": "List routing policies",
-        "description": "List the routing policies configured for your tenant, including the default policy. Read-only — create and edit policies from the dashboard.\n",
+        "description": "List the routing policies configured for your tenant, including the default policy, newest first. Read-only — create and edit policies from the dashboard.\n",
         "security": [
           {
             "ApiKeyAuth": []
@@ -1179,10 +1399,18 @@
         ],
         "parameters": [
           {
-            "$ref": "#/components/parameters/LimitParam"
+            "$ref": "#/components/parameters/PageParam"
           },
           {
-            "$ref": "#/components/parameters/OffsetParam"
+            "name": "limit",
+            "in": "query",
+            "description": "Items per page (default 10, max 100).",
+            "schema": {
+              "type": "integer",
+              "default": 10,
+              "minimum": 1,
+              "maximum": 100
+            }
           }
         ],
         "responses": {
@@ -1202,6 +1430,15 @@
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
@@ -1238,134 +1475,1114 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/RoutingPolicy"
+                  "$ref": "#/components/schemas/RoutingPolicyResponse"
                 }
               }
             }
           },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
           "401": {
             "$ref": "#/components/responses/Unauthorized"
           },
+          "403": {
+            "$ref": "#/components/responses/Forbidden"
+          },
           "404": {
             "$ref": "#/components/responses/NotFound"
           },
+          "409": {
+            "$ref": "#/components/responses/EnvironmentResetting"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
           "500": {
             "$ref": "#/components/responses/ServerError"
           }
         }
       }
-    }
-  },
-  "components": {
-    "securitySchemes": {
-      "ApiKeyAuth": {
-        "type": "apiKey",
-        "in": "header",
-        "name": "X-API-Key",
-        "description": "Secret API key for programmatic access. Send it on every authenticated request. Keep it server-side; never ship it in a client bundle.\n"
-      }
-    },
-    "parameters": {
-      "LimitParam": {
-        "name": "limit",
-        "in": "query",
-        "description": "Page size (default 50, max 200).",
-        "schema": {
-          "type": "integer",
-          "default": 50,
-          "minimum": 1,
-          "maximum": 200
-        }
-      },
-      "OffsetParam": {
-        "name": "offset",
-        "in": "query",
-        "description": "Number of items to skip (default 0).",
-        "schema": {
-          "type": "integer",
-          "default": 0,
-          "minimum": 0
-        }
-      },
-      "VaultIdParam": {
-        "name": "vault_id",
-        "in": "path",
-        "required": true,
-        "description": "Vault id.",
-        "schema": {
-          "type": "string"
-        }
-      },
-      "PageParam": {
-        "name": "page",
-        "in": "query",
-        "description": "Page number (default 1).",
-        "schema": {
-          "type": "integer",
-          "default": 1,
-          "minimum": 1
-        }
-      },
-      "PageSizeParam": {
-        "name": "limit",
-        "in": "query",
-        "description": "Items per page (default 20, max 100).",
-        "schema": {
-          "type": "integer",
-          "default": 20,
-          "minimum": 1,
-          "maximum": 100
-        }
-      }
     },
-    "responses": {
-      "BadRequest": {
-        "description": "The request was malformed or failed validation.",
-        "content": {
-          "application/json": {
-            "schema": {
-              "$ref": "#/components/schemas/Error"
-            },
-            "example": {
-              "success": false,
-              "code": 400,
-              "error": "invalid request"
-            }
+    "/test_helpers/options": {
+      "get": {
+        "operationId": "get-test-helper-options",
+        "tags": [
+          "Test Helpers"
+        ],
+        "x-sandbox-only": true,
+        "summary": "Read what the test helpers accept",
+        "description": "Everything a test helper call in your sandbox may name: the UDAs and vaults you can deposit to, the simulated networks with their assets and levers, the deposit presets, the settlement and payout outcomes, the webhook event types a simulation can cause, how fast each simulated network moves, and how much of the simulation budget is left. Pass `uda_id` to narrow the UDA list to that one UDA and expand each preset into the concrete `facts` (network, asset and amount) it would send to it. Spends no simulation budget and needs no `Idempotency-Key`. Sandbox keys only; a live key is answered `404` with `not a sandbox environment`.\n",
+        "security": [
+          {
+            "ApiKeyAuth": []
           }
-        }
-      },
-      "Unauthorized": {
-        "description": "The `X-API-Key` header is missing or invalid.",
-        "content": {
-          "application/json": {
+        ],
+        "parameters": [
+          {
+            "name": "uda_id",
+            "in": "query",
+            "description": "A UDA in your sandbox. The `udas` list then holds only it, and each preset carries its `facts` for it (`null` where the UDA leaves nothing to express the preset with).\n",
             "schema": {
-              "$ref": "#/components/schemas/Error"
-            },
-            "example": {
-              "success": false,
-              "code": 401,
-              "error": "unauthenticated"
+              "type": "string"
             }
           }
-        }
-      },
-      "NotFound": {
-        "description": "The requested resource does not exist.",
-        "content": {
-          "application/json": {
-            "schema": {
-              "$ref": "#/components/schemas/Error"
-            },
-            "example": {
-              "success": false,
-              "code": 404,
-              "error": "not found"
+        ],
+        "responses": {
+          "200": {
+            "description": "What the test helpers accept in your sandbox.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/TestHelperOptionsResponse"
+                }
+              }
             }
-          }
-        }
-      },
-      "ServerError": {
-        "description": "An unexpected error occurred on the server.",
+          },
+          "400": {
+            "$ref": "#/components/responses/BadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "description": "`not a sandbox environment` (the key is a live key) or `uda not found` (the `uda_id` is not in your sandbox).\n",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                },
+                "example": {
+                  "success": false,
+                  "code": 404,
+                  "error": "not a sandbox environment"
+                }
+              }
+            }
+          },
+          "409": {
+            "$ref": "#/components/responses/SandboxBusy"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
+          "500": {
+            "$ref": "#/components/responses/ServerError"
+          }
+        }
+      }
+    },
+    "/test_helpers/uda/deposits": {
+      "post": {
+        "operationId": "simulate-uda-deposit",
+        "tags": [
+          "Test Helpers"
+        ],
+        "x-sandbox-only": true,
+        "summary": "Simulate a deposit to a UDA",
+        "description": "Send a simulated payment to one of your sandbox UDAs and get the simulation back at once. The deposit reaches Stridge through the same observer as a real one, so it produces the deposit, the settlement and the webhooks a real deposit would. Choose how the settlement ends with `settlement`, or name a `preset` for a shaped payment (underpaid, overpaid, wrong network, wrong asset, dust) — the preset only labels the facts you send, which `GET /test_helpers/options` expands for a UDA. A payment in an asset the UDA does not accept is recorded and settled by nothing, so it takes no `settlement` (except `success` with the `wrong_asset` preset). Requires an `Idempotency-Key`. Spends one unit of the simulation budget. Sandbox keys only.\n",
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/IdempotencyKeyHeader"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SimulateUDADepositRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "$ref": "#/components/responses/SimulationCreated"
+          },
+          "400": {
+            "$ref": "#/components/responses/TestHelperBadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "description": "`not a sandbox environment` (the key is a live key), `uda not found`, `network not simulated`, or `uda has no address on this network`.\n",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                },
+                "example": {
+                  "success": false,
+                  "code": 404,
+                  "error": "not a sandbox environment"
+                }
+              }
+            }
+          },
+          "409": {
+            "$ref": "#/components/responses/SandboxBusy"
+          },
+          "422": {
+            "description": "A request the helper cannot carry out: `uda_id, network_id, asset and amount are required`, `unknown asset` (not one the network carries), `malformed amount`, `unknown settlement outcome`, `unknown preset`, `asset not accepted by the uda` (a `settlement` chosen for an asset the UDA does not accept; `details` carries `network_id` and the `accepted_assets`), `bridge outcome needs a cross-chain route` (the bridge lever is not offered in production), or `idempotency key replayed with a different body`.\n",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                },
+                "examples": {
+                  "malformed-amount": {
+                    "value": {
+                      "success": false,
+                      "code": 422,
+                      "error": "malformed amount"
+                    }
+                  },
+                  "asset-not-accepted": {
+                    "value": {
+                      "success": false,
+                      "code": 422,
+                      "error": "asset not accepted by the uda",
+                      "details": {
+                        "network_id": "60",
+                        "accepted_assets": [
+                          {
+                            "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+                          }
+                        ]
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "429": {
+            "$ref": "#/components/responses/SimulationBudgetExhausted"
+          },
+          "500": {
+            "$ref": "#/components/responses/ServerError"
+          }
+        }
+      }
+    },
+    "/test_helpers/vault/deposits": {
+      "post": {
+        "operationId": "simulate-vault-deposit",
+        "tags": [
+          "Test Helpers"
+        ],
+        "x-sandbox-only": true,
+        "summary": "Simulate a deposit to a vault",
+        "description": "Send a simulated payment to one of your sandbox vaults on a simulated network and get the simulation back at once. `preset` accepts `dust` only. Requires an `Idempotency-Key`. Spends one unit of the simulation budget. Sandbox keys only.\n",
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/IdempotencyKeyHeader"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SimulateVaultDepositRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "$ref": "#/components/responses/SimulationCreated"
+          },
+          "400": {
+            "$ref": "#/components/responses/TestHelperBadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "description": "`not a sandbox environment` (the key is a live key), `vault not found`, `network not simulated`, or `vault has no wallet on this network`.\n",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                },
+                "example": {
+                  "success": false,
+                  "code": 404,
+                  "error": "not a sandbox environment"
+                }
+              }
+            }
+          },
+          "409": {
+            "$ref": "#/components/responses/SandboxBusy"
+          },
+          "422": {
+            "description": "A request the helper cannot carry out: `vault_id, network_id, asset and amount are required`, `unknown asset`, `malformed amount`, `unknown preset`, or `idempotency key replayed with a different body`.\n",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                },
+                "example": {
+                  "success": false,
+                  "code": 422,
+                  "error": "unknown asset"
+                }
+              }
+            }
+          },
+          "429": {
+            "$ref": "#/components/responses/SimulationBudgetExhausted"
+          },
+          "500": {
+            "$ref": "#/components/responses/ServerError"
+          }
+        }
+      }
+    },
+    "/test_helpers/payouts": {
+      "post": {
+        "operationId": "simulate-payout",
+        "tags": [
+          "Test Helpers"
+        ],
+        "x-sandbox-only": true,
+        "summary": "Simulate a payout",
+        "description": "Create an ordinary sandbox payout — the same body and checks as `POST /transfer/payout` — with the fate of its transaction chosen first: `success` confirms it, `fail` fails it, and `hold` keeps it broadcast but unconfirmed until you release or fail it. Requires the key's `payout` scope, as creating a payout does, and an `Idempotency-Key`. Spends one unit of the simulation budget. Sandbox keys only.\n",
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/IdempotencyKeyHeader"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/SimulatePayoutRequest"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "$ref": "#/components/responses/SimulationCreated"
+          },
+          "400": {
+            "$ref": "#/components/responses/TestHelperBadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/PayoutScopeRequired"
+          },
+          "404": {
+            "description": "`not a sandbox environment` (the key is a live key) or `vault not found`.\n",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                },
+                "example": {
+                  "success": false,
+                  "code": 404,
+                  "error": "not a sandbox environment"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "`environment provisioning` or `environment resetting`, `duplicate reference_id for this vault` (`details` carries the existing `payout_id` and its `status`), `a request with this idempotency key is still in flight`, or `Idempotency key reused with different request`.\n",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                },
+                "examples": {
+                  "resetting": {
+                    "value": {
+                      "success": false,
+                      "code": 409,
+                      "error": "environment resetting"
+                    }
+                  },
+                  "duplicate-reference": {
+                    "value": {
+                      "success": false,
+                      "code": 409,
+                      "error": "duplicate reference_id for this vault",
+                      "details": {
+                        "payout_id": "550e8400-e29b-41d4-a716-446655440000",
+                        "status": "confirmed"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "422": {
+            "description": "`vault_id, reference_id, to_address, network_symbol and asset are required`, `state exactly one of amount and usd_amount`, `invalid type, must be 'normal' or 'forceful'`, `unknown payout outcome`, `invalid network_symbol`, `vault has no wallet on this network`, a payout the payout API refuses (`insufficient balance`, `insufficient gas for transaction`, `invalid destination address`, `invalid amount`, `expired_at must be in the future`, `unable to get price for asset`, `network or asset not supported for this tenant`), or `idempotency key replayed with a different body`.\n",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                },
+                "example": {
+                  "success": false,
+                  "code": 422,
+                  "error": "unknown payout outcome"
+                }
+              }
+            }
+          },
+          "429": {
+            "$ref": "#/components/responses/SimulationBudgetExhausted"
+          },
+          "500": {
+            "$ref": "#/components/responses/ServerError"
+          }
+        }
+      }
+    },
+    "/test_helpers/payouts/{payout_id}/release": {
+      "post": {
+        "operationId": "release-simulated-payout",
+        "tags": [
+          "Test Helpers"
+        ],
+        "x-sandbox-only": true,
+        "summary": "Release a held payout",
+        "description": "Confirm a payout that `POST /test_helpers/payouts` created with `outcome: hold`. No body. Requires the key's `payout` scope and an `Idempotency-Key`. Spends one unit of the simulation budget. Sandbox keys only.\n",
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/PayoutIdPathParam"
+          },
+          {
+            "$ref": "#/components/parameters/IdempotencyKeyHeader"
+          }
+        ],
+        "responses": {
+          "201": {
+            "$ref": "#/components/responses/SimulationCreated"
+          },
+          "400": {
+            "$ref": "#/components/responses/TestHelperBadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/PayoutScopeRequired"
+          },
+          "404": {
+            "$ref": "#/components/responses/HeldPayoutNotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/PayoutNotHeld"
+          },
+          "422": {
+            "$ref": "#/components/responses/IdempotencyKeyReused"
+          },
+          "429": {
+            "$ref": "#/components/responses/SimulationBudgetExhausted"
+          },
+          "500": {
+            "$ref": "#/components/responses/ServerError"
+          }
+        }
+      }
+    },
+    "/test_helpers/payouts/{payout_id}/fail": {
+      "post": {
+        "operationId": "fail-simulated-payout",
+        "tags": [
+          "Test Helpers"
+        ],
+        "x-sandbox-only": true,
+        "summary": "Fail a held payout",
+        "description": "Fail a payout that `POST /test_helpers/payouts` created with `outcome: hold`. No body. Requires the key's `payout` scope and an `Idempotency-Key`. Spends one unit of the simulation budget. Sandbox keys only.\n",
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "$ref": "#/components/parameters/PayoutIdPathParam"
+          },
+          {
+            "$ref": "#/components/parameters/IdempotencyKeyHeader"
+          }
+        ],
+        "responses": {
+          "201": {
+            "$ref": "#/components/responses/SimulationCreated"
+          },
+          "400": {
+            "$ref": "#/components/responses/TestHelperBadRequest"
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/PayoutScopeRequired"
+          },
+          "404": {
+            "$ref": "#/components/responses/HeldPayoutNotFound"
+          },
+          "409": {
+            "$ref": "#/components/responses/PayoutNotHeld"
+          },
+          "422": {
+            "$ref": "#/components/responses/IdempotencyKeyReused"
+          },
+          "429": {
+            "$ref": "#/components/responses/SimulationBudgetExhausted"
+          },
+          "500": {
+            "$ref": "#/components/responses/ServerError"
+          }
+        }
+      }
+    },
+    "/test_helpers/simulations": {
+      "get": {
+        "operationId": "list-simulations",
+        "tags": [
+          "Test Helpers"
+        ],
+        "x-sandbox-only": true,
+        "summary": "List simulations",
+        "description": "List the simulations made in your sandbox, newest first. Filter and sort with `filter[]`, `filterOr[]` and `sort[]` on `id`, `kind`, `state`, `preset`, `created_at` and `updated_at`. A reset of the sandbox deletes its simulations. Sandbox keys only.\n",
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "name": "filter[]",
+            "in": "query",
+            "description": "Filter condition, `field:operator:value`; repeat for more (all must match). Operators: `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `between`, `in`, `nin`, `like`, `ilike`, `inc`, `iinc`, `isnull`, `notnull`.\n",
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "example": [
+              "state:eq:completed"
+            ]
+          },
+          {
+            "name": "filterOr[]",
+            "in": "query",
+            "description": "Filter condition, `field:operator:value`; repeat for more (any may match).",
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            }
+          },
+          {
+            "name": "sort[]",
+            "in": "query",
+            "description": "Sort field, `field:direction` (`asc` or `desc`). Defaults to `created_at:desc`.",
+            "schema": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "example": [
+              "created_at:desc"
+            ]
+          },
+          {
+            "$ref": "#/components/parameters/PageParam"
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "description": "Items per page (default 10, max 100).",
+            "schema": {
+              "type": "integer",
+              "default": 10,
+              "minimum": 1,
+              "maximum": 100
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A page of simulations.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SimulationList"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "`invalid query parameters`, or the request also sent `X-Stridge-Environment`.\n",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "$ref": "#/components/responses/NotASandbox"
+          },
+          "409": {
+            "$ref": "#/components/responses/SandboxBusy"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
+          "500": {
+            "$ref": "#/components/responses/ServerError"
+          }
+        }
+      }
+    },
+    "/test_helpers/simulations/{simulation_id}": {
+      "get": {
+        "operationId": "get-simulation",
+        "tags": [
+          "Test Helpers"
+        ],
+        "x-sandbox-only": true,
+        "summary": "Get a simulation",
+        "description": "Read one simulation. With `wait`, the request blocks until the simulation reaches that state (`observed`: Stridge recorded the first object it produced; `completed`: the flow reached its terminal state), stops early (`failed` or `expired`), or `timeout_ms` passes, and then answers `200` with whatever state it reached. Sandbox keys only.\n",
+        "security": [
+          {
+            "ApiKeyAuth": []
+          }
+        ],
+        "parameters": [
+          {
+            "name": "simulation_id",
+            "in": "path",
+            "required": true,
+            "description": "Simulation id.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "wait",
+            "in": "query",
+            "description": "Block until the simulation is `observed` or `completed`.",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "observed",
+                "completed"
+              ]
+            }
+          },
+          {
+            "name": "timeout_ms",
+            "in": "query",
+            "description": "How long `wait` may block, in milliseconds (default 10000). Values above 30000 are capped at 30000.\n",
+            "schema": {
+              "type": "integer",
+              "default": 10000,
+              "minimum": 0
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The simulation.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SimulationResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "`unknown wait` or `malformed timeout_ms`, or the request also sent `X-Stridge-Environment`.\n",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/Unauthorized"
+          },
+          "404": {
+            "description": "`not a sandbox environment` (the key is a live key) or `simulation not found`.\n",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                },
+                "example": {
+                  "success": false,
+                  "code": 404,
+                  "error": "simulation not found"
+                }
+              }
+            }
+          },
+          "409": {
+            "$ref": "#/components/responses/SandboxBusy"
+          },
+          "429": {
+            "$ref": "#/components/responses/TooManyRequests"
+          },
+          "500": {
+            "$ref": "#/components/responses/ServerError"
+          }
+        }
+      }
+    }
+  },
+  "webhooks": {
+    "webhook-event": {
+      "post": {
+        "operationId": "receive-webhook-event",
+        "tags": [
+          "Webhooks"
+        ],
+        "summary": "Receive an event",
+        "security": [],
+        "description": "What Stridge POSTs to each of your webhook endpoints (https only) for every event it subscribes to, from live and from sandbox alike. The body is the signed envelope below; `livemode` and `environment_id` say which environment the event belongs to, and sandbox deliveries also carry `reset_epoch`. Verify `webhook-signature` over the raw body before parsing it: it is the hex HMAC-SHA256, keyed with the endpoint's signing secret, of `webhook-timestamp + \".\" + raw body`. A receiver that re-serialises the body before verifying, or validates the envelope against a schema that refuses unknown fields, breaks.\n",
+        "parameters": [
+          {
+            "name": "webhook-id",
+            "in": "header",
+            "required": true,
+            "description": "The delivery's idempotency key; the same on every retry of the event.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "webhook-timestamp",
+            "in": "header",
+            "required": true,
+            "description": "When the delivery was sent, as a Unix timestamp in seconds. Reject stale timestamps to prevent replays.",
+            "schema": {
+              "type": "string",
+              "example": "1792913022"
+            }
+          },
+          {
+            "name": "webhook-signature",
+            "in": "header",
+            "required": true,
+            "description": "Hex HMAC-SHA256 of `webhook-timestamp + \".\" + raw body`, keyed with the endpoint's signing secret.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/WebhookEnvelope"
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Any `2xx` acknowledges the delivery, within 10 seconds. Anything else, or no answer, is retried with backoff: in live up to 6 attempts, from 10 seconds apart up to 10 minutes; in a sandbox fewer, 30 seconds apart.\n"
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "securitySchemes": {
+      "ApiKeyAuth": {
+        "type": "apiKey",
+        "in": "header",
+        "name": "X-API-Key",
+        "description": "Secret API key for programmatic access. Send it on every authenticated request. Keep it server-side; never ship it in a client bundle. New live keys start `sk_live_` and sandbox keys `sk_sbx_`; live keys issued before sandbox keys existed have no prefix. The key's own environment is the one the request acts in, whatever its prefix. Live and sandbox keys share one base URL: send the key unchanged in this header, which is what routes a sandbox key's request to the sandbox. A keyed request is never asked for a step-up (TOTP or any second factor); step-up applies only to people signed in to the dashboard.\n"
+      }
+    },
+    "parameters": {
+      "LimitParam": {
+        "name": "limit",
+        "in": "query",
+        "description": "Page size (default 50, max 200).",
+        "schema": {
+          "type": "integer",
+          "default": 50,
+          "minimum": 1,
+          "maximum": 200
+        }
+      },
+      "OffsetParam": {
+        "name": "offset",
+        "in": "query",
+        "description": "Number of items to skip (default 0).",
+        "schema": {
+          "type": "integer",
+          "default": 0,
+          "minimum": 0
+        }
+      },
+      "VaultIdParam": {
+        "name": "vault_id",
+        "in": "path",
+        "required": true,
+        "description": "Vault id.",
+        "schema": {
+          "type": "string"
+        }
+      },
+      "PageParam": {
+        "name": "page",
+        "in": "query",
+        "description": "Page number (default 1).",
+        "schema": {
+          "type": "integer",
+          "default": 1,
+          "minimum": 1
+        }
+      },
+      "PageSizeParam": {
+        "name": "limit",
+        "in": "query",
+        "description": "Items per page (default 20, max 100).",
+        "schema": {
+          "type": "integer",
+          "default": 20,
+          "minimum": 1,
+          "maximum": 100
+        }
+      },
+      "IdempotencyKeyHeader": {
+        "name": "Idempotency-Key",
+        "in": "header",
+        "required": true,
+        "description": "Required on every test helper call that pulls a lever (at most 255 characters; without one the call is answered `400 idempotency key required`). A repeat with the same key and body is answered the first response again, refusals included, with `Idempotency-Replay: true`, and never pulls the lever twice. The same key with another body on the same helper is answered `409 Idempotency key reused with different request`; the same key on another helper, or for another payout, is answered `422 idempotency key replayed with a different body`. Keys are remembered for 24 hours per sandbox, and a reset of the sandbox starts them afresh.\n",
+        "schema": {
+          "type": "string",
+          "maxLength": 255
+        },
+        "example": "sim-2f1c9a7e"
+      },
+      "IdempotencyKeyOptional": {
+        "name": "Idempotency-Key",
+        "in": "header",
+        "required": false,
+        "description": "Optional. A unique key for this request, such as a UUID. A repeat of the same request with the same key within 24 hours is answered the first response again, refusals included, with `Idempotency-Replay: true`, and is not carried out twice. Keys are scoped to your workspace and the key's environment, so every API key of that environment shares them. The same key with a different body is answered `409` with `Idempotency key reused with different request`; a repeat that arrives while the first is still running waits for it, and is answered `408` with `Request processing timeout` if it does not finish in time.\n",
+        "schema": {
+          "type": "string"
+        },
+        "example": "6f1c2e7a-4b9d-4c1e-9a7f-0d3b5e8c2a14"
+      },
+      "PayoutIdPathParam": {
+        "name": "payout_id",
+        "in": "path",
+        "required": true,
+        "description": "The held payout's id.",
+        "schema": {
+          "type": "string"
+        }
+      }
+    },
+    "responses": {
+      "BadRequest": {
+        "description": "The request was malformed or failed validation, or a keyed request also sent `X-Stridge-Environment`.\n",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            },
+            "example": {
+              "success": false,
+              "code": 400,
+              "error": "invalid request"
+            }
+          }
+        }
+      },
+      "Unauthorized": {
+        "description": "The `X-API-Key` header is missing (`X-API-Key header is required`; a key sent as a bearer token is told `send the API key in X-API-Key, not in Authorization`), the key is unknown, revoked or expired (`Invalid API key`, `API key is not active`), or the key reached the other environment's API (a sandbox key sent to live, or a live key sent to the sandbox). Send the key unchanged in `X-API-Key` to the same base URL; the error says which.\n",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            },
+            "example": {
+              "success": false,
+              "code": 401,
+              "error": "Invalid API key"
+            }
+          }
+        }
+      },
+      "Forbidden": {
+        "description": "The key may not make this request: its scopes do not cover the operation (`Insufficient permissions`), or it is restricted to an IP allowlist or to referrers and the request came from elsewhere (`API key not allowed from this IP`, `Referrer not allowed`).\n",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            },
+            "example": {
+              "success": false,
+              "code": 403,
+              "error": "Insufficient permissions"
+            }
+          }
+        }
+      },
+      "EnvironmentResetting": {
+        "description": "`environment resetting`: the key's sandbox is being reset from the dashboard, and its keys act in nothing until the reset is done. Retry shortly. Live keys never get it.\n",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            },
+            "example": {
+              "success": false,
+              "code": 409,
+              "error": "environment resetting"
+            }
+          }
+        }
+      },
+      "TooManyRequests": {
+        "description": "`Too many requests`: the rate limit for this operation was reached for the current one-minute window. Wait `Retry-After` seconds.\n",
+        "headers": {
+          "X-RateLimit-Limit": {
+            "$ref": "#/components/headers/X-RateLimit-Limit"
+          },
+          "X-RateLimit-Remaining": {
+            "$ref": "#/components/headers/X-RateLimit-Remaining"
+          },
+          "X-RateLimit-Reset": {
+            "$ref": "#/components/headers/X-RateLimit-Reset"
+          },
+          "Retry-After": {
+            "$ref": "#/components/headers/Retry-After"
+          }
+        },
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            },
+            "example": {
+              "success": false,
+              "code": 429,
+              "error": "Too many requests"
+            }
+          }
+        }
+      },
+      "NotFound": {
+        "description": "The requested resource does not exist.",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            },
+            "example": {
+              "success": false,
+              "code": 404,
+              "error": "not found"
+            }
+          }
+        }
+      },
+      "ServerError": {
+        "description": "An unexpected error occurred on the server.",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            },
+            "example": {
+              "success": false,
+              "code": 500,
+              "error": "internal server error"
+            }
+          }
+        }
+      },
+      "NotASandbox": {
+        "description": "`not a sandbox environment`: the key is a live key. Every test helper answers a live key this way.\n",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            },
+            "example": {
+              "success": false,
+              "code": 404,
+              "error": "not a sandbox environment"
+            }
+          }
+        }
+      },
+      "SandboxBusy": {
+        "description": "`environment provisioning` or `environment resetting`: the sandbox is not ready yet or is being reset; retry shortly. A helper call may also answer `a request with this idempotency key is still in flight`, or `Idempotency key reused with different request` for a key first sent with another body.\n",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            },
+            "example": {
+              "success": false,
+              "code": 409,
+              "error": "environment resetting"
+            }
+          }
+        }
+      },
+      "TestHelperBadRequest": {
+        "description": "`idempotency key required`, `idempotency key too long` (over 255 characters) or `invalid request body`, or the request also sent `X-Stridge-Environment` (`environment header not accepted`).\n",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            },
+            "example": {
+              "success": false,
+              "code": 400,
+              "error": "idempotency key required"
+            }
+          }
+        }
+      },
+      "PayoutScopeRequired": {
+        "description": "The key lacks the `payout` scope, which the payout helpers require as creating a payout does.\n",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            },
+            "example": {
+              "success": false,
+              "code": 403,
+              "error": "Insufficient permissions"
+            }
+          }
+        }
+      },
+      "HeldPayoutNotFound": {
+        "description": "`not a sandbox environment` (the key is a live key) or `payout not found`.\n",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            },
+            "example": {
+              "success": false,
+              "code": 404,
+              "error": "payout not found"
+            }
+          }
+        }
+      },
+      "PayoutNotHeld": {
+        "description": "`payout not held`: no payout helper holds this payout, or it is already final; `details.state` is the payout's status. Also `environment provisioning`, `environment resetting`, or `a request with this idempotency key is still in flight`.\n",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            },
+            "example": {
+              "success": false,
+              "code": 409,
+              "error": "payout not held",
+              "details": {
+                "state": "confirmed"
+              }
+            }
+          }
+        }
+      },
+      "IdempotencyKeyReused": {
+        "description": "`idempotency key replayed with a different body`: the key was first used on another helper or for another payout.\n",
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/Error"
+            },
+            "example": {
+              "success": false,
+              "code": 422,
+              "error": "idempotency key replayed with a different body"
+            }
+          }
+        }
+      },
+      "SimulationBudgetExhausted": {
+        "description": "`simulation budget exhausted`: the sandbox spent its simulations for the current window (600 per hour). `details` carries `limit`, `window_s` and `retry_after_s`, and the `X-RateLimit-*` headers describe the simulation budget. The operation's own rate limit answers `Too many requests` instead, with the same headers describing that limit.\n",
+        "headers": {
+          "X-RateLimit-Limit": {
+            "description": "Simulations allowed per window.",
+            "schema": {
+              "type": "integer"
+            }
+          },
+          "X-RateLimit-Remaining": {
+            "description": "Simulations left in the current window.",
+            "schema": {
+              "type": "integer"
+            }
+          },
+          "X-RateLimit-Reset": {
+            "description": "When the window resets, as a Unix timestamp in seconds.",
+            "schema": {
+              "type": "integer"
+            }
+          },
+          "Retry-After": {
+            "description": "Seconds until a simulation can be made again.",
+            "schema": {
+              "type": "integer"
+            }
+          }
+        },
         "content": {
           "application/json": {
             "schema": {
@@ -1373,14 +2590,173 @@
             },
             "example": {
               "success": false,
-              "code": 500,
-              "error": "internal server error"
+              "code": 429,
+              "error": "simulation budget exhausted",
+              "details": {
+                "limit": 600,
+                "window_s": 3600,
+                "retry_after_s": 1200
+              }
+            }
+          }
+        }
+      },
+      "SimulationCreated": {
+        "description": "The lever was pulled; the simulation is answered at once, usually `running`. Read it back with `GET /test_helpers/simulations/{simulation_id}`.\n",
+        "headers": {
+          "Location": {
+            "description": "Where to read the simulation, relative to the base URL.",
+            "schema": {
+              "type": "string",
+              "example": "/test_helpers/simulations/0192f4c8-7a1e-7c3b-9d2a-5e6f7a8b9c0d"
+            }
+          },
+          "Idempotency-Replay": {
+            "description": "`true` when this answer is the replay of an earlier request with the same `Idempotency-Key`.",
+            "schema": {
+              "type": "string",
+              "enum": [
+                "true"
+              ]
+            }
+          }
+        },
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/SimulationResponse"
             }
           }
         }
       }
     },
+    "headers": {
+      "X-RateLimit-Limit": {
+        "description": "Requests allowed in the current window.",
+        "schema": {
+          "type": "integer",
+          "example": 720
+        }
+      },
+      "X-RateLimit-Remaining": {
+        "description": "Requests left in the current window.",
+        "schema": {
+          "type": "integer",
+          "example": 0
+        }
+      },
+      "X-RateLimit-Reset": {
+        "description": "When the window resets, as a Unix timestamp in seconds.",
+        "schema": {
+          "type": "integer",
+          "example": 1792913022
+        }
+      },
+      "Retry-After": {
+        "description": "Seconds to wait before retrying.",
+        "schema": {
+          "type": "integer",
+          "example": 42
+        }
+      }
+    },
     "schemas": {
+      "Livemode": {
+        "type": "boolean",
+        "description": "`true` when the API key that made the request acts in a live environment, `false` in a sandbox. It is on every object a keyed request answers with — the resource itself, each item of a list, and each object inside a list a resource carries — but not on the `success`/`message` envelope or on an object nested directly in another (such as `destination`, `fees` or `pagination`), so a payload read on its own still says which side of the boundary it came from. The two public endpoints answer without it. It is derived from the key at the time of the response and is never stored.\n",
+        "example": true
+      },
+      "WebhookEnvelope": {
+        "type": "object",
+        "description": "The signed body of every webhook delivery. Fields appear in this order.\n",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "The event's id.",
+            "example": "7401d9c7-e29d-4374-8952-af40f05168b7"
+          },
+          "version": {
+            "type": "string",
+            "description": "The envelope format version.",
+            "example": "1"
+          },
+          "type": {
+            "type": "string",
+            "description": "The event type.",
+            "enum": [
+              "wallet.address.assigned",
+              "transaction.event",
+              "deposit.confirmed",
+              "vault.deposit.detected",
+              "vault.created",
+              "gas_station.created",
+              "payout.confirmed",
+              "payout.failed",
+              "payout.expired",
+              "payout.retrying",
+              "uda.settlement.created",
+              "uda.settlement.completed",
+              "uda.settlement.retrying",
+              "uda.settlement.awaiting_credit",
+              "uda.settlement.failed",
+              "uda.address.created",
+              "treasury.created",
+              "treasury.rotated",
+              "treasury.deleted",
+              "webhook_endpoint.ping"
+            ],
+            "example": "uda.settlement.completed"
+          },
+          "time": {
+            "type": "string",
+            "description": "When the event happened, in UTC (`2006-01-02T15:04:05Z`).",
+            "example": "2026-10-24T11:59:25Z"
+          },
+          "livemode": {
+            "type": "boolean",
+            "description": "`true` for a live environment's event, `false` for a sandbox's.",
+            "example": true
+          },
+          "environment_id": {
+            "type": "string",
+            "description": "The environment the event belongs to. A live environment's id is its workspace's id.\n",
+            "example": "3f2c1d9e-8a47-4b6e-9c11-2d5e7f8a9b04"
+          },
+          "reset_epoch": {
+            "type": "integer",
+            "description": "Sandbox deliveries only: how many times the sandbox had been reset when the event was delivered. Absent on live deliveries. A delivery whose `reset_epoch` is lower than the sandbox's current one describes a world a reset has since emptied.\n",
+            "example": 2
+          },
+          "payload": {
+            "type": "object",
+            "description": "The event's data; its shape depends on `type`.",
+            "additionalProperties": true
+          }
+        },
+        "required": [
+          "id",
+          "version",
+          "type",
+          "time",
+          "livemode",
+          "environment_id",
+          "payload"
+        ],
+        "example": {
+          "id": "7401d9c7-e29d-4374-8952-af40f05168b7",
+          "version": "1",
+          "type": "uda.settlement.completed",
+          "time": "2026-10-24T11:59:25Z",
+          "livemode": false,
+          "environment_id": "3f2c1d9e-8a47-4b6e-9c11-2d5e7f8a9b04",
+          "reset_epoch": 2,
+          "payload": {
+            "id": "stl_71829304a5b6c7d8",
+            "uda_id": "uda_2f8c1a9d4e5f6071",
+            "status": "completed"
+          }
+        }
+      },
       "Error": {
         "type": "object",
         "description": "Canonical error envelope returned by every endpoint on failure.",
@@ -1398,6 +2774,11 @@
             "type": "string",
             "description": "Human-readable error message.",
             "example": "invalid request"
+          },
+          "details": {
+            "type": "object",
+            "description": "What a client needs to act on one particular refusal (for example `state` on `payout not held`, `payout_id` and `status` on a duplicate `reference_id`, or `limit`, `window_s` and `retry_after_s` on `simulation budget exhausted`). Absent from every error that has none.\n",
+            "additionalProperties": true
           }
         },
         "required": [
@@ -1425,49 +2806,243 @@
       "Pagination": {
         "type": "object",
         "properties": {
-          "count": {
-            "type": "integer",
-            "description": "Number of items in this page.",
-            "example": 20
+          "count": {
+            "type": "integer",
+            "description": "Number of items in this page.",
+            "example": 20
+          },
+          "limit": {
+            "type": "integer",
+            "example": 50
+          },
+          "offset": {
+            "type": "integer",
+            "example": 0
+          }
+        }
+      },
+      "DestinationInput": {
+        "type": "object",
+        "description": "Where settlements for this UDA should be delivered.",
+        "properties": {
+          "address": {
+            "type": "string",
+            "description": "Destination wallet address.",
+            "example": "0x3a1f8b2c9d4e5f60718293a4b5c6d7e8f9012345"
+          },
+          "network_id": {
+            "type": "string",
+            "description": "Destination SLIP-44 network id.",
+            "example": "60"
+          },
+          "asset_symbol": {
+            "type": "string",
+            "description": "Destination asset symbol.",
+            "example": "USDC"
+          }
+        },
+        "required": [
+          "address",
+          "network_id"
+        ]
+      },
+      "RoutingRuleMatchInput": {
+        "type": "object",
+        "description": "Conditions a deposit must meet for this routing rule to apply.",
+        "properties": {
+          "source_network_id": {
+            "type": "string",
+            "example": "60"
+          },
+          "source_asset_symbol": {
+            "type": "string",
+            "example": "USDT"
+          }
+        },
+        "required": [
+          "source_network_id"
+        ]
+      },
+      "RoutingRuleDestinationInput": {
+        "type": "object",
+        "properties": {
+          "address": {
+            "type": "string",
+            "example": "0x3a1f8b2c9d4e5f60718293a4b5c6d7e8f9012345"
+          },
+          "network_id": {
+            "type": "string",
+            "example": "60"
+          },
+          "asset_symbol": {
+            "type": "string",
+            "example": "USDC"
+          }
+        },
+        "required": [
+          "address",
+          "network_id"
+        ]
+      },
+      "RoutingRuleInput": {
+        "type": "object",
+        "properties": {
+          "match": {
+            "$ref": "#/components/schemas/RoutingRuleMatchInput"
+          },
+          "destination": {
+            "$ref": "#/components/schemas/RoutingRuleDestinationInput"
+          }
+        },
+        "required": [
+          "match",
+          "destination"
+        ]
+      },
+      "CreateUDAAddressRequest": {
+        "type": "object",
+        "properties": {
+          "owner": {
+            "type": "string",
+            "description": "The owner the UDA is allocated for.",
+            "example": "0x9f8e7d6c5b4a39281706f5e4d3c2b1a098765432"
+          },
+          "destination": {
+            "$ref": "#/components/schemas/DestinationInput"
+          },
+          "accepted_assets": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Asset symbols this UDA accepts; empty means every asset on every UDA-supported chain.",
+            "example": [
+              "USDC",
+              "USDT"
+            ]
+          },
+          "routing_rules": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/RoutingRuleInput"
+            },
+            "description": "Optional; max 3. Specificity-wins precedence: a rule pinning both `source_network_id` and `source_asset_symbol` beats a network-only rule. When nothing matches, settlements use the default destination.\n"
+          },
+          "routing_policy_id": {
+            "type": "string",
+            "description": "Routing policy to attach to this UDA. Omit or send an empty string to attach the tenant's default policy. Per-UDA inline `routing_rules` still take precedence over the policy.\n",
+            "example": "rpol_2f8c1a9d4e5f6071"
+          }
+        },
+        "required": [
+          "owner",
+          "destination"
+        ],
+        "example": {
+          "owner": "0x9f8e7d6c5b4a39281706f5e4d3c2b1a098765432",
+          "destination": {
+            "address": "0x3a1f8b2c9d4e5f60718293a4b5c6d7e8f9012345",
+            "network_id": "60",
+            "asset_symbol": "USDC"
+          },
+          "accepted_assets": [
+            "USDC",
+            "USDT"
+          ]
+        }
+      },
+      "DepositAsset": {
+        "type": "object",
+        "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
+          "symbol": {
+            "type": "string",
+            "example": "USDC"
+          },
+          "address": {
+            "type": "string",
+            "description": "Token contract address (zero address for native).",
+            "example": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+          },
+          "decimals": {
+            "type": "integer",
+            "example": 6
+          },
+          "logo": {
+            "type": "string",
+            "example": "https://assets.stridge.com/tokens/usdc.png"
+          }
+        }
+      },
+      "DepositAddress": {
+        "type": "object",
+        "description": "A per-chain address a depositor can send funds to.",
+        "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
           },
-          "limit": {
-            "type": "integer",
-            "example": 50
+          "address": {
+            "type": "string",
+            "example": "0x7c2d9a1b3e4f5061728394a5b6c7d8e9f0a1b2c3"
           },
-          "offset": {
-            "type": "integer",
-            "example": 0
+          "network_id": {
+            "type": "string",
+            "example": "60"
+          },
+          "eip155_id": {
+            "type": "string",
+            "example": "1"
+          },
+          "network_name": {
+            "type": "string",
+            "example": "Ethereum"
+          },
+          "accepted_assets": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/DepositAsset"
+            }
           }
         }
       },
-      "DestinationInput": {
+      "Destination": {
         "type": "object",
-        "description": "Where settlements for this UDA should be delivered.",
+        "description": "Resolved destination (symbol plus the resolved contract address).",
         "properties": {
           "address": {
             "type": "string",
-            "description": "Destination wallet address.",
             "example": "0x3a1f8b2c9d4e5f60718293a4b5c6d7e8f9012345"
           },
           "network_id": {
             "type": "string",
-            "description": "Destination SLIP-44 network id.",
             "example": "60"
           },
+          "eip155_id": {
+            "type": "string",
+            "example": "1"
+          },
+          "network_name": {
+            "type": "string",
+            "example": "Ethereum"
+          },
           "asset_symbol": {
             "type": "string",
-            "description": "Destination asset symbol.",
             "example": "USDC"
+          },
+          "asset_address": {
+            "type": "string",
+            "example": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+          },
+          "asset_decimals": {
+            "type": "integer",
+            "example": 6
           }
-        },
-        "required": [
-          "address",
-          "network_id"
-        ]
+        }
       },
-      "RoutingRuleMatchInput": {
+      "RoutingRuleMatch": {
         "type": "object",
-        "description": "Conditions a deposit must meet for this routing rule to apply.",
         "properties": {
           "source_network_id": {
             "type": "string",
@@ -1476,13 +3051,14 @@
           "source_asset_symbol": {
             "type": "string",
             "example": "USDT"
+          },
+          "source_token_address": {
+            "type": "string",
+            "example": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
           }
-        },
-        "required": [
-          "source_network_id"
-        ]
+        }
       },
-      "RoutingRuleDestinationInput": {
+      "RoutingRuleDestination": {
         "type": "object",
         "properties": {
           "address": {
@@ -1493,152 +3069,297 @@
             "type": "string",
             "example": "60"
           },
+          "eip155_id": {
+            "type": "string",
+            "example": "1"
+          },
+          "network_name": {
+            "type": "string",
+            "example": "Ethereum"
+          },
           "asset_symbol": {
             "type": "string",
             "example": "USDC"
+          },
+          "asset_address": {
+            "type": "string",
+            "example": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+          },
+          "asset_decimals": {
+            "type": "integer",
+            "example": 6
           }
-        },
-        "required": [
-          "address",
-          "network_id"
-        ]
+        }
       },
-      "RoutingRuleInput": {
+      "RoutingRule": {
         "type": "object",
+        "description": "An echoed routing rule in dual form (symbol plus resolved contract address).",
         "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
           "match": {
-            "$ref": "#/components/schemas/RoutingRuleMatchInput"
+            "$ref": "#/components/schemas/RoutingRuleMatch"
           },
           "destination": {
-            "$ref": "#/components/schemas/RoutingRuleDestinationInput"
+            "$ref": "#/components/schemas/RoutingRuleDestination"
           }
-        },
-        "required": [
-          "match",
-          "destination"
-        ]
+        }
       },
-      "CreateUDAAddressRequest": {
+      "UDAAddress": {
         "type": "object",
         "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
+          "id": {
+            "type": "string",
+            "example": "uda_2f8c1a9d4e5f6071"
+          },
           "owner": {
             "type": "string",
-            "description": "The owner the UDA is allocated for.",
             "example": "0x9f8e7d6c5b4a39281706f5e4d3c2b1a098765432"
           },
+          "status": {
+            "type": "string",
+            "enum": [
+              "active",
+              "retired"
+            ],
+            "example": "active"
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time",
+            "example": "2026-05-20T14:03:12Z"
+          },
           "destination": {
-            "$ref": "#/components/schemas/DestinationInput"
+            "$ref": "#/components/schemas/Destination"
           },
-          "accepted_assets": {
+          "deposit_addresses": {
             "type": "array",
             "items": {
-              "type": "string"
-            },
-            "description": "Asset symbols this UDA accepts; empty means every asset on every UDA-supported chain.",
-            "example": [
-              "USDC",
-              "USDT"
-            ]
+              "$ref": "#/components/schemas/DepositAddress"
+            }
           },
           "routing_rules": {
             "type": "array",
+            "description": "Empty when no rules are configured.",
             "items": {
-              "$ref": "#/components/schemas/RoutingRuleInput"
-            },
-            "description": "Optional; max 3. Specificity-wins precedence: a rule pinning both `source_network_id` and `source_asset_symbol` beats a network-only rule. When nothing matches, settlements use the default destination.\n"
+              "$ref": "#/components/schemas/RoutingRule"
+            }
           },
           "routing_policy_id": {
             "type": "string",
-            "description": "Routing policy to attach to this UDA. Omit or send an empty string to attach the tenant's default policy. Per-UDA inline `routing_rules` still take precedence over the policy.\n",
+            "description": "The routing policy attached to this UDA, when set. Omitted for legacy UDAs that inherit the tenant default policy.\n",
             "example": "rpol_2f8c1a9d4e5f6071"
           }
-        },
-        "required": [
-          "owner",
-          "destination"
-        ],
-        "example": {
-          "owner": "0x9f8e7d6c5b4a39281706f5e4d3c2b1a098765432",
-          "destination": {
-            "address": "0x3a1f8b2c9d4e5f60718293a4b5c6d7e8f9012345",
-            "network_id": "60",
-            "asset_symbol": "USDC"
+        }
+      },
+      "RoutingPolicy": {
+        "type": "object",
+        "description": "A tenant-scoped, ordered routing-policy. Rules are evaluated first-match-wins; an empty rule set falls through to the UDA's default destination.\n",
+        "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
           },
-          "accepted_assets": [
-            "USDC",
-            "USDT"
-          ]
+          "id": {
+            "type": "string",
+            "example": "rpol_2f8c1a9d4e5f6071"
+          },
+          "name": {
+            "type": "string",
+            "example": "vip_tier"
+          },
+          "is_default": {
+            "type": "boolean",
+            "description": "Whether this is the tenant's default policy (one per tenant).",
+            "example": false
+          },
+          "rules": {
+            "type": "array",
+            "description": "Ordered, first-match-wins routing rules (dual form).",
+            "items": {
+              "$ref": "#/components/schemas/RoutingRule"
+            }
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time",
+            "example": "2026-05-20T14:03:12Z"
+          },
+          "updated_at": {
+            "type": "string",
+            "format": "date-time",
+            "example": "2026-05-20T14:03:12Z"
+          }
+        }
+      },
+      "RoutingPolicyResponse": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/RoutingPolicy"
+          }
+        }
+      },
+      "RoutingPolicyList": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/RoutingPolicy"
+            }
+          },
+          "pagination": {
+            "$ref": "#/components/schemas/PagePagination"
+          }
+        }
+      },
+      "UDAAddressList": {
+        "type": "object",
+        "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
+          "data": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/UDAAddress"
+            }
+          },
+          "pagination": {
+            "$ref": "#/components/schemas/Pagination"
+          }
+        }
+      },
+      "QuoteSide": {
+        "type": "object",
+        "properties": {
+          "network_id": {
+            "type": "integer",
+            "description": "EIP-155 chain id for this side.",
+            "example": 1
+          },
+          "asset_address": {
+            "type": "string",
+            "example": "0x0000000000000000000000000000000000000000"
+          },
+          "amount": {
+            "type": "string",
+            "description": "Amount in the asset's smallest unit.",
+            "example": "1000000000000000000"
+          }
         }
       },
-      "DepositAsset": {
+      "QuoteFeeItem": {
         "type": "object",
         "properties": {
-          "symbol": {
+          "kind": {
             "type": "string",
-            "example": "USDC"
+            "example": "platform"
           },
-          "address": {
+          "amount": {
             "type": "string",
-            "description": "Token contract address (zero address for native).",
-            "example": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+            "example": "2500000000000000"
           },
-          "decimals": {
-            "type": "integer",
-            "example": 6
+          "source": {
+            "type": "string",
+            "example": "stridge"
           },
-          "logo": {
+          "recipient": {
             "type": "string",
-            "example": "https://assets.stridge.com/tokens/usdc.png"
+            "example": "0xfee0000000000000000000000000000000000000"
           }
         }
       },
-      "DepositAddress": {
+      "QuoteFees": {
         "type": "object",
-        "description": "A per-chain address a depositor can send funds to.",
         "properties": {
-          "address": {
+          "total_fee": {
             "type": "string",
-            "example": "0x7c2d9a1b3e4f5061728394a5b6c7d8e9f0a1b2c3"
+            "example": "3500000000000000"
           },
-          "network_id": {
+          "gas_fee": {
             "type": "string",
-            "example": "60"
+            "example": "1000000000000000"
           },
-          "eip155_id": {
+          "network_reserve": {
             "type": "string",
-            "example": "1"
+            "description": "Chain-level reserve (e.g. TRON bandwidth).",
+            "example": "0"
           },
-          "network_name": {
+          "platform_fee": {
             "type": "string",
-            "example": "Ethereum"
+            "example": "2500000000000000"
           },
-          "accepted_assets": {
+          "provider_fee": {
+            "type": "string",
+            "description": "Third-party (e.g. LiFi / Relay) fee.",
+            "example": "0"
+          },
+          "items": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/DepositAsset"
+              "$ref": "#/components/schemas/QuoteFeeItem"
             }
           }
         }
       },
-      "Destination": {
+      "QuoteRoute": {
         "type": "object",
-        "description": "Resolved destination (symbol plus the resolved contract address).",
         "properties": {
-          "address": {
+          "provider": {
             "type": "string",
-            "example": "0x3a1f8b2c9d4e5f60718293a4b5c6d7e8f9012345"
+            "example": "lifi"
           },
-          "network_id": {
+          "scenario": {
             "type": "string",
-            "example": "60"
+            "example": "cross_chain_swap"
           },
-          "eip155_id": {
+          "estimated_time_seconds": {
+            "type": "integer",
+            "example": 45
+          }
+        }
+      },
+      "Quote": {
+        "type": "object",
+        "properties": {
+          "from": {
+            "$ref": "#/components/schemas/QuoteSide"
+          },
+          "to": {
+            "$ref": "#/components/schemas/QuoteSide"
+          },
+          "exchange_rate": {
             "type": "string",
-            "example": "1"
+            "example": "0.9985"
           },
-          "network_name": {
+          "expires_at": {
             "type": "string",
-            "example": "Ethereum"
+            "format": "date-time",
+            "example": "2026-05-29T12:05:00Z"
+          },
+          "fees": {
+            "$ref": "#/components/schemas/QuoteFees"
+          },
+          "route": {
+            "$ref": "#/components/schemas/QuoteRoute"
+          }
+        }
+      },
+      "SettlementDeposit": {
+        "type": "object",
+        "properties": {
+          "address": {
+            "type": "string",
+            "example": "0x7c2d9a1b3e4f5061728394a5b6c7d8e9f0a1b2c3"
+          },
+          "amount": {
+            "type": "string",
+            "example": "1000000"
           },
           "asset_symbol": {
             "type": "string",
@@ -1648,47 +3369,35 @@
             "type": "string",
             "example": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
           },
-          "asset_decimals": {
+          "network_id": {
             "type": "integer",
-            "example": 6
-          }
-        }
-      },
-      "RoutingRuleMatch": {
-        "type": "object",
-        "properties": {
-          "source_network_id": {
+            "example": 1
+          },
+          "network_name": {
             "type": "string",
-            "example": "60"
+            "example": "Ethereum"
           },
-          "source_asset_symbol": {
+          "tx_hash": {
             "type": "string",
-            "example": "USDT"
+            "example": "0xab12cd34ef56...7890"
           },
-          "source_token_address": {
+          "confirmed_at": {
             "type": "string",
-            "example": "0xdAC17F958D2ee523a2206206994597C13D831ec7"
+            "format": "date-time",
+            "example": "2026-05-29T11:58:40Z"
           }
         }
       },
-      "RoutingRuleDestination": {
+      "SettlementOutbound": {
         "type": "object",
         "properties": {
           "address": {
             "type": "string",
             "example": "0x3a1f8b2c9d4e5f60718293a4b5c6d7e8f9012345"
           },
-          "network_id": {
-            "type": "string",
-            "example": "60"
-          },
-          "eip155_id": {
-            "type": "string",
-            "example": "1"
-          },
-          "network_name": {
+          "amount": {
             "type": "string",
-            "example": "Ethereum"
+            "example": "998500"
           },
           "asset_symbol": {
             "type": "string",
@@ -1696,130 +3405,130 @@
           },
           "asset_address": {
             "type": "string",
-            "example": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+            "example": "0x55d398326f99059fF775485246999027B3197955"
           },
-          "asset_decimals": {
+          "network_id": {
             "type": "integer",
-            "example": 6
-          }
-        }
-      },
-      "RoutingRule": {
-        "type": "object",
-        "description": "An echoed routing rule in dual form (symbol plus resolved contract address).",
-        "properties": {
-          "match": {
-            "$ref": "#/components/schemas/RoutingRuleMatch"
+            "example": 56
           },
-          "destination": {
-            "$ref": "#/components/schemas/RoutingRuleDestination"
+          "network_name": {
+            "type": "string",
+            "example": "BNB Smart Chain"
+          },
+          "tx_hash": {
+            "type": "string",
+            "example": "0xcd34ef5678...90ab"
+          },
+          "settled_at": {
+            "type": "string",
+            "format": "date-time",
+            "example": "2026-05-29T11:59:25Z"
           }
         }
       },
-      "UDAAddress": {
+      "SettlementFees": {
         "type": "object",
         "properties": {
-          "id": {
+          "total": {
             "type": "string",
-            "example": "uda_2f8c1a9d4e5f6071"
+            "example": "1500"
           },
-          "owner": {
+          "platform": {
             "type": "string",
-            "example": "0x9f8e7d6c5b4a39281706f5e4d3c2b1a098765432"
+            "example": "1500"
           },
-          "status": {
+          "provider": {
             "type": "string",
-            "enum": [
-              "active",
-              "retired"
-            ],
-            "example": "active"
+            "example": "0"
           },
-          "created_at": {
+          "fee_amount": {
             "type": "string",
-            "format": "date-time",
-            "example": "2026-05-20T14:03:12Z"
-          },
-          "destination": {
-            "$ref": "#/components/schemas/Destination"
-          },
-          "deposit_addresses": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/DepositAddress"
-            }
-          },
-          "routing_rules": {
-            "type": "array",
-            "description": "Empty when no rules are configured.",
-            "items": {
-              "$ref": "#/components/schemas/RoutingRule"
-            }
+            "description": "Equal to `total` (back-compat field).",
+            "example": "1500"
+          }
+        }
+      },
+      "SettlementRoute": {
+        "type": "object",
+        "properties": {
+          "provider": {
+            "type": "string",
+            "example": "lifi"
           },
-          "routing_policy_id": {
+          "type": {
             "type": "string",
-            "description": "The routing policy attached to this UDA, when set. Omitted for legacy UDAs that inherit the tenant default policy.\n",
-            "example": "rpol_2f8c1a9d4e5f6071"
+            "example": "cross_chain_swap"
+          },
+          "time_ms": {
+            "type": "integer",
+            "example": 45000
           }
         }
       },
-      "RoutingPolicy": {
+      "Settlement": {
         "type": "object",
-        "description": "A tenant-scoped, ordered routing-policy. Rules are evaluated first-match-wins; an empty rule set falls through to the UDA's default destination.\n",
         "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
           "id": {
             "type": "string",
-            "example": "rpol_2f8c1a9d4e5f6071"
+            "example": "stl_71829304a5b6c7d8"
           },
-          "name": {
+          "uda_id": {
             "type": "string",
-            "example": "vip_tier"
-          },
-          "is_default": {
-            "type": "boolean",
-            "description": "Whether this is the tenant's default policy (one per tenant).",
-            "example": false
+            "example": "uda_2f8c1a9d4e5f6071"
           },
-          "rules": {
-            "type": "array",
-            "description": "Ordered, first-match-wins routing rules (dual form).",
-            "items": {
-              "$ref": "#/components/schemas/RoutingRule"
-            }
+          "status": {
+            "type": "string",
+            "enum": [
+              "created",
+              "routing",
+              "completed",
+              "failed",
+              "retrying"
+            ],
+            "example": "completed"
           },
           "created_at": {
             "type": "string",
             "format": "date-time",
-            "example": "2026-05-20T14:03:12Z"
+            "example": "2026-05-29T11:58:41Z"
           },
           "updated_at": {
             "type": "string",
             "format": "date-time",
-            "example": "2026-05-20T14:03:12Z"
-          }
-        }
-      },
-      "RoutingPolicyList": {
-        "type": "object",
-        "properties": {
-          "data": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/RoutingPolicy"
-            }
+            "example": "2026-05-29T11:59:25Z"
           },
-          "pagination": {
-            "$ref": "#/components/schemas/Pagination"
+          "error": {
+            "type": "string",
+            "description": "Failure reason when `status` is `failed`; empty otherwise.",
+            "example": ""
+          },
+          "deposit": {
+            "$ref": "#/components/schemas/SettlementDeposit"
+          },
+          "settlement": {
+            "$ref": "#/components/schemas/SettlementOutbound"
+          },
+          "fees": {
+            "$ref": "#/components/schemas/SettlementFees"
+          },
+          "route": {
+            "$ref": "#/components/schemas/SettlementRoute"
           }
         }
       },
-      "UDAAddressList": {
+      "SettlementList": {
         "type": "object",
         "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
           "data": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/UDAAddress"
+              "$ref": "#/components/schemas/Settlement"
             }
           },
           "pagination": {
@@ -1827,514 +3536,595 @@
           }
         }
       },
-      "QuoteSide": {
-        "type": "object",
-        "properties": {
-          "network_id": {
-            "type": "integer",
-            "description": "EIP-155 chain id for this side.",
-            "example": 1
-          },
-          "asset_address": {
-            "type": "string",
-            "example": "0x0000000000000000000000000000000000000000"
-          },
-          "amount": {
-            "type": "string",
-            "description": "Amount in the asset's smallest unit.",
-            "example": "1000000000000000000"
-          }
-        }
-      },
-      "QuoteFeeItem": {
+      "SettlementsByReference": {
         "type": "object",
         "properties": {
-          "kind": {
-            "type": "string",
-            "example": "platform"
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
           },
-          "amount": {
+          "reference": {
             "type": "string",
-            "example": "2500000000000000"
+            "description": "The reference that was looked up.",
+            "example": "0xab12cd34ef56...7890"
           },
-          "source": {
-            "type": "string",
-            "example": "stridge"
+          "count": {
+            "type": "integer",
+            "example": 1
           },
-          "recipient": {
-            "type": "string",
-            "example": "0xfee0000000000000000000000000000000000000"
+          "data": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Settlement"
+            }
           }
         }
       },
-      "QuoteFees": {
+      "NativeCurrency": {
         "type": "object",
         "properties": {
-          "total_fee": {
+          "symbol": {
             "type": "string",
-            "example": "3500000000000000"
+            "example": "ETH"
           },
-          "gas_fee": {
+          "name": {
             "type": "string",
-            "example": "1000000000000000"
+            "example": "Ether"
           },
-          "network_reserve": {
+          "decimals": {
+            "type": "integer",
+            "example": 18
+          },
+          "logo": {
             "type": "string",
-            "description": "Chain-level reserve (e.g. TRON bandwidth).",
-            "example": "0"
+            "example": "https://assets.stridge.com/tokens/eth.png"
           },
-          "platform_fee": {
+          "min_deposit_usd": {
             "type": "string",
-            "example": "2500000000000000"
+            "example": "1.00"
           },
-          "provider_fee": {
+          "price_impact": {
             "type": "string",
-            "description": "Third-party (e.g. LiFi / Relay) fee.",
             "example": "0"
-          },
-          "items": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/QuoteFeeItem"
-            }
           }
         }
       },
-      "QuoteRoute": {
+      "AssetInfo": {
         "type": "object",
         "properties": {
-          "provider": {
+          "symbol": {
             "type": "string",
-            "example": "lifi"
+            "example": "USDC"
           },
-          "scenario": {
+          "name": {
             "type": "string",
-            "example": "cross_chain_swap"
+            "example": "USD Coin"
           },
-          "estimated_time_seconds": {
-            "type": "integer",
-            "example": 45
-          }
-        }
-      },
-      "Quote": {
-        "type": "object",
-        "properties": {
-          "from": {
-            "$ref": "#/components/schemas/QuoteSide"
+          "address": {
+            "type": "string",
+            "example": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
           },
-          "to": {
-            "$ref": "#/components/schemas/QuoteSide"
+          "decimals": {
+            "type": "integer",
+            "example": 6
           },
-          "exchange_rate": {
+          "logo": {
             "type": "string",
-            "example": "0.9985"
+            "example": "https://assets.stridge.com/tokens/usdc.png"
           },
-          "expires_at": {
+          "min_deposit_usd": {
             "type": "string",
-            "format": "date-time",
-            "example": "2026-05-29T12:05:00Z"
-          },
-          "fees": {
-            "$ref": "#/components/schemas/QuoteFees"
+            "example": "1.00"
           },
-          "route": {
-            "$ref": "#/components/schemas/QuoteRoute"
+          "price_impact": {
+            "type": "string",
+            "example": "0"
           }
         }
       },
-      "SettlementDeposit": {
+      "SupportedAssetChain": {
         "type": "object",
         "properties": {
-          "address": {
-            "type": "string",
-            "example": "0x7c2d9a1b3e4f5061728394a5b6c7d8e9f0a1b2c3"
-          },
-          "amount": {
+          "network_id": {
             "type": "string",
-            "example": "1000000"
+            "example": "60"
           },
-          "asset_symbol": {
+          "network_name": {
             "type": "string",
-            "example": "USDC"
+            "example": "Ethereum"
           },
-          "asset_address": {
+          "network_symbol": {
             "type": "string",
-            "example": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+            "example": "ETH"
           },
-          "network_id": {
+          "eip155_id": {
             "type": "integer",
+            "description": "Chain-specific numeric id: the EIP-155 chain id for EVM networks (Tempo is `4217`), or the analogous numeric chain id Stridge uses for non-EVM networks (TVM, SVM, Bitcoin). Always present.\n",
             "example": 1
           },
-          "network_name": {
+          "chain_type": {
             "type": "string",
-            "example": "Ethereum"
+            "enum": [
+              "EVM",
+              "TVM",
+              "SVM",
+              "BITCOIN"
+            ],
+            "description": "The network's chain family: `EVM` (Ethereum, BNB Smart Chain, Polygon, Arbitrum, Base, Optimism, Tempo), `TVM` (Tron), `SVM` (Solana) or `BITCOIN` (Bitcoin).\n",
+            "example": "EVM"
           },
-          "tx_hash": {
-            "type": "string",
-            "example": "0xab12cd34ef56...7890"
+          "native_currency": {
+            "$ref": "#/components/schemas/NativeCurrency"
           },
-          "confirmed_at": {
-            "type": "string",
-            "format": "date-time",
-            "example": "2026-05-29T11:58:40Z"
+          "assets": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/AssetInfo"
+            }
           }
         }
       },
-      "SettlementOutbound": {
+      "SupportedAssetsResponse": {
         "type": "object",
         "properties": {
-          "address": {
-            "type": "string",
-            "example": "0x3a1f8b2c9d4e5f60718293a4b5c6d7e8f9012345"
-          },
-          "amount": {
-            "type": "string",
-            "example": "998500"
-          },
-          "asset_symbol": {
-            "type": "string",
-            "example": "USDC"
+          "assets": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SupportedAssetChain"
+            }
+          }
+        }
+      },
+      "PagePagination": {
+        "type": "object",
+        "description": "Page-based pagination metadata returned by the payout, gas-station, routing-policy and simulation lists.",
+        "properties": {
+          "page": {
+            "type": "integer",
+            "example": 1
           },
-          "asset_address": {
-            "type": "string",
-            "example": "0x55d398326f99059fF775485246999027B3197955"
+          "limit": {
+            "type": "integer",
+            "example": 20
           },
-          "network_id": {
+          "total_items": {
             "type": "integer",
-            "example": 56
+            "example": 100
           },
-          "network_name": {
-            "type": "string",
-            "example": "BNB Smart Chain"
+          "total_pages": {
+            "type": "integer",
+            "example": 5
           },
-          "tx_hash": {
-            "type": "string",
-            "example": "0xcd34ef5678...90ab"
+          "has_next": {
+            "type": "boolean",
+            "example": true
           },
-          "settled_at": {
-            "type": "string",
-            "format": "date-time",
-            "example": "2026-05-29T11:59:25Z"
+          "has_prev": {
+            "type": "boolean",
+            "example": false
           }
         }
       },
-      "SettlementFees": {
+      "MoneyValue": {
         "type": "object",
+        "description": "A single balance rendered in human, raw, and USD forms.",
         "properties": {
-          "total": {
-            "type": "string",
-            "example": "1500"
-          },
-          "platform": {
+          "amount": {
             "type": "string",
-            "example": "1500"
+            "description": "Human-readable amount (already divided by decimals).",
+            "example": "1.5"
           },
-          "provider": {
+          "raw": {
             "type": "string",
-            "example": "0"
+            "description": "Amount in the asset's smallest unit.",
+            "example": "1000000000000000000"
           },
-          "fee_amount": {
+          "usd": {
             "type": "string",
-            "description": "Equal to `total` (back-compat field).",
-            "example": "1500"
+            "description": "Indicative USD value.",
+            "example": "3500.00"
           }
         }
       },
-      "SettlementRoute": {
+      "Vault": {
         "type": "object",
         "properties": {
-          "provider": {
-            "type": "string",
-            "example": "lifi"
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
           },
-          "type": {
+          "id": {
             "type": "string",
-            "example": "cross_chain_swap"
+            "example": "550e8400-e29b-41d4-a716-446655440000"
           },
-          "time_ms": {
-            "type": "integer",
-            "example": 45000
+          "label": {
+            "type": "string",
+            "description": "Human-readable vault name.",
+            "example": "hot"
           }
         }
       },
-      "Settlement": {
+      "VaultList": {
         "type": "object",
         "properties": {
-          "id": {
+          "data": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/Vault"
+            }
+          }
+        }
+      },
+      "VaultAddress": {
+        "type": "object",
+        "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
+          "address": {
             "type": "string",
-            "example": "stl_71829304a5b6c7d8"
+            "example": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD58"
           },
-          "uda_id": {
+          "network_id": {
             "type": "string",
-            "example": "uda_2f8c1a9d4e5f6071"
+            "example": "60"
           },
-          "status": {
+          "network_symbol": {
             "type": "string",
-            "enum": [
-              "created",
-              "routing",
-              "completed",
-              "failed",
-              "retrying"
-            ],
-            "example": "completed"
+            "example": "ETH"
           },
           "created_at": {
             "type": "string",
             "format": "date-time",
-            "example": "2026-05-29T11:58:41Z"
+            "example": "2024-01-01T00:00:00Z"
+          }
+        }
+      },
+      "VaultAddressList": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "type": "object",
+            "properties": {
+              "livemode": {
+                "$ref": "#/components/schemas/Livemode"
+              },
+              "addresses": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/VaultAddress"
+                }
+              }
+            }
+          }
+        }
+      },
+      "VaultAddressResponse": {
+        "type": "object",
+        "properties": {
+          "data": {
+            "$ref": "#/components/schemas/VaultAddress"
+          }
+        }
+      },
+      "VaultBalance": {
+        "type": "object",
+        "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
           },
-          "updated_at": {
+          "asset": {
             "type": "string",
-            "format": "date-time",
-            "example": "2026-05-29T11:59:25Z"
+            "example": "Ethereum"
           },
-          "error": {
+          "network_id": {
             "type": "string",
-            "description": "Failure reason when `status` is `failed`; empty otherwise.",
-            "example": ""
+            "example": "60"
           },
-          "deposit": {
-            "$ref": "#/components/schemas/SettlementDeposit"
+          "network_symbol": {
+            "type": "string",
+            "example": "ETH"
           },
-          "settlement": {
-            "$ref": "#/components/schemas/SettlementOutbound"
+          "raw_value": {
+            "type": "string",
+            "description": "Balance in the asset's smallest unit.",
+            "example": "1000000000000000000"
           },
-          "fees": {
-            "$ref": "#/components/schemas/SettlementFees"
+          "raw_value_decimals": {
+            "type": "integer",
+            "example": 18
           },
-          "route": {
-            "$ref": "#/components/schemas/SettlementRoute"
+          "display_values": {
+            "$ref": "#/components/schemas/MoneyValue"
           }
         }
       },
-      "SettlementList": {
+      "VaultBalancesResponse": {
         "type": "object",
         "properties": {
           "data": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/Settlement"
+            "type": "object",
+            "properties": {
+              "livemode": {
+                "$ref": "#/components/schemas/Livemode"
+              },
+              "balances": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/VaultBalance"
+                }
+              }
             }
-          },
-          "pagination": {
-            "$ref": "#/components/schemas/Pagination"
           }
         }
       },
-      "SettlementsByReference": {
+      "VaultTotal": {
         "type": "object",
         "properties": {
-          "reference": {
-            "type": "string",
-            "description": "The reference that was looked up.",
-            "example": "0xab12cd34ef56...7890"
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
           },
-          "count": {
-            "type": "integer",
-            "example": 1
+          "total_usd": {
+            "type": "string",
+            "description": "Combined USD value of every asset in the vault.",
+            "example": "25000.00"
           },
-          "data": {
+          "included_currency": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/Settlement"
-            }
+              "type": "string"
+            },
+            "example": [
+              "ETH",
+              "USDT"
+            ]
           }
         }
       },
-      "NativeCurrency": {
+      "VaultTotalResponse": {
         "type": "object",
         "properties": {
-          "symbol": {
+          "data": {
+            "$ref": "#/components/schemas/VaultTotal"
+          }
+        }
+      },
+      "CreatePayoutRequest": {
+        "type": "object",
+        "description": "A payout from a vault to an external address. Provide either `amount` or `usd_amount`, not both.\n",
+        "properties": {
+          "vault_id": {
             "type": "string",
-            "example": "ETH"
+            "description": "The vault the funds leave from.",
+            "example": "550e8400-e29b-41d4-a716-446655440001"
           },
-          "name": {
+          "asset": {
             "type": "string",
-            "example": "Ether"
+            "description": "Asset symbol to send.",
+            "example": "USDT"
           },
-          "decimals": {
-            "type": "integer",
-            "example": 18
+          "network_symbol": {
+            "type": "string",
+            "description": "Network slug (e.g. `ethereum`, `tron`, `solana`, `bitcoin`, `tempo`).",
+            "example": "ethereum"
           },
-          "logo": {
+          "to_address": {
             "type": "string",
-            "example": "https://assets.stridge.com/tokens/eth.png"
+            "description": "External destination address.",
+            "example": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B"
           },
-          "min_deposit_usd": {
+          "reference_id": {
             "type": "string",
-            "example": "1.00"
+            "description": "Your idempotency key — unique per vault.",
+            "example": "order-12345"
           },
-          "price_impact": {
+          "amount": {
             "type": "string",
-            "example": "0"
+            "description": "Crypto amount; provide either `amount` or `usd_amount`.",
+            "example": "100.50"
+          },
+          "usd_amount": {
+            "type": "string",
+            "description": "USD amount; converted to crypto at the current rate.",
+            "example": "50.00"
+          },
+          "remark": {
+            "type": "string",
+            "description": "Free-form note stored on the payout.",
+            "example": "Payment for order #12345"
+          },
+          "type": {
+            "type": "string",
+            "enum": [
+              "normal",
+              "forceful"
+            ],
+            "default": "normal",
+            "description": "Payout strategy. `normal` (default) refills gas when needed and retries until `expired_at`. `forceful` still refills when needed but is single-attempt — the refill and the transfer are each tried once, with no retry and no `expired_at`; it fails immediately if either can't complete.\n"
+          },
+          "expired_at": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Cutoff after which a non-confirmed payout expires. Defaults to 1 hour from creation; capped at 12 hours ahead. Ignored for `forceful` payouts.\n",
+            "example": "2026-01-01T01:00:00Z"
           }
+        },
+        "required": [
+          "vault_id",
+          "asset",
+          "network_symbol",
+          "to_address",
+          "reference_id"
+        ],
+        "example": {
+          "vault_id": "550e8400-e29b-41d4-a716-446655440001",
+          "asset": "USDT",
+          "network_symbol": "ethereum",
+          "to_address": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B",
+          "reference_id": "order-12345",
+          "amount": "100.50",
+          "remark": "Payment for order #12345",
+          "type": "normal",
+          "expired_at": "2026-01-01T01:00:00Z"
         }
       },
-      "AssetInfo": {
+      "Payout": {
         "type": "object",
         "properties": {
-          "symbol": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
+          "id": {
             "type": "string",
-            "example": "USDC"
+            "example": "550e8400-e29b-41d4-a716-446655440000"
           },
-          "name": {
+          "vault_id": {
             "type": "string",
-            "example": "USD Coin"
+            "example": "550e8400-e29b-41d4-a716-446655440001"
           },
-          "address": {
+          "asset": {
             "type": "string",
-            "example": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
+            "example": "USDT"
           },
-          "decimals": {
-            "type": "integer",
-            "example": 6
+          "network_symbol": {
+            "type": "string",
+            "example": "ethereum"
           },
-          "logo": {
+          "amount": {
             "type": "string",
-            "example": "https://assets.stridge.com/tokens/usdc.png"
+            "description": "Crypto amount sent.",
+            "example": "100.50"
           },
-          "min_deposit_usd": {
+          "usd_amount": {
             "type": "string",
-            "example": "1.00"
+            "description": "USD value at submit time.",
+            "example": "100.50"
           },
-          "price_impact": {
+          "rate": {
             "type": "string",
-            "example": "0"
-          }
-        }
-      },
-      "SupportedAssetChain": {
-        "type": "object",
-        "properties": {
-          "network_id": {
+            "description": "Conversion rate applied when `usd_amount` was used.",
+            "example": "1.0001"
+          },
+          "to_address": {
             "type": "string",
-            "example": "60"
+            "example": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B"
           },
-          "network_name": {
+          "reference_id": {
             "type": "string",
-            "example": "Ethereum"
+            "example": "order-12345"
           },
-          "network_symbol": {
+          "remark": {
             "type": "string",
-            "example": "ETH"
+            "example": "Payment for order #12345"
           },
-          "eip155_id": {
-            "type": "integer",
-            "description": "Chain-specific numeric id: the EIP-155 chain id for EVM networks, or the analogous numeric chain id Stridge uses for non-EVM (TVM, SVM) networks. Always present.\n",
-            "example": 1
+          "type": {
+            "type": "string",
+            "enum": [
+              "normal",
+              "forceful"
+            ],
+            "description": "Payout strategy the payout was created with.",
+            "example": "normal"
           },
-          "chain_type": {
+          "status": {
             "type": "string",
             "enum": [
-              "EVM",
-              "TVM",
-              "SVM"
+              "queued",
+              "processing",
+              "confirmed",
+              "failed",
+              "expired"
             ],
-            "example": "EVM"
+            "example": "confirmed"
           },
-          "native_currency": {
-            "$ref": "#/components/schemas/NativeCurrency"
+          "tx_id": {
+            "type": "string",
+            "description": "On-chain transaction hash; empty until broadcast.",
+            "example": "0xabc123def456789"
           },
-          "assets": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/AssetInfo"
-            }
+          "error": {
+            "type": "string",
+            "description": "Failure reason when `status` is `failed`; empty otherwise.",
+            "example": ""
+          },
+          "created_at": {
+            "type": "string",
+            "format": "date-time",
+            "example": "2026-01-01T00:00:00Z"
+          },
+          "confirmed_at": {
+            "type": "string",
+            "format": "date-time",
+            "example": "2026-01-01T00:05:00Z"
+          },
+          "expired_at": {
+            "type": "string",
+            "format": "date-time",
+            "example": "2026-01-01T01:00:00Z"
           }
         }
       },
-      "SupportedAssetsResponse": {
+      "PayoutResponse": {
         "type": "object",
         "properties": {
-          "assets": {
+          "data": {
+            "$ref": "#/components/schemas/Payout"
+          }
+        }
+      },
+      "PayoutList": {
+        "type": "object",
+        "properties": {
+          "data": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/SupportedAssetChain"
+              "$ref": "#/components/schemas/Payout"
             }
+          },
+          "pagination": {
+            "$ref": "#/components/schemas/PagePagination"
           }
         }
       },
-      "PagePagination": {
+      "GasStationBalance": {
         "type": "object",
-        "description": "Page-based pagination metadata returned by payout and gas-station list endpoints.",
         "properties": {
-          "page": {
-            "type": "integer",
-            "example": 1
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
           },
-          "limit": {
-            "type": "integer",
-            "example": 20
+          "asset": {
+            "type": "string",
+            "example": "Ethereum"
           },
-          "total_items": {
-            "type": "integer",
-            "example": 100
+          "symbol": {
+            "type": "string",
+            "example": "ETH"
           },
-          "total_pages": {
+          "decimal": {
             "type": "integer",
-            "example": 5
-          },
-          "has_next": {
-            "type": "boolean",
-            "example": true
+            "example": 18
           },
-          "has_prev": {
-            "type": "boolean",
-            "example": false
-          }
-        }
-      },
-      "MoneyValue": {
-        "type": "object",
-        "description": "A single balance rendered in human, raw, and USD forms.",
-        "properties": {
-          "amount": {
+          "network_id": {
             "type": "string",
-            "description": "Human-readable amount (already divided by decimals).",
-            "example": "1.5"
+            "example": "60"
           },
-          "raw": {
+          "network_symbol": {
             "type": "string",
-            "description": "Amount in the asset's smallest unit.",
-            "example": "1000000000000000000"
+            "example": "ETH"
           },
-          "usd": {
-            "type": "string",
-            "description": "Indicative USD value.",
-            "example": "3500.00"
+          "balance": {
+            "$ref": "#/components/schemas/MoneyValue"
           }
         }
       },
-      "Vault": {
+      "GasStation": {
         "type": "object",
         "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
           "id": {
             "type": "string",
             "example": "550e8400-e29b-41d4-a716-446655440000"
           },
-          "label": {
-            "type": "string",
-            "description": "Human-readable vault name.",
-            "example": "hot"
-          }
-        }
-      },
-      "VaultList": {
-        "type": "object",
-        "properties": {
-          "data": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/Vault"
-            }
-          }
-        }
-      },
-      "VaultAddress": {
-        "type": "object",
-        "properties": {
           "address": {
             "type": "string",
             "example": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD58"
@@ -2347,43 +4137,35 @@
             "type": "string",
             "example": "ETH"
           },
-          "created_at": {
-            "type": "string",
-            "format": "date-time",
-            "example": "2024-01-01T00:00:00Z"
-          }
-        }
-      },
-      "VaultAddressList": {
-        "type": "object",
-        "properties": {
-          "data": {
-            "type": "object",
-            "properties": {
-              "addresses": {
-                "type": "array",
-                "items": {
-                  "$ref": "#/components/schemas/VaultAddress"
-                }
-              }
+          "balances": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/GasStationBalance"
             }
           }
         }
       },
-      "VaultAddressResponse": {
+      "GasStationResponse": {
         "type": "object",
         "properties": {
           "data": {
-            "$ref": "#/components/schemas/VaultAddress"
+            "$ref": "#/components/schemas/GasStation"
           }
         }
       },
-      "VaultBalance": {
+      "GasStationWallet": {
         "type": "object",
         "properties": {
-          "asset": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
+          "id": {
             "type": "string",
-            "example": "Ethereum"
+            "example": "550e8400-e29b-41d4-a716-446655440000"
+          },
+          "address": {
+            "type": "string",
+            "example": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD58"
           },
           "network_id": {
             "type": "string",
@@ -2391,132 +4173,176 @@
           },
           "network_symbol": {
             "type": "string",
-            "example": "ETH"
-          },
-          "raw_value": {
-            "type": "string",
-            "description": "Balance in the asset's smallest unit.",
-            "example": "1000000000000000000"
-          },
-          "raw_value_decimals": {
-            "type": "integer",
-            "example": 18
+            "example": "ETH"
           },
-          "display_values": {
-            "$ref": "#/components/schemas/MoneyValue"
+          "created_at": {
+            "type": "string",
+            "format": "date-time",
+            "example": "2024-01-01T00:00:00Z"
           }
         }
       },
-      "VaultBalancesResponse": {
+      "GasStationWalletList": {
         "type": "object",
         "properties": {
           "data": {
-            "type": "object",
-            "properties": {
-              "balances": {
-                "type": "array",
-                "items": {
-                  "$ref": "#/components/schemas/VaultBalance"
-                }
-              }
-            }
-          }
-        }
-      },
-      "VaultTotal": {
-        "type": "object",
-        "properties": {
-          "total_usd": {
-            "type": "string",
-            "description": "Combined USD value of every asset in the vault.",
-            "example": "25000.00"
-          },
-          "included_currency": {
             "type": "array",
             "items": {
-              "type": "string"
-            },
-            "example": [
-              "ETH",
-              "USDT"
-            ]
+              "$ref": "#/components/schemas/GasStationWallet"
+            }
+          },
+          "pagination": {
+            "$ref": "#/components/schemas/PagePagination"
           }
         }
       },
-      "VaultTotalResponse": {
+      "SimulationAsset": {
         "type": "object",
+        "description": "The asset a simulated deposit pays in: the network's native coin (`native: true`) or a token named by its contract (`token`). State exactly one.\n",
         "properties": {
-          "data": {
-            "$ref": "#/components/schemas/VaultTotal"
+          "native": {
+            "type": "boolean",
+            "description": "The network's native coin.",
+            "example": true
+          },
+          "token": {
+            "type": "string",
+            "description": "The token's contract address.",
+            "example": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
           }
         }
       },
-      "CreatePayoutRequest": {
+      "SimulateUDADepositRequest": {
         "type": "object",
-        "description": "A payout from a vault to an external address. Provide either `amount` or `usd_amount`, not both.\n",
+        "description": "A simulated payment to one of your sandbox UDAs.",
         "properties": {
-          "vault_id": {
+          "uda_id": {
             "type": "string",
-            "description": "The vault the funds leave from.",
-            "example": "550e8400-e29b-41d4-a716-446655440001"
+            "description": "The UDA to pay.",
+            "example": "uda_01J9Z3K4M5N6P7Q8R9S0T1U2V3"
           },
-          "asset": {
+          "network_id": {
             "type": "string",
-            "description": "Asset symbol to send.",
-            "example": "USDT"
+            "description": "A simulated network the UDA is payable on (see `GET /test_helpers/options`).",
+            "example": "60"
           },
-          "network_symbol": {
+          "asset": {
+            "$ref": "#/components/schemas/SimulationAsset"
+          },
+          "amount": {
             "type": "string",
-            "description": "Network slug.",
-            "example": "ethereum"
+            "description": "A positive whole number of the asset's base units.",
+            "example": "25000000"
           },
-          "to_address": {
+          "settlement": {
             "type": "string",
-            "description": "External destination address.",
-            "example": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B"
+            "enum": [
+              "success",
+              "fail",
+              "retry_then_success"
+            ],
+            "description": "How the settlement ends (default `success`).",
+            "example": "success"
           },
-          "reference_id": {
+          "preset": {
             "type": "string",
-            "description": "Your idempotency key — unique per vault.",
-            "example": "order-12345"
+            "enum": [
+              "underpaid",
+              "overpaid",
+              "wrong_network",
+              "wrong_asset",
+              "dust"
+            ],
+            "description": "Labels the payment with a preset. It does not change what is sent: send the `facts` the options expand for the UDA.\n",
+            "example": "underpaid"
+          }
+        },
+        "required": [
+          "uda_id",
+          "network_id",
+          "asset",
+          "amount"
+        ],
+        "example": {
+          "uda_id": "uda_01J9Z3K4M5N6P7Q8R9S0T1U2V3",
+          "network_id": "60",
+          "asset": {
+            "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
           },
-          "amount": {
+          "amount": "25000000",
+          "settlement": "success"
+        }
+      },
+      "SimulateVaultDepositRequest": {
+        "type": "object",
+        "description": "A simulated payment to one of your sandbox vaults.",
+        "properties": {
+          "vault_id": {
             "type": "string",
-            "description": "Crypto amount; provide either `amount` or `usd_amount`.",
-            "example": "100.50"
+            "description": "The vault to pay.",
+            "example": "550e8400-e29b-41d4-a716-446655440001"
           },
-          "usd_amount": {
+          "network_id": {
             "type": "string",
-            "description": "USD amount; converted to crypto at the current rate.",
-            "example": "50.00"
+            "description": "A simulated network.",
+            "example": "60"
           },
-          "remark": {
+          "asset": {
+            "$ref": "#/components/schemas/SimulationAsset"
+          },
+          "amount": {
             "type": "string",
-            "description": "Free-form note stored on the payout.",
-            "example": "Payment for order #12345"
+            "description": "A positive whole number of the asset's base units.",
+            "example": "1000000000000000000"
           },
-          "type": {
+          "preset": {
             "type": "string",
             "enum": [
-              "normal",
-              "forceful"
+              "dust"
             ],
-            "default": "normal",
-            "description": "Payout strategy. `normal` (default) refills gas when needed and retries until `expired_at`. `forceful` still refills when needed but is single-attempt — the refill and the transfer are each tried once, with no retry and no `expired_at`; it fails immediately if either can't complete.\n"
-          },
-          "expired_at": {
-            "type": "string",
-            "format": "date-time",
-            "description": "Cutoff after which a non-confirmed payout expires. Defaults to 1 hour from creation; capped at 12 hours ahead. Ignored for `forceful` payouts.\n",
-            "example": "2026-01-01T01:00:00Z"
+            "description": "Labels the payment as dust, below the network's minimum deposit.",
+            "example": "dust"
           }
         },
         "required": [
           "vault_id",
+          "network_id",
           "asset",
-          "network_symbol",
-          "to_address",
-          "reference_id"
+          "amount"
+        ],
+        "example": {
+          "vault_id": "550e8400-e29b-41d4-a716-446655440001",
+          "network_id": "60",
+          "asset": {
+            "native": true
+          },
+          "amount": "1000000000000000000"
+        }
+      },
+      "SimulatePayoutRequest": {
+        "description": "The body of `POST /transfer/payout` plus the `outcome` its transaction meets.\n",
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/CreatePayoutRequest"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "outcome": {
+                "type": "string",
+                "enum": [
+                  "success",
+                  "fail",
+                  "hold"
+                ],
+                "description": "`success` confirms the payout's transaction, `fail` fails it, and `hold` leaves it broadcast but unconfirmed until `POST /test_helpers/payouts/{payout_id}/release` or `/fail`.\n",
+                "example": "hold"
+              }
+            },
+            "required": [
+              "outcome"
+            ]
+          }
         ],
         "example": {
           "vault_id": "550e8400-e29b-41d4-a716-446655440001",
@@ -2525,228 +4351,647 @@
           "to_address": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B",
           "reference_id": "order-12345",
           "amount": "100.50",
-          "remark": "Payment for order #12345",
-          "type": "normal",
-          "expired_at": "2026-01-01T01:00:00Z"
+          "outcome": "hold"
         }
       },
-      "Payout": {
+      "SimulationChain": {
+        "type": [
+          "object",
+          "null"
+        ],
+        "description": "The simulated transaction the simulation sent, once there is one.",
+        "properties": {
+          "network_id": {
+            "type": "string",
+            "example": "60"
+          },
+          "hash": {
+            "type": "string",
+            "example": "0x9f2c4e1b7a3d5f60718293a4b5c6d7e8f90123456789abcdef0123456789abcd"
+          }
+        }
+      },
+      "SimulationCause": {
         "type": "object",
+        "description": "A Stridge object the simulation produced, as it stood when last seen.",
         "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
+          "object": {
+            "type": "string",
+            "enum": [
+              "deposit",
+              "settlement",
+              "routing",
+              "payout"
+            ],
+            "example": "settlement"
+          },
           "id": {
             "type": "string",
-            "example": "550e8400-e29b-41d4-a716-446655440000"
+            "example": "stl_01J9Z3K4M5N6P7Q8R9S0T1U2V3"
           },
-          "vault_id": {
+          "status": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The object's status.",
+            "example": "completed"
+          },
+          "event_type": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The webhook event type it last caused.",
+            "example": "uda.settlement.completed"
+          }
+        }
+      },
+      "Simulation": {
+        "type": "object",
+        "description": "One test helper call and how far the flow it started has got. A reset of the sandbox expires the simulations made before it.\n",
+        "properties": {
+          "id": {
             "type": "string",
-            "example": "550e8400-e29b-41d4-a716-446655440001"
+            "example": "0192f4c8-7a1e-7c3b-9d2a-5e6f7a8b9c0d"
           },
-          "asset": {
+          "object": {
             "type": "string",
-            "example": "USDT"
+            "enum": [
+              "simulation"
+            ],
+            "example": "simulation"
           },
-          "network_symbol": {
+          "environment_id": {
             "type": "string",
-            "example": "ethereum"
+            "description": "The sandbox environment the simulation ran in.",
+            "example": "3f2c1d9e-8a47-4b6e-9c11-2d5e7f8a9b04"
           },
-          "amount": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
+          "kind": {
             "type": "string",
-            "description": "Crypto amount sent.",
-            "example": "100.50"
+            "enum": [
+              "uda_deposit",
+              "vault_deposit",
+              "payout",
+              "payout_release",
+              "payout_fail"
+            ],
+            "example": "uda_deposit"
           },
-          "usd_amount": {
+          "preset": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "example": null
+          },
+          "request": {
+            "type": "object",
+            "description": "The request body the helper was called with; for a release or fail, `{ \"payout_id\": \"…\" }`.\n",
+            "additionalProperties": true
+          },
+          "state": {
             "type": "string",
-            "description": "USD value at submit time.",
-            "example": "100.50"
+            "enum": [
+              "running",
+              "observed",
+              "completed",
+              "failed",
+              "expired"
+            ],
+            "description": "`running`: the lever is pulled and nothing recorded yet. `observed`: Stridge recorded the first object it produced. `completed`: the flow reached its terminal state — a failure you chose still completes. `failed`: the simulation itself could not finish (see `error`). `expired`: the sandbox was reset since.\n",
+            "example": "completed"
           },
-          "rate": {
+          "chain": {
+            "$ref": "#/components/schemas/SimulationChain"
+          },
+          "caused": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/SimulationCause"
+            }
+          },
+          "epoch": {
+            "type": "integer",
+            "description": "The sandbox's reset count when the simulation was made.",
+            "example": 0
+          },
+          "error": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Why a `failed` simulation stopped: `world refused`, or `timed out` after 10 minutes.",
+            "example": null
+          },
+          "outcome": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "enum": [
+              "asset not accepted",
+              "not settled",
+              "not recorded",
+              null
+            ],
+            "description": "Why a `completed` simulation stopped short of a settlement: `asset not accepted` (a UDA deposit in an asset the UDA does not accept, recorded and settled by nothing), `not settled` (a UDA deposit Stridge recorded and did not settle for another reason) or `not recorded` (a dust deposit Stridge never recorded). `null` where the flow ran its course.\n",
+            "example": null
+          },
+          "created_at": {
             "type": "string",
-            "description": "Conversion rate applied when `usd_amount` was used.",
-            "example": "1.0001"
+            "format": "date-time",
+            "example": "2026-10-10T12:00:00Z"
           },
-          "to_address": {
+          "updated_at": {
             "type": "string",
-            "example": "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B"
+            "format": "date-time",
+            "example": "2026-10-10T12:00:07Z"
+          }
+        }
+      },
+      "SimulationResponse": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/SuccessEnvelope"
           },
-          "reference_id": {
+          {
+            "type": "object",
+            "properties": {
+              "data": {
+                "$ref": "#/components/schemas/Simulation"
+              }
+            }
+          }
+        ]
+      },
+      "SimulationList": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/SuccessEnvelope"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "data": {
+                "type": "array",
+                "items": {
+                  "$ref": "#/components/schemas/Simulation"
+                }
+              },
+              "pagination": {
+                "$ref": "#/components/schemas/PagePagination"
+              }
+            }
+          }
+        ]
+      },
+      "TestHelperPresetFacts": {
+        "type": [
+          "object",
+          "null"
+        ],
+        "description": "The payment a preset comes to for the UDA named by `uda_id`; `null` without one, or where the UDA leaves nothing to express it with.\n",
+        "properties": {
+          "network_id": {
             "type": "string",
-            "example": "order-12345"
+            "example": "60"
           },
-          "remark": {
+          "asset": {
+            "$ref": "#/components/schemas/SimulationAsset"
+          },
+          "amount": {
             "type": "string",
-            "example": "Payment for order #12345"
+            "example": "1000000"
+          }
+        }
+      },
+      "TestHelperPreset": {
+        "type": "object",
+        "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
           },
-          "type": {
+          "id": {
             "type": "string",
             "enum": [
-              "normal",
-              "forceful"
+              "underpaid",
+              "overpaid",
+              "wrong_network",
+              "wrong_asset",
+              "dust"
             ],
-            "description": "Payout strategy the payout was created with.",
-            "example": "normal"
+            "example": "underpaid"
           },
-          "status": {
+          "label": {
             "type": "string",
-            "enum": [
-              "queued",
-              "processing",
-              "confirmed",
-              "failed",
-              "expired"
-            ],
-            "example": "confirmed"
+            "example": "Underpaid"
           },
-          "tx_id": {
+          "description": {
             "type": "string",
-            "description": "On-chain transaction hash; empty until broadcast.",
-            "example": "0xabc123def456789"
+            "example": "Less than the address usually receives, in an asset it accepts."
           },
-          "error": {
-            "type": "string",
-            "description": "Failure reason when `status` is `failed`; empty otherwise.",
-            "example": ""
+          "applies_to": {
+            "type": "array",
+            "description": "The helpers that accept the preset.",
+            "items": {
+              "type": "string",
+              "enum": [
+                "uda_deposit",
+                "vault_deposit"
+              ]
+            },
+            "example": [
+              "uda_deposit"
+            ]
           },
-          "created_at": {
-            "type": "string",
-            "format": "date-time",
-            "example": "2026-01-01T00:00:00Z"
+          "facts": {
+            "$ref": "#/components/schemas/TestHelperPresetFacts"
+          }
+        }
+      },
+      "TestHelperCrossChainRoute": {
+        "type": "object",
+        "description": "A payment to the UDA on another chain than it settles on, which the bridge lever applies to. The bridge lever is not offered in production, so the list is empty there.\n",
+        "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
           },
-          "confirmed_at": {
+          "network_id": {
             "type": "string",
-            "format": "date-time",
-            "example": "2026-01-01T00:05:00Z"
+            "example": "137"
           },
-          "expired_at": {
-            "type": "string",
-            "format": "date-time",
-            "example": "2026-01-01T01:00:00Z"
+          "asset": {
+            "$ref": "#/components/schemas/SimulationAsset"
           }
         }
       },
-      "PayoutResponse": {
+      "TestHelperAcceptedAsset": {
         "type": "object",
+        "description": "An asset of a simulated network that Stridge settles a deposit of to this UDA.",
         "properties": {
-          "data": {
-            "$ref": "#/components/schemas/Payout"
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
+          "network_id": {
+            "type": "string",
+            "example": "60"
+          },
+          "asset": {
+            "$ref": "#/components/schemas/SimulationAsset"
           }
         }
       },
-      "PayoutList": {
+      "TestHelperUDA": {
         "type": "object",
         "properties": {
-          "data": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
+          "id": {
+            "type": "string",
+            "example": "uda_01J9Z3K4M5N6P7Q8R9S0T1U2V3"
+          },
+          "network_ids": {
             "type": "array",
+            "description": "The simulated networks the UDA is payable on.",
             "items": {
-              "$ref": "#/components/schemas/Payout"
-            }
+              "type": "string"
+            },
+            "example": [
+              "60",
+              "137"
+            ]
           },
-          "pagination": {
-            "$ref": "#/components/schemas/PagePagination"
+          "cross_chain": {
+            "type": "boolean",
+            "description": "Whether any `cross_chain_routes` exist; `false` in production.",
+            "example": false
+          },
+          "cross_chain_routes": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TestHelperCrossChainRoute"
+            },
+            "example": []
+          },
+          "accepted_assets": {
+            "type": "array",
+            "description": "Every asset of the simulated networks the UDA is payable on that Stridge settles a deposit of, spelled out even where the UDA accepts every asset. A deposit of any other asset is recorded and settled by nothing.\n",
+            "items": {
+              "$ref": "#/components/schemas/TestHelperAcceptedAsset"
+            }
           }
         }
       },
-      "GasStationBalance": {
+      "TestHelperVault": {
         "type": "object",
         "properties": {
-          "asset": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
+          "id": {
             "type": "string",
-            "example": "Ethereum"
+            "example": "550e8400-e29b-41d4-a716-446655440001"
           },
-          "symbol": {
+          "label": {
             "type": "string",
-            "example": "ETH"
+            "example": "hot"
           },
-          "decimal": {
-            "type": "integer",
-            "example": 18
+          "network_ids": {
+            "type": "array",
+            "description": "The simulated networks the vault has an address on, which a deposit to it can be made on.",
+            "items": {
+              "type": "string"
+            },
+            "example": [
+              "60",
+              "195"
+            ]
+          }
+        }
+      },
+      "TestHelperNetworkAsset": {
+        "type": "object",
+        "properties": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
           },
-          "network_id": {
+          "symbol": {
             "type": "string",
-            "example": "60"
+            "example": "USDC"
           },
-          "network_symbol": {
-            "type": "string",
-            "example": "ETH"
+          "token": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The token's contract; `null` for the native coin.",
+            "example": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
           },
-          "balance": {
-            "$ref": "#/components/schemas/MoneyValue"
+          "decimals": {
+            "type": "integer",
+            "example": 6
           }
         }
       },
-      "GasStation": {
+      "TestHelperNetwork": {
         "type": "object",
         "properties": {
-          "id": {
-            "type": "string",
-            "example": "550e8400-e29b-41d4-a716-446655440000"
-          },
-          "address": {
-            "type": "string",
-            "example": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD58"
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
           },
           "network_id": {
             "type": "string",
             "example": "60"
           },
-          "network_symbol": {
+          "name": {
             "type": "string",
-            "example": "ETH"
+            "example": "Ethereum"
           },
-          "balances": {
+          "family": {
+            "type": "string",
+            "enum": [
+              "evm",
+              "tvm",
+              "utxo",
+              "svm"
+            ],
+            "example": "evm"
+          },
+          "assets": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/GasStationBalance"
+              "$ref": "#/components/schemas/TestHelperNetworkAsset"
+            }
+          },
+          "levers": {
+            "type": "object",
+            "description": "What a simulation on this network can be made to do.",
+            "properties": {
+              "deposit": {
+                "type": "boolean",
+                "example": true
+              },
+              "payout_outcomes": {
+                "type": "array",
+                "items": {
+                  "type": "string",
+                  "enum": [
+                    "success",
+                    "fail",
+                    "hold"
+                  ]
+                },
+                "example": [
+                  "success",
+                  "fail",
+                  "hold"
+                ]
+              },
+              "bridge": {
+                "type": "boolean",
+                "description": "Whether the bridge lever is offered; `false` in production.",
+                "example": false
+              }
             }
           }
         }
       },
-      "GasStationResponse": {
+      "TestHelperNetworkTiming": {
         "type": "object",
+        "description": "How fast one simulated network moves.",
         "properties": {
-          "data": {
-            "$ref": "#/components/schemas/GasStation"
+          "network_id": {
+            "type": "string",
+            "example": "60"
+          },
+          "block_time_ms": {
+            "type": "integer",
+            "description": "How often the network seals a block while a transaction waits.",
+            "example": 1000
+          },
+          "observable_blocks": {
+            "type": "integer",
+            "description": "How many blocks after inclusion Stridge can first read a transaction.",
+            "example": 1
+          },
+          "confirmation_blocks": {
+            "type": "integer",
+            "description": "How many blocks Stridge waits on top of a transaction before it counts it as confirmed.",
+            "example": 12
+          },
+          "confirmation_delay_ms": {
+            "type": "integer",
+            "description": "How long Stridge waits after sending a transaction before it first checks its confirmations.",
+            "example": 30000
           }
         }
       },
-      "GasStationWallet": {
+      "TestHelperTiming": {
         "type": "object",
+        "description": "How fast the sandbox plays a simulation out.",
         "properties": {
-          "id": {
-            "type": "string",
-            "example": "550e8400-e29b-41d4-a716-446655440000"
+          "networks": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TestHelperNetworkTiming"
+            }
           },
-          "address": {
-            "type": "string",
-            "example": "0x742d35Cc6634C0532925a3b844Bc9e7595f2bD58"
+          "settlement_retry_interval_ms": {
+            "type": "integer",
+            "example": 60000
           },
-          "network_id": {
-            "type": "string",
-            "example": "60"
+          "settlement_retry_min_age_ms": {
+            "type": "integer",
+            "example": 60000
           },
-          "network_symbol": {
-            "type": "string",
-            "example": "ETH"
+          "settlement_max_retries": {
+            "type": "integer",
+            "example": 3
           },
-          "created_at": {
-            "type": "string",
-            "format": "date-time",
-            "example": "2024-01-01T00:00:00Z"
+          "bridge_poll_interval_ms": {
+            "type": "integer",
+            "example": 30000
+          },
+          "non_settling_grace_ms": {
+            "type": "integer",
+            "description": "How long a recorded deposit waits for a settlement before the simulation reads it as one Stridge does not settle.",
+            "example": 60000
+          },
+          "unrecorded_grace_ms": {
+            "type": "integer",
+            "description": "How long a sent deposit waits for Stridge to record it before the simulation reads it as one Stridge does not record.",
+            "example": 60000
           }
         }
       },
-      "GasStationWalletList": {
+      "TestHelperOptions": {
         "type": "object",
         "properties": {
-          "data": {
+          "livemode": {
+            "$ref": "#/components/schemas/Livemode"
+          },
+          "budget": {
+            "type": "object",
+            "description": "The simulation budget, a fixed window per sandbox that every lever-pulling helper call spends from.",
+            "properties": {
+              "limit": {
+                "type": "integer",
+                "example": 600
+              },
+              "window_s": {
+                "type": "integer",
+                "example": 3600
+              },
+              "remaining": {
+                "type": "integer",
+                "example": 597
+              }
+            }
+          },
+          "udas": {
             "type": "array",
             "items": {
-              "$ref": "#/components/schemas/GasStationWallet"
+              "$ref": "#/components/schemas/TestHelperUDA"
             }
           },
-          "pagination": {
-            "$ref": "#/components/schemas/PagePagination"
+          "vaults": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TestHelperVault"
+            }
+          },
+          "networks": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TestHelperNetwork"
+            }
+          },
+          "presets": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/TestHelperPreset"
+            }
+          },
+          "settlement_outcomes": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "example": [
+              "success",
+              "fail",
+              "retry_then_success"
+            ]
+          },
+          "bridge_outcomes": {
+            "type": "array",
+            "description": "The bridge lever's outcomes. The lever is not offered in production (every network's `levers.bridge` is `false`).",
+            "items": {
+              "type": "string"
+            },
+            "example": [
+              "complete",
+              "fail",
+              "refund",
+              "pending"
+            ]
+          },
+          "payout_outcomes": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "example": [
+              "success",
+              "fail",
+              "hold"
+            ]
+          },
+          "event_types": {
+            "type": "array",
+            "description": "The webhook event types a simulation can cause.",
+            "items": {
+              "type": "string"
+            },
+            "example": [
+              "deposit.confirmed",
+              "vault.deposit.detected",
+              "uda.settlement.created",
+              "uda.settlement.retrying",
+              "uda.settlement.completed",
+              "uda.settlement.failed",
+              "payout.confirmed",
+              "payout.failed",
+              "payout.expired"
+            ]
+          },
+          "timing": {
+            "$ref": "#/components/schemas/TestHelperTiming"
           }
         }
+      },
+      "TestHelperOptionsResponse": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/SuccessEnvelope"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "data": {
+                "$ref": "#/components/schemas/TestHelperOptions"
+              }
+            }
+          }
+        ]
       }
     }
   }