@circle-fin/app-kit 1.13.0 → 1.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/index.d.mts CHANGED
@@ -559,6 +559,19 @@ interface GatewayV1Contracts {
559
559
  * @example "0xD05E7D2E7d30b92c5F17d7d0fC575fce231F1A48"
560
560
  */
561
561
  depositForHandler?: string;
562
+ /**
563
+ * The address of the `GenericExecutor` contract.
564
+ *
565
+ * @description Optional. The contract that acts as `mintRecipient` and
566
+ * `destinationCaller` for the CCTP v2 prepaid FORWARD path. It receives the
567
+ * CCTP mint and calls {@link GatewayV1Contracts.depositForHandler} to
568
+ * complete the fast deposit into the {@link GatewayV1Contracts.wallet}.
569
+ * Present only on chains that are fast-deposit destinations; other Gateway
570
+ * chains omit it.
571
+ *
572
+ * @example "0xFa7be2f04F3Ad4ca969260729c6d45B5625984A7"
573
+ */
574
+ genericExecutor?: string;
562
575
  }
563
576
  /**
564
577
  * Versioned map of Gateway contract configurations.
@@ -1403,6 +1416,7 @@ declare const ArcTestnet: {
1403
1416
  readonly wallet: "0x0077777d7EBA4688BDeF3E311b846F25870A19B9";
1404
1417
  readonly minter: "0x0022222ABE238Cc2C7Bb1f21003F0a260052475B";
1405
1418
  readonly depositForHandler: "0xD05E7D2E7d30b92c5F17d7d0fC575fce231F1A48";
1419
+ readonly genericExecutor: "0xEdC81040756AcCfF070c21D37b265b9D0b5Ba45e";
1406
1420
  };
1407
1421
  };
1408
1422
  readonly forwarderSupported: {
@@ -1595,6 +1609,8 @@ declare const Avalanche: {
1595
1609
  readonly v1: {
1596
1610
  readonly wallet: "0x77777777Dcc4d5A8B6E418Fd04D8997ef11000eE";
1597
1611
  readonly minter: "0x2222222d7164433c4C09B0b0D809a9b52C04C205";
1612
+ readonly depositForHandler: "0x16529813203f77E036576666336554a1210dce4D";
1613
+ readonly genericExecutor: "0xFa7be2f04F3Ad4ca969260729c6d45B5625984A7";
1598
1614
  };
1599
1615
  };
1600
1616
  readonly forwarderSupported: {
@@ -1658,6 +1674,8 @@ declare const AvalancheFuji: {
1658
1674
  readonly v1: {
1659
1675
  readonly wallet: "0x0077777d7EBA4688BDeF3E311b846F25870A19B9";
1660
1676
  readonly minter: "0x0022222ABE238Cc2C7Bb1f21003F0a260052475B";
1677
+ readonly depositForHandler: "0xD05E7D2E7d30b92c5F17d7d0fC575fce231F1A48";
1678
+ readonly genericExecutor: "0xEdC81040756AcCfF070c21D37b265b9D0b5Ba45e";
1661
1679
  };
1662
1680
  };
1663
1681
  readonly forwarderSupported: {
@@ -1962,6 +1980,7 @@ declare const Cronos: {
1962
1980
  readonly v2: {
1963
1981
  readonly type: "split";
1964
1982
  readonly tokenMessenger: "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d";
1983
+ readonly tokenMessengerWithFees: "0x71f54F818671cD0D7ea140Da213e5C8b5C92a408";
1965
1984
  readonly messageTransmitter: "0x81D40F21F12A8F0E3252Bccb954D722d4c464B64";
1966
1985
  readonly confirmations: 1;
1967
1986
  readonly fastConfirmations: 1;
@@ -2006,6 +2025,7 @@ declare const CronosTestnet: {
2006
2025
  readonly v2: {
2007
2026
  readonly type: "split";
2008
2027
  readonly tokenMessenger: "0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA";
2028
+ readonly tokenMessengerWithFees: "0x8745D906D67C346E5eb1aEEED38Eb87F34DF0C0A";
2009
2029
  readonly messageTransmitter: "0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275";
2010
2030
  readonly confirmations: 1;
2011
2031
  readonly fastConfirmations: 1;
@@ -2050,6 +2070,7 @@ declare const Edge: {
2050
2070
  readonly v2: {
2051
2071
  readonly type: "split";
2052
2072
  readonly tokenMessenger: "0x98706A006bc632Df31CAdFCBD43F38887ce2ca5c";
2073
+ readonly tokenMessengerWithFees: "0x3Ac96675F9a3E6922713e041645D82f3561d3686";
2053
2074
  readonly messageTransmitter: "0x5b61381Fc9e58E70EfC13a4A97516997019198ee";
2054
2075
  readonly confirmations: 65;
2055
2076
  readonly fastConfirmations: 1;
@@ -2094,6 +2115,7 @@ declare const EdgeTestnet: {
2094
2115
  readonly v2: {
2095
2116
  readonly type: "split";
2096
2117
  readonly tokenMessenger: "0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA";
2118
+ readonly tokenMessengerWithFees: "0x8745D906D67C346E5eb1aEEED38Eb87F34DF0C0A";
2097
2119
  readonly messageTransmitter: "0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275";
2098
2120
  readonly confirmations: 65;
2099
2121
  readonly fastConfirmations: 1;
@@ -2434,6 +2456,7 @@ declare const Injective: {
2434
2456
  readonly v2: {
2435
2457
  readonly type: "split";
2436
2458
  readonly tokenMessenger: "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d";
2459
+ readonly tokenMessengerWithFees: "0x71f54F818671cD0D7ea140Da213e5C8b5C92a408";
2437
2460
  readonly messageTransmitter: "0x81D40F21F12A8F0E3252Bccb954D722d4c464B64";
2438
2461
  readonly confirmations: 1;
2439
2462
  readonly fastConfirmations: 1;
@@ -2480,6 +2503,7 @@ declare const InjectiveTestnet: {
2480
2503
  readonly v2: {
2481
2504
  readonly type: "split";
2482
2505
  readonly tokenMessenger: "0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA";
2506
+ readonly tokenMessengerWithFees: "0x8745D906D67C346E5eb1aEEED38Eb87F34DF0C0A";
2483
2507
  readonly messageTransmitter: "0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275";
2484
2508
  readonly confirmations: 1;
2485
2509
  readonly fastConfirmations: 1;
@@ -2753,6 +2777,7 @@ declare const MonadTestnet: {
2753
2777
  readonly v2: {
2754
2778
  readonly type: "split";
2755
2779
  readonly tokenMessenger: "0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA";
2780
+ readonly tokenMessengerWithFees: "0x8745D906D67C346E5eb1aEEED38Eb87F34DF0C0A";
2756
2781
  readonly messageTransmitter: "0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275";
2757
2782
  readonly confirmations: 1;
2758
2783
  readonly fastConfirmations: 1;
@@ -2797,6 +2822,7 @@ declare const Morph: {
2797
2822
  readonly v2: {
2798
2823
  readonly type: "split";
2799
2824
  readonly tokenMessenger: "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d";
2825
+ readonly tokenMessengerWithFees: "0x71f54F818671cD0D7ea140Da213e5C8b5C92a408";
2800
2826
  readonly messageTransmitter: "0x81D40F21F12A8F0E3252Bccb954D722d4c464B64";
2801
2827
  readonly confirmations: 64;
2802
2828
  readonly fastConfirmations: 1;
@@ -2841,6 +2867,7 @@ declare const MorphTestnet: {
2841
2867
  readonly v2: {
2842
2868
  readonly type: "split";
2843
2869
  readonly tokenMessenger: "0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA";
2870
+ readonly tokenMessengerWithFees: "0x8745D906D67C346E5eb1aEEED38Eb87F34DF0C0A";
2844
2871
  readonly messageTransmitter: "0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275";
2845
2872
  readonly confirmations: 64;
2846
2873
  readonly fastConfirmations: 1;
@@ -3135,6 +3162,7 @@ declare const Pharos: {
3135
3162
  readonly v2: {
3136
3163
  readonly type: "split";
3137
3164
  readonly tokenMessenger: "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d";
3165
+ readonly tokenMessengerWithFees: "0x71f54F818671cD0D7ea140Da213e5C8b5C92a408";
3138
3166
  readonly messageTransmitter: "0x81D40F21F12A8F0E3252Bccb954D722d4c464B64";
3139
3167
  readonly confirmations: 1;
3140
3168
  readonly fastConfirmations: 1;
@@ -3180,6 +3208,7 @@ declare const PharosTestnet: {
3180
3208
  readonly v2: {
3181
3209
  readonly type: "split";
3182
3210
  readonly tokenMessenger: "0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA";
3211
+ readonly tokenMessengerWithFees: "0x8745D906D67C346E5eb1aEEED38Eb87F34DF0C0A";
3183
3212
  readonly messageTransmitter: "0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275";
3184
3213
  readonly confirmations: 1;
3185
3214
  readonly fastConfirmations: 1;
@@ -3480,6 +3509,8 @@ declare const Polygon: {
3480
3509
  readonly v1: {
3481
3510
  readonly wallet: "0x77777777Dcc4d5A8B6E418Fd04D8997ef11000eE";
3482
3511
  readonly minter: "0x2222222d7164433c4C09B0b0D809a9b52C04C205";
3512
+ readonly depositForHandler: "0x16529813203f77E036576666336554a1210dce4D";
3513
+ readonly genericExecutor: "0xFa7be2f04F3Ad4ca969260729c6d45B5625984A7";
3483
3514
  };
3484
3515
  };
3485
3516
  readonly forwarderSupported: {
@@ -3543,6 +3574,8 @@ declare const PolygonAmoy: {
3543
3574
  readonly v1: {
3544
3575
  readonly wallet: "0x0077777d7EBA4688BDeF3E311b846F25870A19B9";
3545
3576
  readonly minter: "0x0022222ABE238Cc2C7Bb1f21003F0a260052475B";
3577
+ readonly depositForHandler: "0xD05E7D2E7d30b92c5F17d7d0fC575fce231F1A48";
3578
+ readonly genericExecutor: "0xEdC81040756AcCfF070c21D37b265b9D0b5Ba45e";
3546
3579
  };
3547
3580
  };
3548
3581
  readonly forwarderSupported: {
@@ -10400,6 +10433,48 @@ TChainDefinition extends ChainDefinition = ChainDefinition> extends WalletContex
10400
10433
  * Must be a valid address format for the specified blockchain.
10401
10434
  */
10402
10435
  recipientAddress?: string;
10436
+ /**
10437
+ * Optional destination dApp deposit action for a fast cross-chain transfer.
10438
+ *
10439
+ * When set, the burned USDC is minted to Circle's GenericExecutor on the
10440
+ * destination chain, which calls the registered dApp (for example, a Gateway
10441
+ * `depositFor`) in the same relayed flow. Consumed by the CCTP v2 provider's
10442
+ * executor-deposit path; requires `useForwarder: true`.
10443
+ *
10444
+ * @see {@link BridgeDepositAction}
10445
+ */
10446
+ deposit?: BridgeDepositAction;
10447
+ }
10448
+ /**
10449
+ * Destination dApp deposit action for a fast cross-chain transfer.
10450
+ *
10451
+ * When present on a bridge destination, the CCTP v2 provider routes the
10452
+ * transfer through Circle's GenericExecutor: the burned USDC is minted to the
10453
+ * executor on the destination chain, which then calls the registered dApp (for
10454
+ * example, a Gateway `depositFor`) in the same relayed flow. Encoded into
10455
+ * executor hookData via `buildDepositForGenericExecutorPayload`.
10456
+ *
10457
+ * @example
10458
+ * ```typescript
10459
+ * import type { BridgeDepositAction } from '@core/provider'
10460
+ *
10461
+ * const deposit: BridgeDepositAction = {
10462
+ * dappId: 'gateway_deposit',
10463
+ * params: ['0xTokenMessengerWithFees', '0xDepositAccount', 0n],
10464
+ * }
10465
+ * ```
10466
+ */
10467
+ interface BridgeDepositAction {
10468
+ /**
10469
+ * Registered dApp identifier the GenericExecutor invokes on the destination
10470
+ * chain (for example, `'gateway_deposit'`).
10471
+ */
10472
+ dappId: string;
10473
+ /**
10474
+ * Positional arguments for the dApp function, in ABI order. Dynamic amount
10475
+ * slots are filled in by the executor from the minted amount.
10476
+ */
10477
+ params: readonly unknown[];
10403
10478
  }
