@circle-fin/app-kit 1.15.3 → 1.17.0

package/unifiedBalance.d.cts

@@ -550,8 +550,23 @@ interface CCTPXChainConfig {
  * const contractType: KitContractType = 'bridge' // Valid
  * const invalidType: KitContractType = 'invalid' // TypeScript error
  * ```
- */
-type KitContractType = 'bridge' | 'adapter';
+ *
+ * @remarks
+ * `'senderPreservingBatcher'` carries a stricter requirement than the others,
+ * because setting it wrong fails silently rather than loudly. It must name a
+ * batching contract that preserves the calling EOA as `msg.sender` in every
+ * subcall — on Arc, the `Multicall3From` predeploy, which achieves that
+ * through the `CallFrom` precompile. The name is deliberately more specific
+ * than "batcher": the ubiquitous Multicall3 at
+ * `0xcA11bde05977b3631167028862bE2a173976CA11` has the same ABI and the same
+ * selectors but does **not** qualify, since each subcall would arrive as the
+ * Multicall3 contract, so a batched `approve` would grant an allowance from
+ * the batcher's own balance rather than from the user's — a field named just
+ * `batcher` would make that misconfiguration look valid. Leave
+ * `senderPreservingBatcher` unset on any chain lacking one; an unset field
+ * simply means callers fall back to submitting calls one at a time.
+ */
+type KitContractType = 'bridge' | 'adapter' | 'senderPreservingBatcher';
 /**
  * Configuration for Gateway v1 contracts.
  *
@@ -1208,8 +1223,13 @@ type PreparedChainRequest = EvmPreparedChainRequest | SolanaPreparedChainRequest
  * Parameters for preparing an EVM contract execution.
  */
 type EvmPreparedChainRequestParams = {
-    /** The type of the prepared execution. */
-    type: 'evm';
+    /**
+     * The type of the prepared execution. Optional here because EVM is the
+     * only chain type `Adapter.prepare()` implementations narrow their param
+     * type to in practice — callers that only ever prepare EVM requests can
+     * omit it rather than repeat a discriminator that never varies for them.
+     */
+    type?: 'evm';
     /** The ABI of the contract. */
     abi: Abi | string[];
     /** The address of the contract. */
@@ -2488,6 +2508,57 @@ interface EarnActionMap {
     readonly claimRewards: ExecuteEarnParams;
 }
 
+/** Permit standards accepted by Borrow Adapter executions. */
+declare enum BorrowPermitType {
+    /** Tokens must be approved separately. */
+    NONE = 0,
+    /** EIP-2612 permit calldata accompanies the token input. */
+    EIP2612 = 1
+}
+/** Token input forwarded by Borrow Kit to the Adapter Contract. */
+interface BorrowTokenInput {
+    readonly permitType: BorrowPermitType;
+    readonly token: `0x${string}`;
+    readonly amount: bigint;
+    readonly permitCalldata: `0x${string}`;
+}
+/** A single instruction in a Circle-signed Borrow execution. */
+interface BorrowInstruction {
+    readonly target: `0x${string}`;
+    readonly data: `0x${string}`;
+    readonly value: string | bigint;
+    readonly tokenIn: `0x${string}`;
+    readonly amountToApprove: string | bigint;
+    readonly tokenOut: `0x${string}`;
+    readonly minTokenOut: string | bigint;
+}
+/** A token recipient in a Circle-signed Borrow execution. */
+interface BorrowTokenRecipient {
+    readonly token: `0x${string}`;
+    readonly beneficiary: `0x${string}`;
+}
+/** Circle-signed Borrow parameters forwarded to the Adapter Contract. */
+interface BorrowExecutionParams {
+    readonly instructions: readonly BorrowInstruction[];
+    readonly tokens: readonly BorrowTokenRecipient[];
+    readonly execId: string | bigint;
+    readonly deadline: string | bigint;
+    readonly metadata: `0x${string}`;
+}
+/** Parameters for a service-signed Borrow Adapter execution. */
+interface ExecuteBorrowParams extends ActionParameters {
+    readonly executeParams: BorrowExecutionParams;
+    readonly tokenInputs: BorrowTokenInput[];
+    readonly signature: `0x${string}`;
+}
+/** Borrow actions supported by EVM adapters. */
+interface BorrowActionMap {
+    /** Execute a Circle-signed partial loan repayment. */
+    readonly repay: ExecuteBorrowParams;
+    /** Execute a Circle-signed borrow. */
+    readonly execute: ExecuteBorrowParams;
+}
+
 /**
  * Single instruction to execute within the Adapter Contract.
  *
@@ -3444,6 +3515,8 @@ interface NativeActionMap {
  * @see {@link ActionPayload} for extracting payload types
  */
 interface ActionMap {
+    /** Borrow operations that execute service-signed payloads. */
+    readonly borrow: BorrowActionMap;
     /** CCTP-specific operations with automatic address resolution. */
     readonly cctp: CCTPActionMap;
     /** CCTPx operations (CrossChainTokenService) for cross-chain transfers of registered tokens (Circle-issued or otherwise). */
@@ -3463,6 +3536,7 @@ interface ActionMap {
     /** Earn operations that execute service-signed payloads via the adapter contract. */
     readonly earn: EarnActionMap;
 }
+
 /**
  * Determine if a type represents an action parameter object (leaf node).
  *
@@ -4292,6 +4366,7 @@ interface ErrorInfo {
  * - retryDelay: Base delay (ms); constant wait for `'fixed'` or exponential seed for `'exponential'`
  * - backoff: Retry-delay strategy, `'fixed'` (default) or `'exponential'`
  * - maxRetryDelayMs: Optional ceiling (ms) for a single backoff wait
+ * - isTerminalError: Optional predicate marking an error non-retryable
  * - headers: Optional HTTP headers to include with each request
  */
 interface ApiPollingConfig {
@@ -4321,6 +4396,18 @@ interface ApiPollingConfig {
      * {@link DEFAULT_MAX_RETRY_DELAY_MS} when omitted.
      */
     maxRetryDelayMs?: number | undefined;
+    /**
+     * Optional predicate that marks a failed attempt as terminal so the poller
+     * throws it immediately instead of spending the remaining retry budget.
+     *
+     * It is consulted before the built-in retry rules, so it can short-circuit an
+     * error those rules would otherwise retry — for example a `404` that a given
+     * route knows is deterministic (the resource does not exist) rather than
+     * transient. The predicate receives the attempt's `Error`, including any
+     * `responseBody` the request attached, and returning `true` skips all
+     * remaining retries. Omit it to keep the default retry policy.
+     */
+    isTerminalError?: ((error: Error) => boolean) | undefined;
     /** Optional HTTP headers to include with requests */
     headers?: Record<string, string> | undefined;
 }
@@ -6939,8 +7026,8 @@ interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = Adapt
      * The token allowance strategy to authorize the deposit.
      *
      * Only valid for same-chain (STANDARD) deposits. Must not be set when
-     * `to` is provided (FAST cross-chain deposits do not use an allowance
-     * strategy).
+     * `config.transferSpeed` is `'FAST'` (FAST cross-chain deposits do not use
+     * an allowance strategy).
      *
      * @defaultValue 'authorize'
      */
@@ -6953,6 +7040,10 @@ interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = Adapt
      * chain, which then calls Gateway `deposit` in a single relayed flow.
      *
      * Must not be set when `config.transferSpeed` is `'STANDARD'`.
+     *
+     * @defaultValue `{ chain: 'Arc' }` for mainnet sources and
+     *   `{ chain: 'Arc_Testnet' }` for testnet sources when
+     *   `config.transferSpeed` is `'FAST'`.
      */
     to?: {
         chain: UnifiedBalanceChainIdentifier;
@@ -6961,7 +7052,7 @@ interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = Adapt
      * Transfer configuration for the deposit.
      *
      * @defaultValue `{ transferSpeed: 'STANDARD' }`. Set `transferSpeed: 'FAST'`
-     *   explicitly for cross-chain deposits (when `to` is provided).
+     *   explicitly for cross-chain deposits; `to` defaults to Arc when omitted.
      */
     config?: DepositConfig;
     /**
@@ -7096,13 +7187,15 @@ interface DepositResult {
     /**
      * Source chain of the cross-chain deposit (FAST path only).
      *
-     * Present when `to` was specified in the deposit params.
+     * Present for every FAST deposit, including those where `to` was omitted
+     * and defaulted to Arc.
      */
     sourceChain?: Blockchain;
     /**
      * Destination chain of the cross-chain deposit (FAST path only).
      *
-     * Present when `to` was specified in the deposit params.
+     * Present for every FAST deposit. When `to` was omitted this is the
+     * default destination (`Arc` or `Arc_Testnet`).
      */
     destinationChain?: Blockchain;
     /**
@@ -7188,8 +7281,11 @@ interface EstimateDepositParams<TAdapterCapabilities extends AdapterCapabilities
     /**
      * Destination chain for a FAST cross-chain deposit.
      *
-     * Required when `config.transferSpeed` is `'FAST'`.
      * Must not be set when `config.transferSpeed` is `'STANDARD'` (the default).
+     *
+     * @defaultValue `{ chain: 'Arc' }` for mainnet sources and
+     *   `{ chain: 'Arc_Testnet' }` for testnet sources when
+     *   `config.transferSpeed` is `'FAST'`.
      */
     to?: {
         chain: UnifiedBalanceChainIdentifier;
@@ -8045,7 +8141,8 @@ declare class AppKitUnifiedBalance {
      * {@link AppKitUnifiedBalance.depositFor}.
      *
      * @param params - Estimate details including the depositor context, amount,
-     *   destination chain, and optional transfer speed.
+     *   destination chain (defaults to Arc / Arc_Testnet for FAST), and optional
+     *   transfer speed.
      * @returns Promise resolving to the itemised fee estimate.
      * @throws {KitError} If the estimate parameters are invalid or the route is
      *   unsupported.

package/unifiedBalance.d.mts

@@ -550,8 +550,23 @@ interface CCTPXChainConfig {
  * const contractType: KitContractType = 'bridge' // Valid
  * const invalidType: KitContractType = 'invalid' // TypeScript error
  * ```
- */
-type KitContractType = 'bridge' | 'adapter';
+ *
+ * @remarks
+ * `'senderPreservingBatcher'` carries a stricter requirement than the others,
+ * because setting it wrong fails silently rather than loudly. It must name a
+ * batching contract that preserves the calling EOA as `msg.sender` in every
+ * subcall — on Arc, the `Multicall3From` predeploy, which achieves that
+ * through the `CallFrom` precompile. The name is deliberately more specific
+ * than "batcher": the ubiquitous Multicall3 at
+ * `0xcA11bde05977b3631167028862bE2a173976CA11` has the same ABI and the same
+ * selectors but does **not** qualify, since each subcall would arrive as the
+ * Multicall3 contract, so a batched `approve` would grant an allowance from
+ * the batcher's own balance rather than from the user's — a field named just
+ * `batcher` would make that misconfiguration look valid. Leave
+ * `senderPreservingBatcher` unset on any chain lacking one; an unset field
+ * simply means callers fall back to submitting calls one at a time.
+ */
+type KitContractType = 'bridge' | 'adapter' | 'senderPreservingBatcher';
 /**
  * Configuration for Gateway v1 contracts.
  *
@@ -1208,8 +1223,13 @@ type PreparedChainRequest = EvmPreparedChainRequest | SolanaPreparedChainRequest
  * Parameters for preparing an EVM contract execution.
  */
 type EvmPreparedChainRequestParams = {
-    /** The type of the prepared execution. */
-    type: 'evm';
+    /**
+     * The type of the prepared execution. Optional here because EVM is the
+     * only chain type `Adapter.prepare()` implementations narrow their param
+     * type to in practice — callers that only ever prepare EVM requests can
+     * omit it rather than repeat a discriminator that never varies for them.
+     */
+    type?: 'evm';
     /** The ABI of the contract. */
     abi: Abi | string[];
     /** The address of the contract. */
@@ -2488,6 +2508,57 @@ interface EarnActionMap {
     readonly claimRewards: ExecuteEarnParams;
 }
 
+/** Permit standards accepted by Borrow Adapter executions. */
+declare enum BorrowPermitType {
+    /** Tokens must be approved separately. */
+    NONE = 0,
+    /** EIP-2612 permit calldata accompanies the token input. */
+    EIP2612 = 1
+}
+/** Token input forwarded by Borrow Kit to the Adapter Contract. */
+interface BorrowTokenInput {
+    readonly permitType: BorrowPermitType;
+    readonly token: `0x${string}`;
+    readonly amount: bigint;
+    readonly permitCalldata: `0x${string}`;
+}
+/** A single instruction in a Circle-signed Borrow execution. */
+interface BorrowInstruction {
+    readonly target: `0x${string}`;
+    readonly data: `0x${string}`;
+    readonly value: string | bigint;
+    readonly tokenIn: `0x${string}`;
+    readonly amountToApprove: string | bigint;
+    readonly tokenOut: `0x${string}`;
+    readonly minTokenOut: string | bigint;
+}
+/** A token recipient in a Circle-signed Borrow execution. */
+interface BorrowTokenRecipient {
+    readonly token: `0x${string}`;
+    readonly beneficiary: `0x${string}`;
+}
+/** Circle-signed Borrow parameters forwarded to the Adapter Contract. */
+interface BorrowExecutionParams {
+    readonly instructions: readonly BorrowInstruction[];
+    readonly tokens: readonly BorrowTokenRecipient[];
+    readonly execId: string | bigint;
+    readonly deadline: string | bigint;
+    readonly metadata: `0x${string}`;
+}
+/** Parameters for a service-signed Borrow Adapter execution. */
+interface ExecuteBorrowParams extends ActionParameters {
+    readonly executeParams: BorrowExecutionParams;
+    readonly tokenInputs: BorrowTokenInput[];
+    readonly signature: `0x${string}`;
+}
+/** Borrow actions supported by EVM adapters. */
+interface BorrowActionMap {
+    /** Execute a Circle-signed partial loan repayment. */
+    readonly repay: ExecuteBorrowParams;
+    /** Execute a Circle-signed borrow. */
+    readonly execute: ExecuteBorrowParams;
+}
+
 /**
  * Single instruction to execute within the Adapter Contract.
  *
@@ -3444,6 +3515,8 @@ interface NativeActionMap {
  * @see {@link ActionPayload} for extracting payload types
  */
 interface ActionMap {
+    /** Borrow operations that execute service-signed payloads. */
+    readonly borrow: BorrowActionMap;
     /** CCTP-specific operations with automatic address resolution. */
     readonly cctp: CCTPActionMap;
     /** CCTPx operations (CrossChainTokenService) for cross-chain transfers of registered tokens (Circle-issued or otherwise). */
@@ -3463,6 +3536,7 @@ interface ActionMap {
     /** Earn operations that execute service-signed payloads via the adapter contract. */
     readonly earn: EarnActionMap;
 }
+
 /**
  * Determine if a type represents an action parameter object (leaf node).
  *
@@ -4292,6 +4366,7 @@ interface ErrorInfo {
  * - retryDelay: Base delay (ms); constant wait for `'fixed'` or exponential seed for `'exponential'`
  * - backoff: Retry-delay strategy, `'fixed'` (default) or `'exponential'`
  * - maxRetryDelayMs: Optional ceiling (ms) for a single backoff wait
+ * - isTerminalError: Optional predicate marking an error non-retryable
  * - headers: Optional HTTP headers to include with each request
  */
 interface ApiPollingConfig {
@@ -4321,6 +4396,18 @@ interface ApiPollingConfig {
      * {@link DEFAULT_MAX_RETRY_DELAY_MS} when omitted.
      */
     maxRetryDelayMs?: number | undefined;
+    /**
+     * Optional predicate that marks a failed attempt as terminal so the poller
+     * throws it immediately instead of spending the remaining retry budget.
+     *
+     * It is consulted before the built-in retry rules, so it can short-circuit an
+     * error those rules would otherwise retry — for example a `404` that a given
+     * route knows is deterministic (the resource does not exist) rather than
+     * transient. The predicate receives the attempt's `Error`, including any
+     * `responseBody` the request attached, and returning `true` skips all
+     * remaining retries. Omit it to keep the default retry policy.
+     */
+    isTerminalError?: ((error: Error) => boolean) | undefined;
     /** Optional HTTP headers to include with requests */
     headers?: Record<string, string> | undefined;
 }
@@ -6939,8 +7026,8 @@ interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = Adapt
      * The token allowance strategy to authorize the deposit.
      *
      * Only valid for same-chain (STANDARD) deposits. Must not be set when
-     * `to` is provided (FAST cross-chain deposits do not use an allowance
-     * strategy).
+     * `config.transferSpeed` is `'FAST'` (FAST cross-chain deposits do not use
+     * an allowance strategy).
      *
      * @defaultValue 'authorize'
      */
@@ -6953,6 +7040,10 @@ interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = Adapt
      * chain, which then calls Gateway `deposit` in a single relayed flow.
      *
      * Must not be set when `config.transferSpeed` is `'STANDARD'`.
+     *
+     * @defaultValue `{ chain: 'Arc' }` for mainnet sources and
+     *   `{ chain: 'Arc_Testnet' }` for testnet sources when
+     *   `config.transferSpeed` is `'FAST'`.
      */
     to?: {
         chain: UnifiedBalanceChainIdentifier;
@@ -6961,7 +7052,7 @@ interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = Adapt
      * Transfer configuration for the deposit.
      *
      * @defaultValue `{ transferSpeed: 'STANDARD' }`. Set `transferSpeed: 'FAST'`
-     *   explicitly for cross-chain deposits (when `to` is provided).
+     *   explicitly for cross-chain deposits; `to` defaults to Arc when omitted.
      */
     config?: DepositConfig;
     /**
@@ -7096,13 +7187,15 @@ interface DepositResult {
     /**
      * Source chain of the cross-chain deposit (FAST path only).
      *
-     * Present when `to` was specified in the deposit params.
+     * Present for every FAST deposit, including those where `to` was omitted
+     * and defaulted to Arc.
      */
     sourceChain?: Blockchain;
     /**
      * Destination chain of the cross-chain deposit (FAST path only).
      *
-     * Present when `to` was specified in the deposit params.
+     * Present for every FAST deposit. When `to` was omitted this is the
+     * default destination (`Arc` or `Arc_Testnet`).
      */
     destinationChain?: Blockchain;
     /**
@@ -7188,8 +7281,11 @@ interface EstimateDepositParams<TAdapterCapabilities extends AdapterCapabilities
     /**
      * Destination chain for a FAST cross-chain deposit.
      *
-     * Required when `config.transferSpeed` is `'FAST'`.
      * Must not be set when `config.transferSpeed` is `'STANDARD'` (the default).
+     *
+     * @defaultValue `{ chain: 'Arc' }` for mainnet sources and
+     *   `{ chain: 'Arc_Testnet' }` for testnet sources when
+     *   `config.transferSpeed` is `'FAST'`.
      */
     to?: {
         chain: UnifiedBalanceChainIdentifier;
@@ -8045,7 +8141,8 @@ declare class AppKitUnifiedBalance {
      * {@link AppKitUnifiedBalance.depositFor}.
      *
      * @param params - Estimate details including the depositor context, amount,
-     *   destination chain, and optional transfer speed.
+     *   destination chain (defaults to Arc / Arc_Testnet for FAST), and optional
+     *   transfer speed.
      * @returns Promise resolving to the itemised fee estimate.
      * @throws {KitError} If the estimate parameters are invalid or the route is
      *   unsupported.

package/unifiedBalance.d.ts

@@ -550,8 +550,23 @@ interface CCTPXChainConfig {
  * const contractType: KitContractType = 'bridge' // Valid
  * const invalidType: KitContractType = 'invalid' // TypeScript error
  * ```
- */
-type KitContractType = 'bridge' | 'adapter';
+ *
+ * @remarks
+ * `'senderPreservingBatcher'` carries a stricter requirement than the others,
+ * because setting it wrong fails silently rather than loudly. It must name a
+ * batching contract that preserves the calling EOA as `msg.sender` in every
+ * subcall — on Arc, the `Multicall3From` predeploy, which achieves that
+ * through the `CallFrom` precompile. The name is deliberately more specific
+ * than "batcher": the ubiquitous Multicall3 at
+ * `0xcA11bde05977b3631167028862bE2a173976CA11` has the same ABI and the same
+ * selectors but does **not** qualify, since each subcall would arrive as the
+ * Multicall3 contract, so a batched `approve` would grant an allowance from
+ * the batcher's own balance rather than from the user's — a field named just
+ * `batcher` would make that misconfiguration look valid. Leave
+ * `senderPreservingBatcher` unset on any chain lacking one; an unset field
+ * simply means callers fall back to submitting calls one at a time.
+ */
+type KitContractType = 'bridge' | 'adapter' | 'senderPreservingBatcher';
 /**
  * Configuration for Gateway v1 contracts.
  *
@@ -1208,8 +1223,13 @@ type PreparedChainRequest = EvmPreparedChainRequest | SolanaPreparedChainRequest
  * Parameters for preparing an EVM contract execution.
  */
 type EvmPreparedChainRequestParams = {
-    /** The type of the prepared execution. */
-    type: 'evm';
+    /**
+     * The type of the prepared execution. Optional here because EVM is the
+     * only chain type `Adapter.prepare()` implementations narrow their param
+     * type to in practice — callers that only ever prepare EVM requests can
+     * omit it rather than repeat a discriminator that never varies for them.
+     */
+    type?: 'evm';
     /** The ABI of the contract. */
     abi: Abi | string[];
     /** The address of the contract. */
@@ -2488,6 +2508,57 @@ interface EarnActionMap {
     readonly claimRewards: ExecuteEarnParams;
 }
 
+/** Permit standards accepted by Borrow Adapter executions. */
+declare enum BorrowPermitType {
+    /** Tokens must be approved separately. */
+    NONE = 0,
+    /** EIP-2612 permit calldata accompanies the token input. */
+    EIP2612 = 1
+}
+/** Token input forwarded by Borrow Kit to the Adapter Contract. */
+interface BorrowTokenInput {
+    readonly permitType: BorrowPermitType;
+    readonly token: `0x${string}`;
+    readonly amount: bigint;
+    readonly permitCalldata: `0x${string}`;
+}
+/** A single instruction in a Circle-signed Borrow execution. */
+interface BorrowInstruction {
+    readonly target: `0x${string}`;
+    readonly data: `0x${string}`;
+    readonly value: string | bigint;
+    readonly tokenIn: `0x${string}`;
+    readonly amountToApprove: string | bigint;
+    readonly tokenOut: `0x${string}`;
+    readonly minTokenOut: string | bigint;
+}
+/** A token recipient in a Circle-signed Borrow execution. */
+interface BorrowTokenRecipient {
+    readonly token: `0x${string}`;
+    readonly beneficiary: `0x${string}`;
+}
+/** Circle-signed Borrow parameters forwarded to the Adapter Contract. */
+interface BorrowExecutionParams {
+    readonly instructions: readonly BorrowInstruction[];
+    readonly tokens: readonly BorrowTokenRecipient[];
+    readonly execId: string | bigint;
+    readonly deadline: string | bigint;
+    readonly metadata: `0x${string}`;
+}
+/** Parameters for a service-signed Borrow Adapter execution. */
+interface ExecuteBorrowParams extends ActionParameters {
+    readonly executeParams: BorrowExecutionParams;
+    readonly tokenInputs: BorrowTokenInput[];
+    readonly signature: `0x${string}`;
+}
+/** Borrow actions supported by EVM adapters. */
+interface BorrowActionMap {
+    /** Execute a Circle-signed partial loan repayment. */
+    readonly repay: ExecuteBorrowParams;
+    /** Execute a Circle-signed borrow. */
+    readonly execute: ExecuteBorrowParams;
+}
+
 /**
  * Single instruction to execute within the Adapter Contract.
  *
@@ -3444,6 +3515,8 @@ interface NativeActionMap {
  * @see {@link ActionPayload} for extracting payload types
  */
 interface ActionMap {
+    /** Borrow operations that execute service-signed payloads. */
+    readonly borrow: BorrowActionMap;
     /** CCTP-specific operations with automatic address resolution. */
     readonly cctp: CCTPActionMap;
     /** CCTPx operations (CrossChainTokenService) for cross-chain transfers of registered tokens (Circle-issued or otherwise). */
@@ -3463,6 +3536,7 @@ interface ActionMap {
     /** Earn operations that execute service-signed payloads via the adapter contract. */
     readonly earn: EarnActionMap;
 }
+
 /**
  * Determine if a type represents an action parameter object (leaf node).
  *
@@ -4292,6 +4366,7 @@ interface ErrorInfo {
  * - retryDelay: Base delay (ms); constant wait for `'fixed'` or exponential seed for `'exponential'`
  * - backoff: Retry-delay strategy, `'fixed'` (default) or `'exponential'`
  * - maxRetryDelayMs: Optional ceiling (ms) for a single backoff wait
+ * - isTerminalError: Optional predicate marking an error non-retryable
  * - headers: Optional HTTP headers to include with each request
  */
 interface ApiPollingConfig {
@@ -4321,6 +4396,18 @@ interface ApiPollingConfig {
      * {@link DEFAULT_MAX_RETRY_DELAY_MS} when omitted.
      */
     maxRetryDelayMs?: number | undefined;
+    /**
+     * Optional predicate that marks a failed attempt as terminal so the poller
+     * throws it immediately instead of spending the remaining retry budget.
+     *
+     * It is consulted before the built-in retry rules, so it can short-circuit an
+     * error those rules would otherwise retry — for example a `404` that a given
+     * route knows is deterministic (the resource does not exist) rather than
+     * transient. The predicate receives the attempt's `Error`, including any
+     * `responseBody` the request attached, and returning `true` skips all
+     * remaining retries. Omit it to keep the default retry policy.
+     */
+    isTerminalError?: ((error: Error) => boolean) | undefined;
     /** Optional HTTP headers to include with requests */
     headers?: Record<string, string> | undefined;
 }
@@ -6939,8 +7026,8 @@ interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = Adapt
      * The token allowance strategy to authorize the deposit.
      *
      * Only valid for same-chain (STANDARD) deposits. Must not be set when
-     * `to` is provided (FAST cross-chain deposits do not use an allowance
-     * strategy).
+     * `config.transferSpeed` is `'FAST'` (FAST cross-chain deposits do not use
+     * an allowance strategy).
      *
      * @defaultValue 'authorize'
      */
@@ -6953,6 +7040,10 @@ interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = Adapt
      * chain, which then calls Gateway `deposit` in a single relayed flow.
      *
      * Must not be set when `config.transferSpeed` is `'STANDARD'`.
+     *
+     * @defaultValue `{ chain: 'Arc' }` for mainnet sources and
+     *   `{ chain: 'Arc_Testnet' }` for testnet sources when
+     *   `config.transferSpeed` is `'FAST'`.
      */
     to?: {
         chain: UnifiedBalanceChainIdentifier;
@@ -6961,7 +7052,7 @@ interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = Adapt
      * Transfer configuration for the deposit.
      *
      * @defaultValue `{ transferSpeed: 'STANDARD' }`. Set `transferSpeed: 'FAST'`
-     *   explicitly for cross-chain deposits (when `to` is provided).
+     *   explicitly for cross-chain deposits; `to` defaults to Arc when omitted.
      */
     config?: DepositConfig;
     /**
@@ -7096,13 +7187,15 @@ interface DepositResult {
     /**
      * Source chain of the cross-chain deposit (FAST path only).
      *
-     * Present when `to` was specified in the deposit params.
+     * Present for every FAST deposit, including those where `to` was omitted
+     * and defaulted to Arc.
      */
     sourceChain?: Blockchain;
     /**
      * Destination chain of the cross-chain deposit (FAST path only).
      *
-     * Present when `to` was specified in the deposit params.
+     * Present for every FAST deposit. When `to` was omitted this is the
+     * default destination (`Arc` or `Arc_Testnet`).
      */
     destinationChain?: Blockchain;
     /**
@@ -7188,8 +7281,11 @@ interface EstimateDepositParams<TAdapterCapabilities extends AdapterCapabilities
     /**
      * Destination chain for a FAST cross-chain deposit.
      *
-     * Required when `config.transferSpeed` is `'FAST'`.
      * Must not be set when `config.transferSpeed` is `'STANDARD'` (the default).
+     *
+     * @defaultValue `{ chain: 'Arc' }` for mainnet sources and
+     *   `{ chain: 'Arc_Testnet' }` for testnet sources when
+     *   `config.transferSpeed` is `'FAST'`.
      */
     to?: {
         chain: UnifiedBalanceChainIdentifier;
@@ -8045,7 +8141,8 @@ declare class AppKitUnifiedBalance {
      * {@link AppKitUnifiedBalance.depositFor}.
      *
      * @param params - Estimate details including the depositor context, amount,
-     *   destination chain, and optional transfer speed.
+     *   destination chain (defaults to Arc / Arc_Testnet for FAST), and optional
+     *   transfer speed.
      * @returns Promise resolving to the itemised fee estimate.
      * @throws {KitError} If the estimate parameters are invalid or the route is
      *   unsupported.