@atumlabs/payment-gateway-client 3.0.1 → 4.0.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { AxiosRequestConfig, AxiosResponse } from 'axios';
-import { d as AuthorizePaymentData, e as AuthorizePaymentResponse, G as GetDefaultsData, f as GetDefaultsResponse, H as HealthCheckResponse, S as SubmitPaymentData, g as SubmitPaymentResponse, h as GetPaymentStatusData, i as GetPaymentStatusResponse2, R as ResolvePaymentData, j as ResolvePaymentResponse2, k as GetPaymentTimelineData, l as GetPaymentTimelineResponse, m as PreparePaymentData, n as PreparePaymentResponse2, C as CreateQuoteRequestData, o as CreateQuoteRequestResponse, p as GetQuoteRequestStatusData, q as GetQuoteRequestStatusResponse, r as AwardQuoteData, s as AwardQuoteResponse, t as SignedMessage, E as ErrorResponse, P as PaymentRequest, u as CreateQuoteRequest } from './sender-auth-verify-C-Q-zvAO.js';
-export { $ as $OpenApiTs, A as AuthTerms, w as AuthorizationResult, x as AwardAccepted, y as AwardRequest, z as AwardResponse, B as AwardedPayment, D as AwardedQuote, F as BidAward, I as ChainDefaultsByChain, J as ChainDefaultsWire, K as DataIntegrityProof, L as DeclineReason, M as DeclineSummaryEntry, N as FulfillmentConfirmation, O as GetDefaultsResult, Q as GetPaymentStatusResponse, T as OwnedAsset, a as ParsedPermit, U as PaymentBlockchainContext, W as PaymentFailure, X as PaymentResponse, Y as PaymentStatus, Z as PaymentSummary, _ as PaymentTimelineResponse, a0 as PaymentTransaction, a1 as PaymentTransactions, a2 as PreparePaymentRequest, a3 as PreparePaymentResponse, a4 as Quote, a5 as QuoteRequestAccepted, a6 as QuoteRequestResponse, a7 as QuoteRequestStatusResponse, a8 as ResolvePaymentResponse, a9 as SenderAuth, aa as SenderAuthMessageScheme, ab as TimelineStep, ac as VerifiableCredential, ad as VerifiableCredentialAuth, V as VerifiedSenderAuth, b as VerifyPaymentRequestExpectations, c as VerifyResult, ae as domain, af as error_code, ag as status, ah as status2, ai as status3, aj as status4, ak as status5, al as status6, am as status7 } from './sender-auth-verify-C-Q-zvAO.js';
+import { h as AuthorizePaymentData, i as AuthorizePaymentResponse, G as GetDefaultsData, j as GetDefaultsResponse, H as HealthCheckResponse, k as SubmitPaymentData, l as SubmitPaymentResponse, m as GetPaymentStatusData, n as GetPaymentStatusResponse2, R as ResolvePaymentData, o as ResolvePaymentResponse2, p as GetPaymentTimelineData, q as GetPaymentTimelineResponse, r as PreparePaymentData, s as PreparePaymentResponse2, t as CreateQuoteRequestData, u as CreateQuoteRequestResponse, w as GetQuoteRequestStatusData, x as GetQuoteRequestStatusResponse, y as AwardQuoteData, z as AwardQuoteResponse, B as SignedMessage, E as ErrorResponse, P as PaymentRequest, D as CreateQuoteRequest } from './sender-auth-verify-CEf7FN6s.js';
+export { $ as $OpenApiTs, A as AuthTerms, F as AuthorizationResult, I as AwardAccepted, J as AwardRequest, K as AwardResponse, L as AwardedPayment, M as AwardedQuote, N as BidAward, O as ChainDefaultsByChain, Q as ChainDefaultsWire, C as CommitmentOutcome, a as CommitmentResult, T as DataIntegrityProof, U as DeclineReason, W as DeclineSummaryEntry, X as FulfillmentAuthorization, Y as FulfillmentConfirmation, Z as GetDefaultsResult, _ as GetPaymentStatusResponse, a0 as OwnedAsset, b as ParsedPermit, a1 as PaymentBlockchainContext, a2 as PaymentFailure, a3 as PaymentResponse, a4 as PaymentStatus, a5 as PaymentSummary, a6 as PaymentTimelineResponse, a7 as PaymentTransaction, a8 as PaymentTransactions, a9 as PreparePaymentRequest, aa as PreparePaymentResponse, ab as Quote, ac as QuoteRequestAccepted, ad as QuoteRequestResponse, ae as QuoteRequestStatusResponse, af as RefundSignature, ag as ResolvePaymentResponse, ah as SenderAuth, ai as SenderAuthMessageScheme, S as SolanaDomain, aj as TimelineStep, ak as VerifiableCredential, al as VerifiableCredentialAuth, V as VerifiedSenderAuth, c as VerifyPaymentRequestExpectations, d as VerifyResult, am as deposit, an as domain, ao as error_code, ap as fulfill, aq as reserve, ar as scheme, as as status, at as status2, au as status3, av as status4, aw as status5, ax as status6, ay as status7 } from './sender-auth-verify-CEf7FN6s.js';
 import { Signer } from 'ethers';
 
 type ApiRequestOptions = {
@@ -376,25 +376,17 @@ interface ChainDefaults {
     fulfillmentProxy: string;
     permit2Contract?: string;
     /**
-     * Which deposit witness the escrow deployed on this chain pins, surfaced by payment-gw
-     * `/v1/defaults` as `deposit_witness_version`. EVM/Tron only — Solana carries the
-     * same fact in `svmSignatureDomainVersion` below.
-     *
-     * `4` and above select the four-member witness
-     * (`depositRequestHash`, `destination`, `reserver`, `releaser`); `3` selects the two-member
-     * witness a not-yet-redeployed escrow pins. ABSENT means four — see the sender-auth package's
-     * `ChainDefaults.depositWitnessVersion` for why absence is the permissive default.
-     *
-     * Passed through to the sender_auth adapter verbatim; this type only has to carry it.
-     */
-    depositWitnessVersion?: number;
-    /**
-     * V3 Solana escrow domain-separation fields, surfaced by payment-gw
-     * `/v1/defaults` for Solana source chains. Used to build the EscrowDomain that the
-     * V3 deposit hash binds to. Absent for EVM/Tron.
+     * Solana escrow domain-separation fields, used to build the EscrowDomain the deposit hash
+     * binds to. Absent for EVM/Tron.
      */
     svmSignatureClusterId?: string;
     svmSignatureDomainVersion?: number;
+    /**
+     * The depositRequestHash version to sign for a deposit from this chain: 1, keccak256 of the
+     * request_id, or 2, the hash of the request's terms. `preparePaymentRequest` signs v2 only for 2;
+     * absent, 1 or a version this build does not know signs v1.
+     */
+    depositRequestHashVersion?: number;
 }
 
 interface Logger {
@@ -526,6 +518,8 @@ declare function createSenderSigner(sourceChainId: string, opts: SenderSignerOpt
  */
 declare function resolveTurnkeyAddresses(cfg: Omit<TurnkeyConfig, 'pinnedAddress'>): Promise<Record<string, string>>;
 
+declare const VERSION = "1.3";
+
 /**
  * CAIP-19 asset identifier parsing, backing the caller-facing entry points.
  *
@@ -588,6 +582,20 @@ declare function parseAssetIdentifier(value: unknown): ParsedAssetIdentifier;
  */
 declare function assetChainId(value: unknown): string;
 
+/**
+ * Derive a `max_source_amount` from a settler's quoted `source_amount` plus a slippage
+ * tolerance in basis points.
+ *
+ * Input and output are both in the SOURCE token's smallest units: the exchange rate is already
+ * inside the quote, so no decimals or price are needed and none are guessed. The result rounds
+ * up, because a cap one unit below quote-plus-tolerance would refuse the fill the caller agreed to.
+ *
+ * @param sourceAmount The quoted `source_amount`, a positive integer in source smallest units.
+ * @param slippageBps Headroom above the quote, whole basis points in [0, 10000].
+ * @returns The cap as a canonical base-10 integer string.
+ */
+declare function capFromQuote(sourceAmount: string | bigint, slippageBps: number): string;
+
 /**
  * The frozen rejection taxonomy. These strings are part of the cross-language contract: Go must
  * reject the same input with the same reason.
@@ -652,7 +660,7 @@ declare const $AuthorizationResult: {
 declare const $PaymentRequest: {
     readonly description: "Structured payment request with sender authorization and optional W3C Verifiable Credentials";
     readonly type: "object";
-    readonly required: readonly ["version", "request_id", "source", "destination", "fulfillment_amount", "sender_auth", "quote_deadline", "fulfillment_deadline"];
+    readonly required: readonly ["version", "request_id", "source", "destination", "fulfillment_amount", "sender_auth", "quote_deadline", "fulfillment_deadline", "fulfillment_verifier", "escrow_contract_address"];
     readonly properties: {
         readonly version: {
             readonly type: "string";
@@ -690,7 +698,7 @@ declare const $PaymentRequest: {
         readonly quote_deadline: {
             readonly type: "string";
             readonly format: "date-time";
-            readonly description: "Required. The deadline for receiving price quotes from settlement providers. After this\npoint no new quotes are accepted. The gateway injects no default and validates the value\nis in the future. The originator must supply it, and a request that omits it or supplies\na past value is rejected with 400.";
+            readonly description: "Required. The deadline for receiving price quotes from settlement providers. After this\npoint no new quotes are accepted. The gateway injects no default and validates the value\nis in the future. The originator must supply it, and a request that omits it or supplies\na past value is rejected with 400.\n\nKeep this window short. A settler holds its quoted price for a limited period of its\nown choosing, and the gateway selects only once the window has closed, so a deadline\nset beyond that hold leaves no quote still awardable and the request is declined with\nQUOTE_WINDOW_TOO_LONG. That hold is set by each settler and is not part of this\ncontract, so treat 60 seconds as a practical upper bound and prefer a shorter window\nwhere your integration allows.";
             readonly example: "2024-12-25T10:30:00Z";
         };
         readonly fulfillment_deadline: {
@@ -699,6 +707,31 @@ declare const $PaymentRequest: {
             readonly description: "Required. The final deadline for completing the payment. If not completed by this time the\npayment fails and is eligible for a refund. The gateway injects no default and validates\nthe value is in the future. The originator must supply it, and a request that omits it or\nsupplies a past value is rejected with 400.";
             readonly example: "2024-12-25T11:00:00Z";
         };
+        readonly executor: {
+            readonly description: "Who performs each leg of the payment. Omitted on the wire means settler for every leg. The split object keeps deposit, reserve, and fulfill as separate keys.";
+            readonly oneOf: readonly [{
+                readonly type: "string";
+                readonly enum: readonly ["settler", "originator"];
+            }, {
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["deposit", "reserve", "fulfill"];
+                readonly properties: {
+                    readonly deposit: {
+                        readonly type: "string";
+                        readonly enum: readonly ["settler", "originator"];
+                    };
+                    readonly reserve: {
+                        readonly type: "string";
+                        readonly enum: readonly ["settler", "originator"];
+                    };
+                    readonly fulfill: {
+                        readonly type: "string";
+                        readonly enum: readonly ["settler", "originator"];
+                    };
+                };
+            }];
+        };
         readonly settler_auth_required: {
             readonly type: "object";
             readonly description: "Policy requirements for settler authentication. Keys are policy names, values indicate if the policy is required.";
@@ -719,7 +752,7 @@ declare const $PaymentRequest: {
         };
         readonly fulfillment_verifier: {
             readonly type: "object";
-            readonly description: "Third-party service that will independently verify your payment was delivered.\nLeave empty to use the default verifier.";
+            readonly description: "The verification service that confirms the payment was delivered before the escrow\nreleases the source funds, and the account it signs with. Required on every chain:\nthe gateway's `/v1/defaults` response supplies it for each chain.";
             readonly required: readonly ["account", "endpoint"];
             readonly properties: {
                 readonly account: {
@@ -737,7 +770,7 @@ declare const $PaymentRequest: {
         };
         readonly escrow_contract_address: {
             readonly type: "string";
-            readonly description: "Escrow contract address, used to protect source funds until proof of fulfillment has been verified. Leave empty to use the default.";
+            readonly description: "Escrow contract on the source chain that holds the source funds until proof of fulfillment has been verified. Required on every chain. Take the value for the source chain from the payment gateway's GET /v1/defaults (`escrow_contract`).";
             readonly example: "0x742D35cC6634c0532925a3b844Bc9e7595F41360";
         };
         readonly fulfillment_proxy: {
@@ -777,10 +810,54 @@ declare const $PaymentRequest: {
         };
     };
 };
+declare const $FulfillmentAuthorization: {
+    readonly description: "Authorization for an originator to fulfill a payment request. The settler produces this declaration after authorizeFulfillment when the payment request's fulfill executor is \"originator\". A settler fulfill does not produce it.\n\nCanonical JSON Schema: schemas/declarations/FulfillmentAuthorization/v1/schema.json\nPublished at https://schemas.atum.xyz/declarations/FulfillmentAuthorization/v1";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["version", "scheme", "authorization", "fulfillment_quote_json", "evidence"];
+    readonly properties: {
+        readonly version: {
+            readonly type: "string";
+            readonly description: "Semver-shaped declaration version (MAJOR.MINOR). The major component is locked to this schema's parent directory (v1 → major must be 1).";
+            readonly pattern: "^1\\.[0-9]+$";
+            readonly example: "1.0";
+        };
+        readonly scheme: {
+            readonly type: "string";
+            readonly description: "Authorization scheme.";
+            readonly enum: readonly ["EIP-3009"];
+        };
+        readonly authorization: {
+            readonly description: "Signed authorization. For scheme EIP-3009, message_prehash is the EIP-712 TransferWithAuthorization typed data as a JSON string ({domain, types, primaryType, message}, with uint256 values as decimal strings), message is its EIP-712 digest, signature is the settler's 65-byte signature over that digest, and payload is absent. message.validBefore is the payment request's fulfillment_deadline in whole unix seconds, and message.nonce is the fulfillment quote hash.";
+            readonly $ref: "#/components/schemas/SignedMessage";
+        };
+        readonly fulfillment_quote_json: {
+            readonly type: "string";
+            readonly description: "Raw JSON of the fulfillment quote (schemas/declarations/FulfillmentQuote/v1/schema.json), including proof metadata so its canonical quote hash can be computed.";
+        };
+        readonly evidence: {
+            readonly type: "object";
+            readonly description: "Pointer to the on-chain evidence of the fulfillment authorization.";
+            readonly additionalProperties: false;
+            readonly required: readonly ["transaction_id", "log_index"];
+            readonly properties: {
+                readonly transaction_id: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly description: "Chain transaction identifier. EVM transactions are 0x-prefixed hex, Tron transactions are hex without that prefix, and Solana transactions are base58.";
+                };
+                readonly log_index: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                };
+            };
+        };
+    };
+};
 declare const $FulfillmentConfirmation: {
     readonly type: "object";
     readonly description: "Confirmation details after a payment has been successfully delivered.\nContains proof of delivery and transaction details for both source and destination chains.\n";
-    readonly required: readonly ["payment_id", "request_id", "fulfillment_timestamp", "source_chain_id", "destination_chain_id"];
+    readonly required: readonly ["payment_id", "request_id", "source_chain_id", "destination_chain_id", "source_tx_hash", "destination_tx_hash"];
     readonly properties: {
         readonly payment_id: {
             readonly type: "string";
@@ -887,12 +964,12 @@ declare const $SignedMessage: {
     readonly properties: {
         readonly message: {
             readonly type: "string";
-            readonly description: "The data that was signed. Format depends on the blockchain:\n- EVM: Hex-encoded message hash (with 0x prefix)\n- Solana: Hex-encoded message hash (with 0x prefix)\n- Tron: Hex-encoded message hash (possibly without 0x prefix)";
+            readonly description: "The data that was signed, hex-encoded with a 0x prefix on every supported chain. For the deposit (signed_messages[0]) it is the 32-byte hash of message_prehash.";
             readonly example: "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef";
         };
         readonly message_prehash: {
             readonly type: "string";
-            readonly description: "Optional: If 'message' contains a hash, this field contains the original data before it was hashed. Useful for verification and debugging.";
+            readonly description: "The original data that `message` is the hash of. Required on every entry of a payment\nrequest's `sender_auth.signed_messages`: the gateway reads the signed terms from it.";
             readonly example: "{\"permit\":{\"token\":\"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48\",\"amount\":\"1000000\"}}";
         };
         readonly signature: {
@@ -990,8 +1067,8 @@ declare const $VerifiableCredential: {
 };
 declare const $PaymentStatus: {
     readonly type: "string";
-    readonly description: "Where your payment is in its lifecycle. One payment reads the same however you ask\nabout it.\n\n- `pending`: accepted and in progress. Nothing has reached the recipient yet.\n- `finalizing`: the transaction paying your recipient is on chain and is accruing\n  the confirmations its chain requires. NOT FINAL, see below.\n- `completed`: delivered, with the required confirmations behind it.\n- `failed`: did not complete. Any funds held in escrow are returned, and `error`\n  describes what went wrong.\n\n`completed` and `failed` are final and will not change afterwards. `pending` and\n`finalizing` will.\n\n**Do not treat `finalizing` as delivered.** It says the payment has been made on\nchain but is not yet irreversible, much as a card authorization is not yet a\nsettlement. It normally becomes `completed`, and it can still become `failed` if\nthe transaction never reaches the confirmation depth its chain requires. Acting on\n`finalizing` — releasing goods, crediting an account — means accepting that risk\ndeliberately, at whatever threshold suits you rather than the one we wait for.\n\n`finalizing` is about paying the recipient. While your own funds are still being\ncommitted on the source chain the payment is `pending`, because nothing has reached\nthe recipient yet.\n";
-    readonly enum: readonly ["pending", "finalizing", "completed", "failed"];
+    readonly description: "Where your payment is in its lifecycle. One payment reads the same however you ask\nabout it.\n\n- `pending`: accepted and in progress. Nothing has reached the recipient yet.\n- `finalizing`: the transaction paying your recipient is on chain and is accruing\n  the confirmations its chain requires. NOT FINAL, see below.\n- `completed`: delivered, with the required confirmations behind it.\n- `failed`: did not complete. Any funds held in escrow are returned, and `error`\n  describes what went wrong.\n- `refunding`: the settler will not deliver this payment and your funds are being\n  returned from escrow. NOT FINAL: it becomes `refund_available` or `refunded`, and it\n  can still become `completed` or `failed`.\n- `refund_available`: the settler did not deliver and the refund is authorized for you\n  to submit. GET /v1/payments/{paymentId}/status returns `refund_signature`, which you\n  submit to the source escrow to return your funds. The other responses report this\n  status without the signature. NOT FINAL: the funds are still in escrow, so it becomes\n  `refunded` once the refund lands, or `completed` if the settler delivers late and is\n  paid first. Do not pay again while it is `refund_available`.\n- `refunded`: your funds were returned from the source escrow. `transactions.refund` is\n  the refund transaction, when it is known.\n\n`completed`, `failed` and `refunded` are final and will not change afterwards.\n`pending`, `finalizing`, `refunding` and `refund_available` will.\n\n**Do not treat `finalizing` as delivered.** It says the payment has been made on\nchain but is not yet irreversible, much as a card authorization is not yet a\nsettlement. It normally becomes `completed`, and it can still become `failed` if\nthe transaction never reaches the confirmation depth its chain requires. Acting on\n`finalizing` — releasing goods, crediting an account — means accepting that risk\ndeliberately, at whatever threshold suits you rather than the one we wait for.\n\n`finalizing` is about paying the recipient. While your own funds are still being\ncommitted on the source chain the payment is `pending`, because nothing has reached\nthe recipient yet.\n";
+    readonly enum: readonly ["pending", "finalizing", "completed", "failed", "refunding", "refund_available", "refunded"];
     readonly example: "pending";
 };
 declare const $PaymentTransaction: {
@@ -1020,7 +1097,7 @@ declare const $PaymentTransaction: {
 };
 declare const $PaymentTransactions: {
     readonly type: "object";
-    readonly description: "The transactions a payment has produced, one entry per stage, added as each becomes\nknown. A stage absent here has produced no transaction yet.\n\nThese are the two movements that decide whether your payment happened: your funds\nbeing committed, and your recipient being paid. Present on every outcome, so a\npayment that did not complete can still be traced on chain.\n`fulfillment_confirmation` is not a substitute: it is written only once a payment\ncompletes, and describes the finished delivery rather than progress towards it.\n\nWhere a stage is attempted more than once, the entry describes the attempt that\ncounts — the one that succeeded, or the last one if none did.\n";
+    readonly description: "The transactions a payment has produced, one entry per stage, added as each becomes\nknown. A stage absent here has produced no transaction yet.\n\nThese are the movements that decide whether your payment happened: your funds being\ncommitted, your recipient being paid, and your funds being returned when the payment\nis refunded. Present on every outcome, so a payment that did not complete can still be\ntraced on chain.\n`fulfillment_confirmation` is not a substitute: it is written only once a payment\ncompletes, and describes the finished delivery rather than progress towards it.\n\nWhere a stage is attempted more than once, the entry describes the attempt that\ncounts — the one that succeeded, or the last one if none did.\n";
     readonly properties: {
         readonly deposit: {
             readonly allOf: readonly [{
@@ -1034,6 +1111,31 @@ declare const $PaymentTransactions: {
             }];
             readonly description: "Paying your recipient on the destination chain.";
         };
+        readonly refund: {
+            readonly allOf: readonly [{
+                readonly $ref: "#/components/schemas/PaymentTransaction";
+            }];
+            readonly description: "Returning your funds from the escrow on the source chain. Can be absent on a\n`refunded` payment when the refund transaction is not known.\n";
+        };
+    };
+};
+declare const $RefundSignature: {
+    readonly type: "object";
+    readonly description: "The refund authorization for a `refund_available` payment, as the verifier signed it.\nSubmit it to the source chain's escrow `refund` to return your funds yourself.\n\nAnyone holding it can submit the refund, but the escrow only ever pays the depositor. If\nthe settler delivers late and is paid first, the refund no longer goes through.\nOn Solana the submitter also receives the rent of the deposit account the refund closes.\n";
+    readonly required: readonly ["signature", "message_hash", "message_prehash"];
+    readonly properties: {
+        readonly signature: {
+            readonly type: "string";
+            readonly description: "The verifier's signature over `message_hash`. Hex with the `0x` prefix on EVM and\nTron chains, hex without it on Solana.\n";
+        };
+        readonly message_hash: {
+            readonly type: "string";
+            readonly description: "The signed digest, hex without the `0x` prefix.";
+        };
+        readonly message_prehash: {
+            readonly type: "string";
+            readonly description: "The signed message as JSON. On EVM and Tron chains it carries the RefundWitness the\nescrow's `refund` takes.\n";
+        };
     };
 };
 declare const $PaymentResponse: {
@@ -1070,9 +1172,32 @@ declare const $PaymentResponse: {
         readonly fulfillment_confirmation: {
             readonly $ref: "#/components/schemas/FulfillmentConfirmation";
         };
+        readonly fulfillment_authorization: {
+            readonly type: "object";
+            readonly description: "The settler-signed FulfillmentAuthorization for this payment, returned verbatim as an\nopaque signed document (structurally the canonical FulfillmentAuthorization/v1 declaration at\nhttps://schemas.atum.xyz/declarations/FulfillmentAuthorization/v1; see also\n`#/components/schemas/FulfillmentAuthorization`). The inner declaration requires\n`version`, `scheme`, `authorization` (the signed EIP-3009 transfer, in `authorization.message_prehash`), `fulfillment_quote_json`,\nand `evidence` (the on-chain authorizeFulfillment transaction). On the wire the settler\ntypically wraps that declaration in JSON-LD with `@context`, `type`, and `proof` — those\nenvelope fields ride alongside the declaration and MUST be preserved byte-for-byte.\n\nPresent when the settler authorized an originator fulfill. Mutually exclusive with\n`fulfillment_confirmation` until the originator fulfills: when this field is populated,\n`fulfillment_confirmation` is absent.\n\nThe service returns these bytes verbatim and does not re-serialize through a typed\nrepresentation (which would normalize timestamps and reorder JSON-LD envelope fields).\n";
+            readonly 'x-go-type': "json.RawMessage";
+        };
         readonly error: {
             readonly $ref: "#/components/schemas/PaymentFailure";
         };
+        readonly refund_reason: {
+            readonly allOf: readonly [{
+                readonly $ref: "#/components/schemas/PaymentFailure";
+            }];
+            readonly description: "Why the settler did not deliver, as it reported when it gave up. Present only when\n`status` is `refunding`, `refund_available` or `refunded`, and absent when the refund\nstarted without a reason from the settler. `status` decides what to do next: its\n`retry_classification` and `request_id_reusable` describe the settler's error, not\nthis payment, and never mean paying again while it is `refunding` or `refund_available`.\n";
+        };
+        readonly requested_count: {
+            readonly type: "integer";
+            readonly description: "How many settler agents this payment's auction was broadcast to. Accompanies\n`decline_summary` and is present under the same condition. Same meaning and same\nabsence rule as on GET /v1/payments/{paymentId}/status: absent means unknown, never\nzero.\n";
+            readonly example: 8;
+        };
+        readonly decline_summary: {
+            readonly type: "array";
+            readonly description: "Why the payment drew few or no quotes, carried on the submission response so that a\n`failed` payment explains itself here rather than requiring a follow-up read. A\npayment that ran out its quote deadline reports `NO_QUOTES_RECEIVED` on `error`;\nthis is what the settlers actually said.\n\nPresent when `status` is `failed`, alongside `error`. A submission rejected before\nits auction opened is answered as an error response rather than this type and carries\nno breakdown, and GET /v1/payments/{paymentId}/status reports the breakdown in every\nstate.\n\nSame counting rules as GET /v1/payments/{paymentId}/status: every declining agent is\ncounted exactly once under its most recent reason, empty means no agent declined,\nabsent means the breakdown could not be read. The free-form decline detail is never\nrelayed.\n";
+            readonly items: {
+                readonly $ref: "#/components/schemas/DeclineSummaryEntry";
+            };
+        };
     };
 };
 declare const $GetPaymentStatusResponse: {
@@ -1107,9 +1232,26 @@ declare const $GetPaymentStatusResponse: {
         readonly fulfillment_confirmation: {
             readonly $ref: "#/components/schemas/FulfillmentConfirmation";
         };
+        readonly fulfillment_authorization: {
+            readonly type: "object";
+            readonly description: "The settler-signed FulfillmentAuthorization for this payment, returned verbatim as an\nopaque signed document (structurally the canonical FulfillmentAuthorization/v1 declaration at\nhttps://schemas.atum.xyz/declarations/FulfillmentAuthorization/v1; see also\n`#/components/schemas/FulfillmentAuthorization`). The inner declaration requires\n`version`, `scheme`, `authorization` (the signed EIP-3009 transfer, in `authorization.message_prehash`), `fulfillment_quote_json`,\nand `evidence` (the on-chain authorizeFulfillment transaction). On the wire the settler\ntypically wraps that declaration in JSON-LD with `@context`, `type`, and `proof` — those\nenvelope fields ride alongside the declaration and MUST be preserved byte-for-byte.\n\nPresent when the settler authorized an originator fulfill. Mutually exclusive with\n`fulfillment_confirmation` until the originator fulfills: when this field is populated,\n`fulfillment_confirmation` is absent.\n\nThe service returns these bytes verbatim and does not re-serialize through a typed\nrepresentation (which would normalize timestamps and reorder JSON-LD envelope fields).\n";
+            readonly 'x-go-type': "json.RawMessage";
+        };
         readonly error: {
             readonly $ref: "#/components/schemas/PaymentFailure";
         };
+        readonly refund_reason: {
+            readonly allOf: readonly [{
+                readonly $ref: "#/components/schemas/PaymentFailure";
+            }];
+            readonly description: "Why the settler did not deliver, as it reported when it gave up. Present only when\n`status` is `refunding`, `refund_available` or `refunded`, and absent when the refund\nstarted without a reason from the settler. `status` decides what to do next: its\n`retry_classification` and `request_id_reusable` describe the settler's error, not\nthis payment, and never mean paying again while it is `refunding` or `refund_available`.\n";
+        };
+        readonly refund_signature: {
+            readonly allOf: readonly [{
+                readonly $ref: "#/components/schemas/RefundSignature";
+            }];
+            readonly description: "Present only when `status` is `refund_available`.";
+        };
         readonly requested_count: {
             readonly type: "integer";
             readonly description: "How many settler agents this payment's auction was broadcast to. Absent means\nunknown, never zero.\n";
@@ -1126,7 +1268,7 @@ declare const $GetPaymentStatusResponse: {
 };
 declare const $PaymentFailure: {
     readonly type: "object";
-    readonly description: "Why a payment failed. Present only when `status` is `failed`, and identical\nhowever you ask about the payment.\n\n`code` is the stable, machine-readable identity of the failure — branch on it\nrather than on `message`, which is written for a person and may be reworded.\n`docs_url` points at the page describing that code.\n";
+    readonly description: "Why a payment failed, or why its settler gave up. As `error` it is present only when\n`status` is `failed`, as `refund_reason` only on the refund statuses, and it is identical\nhowever you ask about the payment.\n\n`code` is the stable, machine-readable identity of the failure — branch on it\nrather than on `message`, which is written for a person and may be reworded.\n`docs_url` points at the page describing that code.\n";
     readonly required: readonly ["code", "message"];
     readonly properties: {
         readonly code: {
@@ -1155,6 +1297,11 @@ declare const $PaymentFailure: {
             readonly description: "What the caller should do next. Absent means the condition has not been classified, which is not the same as safe to retry.\nRe-sending the same `request_id` is an idempotent replay and always safe. This value is about submitting a new one, which starts a new payment. See https://docs.atum.xyz/errors for the value set.";
             readonly example: "RECONCILE_THEN_DECIDE";
         };
+        readonly request_id_reusable: {
+            readonly type: "boolean";
+            readonly description: "Whether the caller may re-send the `request_id` this payment was created under. On this shape it is almost always false, because a payment exists by definition, but it is carried rather than assumed so a caller reads the same field here as on a synchronous error. Absent means undetermined, which a caller should read as false.";
+            readonly example: false;
+        };
         readonly blockchain_context: {
             readonly $ref: "#/components/schemas/PaymentBlockchainContext";
         };
@@ -1250,8 +1397,8 @@ declare const $PreparePaymentRequest: {
         readonly quote_deadline_seconds: {
             readonly type: "integer";
             readonly description: "Seconds until quote deadline (from now).\nHow long to wait for settlement provider quotes.\n";
-            readonly default: 10;
-            readonly example: 10;
+            readonly default: 3;
+            readonly example: 3;
         };
         readonly fulfillment_deadline_seconds: {
             readonly type: "integer";
@@ -1317,6 +1464,12 @@ declare const $PaymentTimelineResponse: {
         readonly error: {
             readonly $ref: "#/components/schemas/PaymentFailure";
         };
+        readonly refund_reason: {
+            readonly allOf: readonly [{
+                readonly $ref: "#/components/schemas/PaymentFailure";
+            }];
+            readonly description: "Why the settler did not deliver, as it reported when it gave up. Present only when\n`status` is `refunding`, `refund_available` or `refunded`, and absent when the refund\nstarted without a reason from the settler. `status` decides what to do next: its\n`retry_classification` and `request_id_reusable` describe the settler's error, not\nthis payment, and never mean paying again while it is `refunding` or `refund_available`.\n";
+        };
         readonly steps: {
             readonly type: "array";
             readonly items: {
@@ -1454,12 +1607,17 @@ declare const $ErrorResponse: {
             readonly description: "What the caller should do next. Absent means the condition has not been classified, which is not the same as safe to retry.\nRe-sending the same `request_id` is an idempotent replay and always safe. This value is about submitting a new one, which starts a new operation. See https://docs.atum.xyz/errors for the value set.";
             readonly example: "RECONCILE_THEN_DECIDE";
         };
+        readonly request_id_reusable: {
+            readonly type: "boolean";
+            readonly description: "Whether the caller may re-send this same request_id. True means no payment was created for it, so the id is still free. False means a payment exists for it, so the id is spent and re-sending only replays this outcome. Absent means undetermined, which a caller should read as false. Separate from retry_classification, which answers what the caller must change rather than whether the id survived.";
+            readonly example: false;
+        };
     };
 };
 declare const $CreateQuoteRequest: {
     readonly type: "object";
     readonly description: "Request body for opening a quote-request batch. Structurally the existing PaymentRequest\nwith `sender_auth` omitted (the spend authorization is deferred to the award call); see\nschemas/declarations/PaymentRequest/v1/schema.json.\n";
-    readonly required: readonly ["version", "request_id", "source", "destination", "fulfillment_amount", "quote_deadline", "fulfillment_deadline"];
+    readonly required: readonly ["version", "request_id", "source", "destination", "fulfillment_amount", "quote_deadline", "fulfillment_deadline", "fulfillment_verifier", "escrow_contract_address"];
     readonly properties: {
         readonly version: {
             readonly type: "string";
@@ -1497,7 +1655,7 @@ declare const $CreateQuoteRequest: {
         readonly quote_deadline: {
             readonly type: "string";
             readonly format: "date-time";
-            readonly description: "Required. End of the collection window. After this point no new quotes are accepted.\nThe gateway injects no default and never mutates the originator-supplied body, so the\nvalue is carried through verbatim to the award call. It must be supplied and must be in\nthe future. Must be strictly earlier than fulfillment_deadline.\n";
+            readonly description: "Required. End of the collection window. After this point no new quotes are accepted.\nThe gateway injects no default and never mutates the originator-supplied body, so the\nvalue is carried through verbatim to the award call. It must be supplied and must be in\nthe future. Must be strictly earlier than fulfillment_deadline.\n\nKeep this window short. A settler holds its quoted price for a limited period of its\nown choosing, and the gateway selects only once the window has closed, so a deadline\nset beyond that hold leaves no quote still awardable and the request is declined with\nQUOTE_WINDOW_TOO_LONG. That hold is set by each settler and is not part of this\ncontract, so treat 60 seconds as a practical upper bound and prefer a shorter window\nwhere your integration allows.\n";
             readonly example: "2026-04-29T12:00:03Z";
         };
         readonly fulfillment_deadline: {
@@ -1523,7 +1681,7 @@ declare const $CreateQuoteRequest: {
         };
         readonly fulfillment_verifier: {
             readonly type: "object";
-            readonly description: "Optional third-party service that independently verifies delivery. Leave empty for the default verifier.";
+            readonly description: "The verification service that confirms the payment was delivered before the escrow\nreleases the source funds, and the account it signs with. Required on every chain:\nthe gateway's `/v1/defaults` response supplies it for each chain.\n";
             readonly required: readonly ["account", "endpoint"];
             readonly properties: {
                 readonly account: {
@@ -1541,7 +1699,7 @@ declare const $CreateQuoteRequest: {
         };
         readonly escrow_contract_address: {
             readonly type: "string";
-            readonly description: "Optional escrow contract address. Leave empty to use the default.";
+            readonly description: "Escrow contract on the source chain that holds the source funds until proof of\nfulfillment has been verified. Required on every chain: the gateway's `/v1/defaults`\nresponse supplies it for each chain (`escrow_contract`).\n";
             readonly example: "0x742D35cC6634c0532925a3b844Bc9e7595F41360";
         };
         readonly fulfillment_proxy: {
@@ -1952,6 +2110,11 @@ declare const $AwardResponse: {
         readonly fulfillment_confirmation: {
             readonly $ref: "#/components/schemas/FulfillmentConfirmation";
         };
+        readonly fulfillment_authorization: {
+            readonly type: "object";
+            readonly description: "The settler-signed FulfillmentAuthorization for this payment, returned verbatim as an\nopaque signed document (structurally the canonical FulfillmentAuthorization/v1 declaration at\nhttps://schemas.atum.xyz/declarations/FulfillmentAuthorization/v1; see also\n`#/components/schemas/FulfillmentAuthorization`). The inner declaration requires\n`version`, `scheme`, `authorization` (the signed EIP-3009 transfer, in `authorization.message_prehash`), `fulfillment_quote_json`,\nand `evidence` (the on-chain authorizeFulfillment transaction). On the wire the settler\ntypically wraps that declaration in JSON-LD with `@context`, `type`, and `proof` — those\nenvelope fields ride alongside the declaration and MUST be preserved byte-for-byte.\n\nPresent when the settler authorized an originator fulfill within the sync wait.\nMutually exclusive with `fulfillment_confirmation` until the originator fulfills: when\nthis field is populated, `fulfillment_confirmation` is absent.\n\nThe service returns these bytes verbatim and does not re-serialize through a typed\nrepresentation (which would normalize timestamps and reorder JSON-LD envelope fields).\n";
+            readonly 'x-go-type': "json.RawMessage";
+        };
     };
 };
 declare const $AwardAccepted: {
@@ -2020,12 +2183,6 @@ declare const $ChainDefaults: {
             readonly description: "The Permit2 this chain's escrow verifies against, sent only when it is not the canonical deployment. When absent, use the canonical Permit2 address for the chain. EVM and Tron only.";
             readonly example: "0x000000000022D473030F116dDEE9F6B43aC78BA3";
         };
-        readonly deposit_witness_version: {
-            readonly type: "integer";
-            readonly minimum: 3;
-            readonly description: "Which deposit witness this chain's escrow expects. `4` and above select the four-member witness, `3` the two-member one; absent means four. EVM and Tron only - on Solana this is carried by `svm_signature_domain_version`.";
-            readonly example: 4;
-        };
         readonly tokens: {
             readonly type: "array";
             readonly description: "Tokens this chain's escrow accepts for deposit. Absent when the gateway has no listing for the chain, which does not mean no token is accepted.";
@@ -2058,7 +2215,13 @@ declare const $ChainDefaults: {
         readonly svm_signature_domain_version: {
             readonly type: "integer";
             readonly minimum: 1;
-            readonly description: "Solana only. Version of the escrow's signing domain. Absent for EVM and Tron.";
+            readonly description: "Solana only. The escrow's signature domain version, which the deposit hash commits to. Absent for EVM and Tron.";
+            readonly example: 5;
+        };
+        readonly deposit_request_hash_version: {
+            readonly type: "integer";
+            readonly minimum: 1;
+            readonly description: "The depositRequestHash version to sign for a deposit from this chain: 1 is keccak256 of the request_id, 2 is the hash of the payment terms, computed over the request body exactly as it is then posted. Absent means 1. A deposit signed with version 1 is still accepted while the gateway publishes 2. The gateway publishes 2 for a chain only once every reader of the deposit there reads version 2, veri-fill's release check included, so this is the network-wide signal a client signs by and a merchant lists 2 in an x402 or MPP challenge by.";
             readonly example: 2;
         };
     };
@@ -2426,109 +2589,25 @@ declare function needsSourceApproval(params: ApprovalParams): Promise<boolean>;
 declare function ensureSourceApproval(params: ApprovalParams): Promise<EnsureApprovalResult>;
 
 /**
- * EVM Permit2 PermitWitnessTransferFrom deposit prehash + EIP-712 digest.
- *
- * Byte-for-byte counterpart of the sibling Go encoder (deposit_encoder.go,
- * `EscrowDepositEncoder`). This is the sender-authorization scheme the Atum
- * protocol uses on EVM chains: it authorizes Permit2 to move tokens into the
- * escrow contract, with a DepositWitness {reserver, releaser}.
+ * EVM Permit2 PermitWitnessTransferFrom deposit prehash and EIP-712 digest.
  *
- * The sender signs the digest this produces, and the serialized prehash travels
- * to the settler as `message_prehash`, so BOTH the digest and the JSON
- * serialization (top-level key order, and `chainId` as a lowercase hex string
- * matching the Go encoder's %#x form) must stay pinned to the Go output. See
- * deposit-encoder.test.ts.
+ * Byte-for-byte counterpart of the Go encoder (deposit_encoder.go, `EscrowDepositEncoder`). The
+ * sender signs the digest, and the serialized prehash travels as `message_prehash`, so both the
+ * digest and the JSON serialization (top-level key order, `chainId` as lowercase hex) are pinned
+ * to the Go output. See deposit-encoder.test.ts.
  */
 /**
- * The Permit2 contract address deployed at the same address on all supported
- * EVM chains; the EIP-712 domain verifyingContract for PermitWitnessTransferFrom.
+ * The Permit2 contract, deployed at the same address on all supported EVM chains; the EIP-712
+ * domain verifyingContract for PermitWitnessTransferFrom.
  */
 declare const PERMIT2_CONTRACT_ADDRESS = "0x000000000022D473030F116dDEE9F6B43aC78BA3";
-interface PermitWitnessTransferFromParams {
-    /** EIP-155 chain ID. */
-    chainId: number;
-    /** The Permit2 contract (PERMIT2_CONTRACT_ADDRESS). */
-    verifyingContract: string;
-    /** TokenPermissions: source token + amount (smallest units, decimal string). */
-    token: string;
-    amount: string;
-    /** The escrow contract address (spender). */
-    spender: string;
-    nonce: bigint;
-    deadline: bigint;
-    /** DepositWitness (V3): reserver (quote selector) + releaser (fulfillment verifier). */
-    reserver: string;
-    releaser: string;
-}
-/**
- * Build the structured prehash for PermitWitnessTransferFrom. The shape is a
- * direct argument set for `wallet.signTypedData(domain, types, message)`:
- *  - `domain` carries only Permit2's on-chain EIP712Domain fields (name,
- *    chainId, verifyingContract; no `version`, no `salt`).
- *  - `types` omits an EIP712Domain entry (ethers derives it from the domain
- *    object's keys and rejects an explicit one).
- *  - `chainId` is emitted as a lowercase hex string to match the Go encoder's
- *    %#x serialization and the settler's `message_prehash` contract; the EIP-712
- *    digest itself is invariant to the number-vs-hex representation.
- */
-declare function createPermitWitnessTransferFromPrehash(params: PermitWitnessTransferFromParams): {
-    types: {
-        PermitWitnessTransferFrom: {
-            name: string;
-            type: string;
-        }[];
-        TokenPermissions: {
-            name: string;
-            type: string;
-        }[];
-        DepositWitness: {
-            name: string;
-            type: string;
-        }[];
-    };
-    primaryType: string;
-    domain: {
-        name: string;
-        chainId: string;
-        verifyingContract: string;
-    };
-    message: {
-        permitted: {
-            token: string;
-            amount: string;
-        };
-        spender: string;
-        nonce: string;
-        deadline: string;
-        witness: {
-            reserver: string;
-            releaser: string;
-        };
-    };
-};
-/**
- * Hash a PermitWitnessTransferFrom prehash into its EIP-712 digest (0x-prefixed
- * 32-byte hex). Accepts the object returned by
- * createPermitWitnessTransferFromPrehash (or an equivalent parsed from JSON).
- */
+/** Hash a PermitWitnessTransferFrom prehash (or one parsed from JSON) into its EIP-712 digest. */
 declare function hashPermitWitnessTransferFrom(prehash: {
     domain: any;
     types: any;
     message: any;
 }): string;
 
-/**
- * EVM Permit2 PermitWitnessTransferFrom sender-auth scheme.
- *
- * The encoder now lives in the shared @atum-labs/evm-escrow-encoding package
- * (byte-parity with the Go EscrowDepositEncoder). This module re-exports it so
- * the pg-client public API and the EVM chain adapter keep the same import
- * surface.
- */
-
-/** Hash a request ID string to a 32-byte identifier. V1 legacy, unused by the V3 deposit witness. */
-declare function hashRequestId(requestId: string): string;
-
 /**
  * Masks a chain ID to 4 bytes for Tron TIP-712 compatibility.
  *
@@ -2571,83 +2650,17 @@ declare function base58ToHex(base58Address: string): string;
 declare function normalizeAddress(address: string): string;
 
 /**
- * TVM (Tron) Permit2 PermitWitnessTransferFrom deposit prehash + TIP-712 digest.
+ * TVM (Tron) Permit2 PermitWitnessTransferFrom deposit prehash and TIP-712 digest.
  *
- * Byte-for-byte counterpart of the sibling Go encoder (deposit_encoder.go,
- * `EscrowDepositEncoder`). Same shape as the EVM deposit encoder, with the
- * Tron-specific normalization applied here: the chainId is masked to its lower
- * 4 bytes (Tron's TIP-712 domain uses a uint32 chainId) and every address is
- * converted from base58 to bare 20-byte hex (0x41 prefix stripped).
- *
- * The sender signs the digest this produces, and the serialized prehash travels
- * to the settler as `message_prehash`, so BOTH the digest and the JSON
- * serialization (key order, and `chainId` as a lowercase hex string) must stay
- * pinned to the Go output. See deposit-encoder.test.ts.
- *
- * V3: DepositWitness is `{reserver, releaser}` — `requestId` is gone.
+ * Byte-for-byte counterpart of the Go encoder (deposit_encoder.go, `EscrowDepositEncoder`). Same
+ * shape as the EVM deposit encoder, with Tron's normalization: the chainId is masked to its lower
+ * 4 bytes (Tron's TIP-712 domain uses a uint32 chainId) and every address is converted from base58
+ * to bare 20-byte hex (0x41 prefix stripped). The digest and the JSON serialization (key order,
+ * `chainId` as lowercase hex) are pinned to the Go output. See deposit-encoder.test.ts.
  */
 /**
- * Parameters for a TVM V3 Permit2 deposit prehash. Addresses may be base58 or
- * hex; they are normalized to bare 20-byte hex internally.
- */
-interface TvmPermitWitnessTransferFromParams {
-    chainId: number;
-    permit2Address: string;
-    tokenAddress: string;
-    amount: string;
-    spenderAddress: string;
-    nonce: bigint;
-    deadline: bigint;
-    reserverAddress: string;
-    releaserAddress: string;
-}
-/**
- * Build the V3 TIP-712 prehash for a Permit2 deposit on Tron, shaped for direct
- * `wallet.signTypedData(domain, types, message)` consumption:
- *  - `domain` carries only name, chainId (pre-masked, lowercase hex string),
- *    verifyingContract — Permit2's on-chain EIP712Domain has no version/salt.
- *  - `types` omits an EIP712Domain entry (ethers derives it from the domain keys).
- *  - all addresses are hex-normalized (0x41 prefix stripped).
- */
-declare function createTvmPermitWitnessTransferFromPrehash(params: TvmPermitWitnessTransferFromParams): {
-    types: {
-        PermitWitnessTransferFrom: {
-            name: string;
-            type: string;
-        }[];
-        TokenPermissions: {
-            name: string;
-            type: string;
-        }[];
-        DepositWitness: {
-            name: string;
-            type: string;
-        }[];
-    };
-    primaryType: string;
-    domain: {
-        name: string;
-        chainId: string;
-        verifyingContract: string;
-    };
-    message: {
-        permitted: {
-            token: string;
-            amount: string;
-        };
-        spender: string;
-        nonce: string;
-        deadline: string;
-        witness: {
-            reserver: string;
-            releaser: string;
-        };
-    };
-};
-/**
- * Hash a TVM Permit2 prehash into its TIP-712 digest (0x-prefixed 32-byte hex).
- * The Tron-specific work (chainId mask, address normalization) already happened
- * in createTvmPermitWitnessTransferFromPrehash.
+ * Hash a TVM Permit2 prehash into its TIP-712 digest. The Tron-specific normalization happens in
+ * the builder.
  */
 declare function hashTvmPermitWitnessTransferFrom(prehash: {
     domain: any;
@@ -2664,32 +2677,13 @@ declare function encodeU64LE(value: bigint): Uint8Array;
 declare const MAX_VALID_SLOT: number;
 
 /**
- * Solana deposit message sender auth scheme implementation.
- *
- * This module provides utilities for creating and hashing Solana deposit
- * authorization messages for the Atum payment gateway.
+ * Solana deposit helpers: replay nonces and base58/hex encoding.
  *
- * The deposit message is a 199-byte binary structure hashed with Keccak-256:
- *   keccak256("deposit" || payment_id[32] || depositor[32] || mint[32] ||
- *             amount[8,LE] || reserver[32] || releaser[32] ||
- *             nonce[8,LE] || issued_at[8,LE] || deadline[8,LE])
- *
- * encodeU64LE, generateSolanaNonce (generateNonce), and MAX_VALID_SLOT are
- * imported from the shared @atum-labs/solana-escrow-encoding package and
- * re-exported here to preserve the public API. base58ToBytes, payment-id
- * generation, and prehash creation stay local, because the local base58/hex
- * helpers carry the exact error messages the client tests assert.
- *
- * NO DEPOSIT HASH IS COMPUTED HERE ANY MORE. hashSolanaDeposit computed the
- * pre-domain-separation layout above and now throws (see its doc comment), and
- * hashSolanaDepositV3 was deleted as an un-exported third copy of the package's
- * own call. Build a deposit through the shared sender_auth adapter, which selects
- * the preimage from the escrow domain version; reach for computeDepositHash /
- * computeDepositHashV2 from the package if you need the raw primitive.
- *
- * The canonical reference is the @atum-labs/solana-escrow-encoding package in
- * this repo (contracts/svm/escrow-encoding), the TypeScript sibling of the
- * on-chain Solana escrow program and the Go signing library.
+ * Deposit authorizations are built through the shared sender_auth adapter
+ * (`getChainAdapter(chainId).buildAuthMessage(...)`), which commits the destination and reads the
+ * escrow's signature domain. For the raw primitive, use computeDepositHashV2 from
+ * @atum-labs/solana-escrow-encoding (contracts/svm/bindings/typescript/escrow-encoding), the encoding shared with the
+ * on-chain program and the Go signing library.
  */
 
 /** Replay horizon in seconds — deposit deadline must be within this window of issuedAt. */
@@ -2699,35 +2693,10 @@ declare const REPLAY_HORIZON_SECS = 128;
  * bounded set the escrow-encoding package defines, which keeps the replay_bucket PDAs reusable.
  */
 declare const TOTAL_BUCKETS = 131072;
-/** Exact byte size of a serialized deposit message (7 + 32*5 + 8*3). */
-declare const DEPOSIT_MESSAGE_SIZE = 199;
-/**
- * Parameters for constructing a Solana deposit authorization message.
- */
-interface SolanaDepositParams {
-    /** Base58 Solana public key of the depositor. */
-    depositor: string;
-    /** Base58 SPL token mint address. */
-    mint: string;
-    /** Token amount in smallest units (uint64). */
-    amount: bigint;
-    /** Base58 public key authorized to reserve funds (quote selector). */
-    reserver: string;
-    /** Base58 public key authorized to release/refund funds (fulfillment verifier). */
-    releaser: string;
-    /** Replay protection nonce (uint64). */
-    nonce: bigint;
-    /** Unix timestamp (seconds) when the authorization was created (uint64). */
-    issuedAt: bigint;
-    /** Unix timestamp (seconds) when the deposit authorization expires (uint64). */
-    deadline: bigint;
-    /** Original request ID string (used for payment ID generation). */
-    requestId: string;
-}
 /**
- * Decodes a Base58-encoded Solana public key to a 32-byte Uint8Array. Kept local
- * rather than using Pubkey.fromBase58: the client tests assert this exact
- * "Invalid Solana public key length" message.
+ * Decodes a Base58-encoded Solana public key to a 32-byte Uint8Array.
+ *
+ * @throws If the decoded key is not 32 bytes.
  */
 declare function base58ToBytes(address: string): Uint8Array;
 /**
@@ -2738,79 +2707,10 @@ declare function bytesToHex(bytes: Uint8Array): string;
  * Converts a hex string (with or without 0x prefix) to a Uint8Array.
  */
 declare function hexToBytes(hex: string): Uint8Array;
-/**
- * Generates a 32-byte payment ID from the request ID and deposit parameters.
- *
- * Formula: keccak256(requestId_str || "deposit" || depositor[32] ||
- *                    amount[8,LE] || reserver[32] || releaser[32] ||
- *                    nonce[8,LE] || issuedAt[8,LE] || deadline[8,LE])
- *
- * TODO: the V3 gateway simplified this to
- * just keccak256(requestID). When we migrate to v3, this function should change
- * to: return keccak256(toUtf8Bytes(requestId)); and the params argument can be
- * removed. The gateway reads payment_id from the prehash so both approaches work.
- *
- * @returns 0x-prefixed hex string (32 bytes)
- */
-declare function generateSolanaPaymentId(requestId: string, params: Omit<SolanaDepositParams, 'requestId'>): string;
-/**
- * Prehash structure for a Solana deposit message.
- * Uses base58 addresses and string numbers for settler parsing.
- */
-interface SolanaDepositPrehash {
-    payment_id: string;
-    depositor: string;
-    mint: string;
-    amount: string;
-    reserver: string;
-    releaser: string;
-    nonce: string;
-    issued_at: string;
-    deadline: string;
-}
-/**
- * Creates the JSON prehash structure for a Solana deposit message.
- * The prehash contains base58 addresses and string numbers, matching the
- * format the settler agent expects in `message_prehash`.
- *
- * @param paymentId 0x-prefixed hex string (32 bytes) from generateSolanaPaymentId()
- * @param params The deposit parameters
- * @returns The structured prehash object
- */
-declare function createSolanaDepositPrehash(paymentId: string, params: SolanaDepositParams): SolanaDepositPrehash;
-/**
- * REMOVED — this function computed the PRE-DOMAIN-SEPARATION deposit hash, which no deployed
- * escrow program accepts. It now throws rather than returning one.
- *
- * The layout it used, kept here as a record of the historical scheme:
- *
- *   keccak256("deposit" || payment_id[32] || depositor[32] || mint[32] ||
- *             amount[8,LE] || reserver[32] || releaser[32] ||
- *             nonce[8,LE] || issued_at[8,LE] || deadline[8,LE])        = 199 bytes
- *
- * Every current program prefixes the preimage with its domain —
- * `"escrow" || signature_domain_version || cluster_id[32] || program_id[32]` — and from domain
- * version 4 also binds `destination_hash`. So the 199-byte hash is not merely out of date, it is
- * unverifiable everywhere: `escrow.rs`'s `require!(deposit_hash == message, DepositHashMismatch)`
- * rejects it on every cluster.
- *
- * WHY IT THROWS INSTEAD OF BEING DELETED OR LEFT ALONE. It was exported from this package's
- * entry point, so removing the symbol outright is a hard break for any consumer that imports it,
- * while leaving it was worse: it returned a well-formed 32-byte hash that fails on-chain with
- * `DepositHashMismatch` and no indication why. Throwing turns an undiagnosable on-chain rejection into an
- * error at the call site that names the replacement.
- *
- * Build deposit authorizations through the shared sender_auth adapter
- * (`getChainAdapter(chainId).buildAuthMessage(...)`), which selects the correct preimage from the
- * domain version it is given and is the same implementation the facilitator verifies against.
- *
- * @throws Always.
- */
-declare function hashSolanaDeposit(_prehash: SolanaDepositPrehash): never;
 /**
  * Generates a valid nonce for Solana replay protection (upper 32 bits: random
- * bucket, lower 8 bits: random slot 0..MAX_VALID_SLOT). Delegates to the shared
- * package's generateNonce (which uses a CSPRNG with rejection sampling).
+ * bucket, lower 8 bits: random slot 0..MAX_VALID_SLOT), using a CSPRNG with
+ * rejection sampling.
  *
  * @returns A bigint nonce suitable for the deposit message
  */
@@ -2823,14 +2723,13 @@ declare function generateSolanaNonce(): bigint;
  * manually-crafted utilities for the Atum payment gateway.
  */
 
-declare const PAYMENT_REQUEST_VERSION = "1.0";
-
 /**
  * Applies a SenderSigner to an unsigned PaymentRequest, signing every entry in
- * signed_messages (filling each signature, and payload.delegate_signer where the
- * chain requires it). Mirrors the CLI signing step for SDK consumers. The gateway
- * verifies every signed message, so a multi-message request must have them all
- * signed; the common single-message case is signed exactly as before.
+ * signed_messages as given (filling each signature, and payload.delegate_signer where the
+ * chain requires it). The gateway verifies every signed message. To check what a request
+ * commits to before signing it, see docs/signing.md.
+ *
+ * @throws If the request has no signed_messages.
  */
 declare function signPaymentRequest(request: PaymentRequest, signer: SenderSigner): Promise<PaymentRequest>;
 type HttpRequestConstructor = new (config: OpenAPIConfig) => BaseHttpRequest;
@@ -2844,50 +2743,48 @@ declare const defaultGateway: string;
  * Default request-layer configuration, with `BASE` set to this package's default
  * gateway ({@link defaultGateway}, production-testnet).
  *
- * The generated value mirrors the first `servers` entry of the OpenAPI contract,
- * which is mainnet. This package defaults to testnet instead, so a client created
- * without an explicit URL never targets a live-funds environment. The override
- * lives here rather than in `src/generated/`, which is reproduced from the
- * contract and stays in sync with it.
+ * The OpenAPI contract's first `servers` entry is mainnet; this package defaults to testnet
+ * so a client created without an explicit URL never targets a live-funds environment.
  *
  * Exported for callers that want the default configuration shape.
- * {@link PaymentGatewayClient} does not read it: the client resolves its own
- * `BASE` and passes it explicitly.
+ * {@link PaymentGatewayClient} does not read it: the client resolves its own `BASE`.
  */
 declare const OpenAPI: OpenAPIConfig;
 /**
  * Default quote-collection window for {@link PaymentGatewayClient.prepareQuoteRequest}
- * (`quote_deadline = now + this`, in seconds). Chosen as the largest value that still
- * lands under the gateway's `quote_sync_wait_seconds` cap (5s): a sync (`?wait=true`)
- * request holds for `min(quote_deadline − receipt, cap)`, so ≤5s returns `ready` with
- * quotes inline while ≥6s returns a poll-instead `collecting`. 5s also gives the widest
- * collection window under that cap — enough to catch slower / backup settlers, where a
- * shorter window can drop them — plus headroom against client↔gateway clock skew. A
- * caller on a badly-skewed clock can still pass a larger `quoteDeadlineSeconds`.
+ * (`quote_deadline = now + this`, in seconds). Bidding closes at the quote deadline and the
+ * gateway always waits until then, so the window is time every quote request spends. 3s
+ * leaves settlers ample time to quote and lets a sync (`?wait=true`) request return `ready`
+ * with its quotes inline. A caller whose clock lags the gateway's should pass a larger
+ * `quoteDeadlineSeconds`, since the gateway refuses a quote deadline already in its past.
  */
-declare const DEFAULT_QUOTE_DEADLINE_SECONDS = 5;
+declare const DEFAULT_QUOTE_DEADLINE_SECONDS = 3;
 /** Default settlement horizon (`fulfillment_deadline = now + this`, seconds); shared by both request builders. */
 declare const DEFAULT_FULFILLMENT_DEADLINE_SECONDS = 3600;
 /**
  * Default `quote_deadline` the single-shot payment path ({@link PaymentGatewayClient.preparePaymentRequest})
- * stamps (seconds) when the caller passes no `quoteDeadlineSeconds`. Higher than the
- * quote-request default because the payment path is not bound by the quote sync-wait cap.
+ * stamps (seconds) when the caller passes no `quoteDeadlineSeconds`. The gateway runs the
+ * auction until this deadline before it awards a settler, so the window is time every
+ * payment spends. It has to cover signing and submitting the request as well as settlers
+ * quoting; 3s fits a signer that answers in well under a second. It is also how long a signed
+ * request stays submittable. Pass a larger `quoteDeadlineSeconds` when signing takes longer
+ * (for example a signer that waits for an approval), to submit the request later, or when the
+ * caller's clock lags the gateway's.
  */
-declare const DEFAULT_PAYMENT_QUOTE_DEADLINE_SECONDS = 10;
+declare const DEFAULT_PAYMENT_QUOTE_DEADLINE_SECONDS = 3;
 /**
  * Extended PaymentGatewayClient with convenience methods
  */
 declare class PaymentGatewayClient extends PaymentGatewayClient$1 {
     constructor(config?: PaymentGatewayClientConfig, HttpRequest?: HttpRequestConstructor);
     /**
-     * Fetches chain defaults from the payment gateway.
-     *
-     * Goes through the generated typed client, so the request shares the payment calls'
-     * transport: one base URL, one timeout policy, and `/v1/defaults` is described by the
-     * OpenAPI contract rather than assembled by hand here.
+     * Fetches chain defaults from the payment gateway (`GET /v1/defaults`), using the same
+     * base URL and timeout policy as the payment calls.
      *
      * @param chainId The CAIP-2 chain identifier (e.g., "eip155:42161")
      * @returns The chain defaults including escrow, quote selector, and fulfillment verifier
+     * @throws If the chain id is empty, the request fails, or the response is missing a
+     *   required field or describes a different chain.
      */
     fetchChainDefaults(chainId: string): Promise<ChainDefaults>;
     /**
@@ -2912,8 +2809,10 @@ declare class PaymentGatewayClient extends PaymentGatewayClient$1 {
      *   destinationAccount: "0xMerchantAddress",
      *   destinationAsset: "eip155:42161/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831", // USDC on Arbitrum
      *   fulfillmentAmount: "10000000", // 10 USDC (6 decimals)
+     *   maxSourceAmount: "10010000",   // at most 10.01 USDC from the payer (source units)
+     *   requestId: "order-4711",
      * });
-     * // max_source_amount, deadlines, request id, and nonce are all defaulted.
+     * // Deadlines and the nonce are defaulted; the spend cap never is.
      *
      * const signer = createSenderSigner("eip155:8453", { provider: "raw", privateKey });
      * await signPaymentRequest(request, signer); // fills sender_auth, ready to submit
@@ -2928,7 +2827,12 @@ declare class PaymentGatewayClient extends PaymentGatewayClient$1 {
         sourceAsset: string;
         destinationAccount: string;
         destinationAsset: string;
-        maxSourceAmount?: string;
+        /**
+         * REQUIRED spend cap in the source token's smallest units: signed into the Permit2 as the most
+         * the escrow may take. Never derived here, because that needs both tokens' decimals and a
+         * price. Build it from a settler quote with `capFromQuote`, or state it explicitly.
+         */
+        maxSourceAmount: string;
         /**
          * REQUIRED idempotency key. It seeds the deterministic deposit nonce, so a retry that
          * reuses the same `requestId` reproduces the same single-use permit (no double-charge),
@@ -2949,24 +2853,24 @@ declare class PaymentGatewayClient extends PaymentGatewayClient$1 {
         /** Clock source used to stamp the deadlines. Defaults to `Date.now`; inject for offline/deterministic builds. */
         now?: () => number;
         /**
-         * Explicit deposit-nonce override. OMIT this in normal use: the deposit's single-use nonce is
-         * then derived deterministically from `requestId` + depositor, so rebuilding the same payment
-         * reproduces the same nonce. What that guarantees differs by chain:
-         *   - EVM/Tron: the Permit2 nonce is a PERMANENT on-chain bitmap, so across any number of
-         *     rebuilds only one deposit can EVER settle — retry-safe without a time bound.
-         *   - Solana: the escrow replay nonce only protects within a ~128s window — the nonce pins the
-         *     replay slot/bucket, but `issued_at` is re-read on each build, so a rebuild in a later
-         *     window is not blocked on-chain by the nonce alone. The payment gateway's `request_id`
-         *     dedup (and the init-only deposit PDA, which blocks a byte-identical re-POST forever) are
-         *     the durable backstop; pin `issued_at` via `solanaClockReader` to keep a rebuild inside
-         *     the same window.
-         * Pass a value only to override the derived nonce.
+         * Explicit deposit-nonce override. Omit in normal use: the nonce is then derived from
+         * `requestId` + depositor, so rebuilding the same payment reproduces it.
+         *   - EVM/Tron: the Permit2 nonce is a permanent on-chain bitmap, so only one deposit can
+         *     settle across any number of rebuilds.
+         *   - Solana: the replay nonce is scoped to a ~128s window from `issued_at`, which is re-read
+         *     on each build. The gateway also deduplicates on `request_id`; pin `issued_at` via
+         *     `solanaClockReader` to keep a rebuild in the same window.
          */
         nonce?: bigint | string;
         /** Solana-only: override the RPC used to read the cluster clock for issued_at. */
         solanaRpcUrl?: string;
         /** Solana-only: injectable clock reader for `issued_at` (offline / test seam). */
         solanaClockReader?: SolanaClusterUnixTimeReader;
+        /**
+         * Who performs deposit, reserve, and fulfill. Omitted leaves the key off. Omitted on the
+         * wire means settler. Send-payment does not set this.
+         */
+        executor?: PaymentRequest['executor'];
         /**
          * Pre-resolved corridor addresses. Omit to fetch them from the gateway
          * `/v1/defaults`; supply to build offline. Each side is resolved independently —
@@ -2980,34 +2884,15 @@ declare class PaymentGatewayClient extends PaymentGatewayClient$1 {
     }): Promise<PaymentRequest>;
     /**
      * Prepares a quote-request body (`CreateQuoteRequest`), ready to POST to
-     * `/v1/payments/quote-requests`. This is the quote-phase counterpart to
-     * `preparePaymentRequest`: it builds the same corridor shape but **without
-     * `sender_auth`** — quote-time is the unauthenticated browse step, so no
-     * signing (and no private key) is required. The spend authorization arrives
-     * later, at the award call.
-     *
-     * Both deadlines are populated here because the gateway requires them and
-     * injects no defaults — it never mutates the originator-supplied body.
-     * `quote_deadline` bounds the collection window (default
-     * `DEFAULT_QUOTE_DEADLINE_SECONDS`); `fulfillment_deadline` bounds settlement
-     * (default `DEFAULT_FULFILLMENT_DEADLINE_SECONDS`). `quote_deadline` must be
-     * strictly earlier than `fulfillment_deadline` (enforced server-side; guarded
-     * here for a clear client-side error).
-     *
-     * `quote_deadline` is stamped client-side and the gateway rejects it unless it
-     * is strictly in the gateway's future, so a caller whose clock may lag the
-     * gateway should pass a larger `quoteDeadlineSeconds` (see
-     * `DEFAULT_QUOTE_DEADLINE_SECONDS` for why the default is what it is).
+     * `/v1/payments/quote-requests`. It carries the same corridor and contract fields as
+     * `preparePaymentRequest` but no `sender_auth`: quoting needs no signature or private key,
+     * and the spend authorization is supplied at award time.
      *
-     * Like `preparePaymentRequest`, this fetches the source/destination chain
-     * defaults and populates the SAME contract fields (`escrow_contract_address`,
-     * `quote_selector`, `fulfillment_verifier`, `fulfillment_proxy`). These are not
-     * optional in practice: the gateway requires `fulfillment_verifier` to build the
-     * request event it broadcasts to settlers, so the quote-request body
-     * must carry the identical contract fields the payment flow does. The ONLY
-     * field this drops relative to `preparePaymentRequest` is `sender_auth`, which
-     * is supplied at award time (quote-time is unauthenticated — no signing, no
-     * private key).
+     * Both deadlines are populated because the gateway requires them and injects no defaults.
+     * `quote_deadline` (default `DEFAULT_QUOTE_DEADLINE_SECONDS`) must be strictly earlier than
+     * `fulfillment_deadline` (default `DEFAULT_FULFILLMENT_DEADLINE_SECONDS`) and strictly in the
+     * gateway's future, so a caller whose clock lags the gateway should pass a larger
+     * `quoteDeadlineSeconds`.
      *
      * @param params Quote-request parameters
      * @returns A complete `CreateQuoteRequest` body (no signature step needed)
@@ -3018,6 +2903,12 @@ declare class PaymentGatewayClient extends PaymentGatewayClient$1 {
         sourceAsset: string;
         destinationAccount: string;
         destinationAsset: string;
+        /**
+         * Spend cap in the source token's smallest units; settlers' quotes above it are filtered.
+         * Omit it to request quotes with no cap: nothing is sent, and the SDK never derives one.
+         * A supplied value must be a positive base-10 integer. To cap a later payment from a quote,
+         * see `capFromQuote`.
+         */
         maxSourceAmount?: string;
         /**
          * The request id. Reuse the SAME value to retry: the gateway returns the original batch
@@ -3034,4 +2925,4 @@ declare class PaymentGatewayClient extends PaymentGatewayClient$1 {
     }): Promise<CreateQuoteRequest>;
 }
 
-export { $AuthorizationResult, $AwardAccepted, $AwardRequest, $AwardResponse, $AwardedPayment, $AwardedQuote, $BidAward, $ChainDefaults, $ChainDefaultsByChain, $CreateQuoteRequest, $DataIntegrityProof, $DeclineReason, $DeclineSummaryEntry, $ErrorResponse, $FulfillmentConfirmation, $GetDefaultsResult, $GetPaymentStatusResponse, $OwnedAsset, $PaymentBlockchainContext, $PaymentFailure, $PaymentRequest, $PaymentResponse, $PaymentStatus, $PaymentSummary, $PaymentTimelineResponse, $PaymentTransaction, $PaymentTransactions, $PreparePaymentRequest, $PreparePaymentResponse, $Quote, $QuoteRequestAccepted, $QuoteRequestResponse, $QuoteRequestStatusResponse, $ResolvePaymentResponse, $SenderAuth, $SenderAuthMessageScheme, $SignedMessage, $TimelineStep, $VerifiableCredential, $VerifiableCredentialAuth, ApiError, type ApiRequestOptions, type ApiResult, type ApprovalParams, AuthorizationsService, AuthorizePaymentData, AuthorizePaymentResponse, AwardQuoteData, AwardQuoteResponse, CancelError, CancelablePromise, type ChainDefaults, ChainDefaultsService, type ConfirmationOptions, CreateQuoteRequest, CreateQuoteRequestData, CreateQuoteRequestResponse, DEFAULT_FULFILLMENT_DEADLINE_SECONDS, DEFAULT_PAYMENT_QUOTE_DEADLINE_SECONDS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_QUOTE_DEADLINE_SECONDS, DEFAULT_REQUEST_TIMEOUT_MS, DEFAULT_SYNC_WAIT_TIMEOUT_MS, DEFAULT_WAIT_BUDGET_MS, DEPOSIT_MESSAGE_SIZE, type EnsureApprovalResult, ErrorResponse, GatewayTimeoutError, GetDefaultsData, GetDefaultsResponse, GetPaymentStatusData, GetPaymentStatusResponse2, GetPaymentTimelineData, GetPaymentTimelineResponse, GetQuoteRequestStatusData, GetQuoteRequestStatusResponse, HealthCheckResponse, HealthService, Interceptors, InvalidAccountError, type Reason as InvalidAccountReason, MAX_VALID_SLOT, type OnCancel, OpenAPI, type OpenAPIConfig, PAYMENT_REQUEST_VERSION, PERMIT2_CONTRACT_ADDRESS, type ParsedAssetIdentifier, PaymentGatewayClient, type PaymentGatewayClientConfig, PaymentRequest, PaymentsService, type PermitWitnessTransferFromParams, PreparePaymentData, PreparePaymentResponse2, QuoteRequestsService, REPLAY_HORIZON_SECS, type RequestTimeouts, ResolvePaymentData, ResolvePaymentResponse2, type SenderSignature, type SenderSigner, type SenderSignerOptions, SignedMessage, type SolanaClusterUnixTimeReader, type SolanaDepositParams, type SolanaDepositPrehash, type StatusSnapshot, SubmitPaymentData, SubmitPaymentResponse, TOTAL_BUCKETS, type TronWebLike, type TurnkeyConfig, TurnkeySenderSigner, type TvmPermitWitnessTransferFromParams, type WaitOutcome, type WaitParams, assetChainId, base58ToBytes, base58ToHex, bytesToHex, createPermitWitnessTransferFromPrehash, createSenderSigner, createSolanaDepositPrehash, createTvmPermitWitnessTransferFromPrehash, defaultGateway, encodeU64LE, ensureSourceApproval, generateSolanaNonce, generateSolanaPaymentId, getErrorResponse, hashPermitWitnessTransferFrom, hashRequestId, hashSolanaDeposit, hashTvmPermitWitnessTransferFrom, hexToBytes, isApiError, isGatewayTimeoutError, isTerminalStatus, isUnconfirmed, maskChainId, needsSourceApproval, normalizeAddress, parseAssetIdentifier, resolveTurnkeyAddresses, signPaymentRequest, waitForTerminalStatus };
+export { $AuthorizationResult, $AwardAccepted, $AwardRequest, $AwardResponse, $AwardedPayment, $AwardedQuote, $BidAward, $ChainDefaults, $ChainDefaultsByChain, $CreateQuoteRequest, $DataIntegrityProof, $DeclineReason, $DeclineSummaryEntry, $ErrorResponse, $FulfillmentAuthorization, $FulfillmentConfirmation, $GetDefaultsResult, $GetPaymentStatusResponse, $OwnedAsset, $PaymentBlockchainContext, $PaymentFailure, $PaymentRequest, $PaymentResponse, $PaymentStatus, $PaymentSummary, $PaymentTimelineResponse, $PaymentTransaction, $PaymentTransactions, $PreparePaymentRequest, $PreparePaymentResponse, $Quote, $QuoteRequestAccepted, $QuoteRequestResponse, $QuoteRequestStatusResponse, $RefundSignature, $ResolvePaymentResponse, $SenderAuth, $SenderAuthMessageScheme, $SignedMessage, $TimelineStep, $VerifiableCredential, $VerifiableCredentialAuth, ApiError, type ApiRequestOptions, type ApiResult, type ApprovalParams, AuthorizationsService, AuthorizePaymentData, AuthorizePaymentResponse, AwardQuoteData, AwardQuoteResponse, CancelError, CancelablePromise, type ChainDefaults, ChainDefaultsService, type ConfirmationOptions, CreateQuoteRequest, CreateQuoteRequestData, CreateQuoteRequestResponse, DEFAULT_FULFILLMENT_DEADLINE_SECONDS, DEFAULT_PAYMENT_QUOTE_DEADLINE_SECONDS, DEFAULT_POLL_INTERVAL_MS, DEFAULT_QUOTE_DEADLINE_SECONDS, DEFAULT_REQUEST_TIMEOUT_MS, DEFAULT_SYNC_WAIT_TIMEOUT_MS, DEFAULT_WAIT_BUDGET_MS, type EnsureApprovalResult, ErrorResponse, GatewayTimeoutError, GetDefaultsData, GetDefaultsResponse, GetPaymentStatusData, GetPaymentStatusResponse2, GetPaymentTimelineData, GetPaymentTimelineResponse, GetQuoteRequestStatusData, GetQuoteRequestStatusResponse, HealthCheckResponse, HealthService, Interceptors, InvalidAccountError, type Reason as InvalidAccountReason, MAX_VALID_SLOT, type OnCancel, OpenAPI, type OpenAPIConfig, VERSION as PAYMENT_REQUEST_VERSION, PERMIT2_CONTRACT_ADDRESS, type ParsedAssetIdentifier, PaymentGatewayClient, type PaymentGatewayClientConfig, PaymentRequest, PaymentsService, PreparePaymentData, PreparePaymentResponse2, QuoteRequestsService, REPLAY_HORIZON_SECS, type RequestTimeouts, ResolvePaymentData, ResolvePaymentResponse2, type SenderSignature, type SenderSigner, type SenderSignerOptions, SignedMessage, type SolanaClusterUnixTimeReader, type StatusSnapshot, SubmitPaymentData, SubmitPaymentResponse, TOTAL_BUCKETS, type TronWebLike, type TurnkeyConfig, TurnkeySenderSigner, type WaitOutcome, type WaitParams, assetChainId, base58ToBytes, base58ToHex, bytesToHex, capFromQuote, createSenderSigner, defaultGateway, encodeU64LE, ensureSourceApproval, generateSolanaNonce, getErrorResponse, hashPermitWitnessTransferFrom, hashTvmPermitWitnessTransferFrom, hexToBytes, isApiError, isGatewayTimeoutError, isTerminalStatus, isUnconfirmed, maskChainId, needsSourceApproval, normalizeAddress, parseAssetIdentifier, resolveTurnkeyAddresses, signPaymentRequest, waitForTerminalStatus };