10404
10479
  /**
10405
10480
  * Parameters for executing a cross-chain bridge operation.
@@ -11950,11 +12025,31 @@ declare abstract class BridgingProvider<TProviderActions = Record<string, unknow
11950
12025
  analyzeStepsForRetry(steps: BridgeStep[]): StepAnalysisResult;
11951
12026
  }
11952
12027
 
12028
+ /**
12029
+ * USD exchange-rate metadata.
12030
+ *
12031
+ * Non-binding, useful for USD-denominated fee estimates. `feeTokenUsd` prices
12032
+ * the source-chain fee token (the token `feeTotalAmount` is denominated in).
12033
+ *
12034
+ * @internal
12035
+ */
12036
+ interface FeeQuoteExchangeRates {
12037
+ /** USD price of the fee token, as a decimal string. */
12038
+ readonly feeTokenUsd: string;
12039
+ /** USD price of the destination token, as a decimal string. */
12040
+ readonly destinationTokenUsd: string;
12041
+ }
11953
12042
  /**
11954
12043
  * The expiry window of a signed quote.
11955
12044
  *
11956
12045
  * A signed quote is short-lived; refresh it immediately before submitting
11957
12046
  * on-chain rather than caching it.
12047
+ *
12048
+ * The API uses different field names depending on `mode`:
12049
+ * - `TIMESTAMP` → `expiresAt` (unix seconds)
12050
+ * - `BLOCK_NUMBER` → `expiresAtBlock` (source-chain block number)
12051
+ *
12052
+ * @internal
11958
12053
  */
