@phala/pay-server 0.9.1 → 0.10.0

package/dist/{js-server/src/generated → generated}/openapi.d.ts

@@ -297,6 +297,23 @@ export interface paths {
         readonly patch?: never;
         readonly trace?: never;
     };
+    readonly "/v1/deposit_addresses/{id}/transactions": {
+        readonly parameters: {
+            readonly query?: never;
+            readonly header?: never;
+            readonly path?: never;
+            readonly cookie?: never;
+        };
+        readonly get?: never;
+        readonly put?: never;
+        /** Submit a deposit-address transaction hint on one of its issued networks. */
+        readonly post: operations["submit_deposit_address_transaction"];
+        readonly delete?: never;
+        readonly options?: never;
+        readonly head?: never;
+        readonly patch?: never;
+        readonly trace?: never;
+    };
     readonly "/v1/deposits": {
         readonly parameters: {
             readonly query?: never;
@@ -514,6 +531,23 @@ export interface paths {
         readonly patch?: never;
         readonly trace?: never;
     };
+    readonly "/v1/quotes/{id}/transactions": {
+        readonly parameters: {
+            readonly query?: never;
+            readonly header?: never;
+            readonly path?: never;
+            readonly cookie?: never;
+        };
+        readonly get?: never;
+        readonly put?: never;
+        /** Submit a quote transaction hint. The stored quote selects the chain and recipient. */
+        readonly post: operations["submit_quote_transaction"];
+        readonly delete?: never;
+        readonly options?: never;
+        readonly head?: never;
+        readonly patch?: never;
+        readonly trace?: never;
+    };
     readonly "/v1/refunds": {
         readonly parameters: {
             readonly query?: never;
@@ -569,9 +603,9 @@ export interface paths {
          * Cancels a pending refund that has no transaction attached and releases its reservation of the
          *     deposit; canceling a canceled refund returns it. Once `mark_paid` attached a transaction, the
          *     refund cannot be canceled, so that the deposit is never paid back twice: it stays reserved
-         *     until verification ends it, `succeeded`, or `failed` when the transaction does not pay it,
-         *     was dropped (its nonce consumed by another transaction at finality), or was never seen by the
-         *     service's providers within 24 hours. Then request a new refund.
+         *     until dual-source finalized verification ends it, `succeeded`, or `failed` when the transaction
+         *     does not pay it. A transaction never seen for 24 hours raises an alert and remains pending;
+         *     contact the operator before taking any further refund action.
          */
         readonly post: operations["cancel_refund"];
         readonly delete?: never;
@@ -597,6 +631,10 @@ export interface paths {
          *     `deposit.refunded` is sent; otherwise it is `failed` with a `failure_reason`. Repeating the same
          *     transaction returns the refund. From here on the refund cannot be canceled: it is `failed`
          *     only when its transaction is proven not to pay it.
+         *     Each environment has a configured attached-pending refund limit (production 2, staging 1),
+         *     and permits one new attachment per
+         *     rolling 24 hours across all accounts and modes. Repeating the same attachment consumes no
+         *     quota. A limit refusal preserves the reservation; contact the operator before another payout.
          */
         readonly post: operations["mark_refund_paid"];
         readonly delete?: never;
@@ -1130,11 +1168,11 @@ export interface components {
          *       "object": "balance",
          *       "unswept": [
          *         {
-         *           "amount_atomic": "202510000000000000000",
-         *           "asset": "PHA",
+         *           "amount_atomic": "25000000",
+         *           "asset": "usdc",
          *           "chain_id": 1,
-         *           "final_amount_atomic": "202510000000000000000",
-         *           "token": "0x6c5ba91642f10282b576d91922ae6448c9d52f4e"
+         *           "final_amount_atomic": "25000000",
+         *           "token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
          *         }
          *       ]
          *     }
@@ -1283,19 +1321,19 @@ export interface components {
          * @example {
          *       "address": "0x2f3e91325b2288bce392711f85f5359661062a91",
          *       "amount": 2500,
-         *       "amount_atomic": "202510000000000000000",
+         *       "amount_atomic": "25000000",
          *       "amount_credited": null,
-         *       "asset": "PHA",
+         *       "asset": "usdc",
          *       "chain_id": 1,
          *       "confirmations": 1,
          *       "currency": "usd",
-         *       "decimals": 18,
+         *       "decimals": 6,
          *       "expires_at": 1790554500,
          *       "id": "qt_5f1c0b6a2d9e4f3a8b7c6d5e4f3a2b10",
          *       "livemode": false,
          *       "object": "quote",
          *       "payment_status": "seen",
-         *       "payment_uri": "ethereum:0x6c5ba91642f10282b576d91922ae6448c9d52f4e@1/transfer?address=0x2f3e91325b2288bce392711f85f5359661062a91&uint256=202510000000000000000",
+         *       "payment_uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48@1/transfer?address=0x2f3e91325b2288bce392711f85f5359661062a91&uint256=25000000",
          *       "status": "open",
          *       "typical_credit_seconds": 30
          *     }
@@ -1319,6 +1357,11 @@ export interface components {
             readonly amount_credited: number | null;
             /** @description Asset code. */
             readonly asset: string;
+            /**
+             * Format: int64
+             * @description Deferred cancellation request time, Unix seconds.
+             */
+            readonly cancel_requested_at?: number | null;
             /**
              * Format: int64
              * @description EVM chain identifier.
@@ -1378,18 +1421,18 @@ export interface components {
          * @example {
          *       "assets": [
          *         {
-         *           "asset": "PHA",
+         *           "asset": "usdc",
          *           "chain_id": 1,
          *           "confirmations": "12",
-         *           "contract": "0x6c5ba91642f10282b576d91922ae6448c9d52f4e",
-         *           "decimals": 18,
-         *           "max_deposit_atomic": "1000000000000000000000000",
+         *           "contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
+         *           "decimals": 6,
+         *           "max_deposit_atomic": "10000000000",
          *           "min_amount": 100,
          *           "min_deposit_atomic": "0",
-         *           "min_refund_atomic": "1000000000000000000",
-         *           "pricing": "spot",
+         *           "min_refund_atomic": "1000000",
+         *           "pricing": "stablecoin",
          *           "quote_amount_decimals": 4,
-         *           "quote_spread_bps": 100,
+         *           "quote_spread_bps": 0,
          *           "quote_tolerance_bps": 100,
          *           "quote_ttl_seconds": 900,
          *           "typical_credit_seconds": 150,
@@ -1569,7 +1612,7 @@ export interface components {
          * @description `POST /v1/quotes` body.
          * @example {
          *       "amount": 2500,
-         *       "asset": "PHA",
+         *       "asset": "usdc",
          *       "chain_id": 1,
          *       "client_reference_id": "team-42",
          *       "currency": "usd",
@@ -1584,7 +1627,7 @@ export interface components {
              * @description The credit to quote, a positive integer in the currency's minor unit (US cents).
              */
             readonly amount: number;
-            /** @description Asset code of the payment on that chain, such as `pha`. */
+            /** @description Asset code of the payment on that chain, such as `usdc`. */
             readonly asset: string;
             /**
              * Format: int64
@@ -1610,7 +1653,7 @@ export interface components {
         /**
          * @description `POST /v1/refunds` body.
          * @example {
-         *       "amount_atomic": "202510000000000000000",
+         *       "amount_atomic": "25000000",
          *       "deposit": "dep_8a1f4e2b6c3d49e0a7b5c1d2e3f40516",
          *       "destination_address": "0x1775c1326aa633546b0b5634ae2bef0ba7cbfc9a",
          *       "metadata": {
@@ -1752,12 +1795,12 @@ export interface components {
          * @example {
          *       "address": "0x2f3e91325b2288bce392711f85f5359661062a91",
          *       "amount": 2500,
-         *       "amount_atomic": "202510000000000000000",
+         *       "amount_atomic": "25000000",
          *       "amount_refunded": 0,
          *       "amount_refunded_atomic": "0",
          *       "amount_reversed": 0,
-         *       "asset": "PHA",
-         *       "asset_contract": "0x6c5ba91642f10282b576d91922ae6448c9d52f4e",
+         *       "asset": "usdc",
+         *       "asset_contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          *       "block_hash": "0x9a1c3e5b7d0f2a4c6e8b0d2f4a6c8e0b2d4f6a8c0e2b4d6f8a0c2e4b6d8f0a2c",
          *       "block_number": 21000000,
          *       "block_time": 1790553612,
@@ -1766,7 +1809,7 @@ export interface components {
          *       "created": 1790553624,
          *       "currency": "usd",
          *       "deposit_address": null,
-         *       "exchange_rate": "0.12345679",
+         *       "exchange_rate": "1.00000000",
          *       "final": true,
          *       "final_at": 1790554572,
          *       "from_address": "0x1775c1326aa633546b0b5634ae2bef0ba7cbfc9a",
@@ -1974,10 +2017,10 @@ export interface components {
          *           "address": "0x0f45147a02e4c9d91aff20024e22095536fd5053",
          *           "assets": [
          *             {
-         *               "asset": "PHA",
-         *               "contract": "0x6c5ba91642f10282b576d91922ae6448c9d52f4e",
-         *               "decimals": 18,
-         *               "payment_uri": "ethereum:0x6c5ba91642f10282b576d91922ae6448c9d52f4e@1/transfer?address=0x0f45147a02e4c9d91aff20024e22095536fd5053"
+         *               "asset": "usdc",
+         *               "contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
+         *               "decimals": 6,
+         *               "payment_uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48@1/transfer?address=0x0f45147a02e4c9d91aff20024e22095536fd5053"
          *             }
          *           ],
          *           "chain_id": 1,
@@ -2062,7 +2105,7 @@ export interface components {
         };
         /** @description A token a deposit address takes on one network. */
         readonly DepositAddressAsset: {
-            /** @description Asset code, such as `pha`. */
+            /** @description Asset code, such as `usdc`. */
             readonly asset: string;
             /** @description ERC-20 contract address. */
             readonly contract: string;
@@ -2096,10 +2139,10 @@ export interface components {
          *               "address": "0x0f45147a02e4c9d91aff20024e22095536fd5053",
          *               "assets": [
          *                 {
-         *                   "asset": "PHA",
-         *                   "contract": "0x6c5ba91642f10282b576d91922ae6448c9d52f4e",
-         *                   "decimals": 18,
-         *                   "payment_uri": "ethereum:0x6c5ba91642f10282b576d91922ae6448c9d52f4e@1/transfer?address=0x0f45147a02e4c9d91aff20024e22095536fd5053"
+         *                   "asset": "usdc",
+         *                   "contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
+         *                   "decimals": 6,
+         *                   "payment_uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48@1/transfer?address=0x0f45147a02e4c9d91aff20024e22095536fd5053"
          *                 }
          *               ],
          *               "chain_id": 1,
@@ -2170,10 +2213,10 @@ export interface components {
          *           "address": "0x0f45147a02e4c9d91aff20024e22095536fd5053",
          *           "assets": [
          *             {
-         *               "asset": "PHA",
-         *               "contract": "0x6c5ba91642f10282b576d91922ae6448c9d52f4e",
-         *               "decimals": 18,
-         *               "payment_uri": "ethereum:0x6c5ba91642f10282b576d91922ae6448c9d52f4e@1/transfer?address=0x0f45147a02e4c9d91aff20024e22095536fd5053"
+         *               "asset": "usdc",
+         *               "contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
+         *               "decimals": 6,
+         *               "payment_uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48@1/transfer?address=0x0f45147a02e4c9d91aff20024e22095536fd5053"
          *             }
          *           ],
          *           "chain_id": 1,
@@ -2272,12 +2315,12 @@ export interface components {
          *         {
          *           "address": "0x2f3e91325b2288bce392711f85f5359661062a91",
          *           "amount": 2500,
-         *           "amount_atomic": "202510000000000000000",
+         *           "amount_atomic": "25000000",
          *           "amount_refunded": 0,
          *           "amount_refunded_atomic": "0",
          *           "amount_reversed": 0,
-         *           "asset": "PHA",
-         *           "asset_contract": "0x6c5ba91642f10282b576d91922ae6448c9d52f4e",
+         *           "asset": "usdc",
+         *           "asset_contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          *           "block_hash": "0x9a1c3e5b7d0f2a4c6e8b0d2f4a6c8e0b2d4f6a8c0e2b4d6f8a0c2e4b6d8f0a2c",
          *           "block_number": 21000000,
          *           "block_time": 1790553612,
@@ -2286,7 +2329,7 @@ export interface components {
          *           "created": 1790553624,
          *           "currency": "usd",
          *           "deposit_address": null,
-         *           "exchange_rate": "0.12345679",
+         *           "exchange_rate": "1.00000000",
          *           "final": true,
          *           "final_at": 1790554572,
          *           "from_address": "0x1775c1326aa633546b0b5634ae2bef0ba7cbfc9a",
@@ -2355,7 +2398,7 @@ export interface components {
         };
         /** @description Stable error fields safe to expose to callers. */
         readonly ErrorDetail: {
-            /** @description Stable machine-readable code. */
+            /** @description Stable machine-readable error code; clients accept future codes. */
             readonly code: string;
             /**
              * @description The documentation of `code` in the API reference. Every error of this service carries it;
@@ -2420,12 +2463,12 @@ export interface components {
          *             "object": {
          *               "address": "0x2f3e91325b2288bce392711f85f5359661062a91",
          *               "amount": 2500,
-         *               "amount_atomic": "202510000000000000000",
+         *               "amount_atomic": "25000000",
          *               "amount_refunded": 0,
          *               "amount_refunded_atomic": "0",
          *               "amount_reversed": 0,
-         *               "asset": "PHA",
-         *               "asset_contract": "0x6c5ba91642f10282b576d91922ae6448c9d52f4e",
+         *               "asset": "usdc",
+         *               "asset_contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          *               "block_hash": "0x9a1c3e5b7d0f2a4c6e8b0d2f4a6c8e0b2d4f6a8c0e2b4d6f8a0c2e4b6d8f0a2c",
          *               "block_number": 21000000,
          *               "block_time": 1790553612,
@@ -2434,7 +2477,7 @@ export interface components {
          *               "created": 1790553624,
          *               "currency": "usd",
          *               "deposit_address": null,
-         *               "exchange_rate": "0.12345679",
+         *               "exchange_rate": "1.00000000",
          *               "final": false,
          *               "final_at": 1790554572,
          *               "from_address": "0x1775c1326aa633546b0b5634ae2bef0ba7cbfc9a",
@@ -2497,12 +2540,12 @@ export interface components {
          *         "object": {
          *           "address": "0x2f3e91325b2288bce392711f85f5359661062a91",
          *           "amount": 2500,
-         *           "amount_atomic": "202510000000000000000",
+         *           "amount_atomic": "25000000",
          *           "amount_refunded": 0,
          *           "amount_refunded_atomic": "0",
          *           "amount_reversed": 0,
-         *           "asset": "PHA",
-         *           "asset_contract": "0x6c5ba91642f10282b576d91922ae6448c9d52f4e",
+         *           "asset": "usdc",
+         *           "asset_contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          *           "block_hash": "0x9a1c3e5b7d0f2a4c6e8b0d2f4a6c8e0b2d4f6a8c0e2b4d6f8a0c2e4b6d8f0a2c",
          *           "block_number": 21000000,
          *           "block_time": 1790553612,
@@ -2511,7 +2554,7 @@ export interface components {
          *           "created": 1790553624,
          *           "currency": "usd",
          *           "deposit_address": null,
-         *           "exchange_rate": "0.12345679",
+         *           "exchange_rate": "1.00000000",
          *           "final": false,
          *           "final_at": 1790554572,
          *           "from_address": "0x1775c1326aa633546b0b5634ae2bef0ba7cbfc9a",
@@ -2665,6 +2708,8 @@ export interface components {
             /** @description The list's path, `/v1/forwarders`. */
             readonly url: string;
         };
+        /** @enum {string} */
+        readonly KnownErrorCode: "refund_attachment_limit_exceeded" | "address_capacity_reached" | "chain_unavailable" | "price_unavailable" | "parameter_invalid" | "parameter_missing" | "parameter_unknown" | "amount_too_small" | "amount_too_large" | "exposure_cap_exceeded" | "paused" | "chain_frozen" | "asset_not_accepted" | "payment_settings_unconfirmed" | "treasury_not_set" | "treasury_proof_invalid" | "treasury_challenge_expired" | "treasury_challenge_used" | "treasury_not_deployed" | "treasury_sanctioned" | "treasury_change_pending" | "treasury_unchanged" | "treasury_unexpected_state" | "quote_payment_received" | "quote_window_closed" | "quote_unexpected_state" | "deposit_unexpected_state" | "deposit_not_refundable" | "deposit_not_final" | "destination_sanctioned" | "transfer_already_used" | "refund_unexpected_state" | "api_key_inactive" | "last_api_key" | "deposit_address_cap_exceeded" | "deposit_address_retired" | "webhook_endpoint_cap_exceeded" | "webhook_endpoint_disabled" | "idempotency_key_reused" | "signature_invalid" | "signature_replayed" | "api_key_missing" | "api_key_invalid" | "api_key_expired" | "permission_denied" | "testmode_charges_only" | "resource_missing" | "idempotency_key_in_use" | "rate_limit" | "customer_rate_limit" | "internal_error" | "unavailable" | "service_maintenance" | "service_restoring" | "restore_not_frozen" | "restore_rescan_incomplete";
         /**
          * @description `POST /v1/refunds/{id}/mark_paid` body: the merchant's refund transaction.
          * @example {
@@ -2793,13 +2838,13 @@ export interface components {
          *           "assets": [
          *             {
          *               "accepted": true,
-         *               "asset": "PHA",
-         *               "contract": "0x6c5ba91642f10282b576d91922ae6448c9d52f4e",
-         *               "decimals": 18,
+         *               "asset": "usdc",
+         *               "contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
+         *               "decimals": 6,
          *               "enabled": true,
          *               "max_deposit_atomic": {
-         *                 "default": "1000000000000000000000000",
-         *                 "max": "1000000000000000000000000",
+         *                 "default": "10000000000",
+         *                 "max": "10000000000",
          *                 "min": "0"
          *               },
          *               "min_amount": {
@@ -2813,14 +2858,14 @@ export interface components {
          *                 "min": "0"
          *               },
          *               "min_refund_atomic": {
-         *                 "default": "1000000000000000000",
-         *                 "max": "1000000000000000000",
-         *                 "min": "1000000000000000000"
+         *                 "default": "1000000",
+         *                 "max": "1000000",
+         *                 "min": "1000000"
          *               },
-         *               "pricing": "spot",
+         *               "pricing": "stablecoin",
          *               "quote_amount_decimals": 4,
          *               "quote_spread_bps": {
-         *                 "default": 50,
+         *                 "default": 0,
          *                 "max": 500,
          *                 "min": 0
          *               },
@@ -2837,13 +2882,13 @@ export interface components {
          *             },
          *             {
          *               "accepted": true,
-         *               "asset": "USDT",
+         *               "asset": "usdt",
          *               "contract": "0xdac17f958d2ee523a2206206994597c13d831ec7",
          *               "decimals": 6,
          *               "enabled": true,
          *               "max_deposit_atomic": {
-         *                 "default": "1000000000000000000000000",
-         *                 "max": "1000000000000000000000000",
+         *                 "default": "10000000000",
+         *                 "max": "10000000000",
          *                 "min": "0"
          *               },
          *               "min_amount": {
@@ -2857,14 +2902,14 @@ export interface components {
          *                 "min": "0"
          *               },
          *               "min_refund_atomic": {
-         *                 "default": "1000000000000000000",
-         *                 "max": "1000000000000000000",
-         *                 "min": "1000000000000000000"
+         *                 "default": "1000000",
+         *                 "max": "1000000",
+         *                 "min": "1000000"
          *               },
          *               "pricing": "stablecoin",
          *               "quote_amount_decimals": 4,
          *               "quote_spread_bps": {
-         *                 "default": 50,
+         *                 "default": 0,
          *                 "max": 500,
          *                 "min": 0
          *               },
@@ -2892,11 +2937,11 @@ export interface components {
          *         {
          *           "assets": [
          *             {
-         *               "asset": "PHA",
-         *               "quote_spread_bps": 100
+         *               "asset": "usdc",
+         *               "quote_spread_bps": 0
          *             },
          *             {
-         *               "asset": "USDT"
+         *               "asset": "usdt"
          *             }
          *           ],
          *           "chain_id": 1,
@@ -2953,15 +2998,15 @@ export interface components {
          * @example {
          *       "address": "0x2f3e91325b2288bce392711f85f5359661062a91",
          *       "amount": 2500,
-         *       "amount_atomic": "202510000000000000000",
-         *       "asset": "PHA",
+         *       "amount_atomic": "25000000",
+         *       "asset": "usdc",
          *       "chain_id": 1,
          *       "client_reference_id": "team-42",
          *       "client_secret": "qt_5f1c0b6a2d9e4f3a8b7c6d5e4f3a2b10_secret_9f8e7d6c5b4a39281706f5e4d3c2b1a0f9e8d7c6b5a4938271605f4e3d2c1b0a",
          *       "created": 1790553600,
          *       "currency": "usd",
          *       "deposit": null,
-         *       "exchange_rate": "0.12345679",
+         *       "exchange_rate": "1.00000000",
          *       "expires_at": 1790554500,
          *       "id": "qt_5f1c0b6a2d9e4f3a8b7c6d5e4f3a2b10",
          *       "livemode": false,
@@ -2970,8 +3015,8 @@ export interface components {
          *       },
          *       "object": "quote",
          *       "payment": {
-         *         "amount_atomic": "202510000000000000000",
-         *         "asset": "PHA",
+         *         "amount_atomic": "25000000",
+         *         "asset": "usdc",
          *         "chain_id": 1,
          *         "confirmations": 1,
          *         "deposit": "dep_8a1f4e2b6c3d49e0a7b5c1d2e3f40516",
@@ -2980,16 +3025,16 @@ export interface components {
          *         "status": "seen",
          *         "tx_hash": "0x7d3c1e5a9b2f4d6c8e0a1b3d5f7c9e2a4b6d8f0c1e3a5b7d9f1c3e5a7b9d1f3e"
          *       },
-         *       "payment_uri": "ethereum:0x6c5ba91642f10282b576d91922ae6448c9d52f4e@1/transfer?address=0x2f3e91325b2288bce392711f85f5359661062a91&uint256=202510000000000000000",
+         *       "payment_uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48@1/transfer?address=0x2f3e91325b2288bce392711f85f5359661062a91&uint256=25000000",
          *       "status": "open",
          *       "terms": {
          *         "confirmations": "12",
-         *         "max_deposit_atomic": "1000000000000000000000000",
+         *         "max_deposit_atomic": "10000000000",
          *         "min_amount": 100,
          *         "min_deposit_atomic": "0",
-         *         "min_refund_atomic": "1000000000000000000",
+         *         "min_refund_atomic": "1000000",
          *         "quote_amount_decimals": 4,
-         *         "quote_spread_bps": 100,
+         *         "quote_spread_bps": 0,
          *         "quote_tolerance_bps": 100,
          *         "quote_ttl_seconds": 900
          *       },
@@ -3008,6 +3053,11 @@ export interface components {
             readonly amount_atomic: string;
             /** @description Asset code. */
             readonly asset: string;
+            /**
+             * Format: int64
+             * @description Deferred cancellation request time, Unix seconds; null before a request.
+             */
+            readonly cancel_requested_at?: number | null;
             /**
              * Format: int64
              * @description EVM chain identifier.
@@ -3082,15 +3132,15 @@ export interface components {
          *         {
          *           "address": "0x2f3e91325b2288bce392711f85f5359661062a91",
          *           "amount": 2500,
-         *           "amount_atomic": "202510000000000000000",
-         *           "asset": "PHA",
+         *           "amount_atomic": "25000000",
+         *           "asset": "usdc",
          *           "chain_id": 1,
          *           "client_reference_id": "team-42",
          *           "client_secret": "qt_5f1c0b6a2d9e4f3a8b7c6d5e4f3a2b10_secret_9f8e7d6c5b4a39281706f5e4d3c2b1a0f9e8d7c6b5a4938271605f4e3d2c1b0a",
          *           "created": 1790553600,
          *           "currency": "usd",
          *           "deposit": null,
-         *           "exchange_rate": "0.12345679",
+         *           "exchange_rate": "1.00000000",
          *           "expires_at": 1790554500,
          *           "id": "qt_5f1c0b6a2d9e4f3a8b7c6d5e4f3a2b10",
          *           "livemode": false,
@@ -3099,8 +3149,8 @@ export interface components {
          *           },
          *           "object": "quote",
          *           "payment": {
-         *             "amount_atomic": "202510000000000000000",
-         *             "asset": "PHA",
+         *             "amount_atomic": "25000000",
+         *             "asset": "usdc",
          *             "chain_id": 1,
          *             "confirmations": 1,
          *             "deposit": "dep_8a1f4e2b6c3d49e0a7b5c1d2e3f40516",
@@ -3109,16 +3159,16 @@ export interface components {
          *             "status": "seen",
          *             "tx_hash": "0x7d3c1e5a9b2f4d6c8e0a1b3d5f7c9e2a4b6d8f0c1e3a5b7d9f1c3e5a7b9d1f3e"
          *           },
-         *           "payment_uri": "ethereum:0x6c5ba91642f10282b576d91922ae6448c9d52f4e@1/transfer?address=0x2f3e91325b2288bce392711f85f5359661062a91&uint256=202510000000000000000",
+         *           "payment_uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48@1/transfer?address=0x2f3e91325b2288bce392711f85f5359661062a91&uint256=25000000",
          *           "status": "open",
          *           "terms": {
          *             "confirmations": "12",
-         *             "max_deposit_atomic": "1000000000000000000000000",
+         *             "max_deposit_atomic": "10000000000",
          *             "min_amount": 100,
          *             "min_deposit_atomic": "0",
-         *             "min_refund_atomic": "1000000000000000000",
+         *             "min_refund_atomic": "1000000",
          *             "quote_amount_decimals": 4,
-         *             "quote_spread_bps": 100,
+         *             "quote_spread_bps": 0,
          *             "quote_tolerance_bps": 100,
          *             "quote_ttl_seconds": 900
          *           },
@@ -3189,15 +3239,15 @@ export interface components {
          * @example {
          *       "address": "0x2f3e91325b2288bce392711f85f5359661062a91",
          *       "amount": 2500,
-         *       "amount_atomic": "202510000000000000000",
-         *       "asset": "PHA",
+         *       "amount_atomic": "25000000",
+         *       "asset": "usdc",
          *       "chain_id": 1,
          *       "client_reference_id": "team-42",
          *       "client_secret": "qt_5f1c0b6a2d9e4f3a8b7c6d5e4f3a2b10_secret_9f8e7d6c5b4a39281706f5e4d3c2b1a0f9e8d7c6b5a4938271605f4e3d2c1b0a",
          *       "created": 1790553600,
          *       "currency": "usd",
          *       "deposit": null,
-         *       "exchange_rate": "0.12345679",
+         *       "exchange_rate": "1.00000000",
          *       "expires_at": 1790554500,
          *       "id": "qt_5f1c0b6a2d9e4f3a8b7c6d5e4f3a2b10",
          *       "livemode": false,
@@ -3206,8 +3256,8 @@ export interface components {
          *       },
          *       "object": "quote",
          *       "payment": {
-         *         "amount_atomic": "202510000000000000000",
-         *         "asset": "PHA",
+         *         "amount_atomic": "25000000",
+         *         "asset": "usdc",
          *         "chain_id": 1,
          *         "confirmations": 1,
          *         "deposit": "dep_8a1f4e2b6c3d49e0a7b5c1d2e3f40516",
@@ -3216,16 +3266,16 @@ export interface components {
          *         "status": "seen",
          *         "tx_hash": "0x7d3c1e5a9b2f4d6c8e0a1b3d5f7c9e2a4b6d8f0c1e3a5b7d9f1c3e5a7b9d1f3e"
          *       },
-         *       "payment_uri": "ethereum:0x6c5ba91642f10282b576d91922ae6448c9d52f4e@1/transfer?address=0x2f3e91325b2288bce392711f85f5359661062a91&uint256=202510000000000000000",
+         *       "payment_uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48@1/transfer?address=0x2f3e91325b2288bce392711f85f5359661062a91&uint256=25000000",
          *       "status": "open",
          *       "terms": {
          *         "confirmations": "12",
-         *         "max_deposit_atomic": "1000000000000000000000000",
+         *         "max_deposit_atomic": "10000000000",
          *         "min_amount": 100,
          *         "min_deposit_atomic": "0",
-         *         "min_refund_atomic": "1000000000000000000",
+         *         "min_refund_atomic": "1000000",
          *         "quote_amount_decimals": 4,
-         *         "quote_spread_bps": 100,
+         *         "quote_spread_bps": 0,
          *         "quote_tolerance_bps": 100,
          *         "quote_ttl_seconds": 900
          *       },
@@ -3237,7 +3287,7 @@ export interface components {
          * @description A refund of (part of) a deposit to the customer, which the merchant pays from the treasury of
          *     the deposit's address and attaches with `mark_paid` (design D5).
          * @example {
-         *       "amount_atomic": "202510000000000000000",
+         *       "amount_atomic": "25000000",
          *       "created": 1790557200,
          *       "deposit": "dep_8a1f4e2b6c3d49e0a7b5c1d2e3f40516",
          *       "destination_address": "0x1775c1326aa633546b0b5634ae2bef0ba7cbfc9a",
@@ -3268,10 +3318,10 @@ export interface components {
             readonly destination_address: string;
             /**
              * @description Why the refund failed: `transaction_failed`, `transfer_not_found`, `sender_mismatch`,
-             *     `destination_mismatch`, `amount_mismatch`, `transfer_already_used`,
-             *     `transaction_dropped` (in no block while, at `finalized` on both providers, its sender's
-             *     nonce was used by another transaction), or `transaction_not_found` (no provider returned
-             *     it within 24 hours of `mark_paid`). New values may be added.
+             *     `destination_mismatch`, `amount_mismatch`, or `transfer_already_used`.
+             *     Historical refunds may retain `transaction_dropped` or `transaction_not_found`; missing
+             *     transactions now remain pending with their reservation and alert after 24 hours.
+             *     New values may be added.
              */
             readonly failure_reason?: string | null;
             /** @description `re_` id. */
@@ -3314,7 +3364,7 @@ export interface components {
          * @example {
          *       "data": [
          *         {
-         *           "amount_atomic": "202510000000000000000",
+         *           "amount_atomic": "25000000",
          *           "created": 1790557200,
          *           "deposit": "dep_8a1f4e2b6c3d49e0a7b5c1d2e3f40516",
          *           "destination_address": "0x1775c1326aa633546b0b5634ae2bef0ba7cbfc9a",
@@ -3388,6 +3438,32 @@ export interface components {
              */
             readonly expires_in?: number;
         };
+        /**
+         * @description The deposit address must already have a network for this chain.
+         * @example {
+         *       "chain_id": 84532,
+         *       "transaction_hash": "0x7d3c1e5a9b2f4d6c8e0a1b3d5f7c9e2a4b6d8f0c1e3a5b7d9f1c3e5a7b9d1f3e"
+         *     }
+         */
+        readonly SubmitDepositAddressTransactionRequest: {
+            /**
+             * Format: int64
+             * @description One of this object's issued network identifiers.
+             */
+            readonly chain_id: number;
+            /** @description Transaction hash, exactly 32 hexadecimal bytes prefixed by `0x`. */
+            readonly transaction_hash: string;
+        };
+        /**
+         * @description A quote's chain is derived from its stored terms.
+         * @example {
+         *       "transaction_hash": "0x7d3c1e5a9b2f4d6c8e0a1b3d5f7c9e2a4b6d8f0c1e3a5b7d9f1c3e5a7b9d1f3e"
+         *     }
+         */
+        readonly SubmitQuoteTransactionRequest: {
+            /** @description Transaction hash, exactly 32 hexadecimal bytes prefixed by `0x`. */
+            readonly transaction_hash: string;
+        };
         /**
          * @description A sweep: one finalized `Flushed` event of the factory, which moved a forwarder's whole balance
          *     of a token to its treasury (Stripe's Payout). Anyone can send the `flush`; the merchant usually
@@ -3444,8 +3520,8 @@ export interface components {
          *       "data": [
          *         {
          *           "address": "0x2f3e91325b2288bce392711f85f5359661062a91",
-         *           "amount_atomic": "202510000000000000000",
-         *           "asset": "PHA",
+         *           "amount_atomic": "25000000",
+         *           "asset": "usdc",
          *           "block_number": 21000420,
          *           "chain_id": 1,
          *           "created": 1790560800,
@@ -3454,7 +3530,7 @@ export interface components {
          *           "livemode": false,
          *           "log_index": 7,
          *           "object": "sweep",
-         *           "token": "0x6c5ba91642f10282b576d91922ae6448c9d52f4e",
+         *           "token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
          *           "treasury": "0x936c1991f8da9a919fa11b557a3514719f5a4504",
          *           "tx_hash": "0x4b6d8f0a2c4e6a8c0e2b4d6f8a0c2e4b6d8f0a2c4e6b8d0f2a4c6e8b0d2f4a6c"
          *         }
@@ -3477,6 +3553,32 @@ export interface components {
             /** @description The list's path, `/v1/sweeps`. */
             readonly url: string;
         };
+        /**
+         * @description A quiet acknowledgement, including for ignored hints.
+         * @example {
+         *       "object": "transaction_submission",
+         *       "status": "received",
+         *       "transaction_hash": "0x7d3c1e5a9b2f4d6c8e0a1b3d5f7c9e2a4b6d8f0c1e3a5b7d9f1c3e5a7b9d1f3e"
+         *     }
+         */
+        readonly TransactionSubmission: {
+            /** @description Object discriminator. */
+            readonly object: components["schemas"]["TransactionSubmissionObject"];
+            /** @description Acknowledgement only; poll the original object for payment status. */
+            readonly status: components["schemas"]["TransactionSubmissionStatus"];
+            /** @description Hash echoed from the submission. */
+            readonly transaction_hash: string;
+        };
+        /**
+         * @description Constant submission object discriminator.
+         * @enum {string}
+         */
+        readonly TransactionSubmissionObject: "transaction_submission";
+        /**
+         * @description Received acknowledges submission only, never detection or verification.
+         * @enum {string}
+         */
+        readonly TransactionSubmissionStatus: "received";
         /**
          * @description An account's treasury of one chain and mode (design D10): the only address the forwarders
          *     issued over it can pay.
@@ -3674,11 +3776,11 @@ export interface components {
          *         {
          *           "assets": [
          *             {
-         *               "asset": "PHA",
-         *               "quote_spread_bps": 100
+         *               "asset": "usdc",
+         *               "quote_spread_bps": 0
          *             },
          *             {
-         *               "asset": "USDT"
+         *               "asset": "usdt"
          *             }
          *           ],
          *           "chain_id": 1,
@@ -5307,6 +5409,19 @@ export interface operations {
                     readonly "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /** @description Permanent chain `address_capacity_reached`; not retryable */
+            readonly 422: {
+                headers: {
+                    /** @description Tenant data and credentials must never be stored, including errors */
+                    readonly "Cache-Control": "no-store";
+                    /** @description The request's id, `req_…` (https://docs.stripe.com/api/request_ids) */
+                    readonly "Request-Id"?: string;
+                    readonly [name: string]: unknown;
+                };
+                content: {
+                    readonly "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /** @description `rate_limit`: retry after `Retry-After` seconds */
             readonly 429: {
                 headers: {
@@ -5660,6 +5775,19 @@ export interface operations {
                     readonly "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /** @description Permanent chain `address_capacity_reached`; not retryable */
+            readonly 422: {
+                headers: {
+                    /** @description Tenant data and credentials must never be stored, including errors */
+                    readonly "Cache-Control": "no-store";
+                    /** @description The request's id, `req_…` (https://docs.stripe.com/api/request_ids) */
+                    readonly "Request-Id"?: string;
+                    readonly [name: string]: unknown;
+                };
+                content: {
+                    readonly "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /** @description `rate_limit`, or `customer_rate_limit`: the customer's rotations per hour; retry after `Retry-After` seconds */
             readonly 429: {
                 headers: {
@@ -5692,6 +5820,40 @@ export interface operations {
             };
         };
     };
+    readonly submit_deposit_address_transaction: {
+        readonly parameters: {
+            readonly query?: {
+                /** @description Object's browser client secret; omit with a merchant key */
+                readonly client_secret?: string;
+            };
+            readonly header?: never;
+            readonly path: {
+                /** @description Deposit-address identifier */
+                readonly id: string;
+            };
+            readonly cookie?: never;
+        };
+        readonly requestBody: {
+            readonly content: {
+                readonly "application/json": components["schemas"]["SubmitDepositAddressTransactionRequest"];
+            };
+        };
+        readonly responses: {
+            /** @description Received, including ignored hints. No payment result is disclosed. */
+            readonly 202: {
+                headers: {
+                    /** @description Tenant data and credentials must never be stored, including errors */
+                    readonly "Cache-Control": "no-store";
+                    /** @description The request's id, `req_…` (https://docs.stripe.com/api/request_ids) */
+                    readonly "Request-Id"?: string;
+                    readonly [name: string]: unknown;
+                };
+                content: {
+                    readonly "application/json": components["schemas"]["TransactionSubmission"];
+                };
+            };
+        };
+    };
     readonly list_deposits: {
         readonly parameters: {
             readonly query?: {
@@ -6865,6 +7027,19 @@ export interface operations {
                     readonly "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /** @description Permanent chain `address_capacity_reached`; not retryable */
+            readonly 422: {
+                headers: {
+                    /** @description Tenant data and credentials must never be stored, including errors */
+                    readonly "Cache-Control": "no-store";
+                    /** @description The request's id, `req_…` (https://docs.stripe.com/api/request_ids) */
+                    readonly "Request-Id"?: string;
+                    readonly [name: string]: unknown;
+                };
+                content: {
+                    readonly "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /** @description `rate_limit`, or `customer_rate_limit`: the customer's quotes per minute; retry after `Retry-After` seconds */
             readonly 429: {
                 headers: {
@@ -6880,7 +7055,7 @@ export interface operations {
                     readonly "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
-            /** @description Service Unavailable */
+            /** @description `chain_unavailable`, `price_unavailable` or Service Unavailable */
             readonly 503: {
                 headers: {
                     /** @description Tenant data and credentials must never be stored, including errors */
@@ -7252,6 +7427,40 @@ export interface operations {
             };
         };
     };
+    readonly submit_quote_transaction: {
+        readonly parameters: {
+            readonly query?: {
+                /** @description Object's browser client secret; omit with a merchant key */
+                readonly client_secret?: string;
+            };
+            readonly header?: never;
+            readonly path: {
+                /** @description Quote identifier */
+                readonly id: string;
+            };
+            readonly cookie?: never;
+        };
+        readonly requestBody: {
+            readonly content: {
+                readonly "application/json": components["schemas"]["SubmitQuoteTransactionRequest"];
+            };
+        };
+        readonly responses: {
+            /** @description Received, including ignored hints. No payment result is disclosed. */
+            readonly 202: {
+                headers: {
+                    /** @description Tenant data and credentials must never be stored, including errors */
+                    readonly "Cache-Control": "no-store";
+                    /** @description The request's id, `req_…` (https://docs.stripe.com/api/request_ids) */
+                    readonly "Request-Id"?: string;
+                    readonly [name: string]: unknown;
+                };
+                content: {
+                    readonly "application/json": components["schemas"]["TransactionSubmission"];
+                };
+            };
+        };
+    };
     readonly list_refunds: {
         readonly parameters: {
             readonly query?: {
@@ -7919,6 +8128,19 @@ export interface operations {
                     readonly "application/json": components["schemas"]["ErrorResponse"];
                 };
             };
+            /** @description Non-retryable `refund_attachment_limit_exceeded`; contact the operator. The reservation is preserved. */
+            readonly 422: {
+                headers: {
+                    /** @description Tenant data and credentials must never be stored, including errors */
+                    readonly "Cache-Control": "no-store";
+                    /** @description The request's id, `req_…` (https://docs.stripe.com/api/request_ids) */
+                    readonly "Request-Id"?: string;
+                    readonly [name: string]: unknown;
+                };
+                content: {
+                    readonly "application/json": components["schemas"]["ErrorResponse"];
+                };
+            };
             /** @description `rate_limit`: retry after `Retry-After` seconds */
             readonly 429: {
                 headers: {