11959
12054
  type FeeQuoteExpiry = {
11960
12055
  /** Identify an exact Unix timestamp expiry. */
@@ -11970,6 +12065,83 @@ type FeeQuoteExpiry = {
11970
12065
  readonly blockEstimatedAt?: number;
11971
12066
  };
11972
12067
 
12068
+ /**
12069
+ * Fee category describing the origin of a fee line item.
12070
+ *
12071
+ * - `'provider'` — Fee charged by the cross-chain provider (e.g. protocol fee).
12072
+ * - `'gasFee'` — On-chain gas cost denominated in the transfer token (e.g. USDC).
12073
+ * - `'kit'` — Fee charged by the kit / developer integration.
12074
+ * - `'forwarder'` — Fee charged by Circle's Forwarding Service for automatic mint.
12075
+ */
12076
+ type FeeType = 'provider' | 'gasFee' | 'kit' | 'forwarder';
12077
+ /**
12078
+ * Per-chain breakdown of a fee amount.
12079
+ *
12080
+ * @example
12081
+ * ```typescript
12082
+ * import type { FeeAllocation } from '@core/types'
12083
+ * import { Blockchain } from '@core/chains'
12084
+ *
12085
+ * const allocation: FeeAllocation = {
12086
+ * chain: Blockchain.Ethereum,
12087
+ * amount: '0.00005',
12088
+ * }
12089
+ * ```
12090
+ */
12091
+ interface FeeAllocation {
12092
+ /** The chain to which this portion of the fee applies. */
12093
+ chain: Blockchain;
12094
+ /** The fee amount on this chain (human-readable decimal string). */
12095
+ amount: string;
12096
+ }
12097
+ /**
12098
+ * A single fee line item within an estimate.
12099
+ *
12100
+ * @remarks
12101
+ * Each entry describes a fee category (`type`), the token it is
12102
+ * denominated in, the aggregate `amount`, and an optional per-chain
12103
+ * `allocations` breakdown.
12104
+ *
12105
+ * @example
12106
+ * ```typescript
12107
+ * import type { FeeEntry } from '@core/types'
12108
+ * import { Blockchain } from '@core/chains'
12109
+ *
12110
+ * // Fee with per-chain allocation breakdown
12111
+ * const providerFee: FeeEntry = {
12112
+ * type: 'provider',
12113
+ * token: 'USDC',
12114
+ * amount: '0.00011',
12115
+ * allocations: [
12116
+ * { chain: Blockchain.Ethereum, amount: '0.00005' },
12117
+ * { chain: Blockchain.Polygon, amount: '0.00006' },
12118
+ * ],
12119
+ * }
12120
+ *
12121
+ * // Flat fee without allocations (e.g. forwarder)
12122
+ * const forwarderFee: FeeEntry = {
12123
+ * type: 'forwarder',
12124
+ * token: 'USDC',
12125
+ * amount: '0.005',
12126
+ * }
12127
+ * ```
12128
+ */
12129
+ interface FeeEntry {
12130
+ /** The category of this fee. */
12131
+ type: FeeType;
12132
+ /** The token in which this fee is denominated (e.g. `'USDC'`, `'ETH'`). */
12133
+ token: string;
12134
+ /** Aggregate fee amount (human-readable decimal string). */
12135
+ amount: string;
12136
+ /** Per-chain breakdown of the fee. Omitted for flat fees (e.g. forwarder). */
12137
+ allocations?: FeeAllocation[];
12138
+ /**
12139
+ * When `type === 'kit'`, the address that receives the kit fee.
12140
+ * Omitted for other fee types.
12141
+ */
12142
+ recipientAddress?: string;
12143
+ }
12144
+
11973
12145
  /**
11974
12146
  * Configure how CCTP and forwarding fees are collected for a bridge.
11975
12147
  *
@@ -13322,6 +13494,74 @@ declare class CCTPV2BridgingProvider extends BridgingProvider<CCTPV2Actions> imp
13322
13494
  * ```
13323
13495
  */
13324
13496
  estimate<TFromAdapterCapabilities extends AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities>(params: CCTPV2BridgeParams<TFromAdapterCapabilities, TToAdapterCapabilities>): Promise<EstimateResult$1>;
13497
+ /**
13498
+ * Estimate source-chain gas for a prepaid-FORWARD deposit burn via
13499
+ * `TokenMessengerWithFees.depositForBurnWithHookAndFees`.
13500
+ *
13501
+ * Builds a size-correct GenericExecutor hookData placeholder — using the
13502
+ * pre-validated `contracts.executor` and `contracts.depositForHandler` — so
13503
+ * the EVM calldata length matches production. Attempts a live
13504
+ * `eth_estimateGas` via the adapter's `cctp.v2.depositForBurnWithFees`
13505
+ * action and falls back to the static
13506
+ * {@link DEPOSIT_FOR_BURN_WITH_FEES_GAS_ESTIMATE_EVM} constant when the live
13507
+ * RPC call fails.
13508
+ *
13509
+ * Gateway eligibility is the caller's responsibility: validate the
13510
+ * destination chain with `resolveGatewayExecutorContracts` (UBK) before
13511
+ * calling this method.
13512
+ *
13513
+ * @param params - Estimation parameters including adapter, chains, amount,
13514
+ * the signed fee quote returned by the Quote API, and the pre-validated
13515
+ * Gateway executor contracts resolved by the caller.
13516
+ * @returns Promise resolving to the estimated (or fallback) gas cost.
13517
+ * @throws KitError `SERVICE_INTERNAL_ERROR` (FATAL) if `dstChain`'s
13518
+ * `usdcAddress` is `null`.
13519
+ *
13520
+ * @example
13521
+ * ```typescript
13522
+ * const contracts = resolveGatewayExecutorContracts(srcChain, dstChain)
13523
+ * const gasEstimate = await CCTPV2BridgingProvider.estimateDepositBurn({
13524
+ * adapter: evmAdapter,
13525
+ * srcChain: Ethereum,
13526
+ * dstChain: ArcTestnet,
13527
+ * amountMinorUnits: 100_000_000n,
13528
+ * refundAddress: '0xUserWallet',
13529
+ * signedQuote: quote.signedQuote,
13530
+ * feeToken: quote.feeToken,
13531
+ * feeTotalAmount: BigInt(quote.feeTotalAmount),
13532
+ * resolvedContext,
13533
+ * contracts,
13534
+ * })
13535
+ * ```
13536
+ */
13537
+ static estimateDepositBurn<TAdapterCapabilities extends AdapterCapabilities>(params: {
13538
+ /** Source-chain adapter for gas estimation. */
13539
+ adapter: Adapter<TAdapterCapabilities>;
13540
+ /** CCTP v2-enabled source chain. */
13541
+ srcChain: ChainDefinitionWithCCTPv2;
13542
+ /** CCTP v2-enabled destination chain. */
13543
+ dstChain: ChainDefinitionWithCCTPv2;
13544
+ /** Transfer amount in USDC minor units (6 decimals). */
13545
+ amountMinorUnits: bigint;
13546
+ /** Signer address; used as depositor, GE recovery address, and fee refund address. */
13547
+ refundAddress: string;
13548
+ /** Signed quote bytes from the Fee Quote service. */
13549
+ signedQuote: string;
13550
+ /** Fee token address (zero address for native currency fees). */
13551
+ feeToken: string;
13552
+ /** Total fee amount in fee-token minor units. */
13553
+ feeTotalAmount: bigint;
13554
+ /** Resolved operation context for the source-chain adapter. */
13555
+ resolvedContext: OperationContext<TAdapterCapabilities>;
13556
+ /**
13557
+ * Pre-validated Gateway executor contracts for the destination chain.
13558
+ * Resolved by the caller (e.g. UBK) before invoking this method.
13559
+ */
13560
+ contracts: {
13561
+ executor: string;
13562
+ depositForHandler: string;
13563
+ };
13564
+ }): Promise<EstimatedGas>;
13325
13565
  /**
13326
13566
  * Extracts OperationContext from bridge parameters for a given wallet context.
13327
13567
  *
@@ -13648,6 +13888,64 @@ declare class CCTPV2BridgingProvider extends BridgingProvider<CCTPV2Actions> imp
13648
13888
  * ```
13649
13889
  */
13650
13890
  burn<TFromAdapterCapabilities extends AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities>(params: BridgeParams$1<TFromAdapterCapabilities, TToAdapterCapabilities>): Promise<PreparedChainRequest>;
13891
+ /**
13892
+ * Prepare the source-chain `depositForBurnWithHookAndFees` call for the
13893
+ * GenericExecutor FORWARD path.
13894
+ *
13895
+ * Exposed as a public static method so the UBK fast-deposit flow can invoke
13896
+ * it directly without holding a provider instance. The byte layout mirrors
13897
+ * {@link CCTPV2BridgingProvider.estimateDepositBurn} so gas estimates and the
13898
+ * executed call agree.
13899
+ *
13900
+ * @typeParam TFromAdapterCapabilities - The source adapter's capabilities.
13901
+ * @param params - Burn parameters including adapter, chains, deposit action,
13902
+ * amount, signer address, signed fee quote, and pre-resolved adapter context.
13903
+ * @returns The prepared `depositForBurnWithHookAndFees` burn transaction.
13904
+ * @throws {KitError} `UNSUPPORTED_ROUTE` when `dstChain` lacks a
13905
+ * GenericExecutor or DepositForHandler, or the `deposit.dappId` is unknown.
13906
+ *
13907
+ * @example
13908
+ * ```typescript
13909
+ * import { CCTPV2BridgingProvider } from '@circle-fin/provider-cctp-v2'
13910
+ * import { Ethereum, ArcTestnet } from '@core/chains'
13911
+ *
13912
+ * const prepared = await CCTPV2BridgingProvider.prepareDepositForBurn({
13913
+ * adapter,
13914
+ * srcChain: Ethereum,
13915
+ * dstChain: ArcTestnet,
13916
+ * deposit: { dappId: 'gateway_deposit', params: [usdcAddress, recipient, 0n] },
13917
+ * amountMinorUnits: 100_000_000n,
13918
+ * refundAddress: '0xSender...',
13919
+ * signedQuote: quote.signedQuote,
13920
+ * feeToken: quote.feeToken,
13921
+ * feeTotalAmount: BigInt(quote.feeTotalAmount),
13922
+ * resolvedContext,
13923
+ * })
13924
+ * const txHash = await prepared.execute()
13925
+ * ```
13926
+ */
13927
+ static prepareDepositForBurn<TFromAdapterCapabilities extends AdapterCapabilities>(params: {
13928
+ /** Source-chain adapter for signing and submitting the burn. */
13929
+ adapter: Adapter<TFromAdapterCapabilities>;
13930
+ /** CCTP v2-enabled source chain. */
13931
+ srcChain: ChainDefinitionWithCCTPv2;
13932
+ /** CCTP v2-enabled destination chain (must have a GenericExecutor configured). */
13933
+ dstChain: ChainDefinitionWithCCTPv2;
13934
+ /** Destination dApp deposit action (`dappId` + encoded `params`). */
13935
+ deposit: BridgeDepositAction;
13936
+ /** Transfer amount in USDC minor units (6 decimals). */
13937
+ amountMinorUnits: bigint;
13938
+ /** Signer address; used as GenericExecutor recovery address and fee refund address. */
13939
+ refundAddress: string;
13940
+ /** Signed quote bytes from the Fee Quote service. */
13941
+ signedQuote: string;
13942
+ /** Fee token address (zero address for native-currency fees). */
13943
+ feeToken: string;
13944
+ /** Total fee amount in fee-token minor units. */
13945
+ feeTotalAmount: bigint;
13946
+ /** Resolved operation context for the source-chain adapter. */
13947
+ resolvedContext: OperationContext<TFromAdapterCapabilities>;
13948
+ }): Promise<PreparedChainRequest>;
13651
13949
  /**
13652
13950
  * Prepare a prepaid-FORWARD burn through the `TokenMessengerWithFees` wrapper.
13653
13951
  *
@@ -20751,26 +21049,31 @@ declare const getVaultsParamsSchema: z.ZodObject<{
20751
21049
  wallet: z.ZodString;
20752
21050
  minter: z.ZodString;
20753
21051
  depositForHandler: z.ZodOptional<z.ZodString>;
21052
+ genericExecutor: z.ZodOptional<z.ZodString>;
20754
21053
  }, "strict", z.ZodTypeAny, {
20755
21054
  wallet: string;
20756
21055
  minter: string;
20757
21056
  depositForHandler?: string | undefined;
21057
+ genericExecutor?: string | undefined;
20758
21058
  }, {
20759
21059
  wallet: string;
20760
21060
  minter: string;
20761
21061
  depositForHandler?: string | undefined;
21062
+ genericExecutor?: string | undefined;
20762
21063
  }>>;
20763
21064
  }, "strict", z.ZodTypeAny, {
20764
21065
  v1?: {
20765
21066
  wallet: string;
20766
21067
  minter: string;
20767
21068
  depositForHandler?: string | undefined;
21069
+ genericExecutor?: string | undefined;
20768
21070
  } | undefined;
20769
21071
  }, {
20770
21072
  v1?: {
20771
21073
  wallet: string;
20772
21074
  minter: string;
20773
21075
  depositForHandler?: string | undefined;
21076
+ genericExecutor?: string | undefined;
20774
21077
  } | undefined;
20775
21078
  }>;
20776
21079
  forwarderSupported: z.ZodObject<{
@@ -20790,6 +21093,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
20790
21093
  wallet: string;
20791
21094
  minter: string;
20792
21095
  depositForHandler?: string | undefined;
21096
+ genericExecutor?: string | undefined;
20793
21097
  } | undefined;
20794
21098
  };
20795
21099
  forwarderSupported: {
@@ -20803,6 +21107,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
20803
21107
  wallet: string;
20804
21108
  minter: string;
20805
21109
  depositForHandler?: string | undefined;
21110
+ genericExecutor?: string | undefined;
20806
21111
  } | undefined;
20807
21112
  };
20808
21113
  forwarderSupported: {
@@ -20814,8 +21119,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
20814
21119
  type: z.ZodLiteral<"evm">;
20815
21120
  chainId: z.ZodNumber;
20816
21121
  }, "strict", z.ZodTypeAny, {
20817
- type: "evm";
20818
21122
  name: string;
21123
+ type: "evm";
20819
21124
  chain: Blockchain;
20820
21125
  nativeCurrency: {
20821
21126
  symbol: string;
@@ -20837,6 +21142,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
20837
21142
  wallet: string;
20838
21143
  minter: string;
20839
21144
  depositForHandler?: string | undefined;
21145
+ genericExecutor?: string | undefined;
20840
21146
  } | undefined;
20841
21147
  };
20842
21148
  forwarderSupported: {
@@ -20850,8 +21156,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
20850
21156
  adapter?: string | undefined;
20851
21157
  } | undefined;
20852
21158
  }, {
20853
- type: "evm";
20854
21159
  name: string;
21160
+ type: "evm";
20855
21161
  chain: Blockchain;
20856
21162
  nativeCurrency: {
20857
21163
  symbol: string;
@@ -20873,6 +21179,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
20873
21179
  wallet: string;
20874
21180
  minter: string;
20875
21181
  depositForHandler?: string | undefined;
21182
+ genericExecutor?: string | undefined;
20876
21183
  } | undefined;
20877
21184
  };
20878
21185
  forwarderSupported: {
@@ -20926,26 +21233,31 @@ declare const getVaultsParamsSchema: z.ZodObject<{
20926
21233
  wallet: z.ZodString;
20927
21234
  minter: z.ZodString;
20928
21235
  depositForHandler: z.ZodOptional<z.ZodString>;
21236
+ genericExecutor: z.ZodOptional<z.ZodString>;
20929
21237
  }, "strict", z.ZodTypeAny, {
20930
21238
  wallet: string;
20931
21239
  minter: string;
20932
21240
  depositForHandler?: string | undefined;
21241
+ genericExecutor?: string | undefined;
20933
21242
  }, {
20934
21243
  wallet: string;
20935
21244
  minter: string;
20936
21245
  depositForHandler?: string | undefined;
21246
+ genericExecutor?: string | undefined;
20937
21247
  }>>;
20938
21248
  }, "strict", z.ZodTypeAny, {
20939
21249
  v1?: {
20940
21250
  wallet: string;
20941
21251
  minter: string;
20942
21252
  depositForHandler?: string | undefined;
21253
+ genericExecutor?: string | undefined;
20943
21254
  } | undefined;
20944
21255
  }, {
20945
21256
  v1?: {
20946
21257
  wallet: string;
20947
21258
  minter: string;
20948
21259
  depositForHandler?: string | undefined;
21260
+ genericExecutor?: string | undefined;
20949
21261
  } | undefined;
20950
21262
  }>;
20951
21263
  forwarderSupported: z.ZodObject<{
@@ -20965,6 +21277,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
20965
21277
  wallet: string;
20966
21278
  minter: string;
20967
21279
  depositForHandler?: string | undefined;
21280
+ genericExecutor?: string | undefined;
20968
21281
  } | undefined;
20969
21282
  };
20970
21283
  forwarderSupported: {
@@ -20978,6 +21291,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
20978
21291
  wallet: string;
20979
21292
  minter: string;
20980
21293
  depositForHandler?: string | undefined;
21294
+ genericExecutor?: string | undefined;
20981
21295
  } | undefined;
20982
21296
  };
20983
21297
  forwarderSupported: {
@@ -20988,8 +21302,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
20988
21302
  } & {
20989
21303
  type: z.ZodEnum<["algorand", "avalanche", "solana", "aptos", "near", "stellar", "sui", "hedera", "noble", "polkadot"]>;
20990
21304
  }, "strict", z.ZodTypeAny, {
20991
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
20992
21305
  name: string;
21306
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
20993
21307
  chain: Blockchain;
20994
21308
  nativeCurrency: {
20995
21309
  symbol: string;
@@ -21010,6 +21324,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21010
21324
  wallet: string;
21011
21325
  minter: string;
21012
21326
  depositForHandler?: string | undefined;
21327
+ genericExecutor?: string | undefined;
21013
21328
  } | undefined;
21014
21329
  };
21015
21330
  forwarderSupported: {
@@ -21023,8 +21338,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21023
21338
  adapter?: string | undefined;
21024
21339
  } | undefined;
21025
21340
  }, {
21026
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21027
21341
  name: string;
21342
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21028
21343
  chain: Blockchain;
21029
21344
  nativeCurrency: {
21030
21345
  symbol: string;
@@ -21045,6 +21360,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21045
21360
  wallet: string;
21046
21361
  minter: string;
21047
21362
  depositForHandler?: string | undefined;
21363
+ genericExecutor?: string | undefined;
21048
21364
  } | undefined;
21049
21365
  };
21050
21366
  forwarderSupported: {
@@ -21058,8 +21374,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21058
21374
  adapter?: string | undefined;
21059
21375
  } | undefined;
21060
21376
  }>]>, {
21061
- type: "evm";
21062
21377
  name: string;
21378
+ type: "evm";
21063
21379
  chain: Blockchain;
21064
21380
  nativeCurrency: {
21065
21381
  symbol: string;
@@ -21081,6 +21397,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21081
21397
  wallet: string;
21082
21398
  minter: string;
21083
21399
  depositForHandler?: string | undefined;
21400
+ genericExecutor?: string | undefined;
21084
21401
  } | undefined;
21085
21402
  };
21086
21403
  forwarderSupported: {
@@ -21094,8 +21411,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21094
21411
  adapter?: string | undefined;
21095
21412
  } | undefined;
21096
21413
  } | {
21097
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21098
21414
  name: string;
21415
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21099
21416
  chain: Blockchain;
21100
21417
  nativeCurrency: {
21101
21418
  symbol: string;
@@ -21116,6 +21433,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21116
21433
  wallet: string;
21117
21434
  minter: string;
21118
21435
  depositForHandler?: string | undefined;
21436
+ genericExecutor?: string | undefined;
21119
21437
  } | undefined;
21120
21438
  };
21121
21439
  forwarderSupported: {
@@ -21129,8 +21447,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21129
21447
  adapter?: string | undefined;
21130
21448
  } | undefined;
21131
21449
  }, {
21132
- type: "evm";
21133
21450
  name: string;
21451
+ type: "evm";
21134
21452
  chain: Blockchain;
21135
21453
  nativeCurrency: {
21136
21454
  symbol: string;
@@ -21152,6 +21470,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21152
21470
  wallet: string;
21153
21471
  minter: string;
21154
21472
  depositForHandler?: string | undefined;
21473
+ genericExecutor?: string | undefined;
21155
21474
  } | undefined;
21156
21475
  };
21157
21476
  forwarderSupported: {
@@ -21165,8 +21484,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21165
21484
  adapter?: string | undefined;
21166
21485
  } | undefined;
21167
21486
  } | {
21168
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21169
21487
  name: string;
21488
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21170
21489
  chain: Blockchain;
21171
21490
  nativeCurrency: {
21172
21491
  symbol: string;
@@ -21187,6 +21506,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21187
21506
  wallet: string;
21188
21507
  minter: string;
21189
21508
  depositForHandler?: string | undefined;
21509
+ genericExecutor?: string | undefined;
21190
21510
  } | undefined;
21191
21511
  };
21192
21512
  forwarderSupported: {
@@ -21203,8 +21523,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21203
21523
  vaultAddress: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>, `0x${string}`, string>, `0x${string}`, string>;
21204
21524
  }, "strip", z.ZodTypeAny, {
21205
21525
  chain: string | {
21206
- type: "evm";
21207
21526
  name: string;
21527
+ type: "evm";
21208
21528
  chain: Blockchain;
21209
21529
  nativeCurrency: {
21210
21530
  symbol: string;
@@ -21226,6 +21546,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21226
21546
  wallet: string;
21227
21547
  minter: string;
21228
21548
  depositForHandler?: string | undefined;
21549
+ genericExecutor?: string | undefined;
21229
21550
  } | undefined;
21230
21551
  };
21231
21552
  forwarderSupported: {
@@ -21239,8 +21560,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21239
21560
  adapter?: string | undefined;
21240
21561
  } | undefined;
21241
21562
  } | {
21242
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21243
21563
  name: string;
21564
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21244
21565
  chain: Blockchain;
21245
21566
  nativeCurrency: {
21246
21567
  symbol: string;
@@ -21261,6 +21582,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21261
21582
  wallet: string;
21262
21583
  minter: string;
21263
21584
  depositForHandler?: string | undefined;
21585
+ genericExecutor?: string | undefined;
21264
21586
  } | undefined;
21265
21587
  };
21266
21588
  forwarderSupported: {
@@ -21277,8 +21599,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21277
21599
  vaultAddress: `0x${string}`;
21278
21600
  }, {
21279
21601
  chain: string | {
21280
- type: "evm";
21281
21602
  name: string;
21603
+ type: "evm";
21282
21604
  chain: Blockchain;
21283
21605
  nativeCurrency: {
21284
21606
  symbol: string;
@@ -21300,6 +21622,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21300
21622
  wallet: string;
21301
21623
  minter: string;
21302
21624
  depositForHandler?: string | undefined;
21625
+ genericExecutor?: string | undefined;
21303
21626
  } | undefined;
21304
21627
  };
21305
21628
  forwarderSupported: {
@@ -21313,8 +21636,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21313
21636
  adapter?: string | undefined;
21314
21637
  } | undefined;
21315
21638
  } | {
21316
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21317
21639
  name: string;
21640
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21318
21641
  chain: Blockchain;
21319
21642
  nativeCurrency: {
21320
21643
  symbol: string;
@@ -21335,6 +21658,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21335
21658
  wallet: string;
21336
21659
  minter: string;
21337
21660
  depositForHandler?: string | undefined;
21661
+ genericExecutor?: string | undefined;
21338
21662
  } | undefined;
21339
21663
  };
21340
21664
  forwarderSupported: {
@@ -21379,8 +21703,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21379
21703
  }, "strip", z.ZodTypeAny, {
21380
21704
  vaults: {
21381
21705
  chain: string | {
21382
- type: "evm";
21383
21706
  name: string;
21707
+ type: "evm";
21384
21708
  chain: Blockchain;
21385
21709
  nativeCurrency: {
21386
21710
  symbol: string;
@@ -21402,6 +21726,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21402
21726
  wallet: string;
21403
21727
  minter: string;
21404
21728
  depositForHandler?: string | undefined;
21729
+ genericExecutor?: string | undefined;
21405
21730
  } | undefined;
21406
21731
  };
21407
21732
  forwarderSupported: {
@@ -21415,8 +21740,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21415
21740
  adapter?: string | undefined;
21416
21741
  } | undefined;
21417
21742
  } | {
21418
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21419
21743
  name: string;
21744
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21420
21745
  chain: Blockchain;
21421
21746
  nativeCurrency: {
21422
21747
  symbol: string;
@@ -21437,6 +21762,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21437
21762
  wallet: string;
21438
21763
  minter: string;
21439
21764
  depositForHandler?: string | undefined;
21765
+ genericExecutor?: string | undefined;
21440
21766
  } | undefined;
21441
21767
  };
21442
21768
  forwarderSupported: {
@@ -21461,8 +21787,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21461
21787
  }, {
21462
21788
  vaults: {
21463
21789
  chain: string | {
21464
- type: "evm";
21465
21790
  name: string;
21791
+ type: "evm";
21466
21792
  chain: Blockchain;
21467
21793
  nativeCurrency: {
21468
21794
  symbol: string;
@@ -21484,6 +21810,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21484
21810
  wallet: string;
21485
21811
  minter: string;
21486
21812
  depositForHandler?: string | undefined;
21813
+ genericExecutor?: string | undefined;
21487
21814
  } | undefined;
21488
21815
  };
21489
21816
  forwarderSupported: {
@@ -21497,8 +21824,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21497
21824
  adapter?: string | undefined;
21498
21825
  } | undefined;
21499
21826
  } | {
21500
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21501
21827
  name: string;
21828
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21502
21829
  chain: Blockchain;
21503
21830
  nativeCurrency: {
21504
21831
  symbol: string;
@@ -21519,6 +21846,7 @@ declare const getVaultsParamsSchema: z.ZodObject<{
21519
21846
  wallet: string;
21520
21847
  minter: string;
21521
21848
  depositForHandler?: string | undefined;
21849
+ genericExecutor?: string | undefined;
21522
21850
  } | undefined;
21523
21851
  };
21524
21852
  forwarderSupported: {
@@ -21597,26 +21925,31 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21597
21925
  wallet: z.ZodString;
21598
21926
  minter: z.ZodString;
21599
21927
  depositForHandler: z.ZodOptional<z.ZodString>;
21928
+ genericExecutor: z.ZodOptional<z.ZodString>;
21600
21929
  }, "strict", z.ZodTypeAny, {
21601
21930
  wallet: string;
21602
21931
  minter: string;
21603
21932
  depositForHandler?: string | undefined;
21933
+ genericExecutor?: string | undefined;
21604
21934
  }, {
21605
21935
  wallet: string;
21606
21936
  minter: string;
21607
21937
  depositForHandler?: string | undefined;
21938
+ genericExecutor?: string | undefined;
21608
21939
  }>>;
21609
21940
  }, "strict", z.ZodTypeAny, {
21610
21941
  v1?: {
21611
21942
  wallet: string;
21612
21943
  minter: string;
21613
21944
  depositForHandler?: string | undefined;
21945
+ genericExecutor?: string | undefined;
21614
21946
  } | undefined;
21615
21947
  }, {
21616
21948
  v1?: {
21617
21949
  wallet: string;
21618
21950
  minter: string;
21619
21951
  depositForHandler?: string | undefined;
21952
+ genericExecutor?: string | undefined;
21620
21953
  } | undefined;
21621
21954
  }>;
21622
21955
  forwarderSupported: z.ZodObject<{
@@ -21636,6 +21969,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21636
21969
  wallet: string;
21637
21970
  minter: string;
21638
21971
  depositForHandler?: string | undefined;
21972
+ genericExecutor?: string | undefined;
21639
21973
  } | undefined;
21640
21974
  };
21641
21975
  forwarderSupported: {
@@ -21649,6 +21983,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21649
21983
  wallet: string;
21650
21984
  minter: string;
21651
21985
  depositForHandler?: string | undefined;
21986
+ genericExecutor?: string | undefined;
21652
21987
  } | undefined;
21653
21988
  };
21654
21989
  forwarderSupported: {
@@ -21660,8 +21995,8 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21660
21995
  type: z.ZodLiteral<"evm">;
21661
21996
  chainId: z.ZodNumber;
21662
21997
  }, "strict", z.ZodTypeAny, {
21663
- type: "evm";
21664
21998
  name: string;
21999
+ type: "evm";
21665
22000
  chain: Blockchain;
21666
22001
  nativeCurrency: {
21667
22002
  symbol: string;
@@ -21683,6 +22018,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21683
22018
  wallet: string;
21684
22019
  minter: string;
21685
22020
  depositForHandler?: string | undefined;
22021
+ genericExecutor?: string | undefined;
21686
22022
  } | undefined;
21687
22023
  };
21688
22024
  forwarderSupported: {
@@ -21696,8 +22032,8 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21696
22032
  adapter?: string | undefined;
21697
22033
  } | undefined;
21698
22034
  }, {
21699
- type: "evm";
21700
22035
  name: string;
22036
+ type: "evm";
21701
22037
  chain: Blockchain;
21702
22038
  nativeCurrency: {
21703
22039
  symbol: string;
@@ -21719,6 +22055,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21719
22055
  wallet: string;
21720
22056
  minter: string;
21721
22057
  depositForHandler?: string | undefined;
22058
+ genericExecutor?: string | undefined;
21722
22059
  } | undefined;
21723
22060
  };
21724
22061
  forwarderSupported: {
@@ -21772,26 +22109,31 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21772
22109
  wallet: z.ZodString;
21773
22110
  minter: z.ZodString;
21774
22111
  depositForHandler: z.ZodOptional<z.ZodString>;
22112
+ genericExecutor: z.ZodOptional<z.ZodString>;
21775
22113
  }, "strict", z.ZodTypeAny, {
21776
22114
  wallet: string;
21777
22115
  minter: string;
21778
22116
  depositForHandler?: string | undefined;
22117
+ genericExecutor?: string | undefined;
21779
22118
  }, {
21780
22119
  wallet: string;
21781
22120
  minter: string;
21782
22121
  depositForHandler?: string | undefined;
22122
+ genericExecutor?: string | undefined;
21783
22123
  }>>;
21784
22124
  }, "strict", z.ZodTypeAny, {
21785
22125
  v1?: {
21786
22126
  wallet: string;
21787
22127
  minter: string;
21788
22128
  depositForHandler?: string | undefined;
22129
+ genericExecutor?: string | undefined;
21789
22130
  } | undefined;
21790
22131
  }, {
21791
22132
  v1?: {
21792
22133
  wallet: string;
21793
22134
  minter: string;
21794
22135
  depositForHandler?: string | undefined;
22136
+ genericExecutor?: string | undefined;
21795
22137
  } | undefined;
21796
22138
  }>;
21797
22139
  forwarderSupported: z.ZodObject<{
@@ -21811,6 +22153,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21811
22153
  wallet: string;
21812
22154
  minter: string;
21813
22155
  depositForHandler?: string | undefined;
22156
+ genericExecutor?: string | undefined;
21814
22157
  } | undefined;
21815
22158
  };
21816
22159
  forwarderSupported: {
@@ -21824,6 +22167,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21824
22167
  wallet: string;
21825
22168
  minter: string;
21826
22169
  depositForHandler?: string | undefined;
22170
+ genericExecutor?: string | undefined;
21827
22171
  } | undefined;
21828
22172
  };
21829
22173
  forwarderSupported: {
@@ -21834,8 +22178,8 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21834
22178
  } & {
21835
22179
  type: z.ZodEnum<["algorand", "avalanche", "solana", "aptos", "near", "stellar", "sui", "hedera", "noble", "polkadot"]>;
21836
22180
  }, "strict", z.ZodTypeAny, {
21837
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21838
22181
  name: string;
22182
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21839
22183
  chain: Blockchain;
21840
22184
  nativeCurrency: {
21841
22185
  symbol: string;
@@ -21856,6 +22200,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21856
22200
  wallet: string;
21857
22201
  minter: string;
21858
22202
  depositForHandler?: string | undefined;
22203
+ genericExecutor?: string | undefined;
21859
22204
  } | undefined;
21860
22205
  };
21861
22206
  forwarderSupported: {
@@ -21869,8 +22214,8 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21869
22214
  adapter?: string | undefined;
21870
22215
  } | undefined;
21871
22216
  }, {
21872
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21873
22217
  name: string;
22218
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21874
22219
  chain: Blockchain;
21875
22220
  nativeCurrency: {
21876
22221
  symbol: string;
@@ -21891,6 +22236,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21891
22236
  wallet: string;
21892
22237
  minter: string;
21893
22238
  depositForHandler?: string | undefined;
22239
+ genericExecutor?: string | undefined;
21894
22240
  } | undefined;
21895
22241
  };
21896
22242
  forwarderSupported: {
@@ -21904,8 +22250,8 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21904
22250
  adapter?: string | undefined;
21905
22251
  } | undefined;
21906
22252
  }>]>, {
21907
- type: "evm";
21908
22253
  name: string;
22254
+ type: "evm";
21909
22255
  chain: Blockchain;
21910
22256
  nativeCurrency: {
21911
22257
  symbol: string;
@@ -21927,6 +22273,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21927
22273
  wallet: string;
21928
22274
  minter: string;
21929
22275
  depositForHandler?: string | undefined;
22276
+ genericExecutor?: string | undefined;
21930
22277
  } | undefined;
21931
22278
  };
21932
22279
  forwarderSupported: {
@@ -21940,8 +22287,8 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21940
22287
  adapter?: string | undefined;
21941
22288
  } | undefined;
21942
22289
  } | {
21943
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21944
22290
  name: string;
22291
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
21945
22292
  chain: Blockchain;
21946
22293
  nativeCurrency: {
21947
22294
  symbol: string;
@@ -21962,6 +22309,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21962
22309
  wallet: string;
21963
22310
  minter: string;
21964
22311
  depositForHandler?: string | undefined;
22312
+ genericExecutor?: string | undefined;
21965
22313
  } | undefined;
21966
22314
  };
21967
22315
  forwarderSupported: {
@@ -21975,8 +22323,8 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21975
22323
  adapter?: string | undefined;
21976
22324
  } | undefined;
21977
22325
  }, {
21978
- type: "evm";
21979
22326
  name: string;
22327
+ type: "evm";
21980
22328
  chain: Blockchain;
21981
22329
  nativeCurrency: {
21982
22330
  symbol: string;
@@ -21998,6 +22346,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
21998
22346
  wallet: string;
21999
22347
  minter: string;
22000
22348
  depositForHandler?: string | undefined;
22349
+ genericExecutor?: string | undefined;
22001
22350
  } | undefined;
22002
22351
  };
22003
22352
  forwarderSupported: {
@@ -22011,8 +22360,8 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
22011
22360
  adapter?: string | undefined;
22012
22361
  } | undefined;
22013
22362
  } | {
22014
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22015
22363
  name: string;
22364
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22016
22365
  chain: Blockchain;
22017
22366
  nativeCurrency: {
22018
22367
  symbol: string;
@@ -22033,6 +22382,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
22033
22382
  wallet: string;
22034
22383
  minter: string;
22035
22384
  depositForHandler?: string | undefined;
22385
+ genericExecutor?: string | undefined;
22036
22386
  } | undefined;
22037
22387
  };
22038
22388
  forwarderSupported: {
@@ -22081,8 +22431,8 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
22081
22431
  }>>;
22082
22432
  }, "strip", z.ZodTypeAny, {
22083
22433
  chain: string | {
22084
- type: "evm";
22085
22434
  name: string;
22435
+ type: "evm";
22086
22436
  chain: Blockchain;
22087
22437
  nativeCurrency: {
22088
22438
  symbol: string;
@@ -22104,6 +22454,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
22104
22454
  wallet: string;
22105
22455
  minter: string;
22106
22456
  depositForHandler?: string | undefined;
22457
+ genericExecutor?: string | undefined;
22107
22458
  } | undefined;
22108
22459
  };
22109
22460
  forwarderSupported: {
@@ -22117,8 +22468,8 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
22117
22468
  adapter?: string | undefined;
22118
22469
  } | undefined;
22119
22470
  } | {
22120
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22121
22471
  name: string;
22472
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22122
22473
  chain: Blockchain;
22123
22474
  nativeCurrency: {
22124
22475
  symbol: string;
@@ -22139,6 +22490,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
22139
22490
  wallet: string;
22140
22491
  minter: string;
22141
22492
  depositForHandler?: string | undefined;
22493
+ genericExecutor?: string | undefined;
22142
22494
  } | undefined;
22143
22495
  };
22144
22496
  forwarderSupported: {
@@ -22167,8 +22519,8 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
22167
22519
  pageSize?: number | undefined;
22168
22520
  }, {
22169
22521
  chain: string | {
22170
- type: "evm";
22171
22522
  name: string;
22523
+ type: "evm";
22172
22524
  chain: Blockchain;
22173
22525
  nativeCurrency: {
22174
22526
  symbol: string;
@@ -22190,6 +22542,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
22190
22542
  wallet: string;
22191
22543
  minter: string;
22192
22544
  depositForHandler?: string | undefined;
22545
+ genericExecutor?: string | undefined;
22193
22546
  } | undefined;
22194
22547
  };
22195
22548
  forwarderSupported: {
@@ -22203,8 +22556,8 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
22203
22556
  adapter?: string | undefined;
22204
22557
  } | undefined;
22205
22558
  } | {
22206
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22207
22559
  name: string;
22560
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22208
22561
  chain: Blockchain;
22209
22562
  nativeCurrency: {
22210
22563
  symbol: string;
@@ -22225,6 +22578,7 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
22225
22578
  wallet: string;
22226
22579
  minter: string;
22227
22580
  depositForHandler?: string | undefined;
22581
+ genericExecutor?: string | undefined;
22228
22582
  } | undefined;
22229
22583
  };
22230
22584
  forwarderSupported: {
@@ -22310,26 +22664,31 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22310
22664
  wallet: z.ZodString;
22311
22665
  minter: z.ZodString;
22312
22666
  depositForHandler: z.ZodOptional<z.ZodString>;
22667
+ genericExecutor: z.ZodOptional<z.ZodString>;
22313
22668
  }, "strict", z.ZodTypeAny, {
22314
22669
  wallet: string;
22315
22670
  minter: string;
22316
22671
  depositForHandler?: string | undefined;
22672
+ genericExecutor?: string | undefined;
22317
22673
  }, {
22318
22674
  wallet: string;
22319
22675
  minter: string;
22320
22676
  depositForHandler?: string | undefined;
22677
+ genericExecutor?: string | undefined;
22321
22678
  }>>;
22322
22679
  }, "strict", z.ZodTypeAny, {
22323
22680
  v1?: {
22324
22681
  wallet: string;
22325
22682
  minter: string;
22326
22683
  depositForHandler?: string | undefined;
22684
+ genericExecutor?: string | undefined;
22327
22685
  } | undefined;
22328
22686
  }, {
22329
22687
  v1?: {
22330
22688
  wallet: string;
22331
22689
  minter: string;
22332
22690
  depositForHandler?: string | undefined;
22691
+ genericExecutor?: string | undefined;
22333
22692
  } | undefined;
22334
22693
  }>;
22335
22694
  forwarderSupported: z.ZodObject<{
@@ -22349,6 +22708,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22349
22708
  wallet: string;
22350
22709
  minter: string;
22351
22710
  depositForHandler?: string | undefined;
22711
+ genericExecutor?: string | undefined;
22352
22712
  } | undefined;
22353
22713
  };
22354
22714
  forwarderSupported: {
@@ -22362,6 +22722,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22362
22722
  wallet: string;
22363
22723
  minter: string;
22364
22724
  depositForHandler?: string | undefined;
22725
+ genericExecutor?: string | undefined;
22365
22726
  } | undefined;
22366
22727
  };
22367
22728
  forwarderSupported: {
@@ -22373,8 +22734,8 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22373
22734
  type: z.ZodLiteral<"evm">;
22374
22735
  chainId: z.ZodNumber;
22375
22736
  }, "strict", z.ZodTypeAny, {
22376
- type: "evm";
22377
22737
  name: string;
22738
+ type: "evm";
22378
22739
  chain: Blockchain;
22379
22740
  nativeCurrency: {
22380
22741
  symbol: string;
@@ -22396,6 +22757,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22396
22757
  wallet: string;
22397
22758
  minter: string;
22398
22759
  depositForHandler?: string | undefined;
22760
+ genericExecutor?: string | undefined;
22399
22761
  } | undefined;
22400
22762
  };
22401
22763
  forwarderSupported: {
@@ -22409,8 +22771,8 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22409
22771
  adapter?: string | undefined;
22410
22772
  } | undefined;
22411
22773
  }, {
22412
- type: "evm";
22413
22774
  name: string;
22775
+ type: "evm";
22414
22776
  chain: Blockchain;
22415
22777
  nativeCurrency: {
22416
22778
  symbol: string;
@@ -22432,6 +22794,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22432
22794
  wallet: string;
22433
22795
  minter: string;
22434
22796
  depositForHandler?: string | undefined;
22797
+ genericExecutor?: string | undefined;
22435
22798
  } | undefined;
22436
22799
  };
22437
22800
  forwarderSupported: {
@@ -22485,26 +22848,31 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22485
22848
  wallet: z.ZodString;
22486
22849
  minter: z.ZodString;
22487
22850
  depositForHandler: z.ZodOptional<z.ZodString>;
22851
+ genericExecutor: z.ZodOptional<z.ZodString>;
22488
22852
  }, "strict", z.ZodTypeAny, {
22489
22853
  wallet: string;
22490
22854
  minter: string;
22491
22855
  depositForHandler?: string | undefined;
22856
+ genericExecutor?: string | undefined;
22492
22857
  }, {
22493
22858
  wallet: string;
22494
22859
  minter: string;
22495
22860
  depositForHandler?: string | undefined;
22861
+ genericExecutor?: string | undefined;
22496
22862
  }>>;
22497
22863
  }, "strict", z.ZodTypeAny, {
22498
22864
  v1?: {
22499
22865
  wallet: string;
22500
22866
  minter: string;
22501
22867
  depositForHandler?: string | undefined;
22868
+ genericExecutor?: string | undefined;
22502
22869
  } | undefined;
22503
22870
  }, {
22504
22871
  v1?: {
22505
22872
  wallet: string;
22506
22873
  minter: string;
22507
22874
  depositForHandler?: string | undefined;
22875
+ genericExecutor?: string | undefined;
22508
22876
  } | undefined;
22509
22877
  }>;
22510
22878
  forwarderSupported: z.ZodObject<{
@@ -22524,6 +22892,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22524
22892
  wallet: string;
22525
22893
  minter: string;
22526
22894
  depositForHandler?: string | undefined;
22895
+ genericExecutor?: string | undefined;
22527
22896
  } | undefined;
22528
22897
  };
22529
22898
  forwarderSupported: {
@@ -22537,6 +22906,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22537
22906
  wallet: string;
22538
22907
  minter: string;
22539
22908
  depositForHandler?: string | undefined;
22909
+ genericExecutor?: string | undefined;
22540
22910
  } | undefined;
22541
22911
  };
22542
22912
  forwarderSupported: {
@@ -22547,8 +22917,8 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22547
22917
  } & {
22548
22918
  type: z.ZodEnum<["algorand", "avalanche", "solana", "aptos", "near", "stellar", "sui", "hedera", "noble", "polkadot"]>;
22549
22919
  }, "strict", z.ZodTypeAny, {
22550
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22551
22920
  name: string;
22921
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22552
22922
  chain: Blockchain;
22553
22923
  nativeCurrency: {
22554
22924
  symbol: string;
@@ -22569,6 +22939,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22569
22939
  wallet: string;
22570
22940
  minter: string;
22571
22941
  depositForHandler?: string | undefined;
22942
+ genericExecutor?: string | undefined;
22572
22943
  } | undefined;
22573
22944
  };
22574
22945
  forwarderSupported: {
@@ -22582,8 +22953,8 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22582
22953
  adapter?: string | undefined;
22583
22954
  } | undefined;
22584
22955
  }, {
22585
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22586
22956
  name: string;
22957
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22587
22958
  chain: Blockchain;
22588
22959
  nativeCurrency: {
22589
22960
  symbol: string;
@@ -22604,6 +22975,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22604
22975
  wallet: string;
22605
22976
  minter: string;
22606
22977
  depositForHandler?: string | undefined;
22978
+ genericExecutor?: string | undefined;
22607
22979
  } | undefined;
22608
22980
  };
22609
22981
  forwarderSupported: {
@@ -22617,8 +22989,8 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22617
22989
  adapter?: string | undefined;
22618
22990
  } | undefined;
22619
22991
  }>]>, {
22620
- type: "evm";
22621
22992
  name: string;
22993
+ type: "evm";
22622
22994
  chain: Blockchain;
22623
22995
  nativeCurrency: {
22624
22996
  symbol: string;
@@ -22640,6 +23012,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22640
23012
  wallet: string;
22641
23013
  minter: string;
22642
23014
  depositForHandler?: string | undefined;
23015
+ genericExecutor?: string | undefined;
22643
23016
  } | undefined;
22644
23017
  };
22645
23018
  forwarderSupported: {
@@ -22653,8 +23026,8 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22653
23026
  adapter?: string | undefined;
22654
23027
  } | undefined;
22655
23028
  } | {
22656
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22657
23029
  name: string;
23030
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22658
23031
  chain: Blockchain;
22659
23032
  nativeCurrency: {
22660
23033
  symbol: string;
@@ -22675,6 +23048,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22675
23048
  wallet: string;
22676
23049
  minter: string;
22677
23050
  depositForHandler?: string | undefined;
23051
+ genericExecutor?: string | undefined;
22678
23052
  } | undefined;
22679
23053
  };
22680
23054
  forwarderSupported: {
@@ -22688,8 +23062,8 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22688
23062
  adapter?: string | undefined;
22689
23063
  } | undefined;
22690
23064
  }, {
22691
- type: "evm";
22692
23065
  name: string;
23066
+ type: "evm";
22693
23067
  chain: Blockchain;
22694
23068
  nativeCurrency: {
22695
23069
  symbol: string;
@@ -22711,6 +23085,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22711
23085
  wallet: string;
22712
23086
  minter: string;
22713
23087
  depositForHandler?: string | undefined;
23088
+ genericExecutor?: string | undefined;
22714
23089
  } | undefined;
22715
23090
  };
22716
23091
  forwarderSupported: {
@@ -22724,8 +23099,8 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22724
23099
  adapter?: string | undefined;
22725
23100
  } | undefined;
22726
23101
  } | {
22727
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22728
23102
  name: string;
23103
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22729
23104
  chain: Blockchain;
22730
23105
  nativeCurrency: {
22731
23106
  symbol: string;
@@ -22746,6 +23121,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22746
23121
  wallet: string;
22747
23122
  minter: string;
22748
23123
  depositForHandler?: string | undefined;
23124
+ genericExecutor?: string | undefined;
22749
23125
  } | undefined;
22750
23126
  };
22751
23127
  forwarderSupported: {
@@ -22794,8 +23170,8 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22794
23170
  }>>;
22795
23171
  }, "page">, "strip", z.ZodTypeAny, {
22796
23172
  chain: string | {
22797
- type: "evm";
22798
23173
  name: string;
23174
+ type: "evm";
22799
23175
  chain: Blockchain;
22800
23176
  nativeCurrency: {
22801
23177
  symbol: string;
@@ -22817,6 +23193,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22817
23193
  wallet: string;
22818
23194
  minter: string;
22819
23195
  depositForHandler?: string | undefined;
23196
+ genericExecutor?: string | undefined;
22820
23197
  } | undefined;
22821
23198
  };
22822
23199
  forwarderSupported: {
@@ -22830,8 +23207,8 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22830
23207
  adapter?: string | undefined;
22831
23208
  } | undefined;
22832
23209
  } | {
22833
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22834
23210
  name: string;
23211
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22835
23212
  chain: Blockchain;
22836
23213
  nativeCurrency: {
22837
23214
  symbol: string;
@@ -22852,6 +23229,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22852
23229
  wallet: string;
22853
23230
  minter: string;
22854
23231
  depositForHandler?: string | undefined;
23232
+ genericExecutor?: string | undefined;
22855
23233
  } | undefined;
22856
23234
  };
22857
23235
  forwarderSupported: {
@@ -22879,8 +23257,8 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22879
23257
  pageSize?: number | undefined;
22880
23258
  }, {
22881
23259
  chain: string | {
22882
- type: "evm";
22883
23260
  name: string;
23261
+ type: "evm";
22884
23262
  chain: Blockchain;
22885
23263
  nativeCurrency: {
22886
23264
  symbol: string;
@@ -22902,6 +23280,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22902
23280
  wallet: string;
22903
23281
  minter: string;
22904
23282
  depositForHandler?: string | undefined;
23283
+ genericExecutor?: string | undefined;
22905
23284
  } | undefined;
22906
23285
  };
22907
23286
  forwarderSupported: {
@@ -22915,8 +23294,8 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22915
23294
  adapter?: string | undefined;
22916
23295
  } | undefined;
22917
23296
  } | {
22918
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22919
23297
  name: string;
23298
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
22920
23299
  chain: Blockchain;
22921
23300
  nativeCurrency: {
22922
23301
  symbol: string;
@@ -22937,6 +23316,7 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
22937
23316
  wallet: string;
22938
23317
  minter: string;
22939
23318
  depositForHandler?: string | undefined;
23319
+ genericExecutor?: string | undefined;
22940
23320
  } | undefined;
22941
23321
  };
22942
23322
  forwarderSupported: {
@@ -23092,26 +23472,31 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23092
23472
  wallet: z.ZodString;
23093
23473
  minter: z.ZodString;
23094
23474
  depositForHandler: z.ZodOptional<z.ZodString>;
23475
+ genericExecutor: z.ZodOptional<z.ZodString>;
23095
23476
  }, "strict", z.ZodTypeAny, {
23096
23477
  wallet: string;
23097
23478
  minter: string;
23098
23479
  depositForHandler?: string | undefined;
23480
+ genericExecutor?: string | undefined;
23099
23481
  }, {
23100
23482
  wallet: string;
23101
23483
  minter: string;
23102
23484
  depositForHandler?: string | undefined;
23485
+ genericExecutor?: string | undefined;
23103
23486
  }>>;
23104
23487
  }, "strict", z.ZodTypeAny, {
23105
23488
  v1?: {
23106
23489
  wallet: string;
23107
23490
  minter: string;
23108
23491
  depositForHandler?: string | undefined;
23492
+ genericExecutor?: string | undefined;
23109
23493
  } | undefined;
23110
23494
  }, {
23111
23495
  v1?: {
23112
23496
  wallet: string;
23113
23497
  minter: string;
23114
23498
  depositForHandler?: string | undefined;
23499
+ genericExecutor?: string | undefined;
23115
23500
  } | undefined;
23116
23501
  }>;
23117
23502
  forwarderSupported: z.ZodObject<{
@@ -23131,6 +23516,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23131
23516
  wallet: string;
23132
23517
  minter: string;
23133
23518
  depositForHandler?: string | undefined;
23519
+ genericExecutor?: string | undefined;
23134
23520
  } | undefined;
23135
23521
  };
23136
23522
  forwarderSupported: {
@@ -23144,6 +23530,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23144
23530
  wallet: string;
23145
23531
  minter: string;
23146
23532
  depositForHandler?: string | undefined;
23533
+ genericExecutor?: string | undefined;
23147
23534
  } | undefined;
23148
23535
  };
23149
23536
  forwarderSupported: {
@@ -23155,8 +23542,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23155
23542
  type: z.ZodLiteral<"evm">;
23156
23543
  chainId: z.ZodNumber;
23157
23544
  }, "strict", z.ZodTypeAny, {
23158
- type: "evm";
23159
23545
  name: string;
23546
+ type: "evm";
23160
23547
  chain: Blockchain;
23161
23548
  nativeCurrency: {
23162
23549
  symbol: string;
@@ -23178,6 +23565,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23178
23565
  wallet: string;
23179
23566
  minter: string;
23180
23567
  depositForHandler?: string | undefined;
23568
+ genericExecutor?: string | undefined;
23181
23569
  } | undefined;
23182
23570
  };
23183
23571
  forwarderSupported: {
@@ -23191,8 +23579,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23191
23579
  adapter?: string | undefined;
23192
23580
  } | undefined;
23193
23581
  }, {
23194
- type: "evm";
23195
23582
  name: string;
23583
+ type: "evm";
23196
23584
  chain: Blockchain;
23197
23585
  nativeCurrency: {
23198
23586
  symbol: string;
@@ -23214,6 +23602,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23214
23602
  wallet: string;
23215
23603
  minter: string;
23216
23604
  depositForHandler?: string | undefined;
23605
+ genericExecutor?: string | undefined;
23217
23606
  } | undefined;
23218
23607
  };
23219
23608
  forwarderSupported: {
@@ -23267,26 +23656,31 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23267
23656
  wallet: z.ZodString;
23268
23657
  minter: z.ZodString;
23269
23658
  depositForHandler: z.ZodOptional<z.ZodString>;
23659
+ genericExecutor: z.ZodOptional<z.ZodString>;
23270
23660
  }, "strict", z.ZodTypeAny, {
23271
23661
  wallet: string;
23272
23662
  minter: string;
23273
23663
  depositForHandler?: string | undefined;
23664
+ genericExecutor?: string | undefined;
23274
23665
  }, {
23275
23666
  wallet: string;
23276
23667
  minter: string;
23277
23668
  depositForHandler?: string | undefined;
23669
+ genericExecutor?: string | undefined;
23278
23670
  }>>;
23279
23671
  }, "strict", z.ZodTypeAny, {
23280
23672
  v1?: {
23281
23673
  wallet: string;
23282
23674
  minter: string;
23283
23675
  depositForHandler?: string | undefined;
23676
+ genericExecutor?: string | undefined;
23284
23677
  } | undefined;
23285
23678
  }, {
23286
23679
  v1?: {
23287
23680
  wallet: string;
23288
23681
  minter: string;
23289
23682
  depositForHandler?: string | undefined;
23683
+ genericExecutor?: string | undefined;
23290
23684
  } | undefined;
23291
23685
  }>;
23292
23686
  forwarderSupported: z.ZodObject<{
@@ -23306,6 +23700,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23306
23700
  wallet: string;
23307
23701
  minter: string;
23308
23702
  depositForHandler?: string | undefined;
23703
+ genericExecutor?: string | undefined;
23309
23704
  } | undefined;
23310
23705
  };
23311
23706
  forwarderSupported: {
@@ -23319,6 +23714,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23319
23714
  wallet: string;
23320
23715
  minter: string;
23321
23716
  depositForHandler?: string | undefined;
23717
+ genericExecutor?: string | undefined;
23322
23718
  } | undefined;
23323
23719
  };
23324
23720
  forwarderSupported: {
@@ -23329,8 +23725,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23329
23725
  } & {
23330
23726
  type: z.ZodEnum<["algorand", "avalanche", "solana", "aptos", "near", "stellar", "sui", "hedera", "noble", "polkadot"]>;
23331
23727
  }, "strict", z.ZodTypeAny, {
23332
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23333
23728
  name: string;
23729
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23334
23730
  chain: Blockchain;
23335
23731
  nativeCurrency: {
23336
23732
  symbol: string;
@@ -23351,6 +23747,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23351
23747
  wallet: string;
23352
23748
  minter: string;
23353
23749
  depositForHandler?: string | undefined;
23750
+ genericExecutor?: string | undefined;
23354
23751
  } | undefined;
23355
23752
  };
23356
23753
  forwarderSupported: {
@@ -23364,8 +23761,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23364
23761
  adapter?: string | undefined;
23365
23762
  } | undefined;
23366
23763
  }, {
23367
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23368
23764
  name: string;
23765
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23369
23766
  chain: Blockchain;
23370
23767
  nativeCurrency: {
23371
23768
  symbol: string;
@@ -23386,6 +23783,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23386
23783
  wallet: string;
23387
23784
  minter: string;
23388
23785
  depositForHandler?: string | undefined;
23786
+ genericExecutor?: string | undefined;
23389
23787
  } | undefined;
23390
23788
  };
23391
23789
  forwarderSupported: {
@@ -23399,8 +23797,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23399
23797
  adapter?: string | undefined;
23400
23798
  } | undefined;
23401
23799
  }>]>, {
23402
- type: "evm";
23403
23800
  name: string;
23801
+ type: "evm";
23404
23802
  chain: Blockchain;
23405
23803
  nativeCurrency: {
23406
23804
  symbol: string;
@@ -23422,6 +23820,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23422
23820
  wallet: string;
23423
23821
  minter: string;
23424
23822
  depositForHandler?: string | undefined;
23823
+ genericExecutor?: string | undefined;
23425
23824
  } | undefined;
23426
23825
  };
23427
23826
  forwarderSupported: {
@@ -23435,8 +23834,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23435
23834
  adapter?: string | undefined;
23436
23835
  } | undefined;
23437
23836
  } | {
23438
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23439
23837
  name: string;
23838
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23440
23839
  chain: Blockchain;
23441
23840
  nativeCurrency: {
23442
23841
  symbol: string;
@@ -23457,6 +23856,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23457
23856
  wallet: string;
23458
23857
  minter: string;
23459
23858
  depositForHandler?: string | undefined;
23859
+ genericExecutor?: string | undefined;
23460
23860
  } | undefined;
23461
23861
  };
23462
23862
  forwarderSupported: {
@@ -23470,8 +23870,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23470
23870
  adapter?: string | undefined;
23471
23871
  } | undefined;
23472
23872
  }, {
23473
- type: "evm";
23474
23873
  name: string;
23874
+ type: "evm";
23475
23875
  chain: Blockchain;
23476
23876
  nativeCurrency: {
23477
23877
  symbol: string;
@@ -23493,6 +23893,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23493
23893
  wallet: string;
23494
23894
  minter: string;
23495
23895
  depositForHandler?: string | undefined;
23896
+ genericExecutor?: string | undefined;
23496
23897
  } | undefined;
23497
23898
  };
23498
23899
  forwarderSupported: {
@@ -23506,8 +23907,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23506
23907
  adapter?: string | undefined;
23507
23908
  } | undefined;
23508
23909
  } | {
23509
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23510
23910
  name: string;
23911
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23511
23912
  chain: Blockchain;
23512
23913
  nativeCurrency: {
23513
23914
  symbol: string;
@@ -23528,6 +23929,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23528
23929
  wallet: string;
23529
23930
  minter: string;
23530
23931
  depositForHandler?: string | undefined;
23932
+ genericExecutor?: string | undefined;
23531
23933
  } | undefined;
23532
23934
  };
23533
23935
  forwarderSupported: {
@@ -23544,8 +23946,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23544
23946
  recipientAddress: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string, string>, string, string>, `0x${string}`, string>, `0x${string}`, string>, `0x${string}`, string>;
23545
23947
  }, "strict", z.ZodTypeAny, {
23546
23948
  chain: string | {
23547
- type: "evm";
23548
23949
  name: string;
23950
+ type: "evm";
23549
23951
  chain: Blockchain;
23550
23952
  nativeCurrency: {
23551
23953
  symbol: string;
@@ -23567,6 +23969,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23567
23969
  wallet: string;
23568
23970
  minter: string;
23569
23971
  depositForHandler?: string | undefined;
23972
+ genericExecutor?: string | undefined;
23570
23973
  } | undefined;
23571
23974
  };
23572
23975
  forwarderSupported: {
@@ -23580,8 +23983,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23580
23983
  adapter?: string | undefined;
23581
23984
  } | undefined;
23582
23985
  } | {
23583
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23584
23986
  name: string;
23987
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23585
23988
  chain: Blockchain;
23586
23989
  nativeCurrency: {
23587
23990
  symbol: string;
@@ -23602,6 +24005,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23602
24005
  wallet: string;
23603
24006
  minter: string;
23604
24007
  depositForHandler?: string | undefined;
24008
+ genericExecutor?: string | undefined;
23605
24009
  } | undefined;
23606
24010
  };
23607
24011
  forwarderSupported: {
@@ -23618,8 +24022,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23618
24022
  recipientAddress: `0x${string}`;
23619
24023
  }, {
23620
24024
  chain: string | {
23621
- type: "evm";
23622
24025
  name: string;
24026
+ type: "evm";
23623
24027
  chain: Blockchain;
23624
24028
  nativeCurrency: {
23625
24029
  symbol: string;
@@ -23641,6 +24045,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23641
24045
  wallet: string;
23642
24046
  minter: string;
23643
24047
  depositForHandler?: string | undefined;
24048
+ genericExecutor?: string | undefined;
23644
24049
  } | undefined;
23645
24050
  };
23646
24051
  forwarderSupported: {
@@ -23654,8 +24059,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23654
24059
  adapter?: string | undefined;
23655
24060
  } | undefined;
23656
24061
  } | {
23657
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23658
24062
  name: string;
24063
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23659
24064
  chain: Blockchain;
23660
24065
  nativeCurrency: {
23661
24066
  symbol: string;
@@ -23676,6 +24081,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23676
24081
  wallet: string;
23677
24082
  minter: string;
23678
24083
  depositForHandler?: string | undefined;
24084
+ genericExecutor?: string | undefined;
23679
24085
  } | undefined;
23680
24086
  };
23681
24087
  forwarderSupported: {
@@ -23726,8 +24132,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23726
24132
  amount: string;
23727
24133
  to: {
23728
24134
  chain: string | {
23729
- type: "evm";
23730
24135
  name: string;
24136
+ type: "evm";
23731
24137
  chain: Blockchain;
23732
24138
  nativeCurrency: {
23733
24139
  symbol: string;
@@ -23749,6 +24155,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23749
24155
  wallet: string;
23750
24156
  minter: string;
23751
24157
  depositForHandler?: string | undefined;
24158
+ genericExecutor?: string | undefined;
23752
24159
  } | undefined;
23753
24160
  };
23754
24161
  forwarderSupported: {
@@ -23762,8 +24169,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23762
24169
  adapter?: string | undefined;
23763
24170
  } | undefined;
23764
24171
  } | {
23765
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23766
24172
  name: string;
24173
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23767
24174
  chain: Blockchain;
23768
24175
  nativeCurrency: {
23769
24176
  symbol: string;
@@ -23784,6 +24191,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23784
24191
  wallet: string;
23785
24192
  minter: string;
23786
24193
  depositForHandler?: string | undefined;
24194
+ genericExecutor?: string | undefined;
23787
24195
  } | undefined;
23788
24196
  };
23789
24197
  forwarderSupported: {
@@ -23813,8 +24221,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23813
24221
  amount: string;
23814
24222
  to: {
23815
24223
  chain: string | {
23816
- type: "evm";
23817
24224
  name: string;
24225
+ type: "evm";
23818
24226
  chain: Blockchain;
23819
24227
  nativeCurrency: {
23820
24228
  symbol: string;
@@ -23836,6 +24244,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23836
24244
  wallet: string;
23837
24245
  minter: string;
23838
24246
  depositForHandler?: string | undefined;
24247
+ genericExecutor?: string | undefined;
23839
24248
  } | undefined;
23840
24249
  };
23841
24250
  forwarderSupported: {
@@ -23849,8 +24258,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23849
24258
  adapter?: string | undefined;
23850
24259
  } | undefined;
23851
24260
  } | {
23852
- type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23853
24261
  name: string;
24262
+ type: "algorand" | "avalanche" | "solana" | "aptos" | "near" | "stellar" | "sui" | "hedera" | "noble" | "polkadot";
23854
24263
  chain: Blockchain;
23855
24264
  nativeCurrency: {
23856
24265
  symbol: string;
@@ -23871,6 +24280,7 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
23871
24280
  wallet: string;
23872
24281
  minter: string;
23873
24282
  depositForHandler?: string | undefined;
24283
+ genericExecutor?: string | undefined;
23874
24284
  } | undefined;
23875
24285
  };
23876
24286
  forwarderSupported: {
@@ -24947,7 +25357,7 @@ interface SpendResult$1 {
24947
25357
  * executed spend. Same shape as {@link EstimateSpendResult.fees}.
24948
25358
  * Omitted when using `config.retry` (no estimate was run).
24949
25359
  */
24950
- fees?: FeeEntry$1[];
25360
+ fees?: FeeEntry[];
24951
25361
  /**
24952
25362
  * Gateway transfer identifier. Present when `useForwarder` is enabled
24953
25363
  * and can be used to query transfer status via `GET /v1/transfer/{id}`.
@@ -24969,80 +25379,6 @@ interface SpendResult$1 {
24969
25379
  */
24970
25380
  steps?: SpendStep[];
24971
25381
  }
24972
- /**
24973
- * Fee category describing the origin of a fee line item.
24974
- *
24975
- * - `'provider'` — Fee charged by the cross-chain provider (e.g. protocol fee).
24976
- * - `'gasFee'` — On-chain gas cost denominated in the transfer token (e.g. USDC).
24977
- * - `'kit'` — Fee charged by the kit / developer integration.
24978
- * - `'forwarder'` — Fee charged by Circle's Forwarding Service for automatic mint.
24979
- */
24980
- type FeeType$1 = 'provider' | 'gasFee' | 'kit' | 'forwarder';
24981
- /**
24982
- * Per-chain breakdown of a fee amount.
24983
- *
24984
- * @example
24985
- * ```typescript
24986
- * import type { FeeAllocation } from '@circle-fin/provider-gateway-v1'
24987
- *
24988
- * const allocation: FeeAllocation = {
24989
- * chain: 'Ethereum',
24990
- * amount: '0.00005',
24991
- * }
24992
- * ```
24993
- */
24994
- interface FeeAllocation$1 {
24995
- /** The chain to which this portion of the fee applies. */
24996
- chain: Blockchain;
24997
- /** The fee amount on this chain (human-readable decimal string). */
24998
- amount: string;
24999
- }
25000
- /**
25001
- * A single fee line item within an estimate.
25002
- *
25003
- * @remarks
25004
- * Each entry describes a fee category (`type`), the token it is
25005
- * denominated in, the aggregate `amount`, and an optional per-chain
25006
- * `allocations` breakdown.
25007
- *
25008
- * @example
25009
- * ```typescript
25010
- * import type { FeeEntry } from '@circle-fin/provider-gateway-v1'
25011
- *
25012
- * // Fee with per-chain allocation breakdown
25013
- * const providerFee: FeeEntry = {
25014
- * type: 'provider',
25015
- * token: 'USDC',
25016
- * amount: '0.00011',
25017
- * allocations: [
25018
- * { chain: 'Ethereum', amount: '0.00005' },
25019
- * { chain: 'Polygon', amount: '0.00006' },
25020
- * ],
25021
- * }
25022
- *
25023
- * // Flat fee without allocations (e.g. forwarder)
25024
- * const forwarderFee: FeeEntry = {
25025
- * type: 'forwarder',
25026
- * token: 'USDC',
25027
- * amount: '0.005',
25028
- * }
25029
- * ```
25030
- */
25031
- interface FeeEntry$1 {
25032
- /** The category of this fee. */
25033
- type: FeeType$1;
25034
- /** The token in which this fee is denominated (e.g. `'USDC'`, `'ETH'`). */
25035
- token: string;
25036
- /** Aggregate fee amount (human-readable decimal string). */
25037
- amount: string;
25038
- /** Per-chain breakdown of the fee. Omitted for flat fees (e.g. forwarder). */
25039
- allocations?: FeeAllocation$1[];
25040
- /**
25041
- * When `type === 'kit'`, the address that receives the kit fee.
25042
- * Omitted for other fee types.
25043
- */
25044
- recipientAddress?: string;
25045
- }
25046
25382
  /**
25047
25383
  * Cost estimation for a spend (mint) operation.
25048
25384
  *
@@ -25090,7 +25426,7 @@ interface FeeEntry$1 {
25090
25426
  */
25091
25427
  interface EstimateSpendResult$1 {
25092
25428
  /** Itemised fee breakdown for the spend operation. */
25093
- fees: FeeEntry$1[];
25429
+ fees: FeeEntry[];
25094
25430
  }
25095
25431
 
25096
25432
  /**
@@ -26477,80 +26813,7 @@ type FeeRecipientChainType = 'evm' | 'solana';
26477
26813
  * ```
26478
26814
  */
26479
26815
  type FeeRecipientsConfig = Partial<Record<FeeRecipientChainType, string>>;
26480
- /**
26481
- * Fee category describing the origin of a fee line item.
26482
- *
26483
- * - `'provider'` — Fee charged by the cross-chain provider (e.g. protocol fee).
26484
- * - `'gasFee'` — On-chain gas cost denominated in the transfer token (e.g. USDC).
26485
- * - `'kit'` — Fee charged by the kit / developer integration.
26486
- * - `'forwarder'` — Fee charged by Circle's Forwarding Service for automatic mint.
26487
- */
26488
- type FeeType = 'provider' | 'gasFee' | 'kit' | 'forwarder';
26489
- /**
26490
- * Per-chain breakdown of a fee amount.
26491
- *
26492
- * @example
26493
- * ```typescript
26494
- * import type { FeeAllocation } from '@circle-fin/unified-balance-kit'
26495
- *
26496
- * const allocation: FeeAllocation = {
26497
- * chain: 'Ethereum',
26498
- * amount: '0.00005',
26499
- * }
26500
- * ```
26501
- */
26502
- interface FeeAllocation {
26503
- /** The chain to which this portion of the fee applies. */
26504
- chain: Blockchain;
26505
- /** The fee amount on this chain (human-readable decimal string). */
26506
- amount: string;
26507
- }
26508
- /**
26509
- * A single fee line item within an estimate.
26510
- *
26511
- * @remarks
26512
- * Each entry describes a fee category (`type`), the token it is
26513
- * denominated in, the aggregate `amount`, and an optional per-chain
26514
- * `allocations` breakdown.
26515
- *
26516
- * @example
26517
- * ```typescript
26518
- * import type { FeeEntry } from '@circle-fin/unified-balance-kit'
26519
- *
26520
- * // Fee with per-chain allocation breakdown
26521
- * const providerFee: FeeEntry = {
26522
- * type: 'provider',
26523
- * token: 'USDC',
26524
- * amount: '0.00011',
26525
- * allocations: [
26526
- * { chain: 'Ethereum', amount: '0.00005' },
26527
- * { chain: 'Polygon', amount: '0.00006' },
26528
- * ],
26529
- * }
26530
- *
26531
- * // Flat fee without allocations (e.g. forwarder)
26532
- * const forwarderFee: FeeEntry = {
26533
- * type: 'forwarder',
26534
- * token: 'USDC',
26535
- * amount: '0.005',
26536
- * }
26537
- * ```
26538
- */
26539
- interface FeeEntry {
26540
- /** The category of this fee. */
26541
- type: FeeType;
26542
- /** The token in which this fee is denominated (e.g. `'USDC'`, `'ETH'`). */
26543
- token: string;
26544
- /** Aggregate fee amount (human-readable decimal string). */
26545
- amount: string;
26546
- /** Per-chain breakdown of the fee. Omitted for flat fees (e.g. forwarder). */
26547
- allocations?: FeeAllocation[];
26548
- /**
26549
- * When `type === 'kit'`, the address that receives the kit fee.
26550
- * Omitted for other fee types.
26551
- */
26552
- recipientAddress?: string;
26553
- }
26816
+
26554
26817
  /**
26555
26818
  * Cost estimation for a spend (mint) operation.
26556
26819
  *
@@ -26790,7 +27053,7 @@ type AllowanceStrategy = 'approve' | 'permit' | 'authorize';
26790
27053
  * }
26791
27054
  * ```
26792
27055
  */
26793
- interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
27056
+ interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends BridgeChainIdentifier = BridgeChainIdentifier> {
26794
27057
  /**
26795
27058
  * The adapter context identifying the depositor and chain.
26796
27059
  */
@@ -26803,7 +27066,7 @@ interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = Adapt
26803
27066
  amount: string;
26804
27067
  /**
26805
27068
  * The token to deposit.
26806
- * Accepts any case (e.g. `'usdc'`, `'Usdc'`); normalised to uppercase internally.
27069
+ * Accepts any case (e.g. `'usdc'`, `'Usdc'`); normalized to uppercase internally.
26807
27070
  *
26808
27071
  * @defaultValue 'USDC'
26809
27072
  */
@@ -26811,9 +27074,40 @@ interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = Adapt
26811
27074
  /**
26812
27075
  * The token allowance strategy to authorize the deposit.
26813
27076
  *
27077
+ * Only valid for same-chain (STANDARD) deposits. Must not be set when
27078
+ * `to` is provided (FAST cross-chain deposits do not use an allowance
27079
+ * strategy).
27080
+ *
26814
27081
  * @defaultValue 'authorize'
26815
27082
  */
26816
27083
  allowanceStrategy?: AllowanceStrategy;
27084
+ /**
27085
+ * Destination chain for a FAST cross-chain deposit.
27086
+ *
27087
+ * When set, the deposit follows the prepaid-FORWARD CCTP v2 path:
27088
+ * the burned USDC is minted to the GenericExecutor on the destination
27089
+ * chain, which then calls Gateway `deposit` in a single relayed flow.
27090
+ *
27091
+ * Must not be set when `config.transferSpeed` is `'STANDARD'`.
27092
+ */
27093
+ to?: {
27094
+ chain: UnifiedBalanceChainIdentifier;
27095
+ };
27096
+ /**
27097
+ * Transfer configuration for the deposit.
27098
+ *
27099
+ * @defaultValue `{ transferSpeed: 'STANDARD' }`. Set `transferSpeed: 'FAST'`
27100
+ * explicitly for cross-chain deposits (when `to` is provided).
27101
+ */
27102
+ config?: DepositConfig;
27103
+ /**
27104
+ * Opaque signed fee-quote bytes from the Quote API.
27105
+ *
27106
+ * Pass this to commit to the fee price returned by a previous
27107
+ * {@link estimateDeposit} call (see {@link EstimateDepositResult.quote}).
27108
+ * When omitted a fresh quote is fetched automatically (FAST path only).
27109
+ */
27110
+ quote?: string;
26817
27111
  }
26818
27112
  /**
26819
27113
  * Parameters for depositing tokens into *another* Gateway account.
@@ -26840,7 +27134,7 @@ interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = Adapt
26840
27134
  * }
26841
27135
  * ```
26842
27136
  */
26843
- interface DepositForParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> extends Omit<DepositParams<TAdapterCapabilities, TChainIdentifier>, 'allowanceStrategy'> {
27137
+ interface DepositForParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends BridgeChainIdentifier = BridgeChainIdentifier> extends Omit<DepositParams<TAdapterCapabilities, TChainIdentifier>, 'allowanceStrategy'> {
26844
27138
  /**
26845
27139
  * The Gateway account address to credit with the deposit.
26846
27140
  *
@@ -26849,6 +27143,34 @@ interface DepositForParams<TAdapterCapabilities extends AdapterCapabilities = Ad
26849
27143
  */
26850
27144
  depositAccount: string;
26851
27145
  }
27146
+ /**
27147
+ * Relay progress for a cross-chain (FAST) deposit.
27148
+ *
27149
+ * Set after `depositFastCrossChain` completes the ~60-second relay wait.
27150
+ * Always present on the FAST path; absent on same-chain STANDARD deposits.
27151
+ *
27152
+ * @example
27153
+ * ```typescript
27154
+ * if (result.progress?.status === 'DONE') {
27155
+ * console.log('Minted on destination:', result.txHash)
27156
+ * } else if (result.progress?.status === 'PENDING') {
27157
+ * console.log('Relay still in progress — poll getDepositStatus later')
27158
+ * } else if (result.progress?.status === 'FAILED') {
27159
+ * console.log('Relay failed — manual mint may be required')
27160
+ * }
27161
+ * ```
27162
+ */
27163
+ interface DepositProgress {
27164
+ /**
27165
+ * Relay outcome after the burn is confirmed on the source chain.
27166
+ *
27167
+ * - `'DONE'` — Circle's relayer minted USDC on the destination chain.
27168
+ * - `'PENDING'` — Relay timed out (~60 s); the mint may still complete.
27169
+ * - `'FAILED'` — Relayer reported a permanent failure; manual mint may
27170
+ * be required.
27171
+ */
27172
+ status: 'DONE' | 'PENDING' | 'FAILED';
27173
+ }
26852
27174
  /**
26853
27175
  * Result returned after a successful deposit operation.
26854
27176
  *
@@ -26878,22 +27200,232 @@ interface DepositResult {
26878
27200
  depositedTo: string;
26879
27201
  /** The address that signed and funded the deposit. */
26880
27202
  depositedBy: string;
26881
- /** The chain on which the deposit occurred. */
27203
+ /**
27204
+ * The chain where the deposit balance lands.
27205
+ *
27206
+ * @remarks For cross-chain (FAST) deposits this is the destination chain
27207
+ * where the minted USDC is credited. For same-chain (STANDARD) deposits it
27208
+ * is the chain the deposit occurred on. Prefer `sourceChain` /
27209
+ * `destinationChain` for cross-chain flows.
27210
+ */
26882
27211
  chain: Blockchain;
26883
27212
  /**
26884
- * Unique identifier returned by the blockchain once the
26885
- * transaction is mined.
27213
+ * Transaction hash of the completed deposit.
27214
+ *
27215
+ * @remarks
27216
+ * For same-chain (STANDARD) deposits this is the on-chain deposit
27217
+ * transaction. For cross-chain (FAST) deposits with
27218
+ * `progress.status === 'DONE'` this is the Circle-relayed mint on the
27219
+ * destination chain; when the relay is still pending or has failed it
27220
+ * falls back to the source-chain burn hash.
26886
27221
  */
26887
27222
  txHash: string;
26888
27223
  /**
26889
- * Link to view the transaction details on the appropriate
26890
- * blockchain explorer.
27224
+ * Link to view the transaction on a block explorer.
26891
27225
  *
26892
27226
  * @remarks
26893
- * May be `undefined` when the explorer URL cannot be resolved
26894
- * for the chain.
27227
+ * Follows the same chain as {@link txHash}: points to the destination-chain
27228
+ * mint for a completed FAST deposit, or the source-chain burn otherwise.
27229
+ * May be `undefined` when the chain has no configured explorer URL.
26895
27230
  */
26896
27231
  explorerUrl?: string;
27232
+ /**
27233
+ * Source chain of the cross-chain deposit (FAST path only).
27234
+ *
27235
+ * Present when `to` was specified in the deposit params.
27236
+ */
27237
+ sourceChain?: Blockchain;
27238
+ /**
27239
+ * Destination chain of the cross-chain deposit (FAST path only).
27240
+ *
27241
+ * Present when `to` was specified in the deposit params.
27242
+ */
27243
+ destinationChain?: Blockchain;
27244
+ /**
27245
+ * Itemised fee breakdown for the cross-chain deposit (FAST path only).
27246
+ *
27247
+ * Contains at least a `gasFee` entry and a `forwarder` entry (Circle
27248
+ * FORWARD fee). The `gasFee` covers the source-chain burn gas; when a
27249
+ * `usdc.approve` was required it also includes the actual on-chain approve
27250
+ * gas derived from the transaction receipt.
27251
+ */
27252
+ fees?: FeeEntry[];
27253
+ /**
27254
+ * Relay progress after the source-chain burn (FAST path only).
27255
+ *
27256
+ * Present on every FAST deposit result. Use this to determine whether
27257
+ * the destination-chain mint completed within the ~60-second relay window.
27258
+ */
27259
+ progress?: DepositProgress;
27260
+ }
27261
+ /**
27262
+ * Transfer-speed configuration for a deposit operation.
27263
+ *
27264
+ * @example
27265
+ * ```typescript
27266
+ * import type { DepositConfig } from '@circle-fin/unified-balance-kit'
27267
+ *
27268
+ * const config: DepositConfig = { transferSpeed: 'FAST' }
27269
+ * ```
27270
+ */
27271
+ interface DepositConfig {
27272
+ /**
27273
+ * Requested transfer speed for a cross-chain fast deposit.
27274
+ *
27275
+ * @defaultValue `'STANDARD'`
27276
+ */
27277
+ transferSpeed?: 'FAST' | 'STANDARD';
27278
+ }
27279
+ /**
27280
+ * Parameters for estimating the fees of a fast cross-chain deposit.
27281
+ *
27282
+ * The result is plain, serializable data — no live adapter reference is
27283
+ * included. Pass the result (plus `from`) directly to
27284
+ * {@link DepositParams} or {@link DepositForParams} for execution:
27285
+ *
27286
+ * ```typescript
27287
+ * const estimate = await kit.estimateDeposit({ from, amount, token, to })
27288
+ * const result = await kit.deposit({ ...estimate, from })
27289
+ * ```
27290
+ *
27291
+ * @typeParam TAdapterCapabilities - Adapter capability constraints.
27292
+ * @typeParam TChainIdentifier - Accepted chain identifier type.
27293
+ *
27294
+ * @example
27295
+ * ```typescript
27296
+ * import type { EstimateDepositParams } from '@circle-fin/unified-balance-kit'
27297
+ *
27298
+ * const params: EstimateDepositParams = {
27299
+ * from: { adapter: evmAdapter, chain: 'Ethereum' },
27300
+ * amount: '100',
27301
+ * to: { chain: 'Arc_Testnet' },
27302
+ * config: { transferSpeed: 'FAST' },
27303
+ * }
27304
+ * ```
27305
+ */
27306
+ interface EstimateDepositParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends BridgeChainIdentifier = BridgeChainIdentifier> {
27307
+ /**
27308
+ * The adapter context identifying the depositor and source chain.
27309
+ * The adapter is used for source-chain gas estimation.
27310
+ */
27311
+ from: AdapterContext<TAdapterCapabilities, TChainIdentifier>;
27312
+ /**
27313
+ * The amount of tokens to deposit (human-readable decimal string).
27314
+ *
27315
+ * @example "100", "0.5"
27316
+ */
27317
+ amount: string;
27318
+ /**
27319
+ * The token to deposit.
27320
+ *
27321
+ * @defaultValue 'USDC'
27322
+ */
27323
+ token?: SupportedTokenInput;
27324
+ /**
27325
+ * Destination chain for a FAST cross-chain deposit.
27326
+ *
27327
+ * Required when `config.transferSpeed` is `'FAST'`.
27328
+ * Must not be set when `config.transferSpeed` is `'STANDARD'` (the default).
27329
+ */
27330
+ to?: {
27331
+ chain: UnifiedBalanceChainIdentifier;
27332
+ };
27333
+ /**
27334
+ * Transfer configuration.
27335
+ *
27336
+ * @defaultValue `{ transferSpeed: 'STANDARD' }`
27337
+ */
27338
+ config?: DepositConfig;
27339
+ /**
27340
+ * Gateway account address to credit (for a `depositFor` round-trip).
27341
+ *
27342
+ * When provided, this value is echoed on the result so
27343
+ * `kit.depositFor({ ...estimate, from })` works without re-specifying it.
27344
+ */
27345
+ depositAccount?: string;
27346
+ /**
27347
+ * Allowance strategy echoed to the result for round-trip convenience.
27348
+ */
27349
+ allowanceStrategy?: AllowanceStrategy;
27350
+ }
27351
+ /**
27352
+ * Fee-preview result returned by `estimateDeposit`.
27353
+ *
27354
+ * Plain, serializable data — no live adapter reference. Pass the result
27355
+ * directly to `deposit` or `depositFor` (re-attaching only `from`):
27356
+ *
27357
+ * ```typescript
27358
+ * const estimate = await kit.estimateDeposit({ from, amount, token, to })
27359
+ * const result = await kit.deposit({ ...estimate, from })
27360
+ * ```
27361
+ *
27362
+ * @example
27363
+ * ```typescript
27364
+ * import type { EstimateDepositResult } from '@circle-fin/unified-balance-kit'
27365
+ *
27366
+ * const result: EstimateDepositResult = {
27367
+ * amount: '100',
27368
+ * token: 'USDC',
27369
+ * to: { chain: 'Arc_Testnet' },
27370
+ * config: { transferSpeed: 'FAST' },
27371
+ * fees: [
27372
+ * { type: 'gasFee', token: 'ETH', amount: '0.0002' },
27373
+ * { type: 'forwarder', token: 'USDC', amount: '0.12' },
27374
+ * ],
27375
+ * quote: '0x…',
27376
+ * }
27377
+ * ```
27378
+ */
27379
+ interface EstimateDepositResult {
27380
+ /** Deposit amount (human-readable decimal string). */
27381
+ amount: string;
27382
+ /** Normalized token to deposit. */
27383
+ token: SupportedToken;
27384
+ /**
27385
+ * Destination chain (echoed from input).
27386
+ *
27387
+ * Present for FAST transfers; absent for STANDARD.
27388
+ */
27389
+ to?: {
27390
+ chain: UnifiedBalanceChainIdentifier;
27391
+ };
27392
+ /** Transfer configuration (echoed with defaults applied). */
27393
+ config: Required<DepositConfig>;
27394
+ /**
27395
+ * Itemized fee breakdown.
27396
+ *
27397
+ * Always contains at least a `gasFee` entry. For FAST transfers the gas
27398
+ * cost includes the source-chain burn; when the current USDC allowance is
27399
+ * insufficient it also includes the `usdc.approve` transaction. For
27400
+ * STANDARD deposits on EVM with `allowanceStrategy: 'approve'`, or any
27401
+ * `depositFor` on EVM, the gas cost includes both the
27402
+ * `usdc.increaseAllowance` and the deposit transaction. A `forwarder`
27403
+ * entry is always present for FAST cross-chain transfers.
27404
+ */
27405
+ fees: FeeEntry[];
27406
+ /**
27407
+ * Opaque signed fee-quote bytes from the Quote API.
27408
+ *
27409
+ * Present for FAST cross-chain deposits; absent for STANDARD or
27410
+ * same-chain. Pass this to {@link deposit} or {@link depositFor} to
27411
+ * commit to the quoted price.
27412
+ */
27413
+ quote?: string;
27414
+ /**
27415
+ * Gateway account to credit (echoed from input for `depositFor` round-trip).
27416
+ */
27417
+ depositAccount?: string;
27418
+ /**
27419
+ * Allowance strategy (echoed from input for `deposit` round-trip).
27420
+ */
27421
+ allowanceStrategy?: AllowanceStrategy;
27422
+ /**
27423
+ * Optional USD exchange-rate metadata from the Quote API.
27424
+ *
27425
+ * Present when the Quote API returns exchange rates for the fee token
27426
+ * and destination token. Non-binding; useful for USD-denominated display.
27427
+ */
27428
+ exchangeRates?: FeeQuoteExchangeRates;
26897
27429
  }
26898
27430
 
26899
27431
  /**
@@ -28378,6 +28910,35 @@ declare class AppKitUnifiedBalance {
28378
28910
  * ```
28379
28911
  */
28380
28912
  depositFor(params: DepositForParams): Promise<DepositResult>;
28913
+ /**
28914
+ * Estimate the fees for a deposit without executing it.
28915
+ *
28916
+ * Return plain, serializable data that can be spread directly into
28917
+ * {@link AppKitUnifiedBalance.deposit} or
28918
+ * {@link AppKitUnifiedBalance.depositFor}.
28919
+ *
28920
+ * @param params - Estimate details including the depositor context, amount,
28921
+ * destination chain, and optional transfer speed.
28922
+ * @returns Promise resolving to the itemised fee estimate.
28923
+ * @throws {KitError} If the estimate parameters are invalid or the route is
28924
+ * unsupported.
28925
+ *
28926
+ * @example
28927
+ * ```typescript
28928
+ * const estimate = await kit.unifiedBalance.estimateDeposit({
28929
+ * from: { adapter, chain: 'Ethereum' },
28930
+ * amount: '100',
28931
+ * to: { chain: 'Polygon' },
28932
+ * config: { transferSpeed: 'FAST' },
28933
+ * })
28934
+ *
28935
+ * const result = await kit.unifiedBalance.deposit({
28936
+ * ...estimate,
28937
+ * from: { adapter, chain: 'Ethereum' },
28938
+ * })
28939
+ * ```
28940
+ */
28941
+ estimateDeposit(params: EstimateDepositParams): Promise<EstimateDepositResult>;
28381
28942
  /**
28382
28943
  * Spend (mint) USDC on a destination chain by pulling funds from one or
28383
28944
  * more account sources.