@circle-fin/app-kit 1.11.0 → 1.12.0

package/index.d.ts

@@ -740,6 +740,8 @@ declare enum Blockchain {
     World_Chain_Sepolia = "World_Chain_Sepolia",
     XDC = "XDC",
     XDC_Apothem = "XDC_Apothem",
+    X_Layer = "X_Layer",
+    X_Layer_Testnet = "X_Layer_Testnet",
     ZKSync_Era = "ZKSync_Era",
     ZKSync_Sepolia = "ZKSync_Sepolia"
 }
@@ -952,6 +954,7 @@ declare enum BridgeChain {
     Unichain = "Unichain",
     World_Chain = "World_Chain",
     XDC = "XDC",
+    X_Layer = "X_Layer",
     Arc_Testnet = "Arc_Testnet",
     Arbitrum_Sepolia = "Arbitrum_Sepolia",
     Avalanche_Fuji = "Avalanche_Fuji",
@@ -975,7 +978,8 @@ declare enum BridgeChain {
     Sonic_Testnet = "Sonic_Testnet",
     Unichain_Sepolia = "Unichain_Sepolia",
     World_Chain_Sepolia = "World_Chain_Sepolia",
-    XDC_Apothem = "XDC_Apothem"
+    XDC_Apothem = "XDC_Apothem",
+    X_Layer_Testnet = "X_Layer_Testnet"
 }
 /**
  * Type representing valid bridge chain identifiers.
@@ -3386,7 +3390,7 @@ declare const PolygonAmoy: {
     readonly chainId: 80002;
     readonly isTestnet: true;
     readonly explorerUrl: "https://amoy.polygonscan.com/tx/{hash}";
-    readonly rpcEndpoints: readonly ["https://rpc-amoy.polygon.technology"];
+    readonly rpcEndpoints: readonly ["https://polygon-amoy-bor-rpc.publicnode.com", "https://polygon-amoy.drpc.org"];
     readonly eurcAddress: null;
     readonly usdcAddress: "0x41e94eb019c0762f9bfcf9fb1e58725bfb0e7582";
     readonly usdtAddress: null;
@@ -4232,6 +4236,98 @@ declare const XDCApothem: {
     };
 };
 
+/**
+ * X Layer Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the X Layer blockchain.
+ * X Layer is an EVM-compatible OP Stack Layer-2 blockchain built by OKX,
+ * using OKB as its native gas token. (Migrated from Polygon zkEVM/CDK to the
+ * OP Stack on 2025-10-27; older docs describing it as zkEVM are obsolete.)
+ */
+declare const XLayer: {
+    readonly type: "evm";
+    readonly chain: Blockchain.X_Layer;
+    readonly name: "X Layer";
+    readonly title: "X Layer Mainnet";
+    readonly nativeCurrency: {
+        readonly name: "OKB";
+        readonly symbol: "OKB";
+        readonly decimals: 18;
+    };
+    readonly chainId: 196;
+    readonly isTestnet: false;
+    readonly explorerUrl: "https://www.oklink.com/xlayer/tx/{hash}";
+    readonly rpcEndpoints: readonly ["https://xlayerrpc.okx.com"];
+    readonly eurcAddress: null;
+    readonly usdcAddress: "0xB6CEceAB302E2E4948951eE7843FC24E92933061";
+    readonly usdtAddress: null;
+    readonly cctp: {
+        readonly domain: 37;
+        readonly contracts: {
+            readonly v2: {
+                readonly type: "split";
+                readonly tokenMessenger: "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d";
+                readonly messageTransmitter: "0x81D40F21F12A8F0E3252Bccb954D722d4c464B64";
+                readonly confirmations: 65;
+                readonly fastConfirmations: 1;
+            };
+        };
+        readonly forwarderSupported: {
+            readonly source: false;
+            readonly destination: false;
+        };
+    };
+    readonly kitContracts: {
+        readonly bridge: "0xB3FA262d0fB521cc93bE83d87b322b8A23DAf3F0";
+    };
+};
+
+/**
+ * X Layer Testnet chain definition
+ * @remarks
+ * This represents the official test network for the X Layer blockchain.
+ * X Layer is an EVM-compatible OP Stack Layer-2 blockchain built by OKX,
+ * using OKB as its native gas token. (Migrated from Polygon zkEVM/CDK to the
+ * OP Stack on 2025-10-27; older docs describing it as zkEVM are obsolete.)
+ */
+declare const XLayerTestnet: {
+    readonly type: "evm";
+    readonly chain: Blockchain.X_Layer_Testnet;
+    readonly name: "X Layer Testnet";
+    readonly title: "X Layer Testnet";
+    readonly nativeCurrency: {
+        readonly name: "OKB";
+        readonly symbol: "OKB";
+        readonly decimals: 18;
+    };
+    readonly chainId: 1952;
+    readonly isTestnet: true;
+    readonly explorerUrl: "https://web3.okx.com/explorer/x-layer-testnet/tx/{hash}";
+    readonly rpcEndpoints: readonly ["https://testrpc.xlayer.tech"];
+    readonly eurcAddress: null;
+    readonly usdcAddress: "0xDec90b78111Ba2fc6FC6d84d8B9ec159A2d4b9B3";
+    readonly usdtAddress: null;
+    readonly cctp: {
+        readonly domain: 37;
+        readonly contracts: {
+            readonly v2: {
+                readonly type: "split";
+                readonly tokenMessenger: "0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA";
+                readonly messageTransmitter: "0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275";
+                readonly confirmations: 65;
+                readonly fastConfirmations: 1;
+            };
+        };
+        readonly forwarderSupported: {
+            readonly source: false;
+            readonly destination: false;
+        };
+    };
+    readonly kitContracts: {
+        readonly bridge: "0xC5567a5E3370d4DBfB0540025078e283e36A363d";
+    };
+};
+
 /**
  * ZKSync Era Mainnet chain definition
  * @remarks
@@ -4347,6 +4443,8 @@ declare const Chains_WorldChain: typeof WorldChain;
 declare const Chains_WorldChainSepolia: typeof WorldChainSepolia;
 declare const Chains_XDC: typeof XDC;
 declare const Chains_XDCApothem: typeof XDCApothem;
+declare const Chains_XLayer: typeof XLayer;
+declare const Chains_XLayerTestnet: typeof XLayerTestnet;
 declare const Chains_ZKSyncEra: typeof ZKSyncEra;
 declare const Chains_ZKSyncEraSepolia: typeof ZKSyncEraSepolia;
 declare namespace Chains {
@@ -4416,6 +4514,8 @@ declare namespace Chains {
     Chains_WorldChainSepolia as WorldChainSepolia,
     Chains_XDC as XDC,
     Chains_XDCApothem as XDCApothem,
+    Chains_XLayer as XLayer,
+    Chains_XLayerTestnet as XLayerTestnet,
     Chains_ZKSyncEra as ZKSyncEra,
     Chains_ZKSyncEraSepolia as ZKSyncEraSepolia,
   };
@@ -15871,6 +15971,17 @@ interface EarnServiceConfig {
      * Override for testing against staging or local environments.
      */
     readonly baseUrl?: string | undefined;
+    /**
+     * Enable or disable batched transaction execution.
+     *
+     * When `true` (or `undefined` / omitted), same-chain deposit and withdraw
+     * bundle the approve and execute calls into one adapter-native atomic batch
+     * when the connected wallet supports it. Set to `false` to force the
+     * sequential approve → execute flow.
+     *
+     * @defaultValue `undefined` (batching attempted when the wallet supports it)
+     */
+    readonly batchTransactions?: boolean | undefined;
 }
 /**
  * A single vault query specifying chain and vault address.
@@ -16388,6 +16499,278 @@ interface AssetAmount {
      */
     readonly status?: string | undefined;
 }
+/**
+ * The earn write operation a decoded transaction represents.
+ *
+ * Same-chain deposit, withdraw, and claim-rewards all bundle their work inside a
+ * single Adapter `execute()` call, so the action cannot be inferred from the
+ * calldata alone and is carried explicitly.
+ *
+ * @example
+ * ```typescript
+ * const action: EarnActionKind = 'deposit'
+ * ```
+ */
+type EarnActionKind = 'deposit' | 'withdraw' | 'claimRewards';
+/**
+ * A token address paired with a base-unit amount.
+ *
+ * Amounts are kept as base-unit decimal strings (never a `number`) so they are
+ * lossless and JSON-safe; format them for display with the token's decimals.
+ *
+ * @example
+ * ```typescript
+ * const usdc: DecodedTokenAmount = {
+ *   address: '0x3600000000000000000000000000000000000000',
+ *   amount: '1000000',
+ * }
+ * ```
+ */
+interface DecodedTokenAmount {
+    /** Token contract address. */
+    readonly address: `0x${string}`;
+    /** Amount in the token's smallest unit, as a decimal string. */
+    readonly amount: string;
+}
+/**
+ * A single claimed reward: the token and cumulative amount, plus the account
+ * credited.
+ *
+ * Extends {@link DecodedTokenAmount} with the Merkl `claim` recipient so a
+ * signer can see who receives each reward, not just the token and amount.
+ *
+ * The inherited `amount` is the *cumulative lifetime* total claimable for this
+ * `(recipient, token)` pair, exactly as encoded in the signed Merkl `claim`
+ * calldata — not the net amount transferred by this transaction. The Merkl
+ * Distributor sends only `amount - alreadyClaimed`, so treat this as the
+ * running claim total, not "the reward about to be received."
+ *
+ * @example
+ * ```typescript
+ * const reward: DecodedRewardClaim = {
+ *   recipient: '0xdbfF385d31bee3bA4DbdD7563c512e1C491bdD19',
+ *   address: '0x0000000000000000000000000000000000000a22',
+ *   amount: '1000000',
+ * }
+ * ```
+ */
+interface DecodedRewardClaim extends DecodedTokenAmount {
+    /** Account credited with this reward (the Merkl `claim` user). */
+    readonly recipient: `0x${string}`;
+}
+/**
+ * A single decoded inner instruction from an Adapter `execute()` bundle.
+ *
+ * Each variant mirrors the on-chain call the earn service signed, so a signer
+ * sees exactly what the bundle does rather than opaque calldata. Values decoded
+ * from `uint256` fields are represented as base-unit decimal strings.
+ *
+ * @example
+ * ```typescript
+ * const instruction: DecodedEarnInstruction = {
+ *   method: 'deposit',
+ *   vault: '0xAabbeF1D3971c710276ed41eC791BbE14CdB8E88',
+ *   assets: '1000000',
+ *   receiver: '0xdbfF385d31bee3bA4DbdD7563c512e1C491bdD19',
+ * }
+ * ```
+ */
+type DecodedEarnInstruction = {
+    readonly method: 'deposit';
+    /** ERC-4626 vault the assets are deposited into. */
+    readonly vault: `0x${string}`;
+    /** Assets deposited, in the underlying token's smallest unit. */
+    readonly assets: string;
+    /** Account credited with the minted vault shares. */
+    readonly receiver: `0x${string}`;
+} | {
+    readonly method: 'withdraw';
+    /** ERC-4626 vault the assets are withdrawn from. */
+    readonly vault: `0x${string}`;
+    /** Assets withdrawn, in the underlying token's smallest unit. */
+    readonly assets: string;
+    /** Account credited with the withdrawn assets. */
+    readonly receiver: `0x${string}`;
+    /** Account whose shares are burned (the Adapter for EarnKit). */
+    readonly owner: `0x${string}`;
+} | {
+    readonly method: 'redeem';
+    /** ERC-4626 vault the shares are redeemed from. */
+    readonly vault: `0x${string}`;
+    /** Shares redeemed, in the vault-share token's smallest unit. */
+    readonly shares: string;
+    /** Account credited with the redeemed assets. */
+    readonly receiver: `0x${string}`;
+    /** Account whose shares are burned (the Adapter for EarnKit). */
+    readonly owner: `0x${string}`;
+} | {
+    readonly method: 'takeFeeERC20';
+    /** FeeTaker contract the fee is paid to. */
+    readonly feeTaker: `0x${string}`;
+    /** Token the fee is denominated in. */
+    readonly token: `0x${string}`;
+    /** Account credited with the fee. */
+    readonly beneficiary: `0x${string}`;
+    /** Fee amount in the token's smallest unit. */
+    readonly fee: string;
+    /** 8-byte kit identifier passed to the FeeTaker. */
+    readonly kitType: `0x${string}`;
+} | {
+    readonly method: 'claim';
+    /** Merkl Distributor the rewards are claimed from. */
+    readonly distributor: `0x${string}`;
+    /** One entry per claimed reward token. */
+    readonly rewards: readonly DecodedRewardClaim[];
+};
+/**
+ * A human-readable decode of the Adapter `execute()` transaction a signer is
+ * asked to sign for a same-chain earn operation.
+ *
+ * `instructions` is the full-fidelity decode of every inner call; `summary`
+ * lifts the values a wallet prompt cares about (token + amount, vault, receiver,
+ * fee, rewards) to the top level. Every value is derived from the same signed
+ * `executeParams` the SDK encodes into the transaction, so the decode cannot
+ * drift from what is actually signed.
+ *
+ * @example
+ * ```typescript
+ * const decoded: DecodedEarnTx = {
+ *   action: 'deposit',
+ *   chain: 'Arc_Testnet',
+ *   adapter: '0xBBD70b01a1CAbc96d5b7b129Ae1AAabdf50dd40b',
+ *   instructions: [
+ *     {
+ *       method: 'deposit',
+ *       vault: '0xAabbeF1D3971c710276ed41eC791BbE14CdB8E88',
+ *       assets: '1000000',
+ *       receiver: '0xdbfF385d31bee3bA4DbdD7563c512e1C491bdD19',
+ *     },
+ *   ],
+ *   summary: {
+ *     token: {
+ *       address: '0x3600000000000000000000000000000000000000',
+ *       amount: '1000000',
+ *     },
+ *     vault: '0xAabbeF1D3971c710276ed41eC791BbE14CdB8E88',
+ *     receiver: '0xdbfF385d31bee3bA4DbdD7563c512e1C491bdD19',
+ *   },
+ * }
+ * ```
+ */
+interface DecodedEarnTx {
+    /** The earn operation this transaction performs. */
+    readonly action: EarnActionKind;
+    /** Chain identifier the transaction executes on. */
+    readonly chain: EarnChainIdentifier;
+    /** Adapter contract the `execute()` call targets. */
+    readonly adapter: `0x${string}`;
+    /** Full decode of every inner instruction in the `execute()` bundle. */
+    readonly instructions: readonly DecodedEarnInstruction[];
+    /** Wallet-prompt-ready summary of the primary values being signed. */
+    readonly summary: {
+        /**
+         * The token and amount this operation is denominated in, with the address
+         * and amount always in the same unit: the underlying asset deposited
+         * (deposit) or withdrawn (withdraw), or the vault-share token redeemed
+         * (redeem).
+         */
+        readonly token?: DecodedTokenAmount;
+        /** Target vault, when the action operates on one. */
+        readonly vault?: `0x${string}`;
+        /** Account credited by the operation. */
+        readonly receiver?: `0x${string}`;
+        /** Circle fee taken by the operation, when charged. */
+        readonly fee?: DecodedTokenAmount;
+        /** Rewards claimed, for claim-rewards, each with its credited recipient. */
+        readonly rewards?: readonly DecodedRewardClaim[];
+    };
+}
+/**
+ * The exact single EVM call an EarnKit same-chain operation authorizes.
+ *
+ * This is the canonical Adapter `execute()` call as it will be handed to the
+ * wallet or signing strategy — target, calldata, and native value — not a
+ * serialized transaction (fees and nonce are still selected by the wallet
+ * afterwards).
+ *
+ * @example
+ * ```typescript
+ * const encoded: EarnEncodedTransaction = {
+ *   to: '0xBBD70b01a1CAbc96d5b7b129Ae1AAabdf50dd40b',
+ *   data: '0x…',
+ *   value: 0n,
+ * }
+ * ```
+ */
+interface EarnEncodedTransaction {
+    /** Adapter contract the `execute()` call targets. */
+    readonly to: `0x${string}`;
+    /** ABI-encoded `execute()` calldata about to be authorized. */
+    readonly data: `0x${string}`;
+    /** Native token value the authorized call specifies, when the call sets one. */
+    readonly value?: bigint | undefined;
+}
+/**
+ * Namespaced discriminator for the EarnKit authorization review.
+ *
+ * Applications match on this in an adapter `onBeforeAuthorize` hook to decide
+ * whether the request carries EarnKit semantic data. Prefer the
+ * {@link isEarnExecuteReview} type guard over comparing this string directly.
+ *
+ * @example
+ * ```typescript
+ * if (review?.kind === EARN_EXECUTE_REVIEW_KIND) { … }
+ * ```
+ */
+declare const EARN_EXECUTE_REVIEW_KIND: "earn.execute";
+/**
+ * Verified semantic review data EarnKit attaches to a same-chain
+ * deposit / withdraw / claim-rewards authorization.
+ *
+ * Surfaced as the `data` of the adapter `AuthorizationReview` whose `kind` is
+ * {@link EARN_EXECUTE_REVIEW_KIND}. It pairs the exact calldata being
+ * authorized ({@link encoded}) with a drift-free decode of it
+ * ({@link decoded}). The factory that produces it re-decodes the final
+ * calldata and asserts every instruction matches the service-signed
+ * parameters, so a populated review is proof the preview matches what is
+ * signed — never a best-effort guess.
+ *
+ * @example
+ * ```typescript
+ * import { createViemAdapter } from '@circle-fin/adapter-viem-v2/next'
+ *
+ * const adapter = createViemAdapter({
+ *   capabilities,
+ *   getPublicClient,
+ *   getWalletClient,
+ *   onBeforeAuthorize: async ({ review }) => {
+ *     if (isEarnExecuteReview(review)) {
+ *       const { decoded } = review.data
+ *       await showEarnConfirmation(decoded.summary)
+ *     }
+ *     return 'approve'
+ *   },
+ * })
+ * ```
+ */
+interface EarnExecuteReview {
+    /** The exact Adapter `execute()` call being authorized. */
+    readonly encoded: EarnEncodedTransaction;
+    /** Drift-free decode of {@link encoded}, verified against signed params. */
+    readonly decoded: DecodedEarnTx;
+}
+/**
+ * An adapter authorization review carrying {@link EarnExecuteReview} data.
+ *
+ * The shape an `onBeforeAuthorize` hook sees on `request.review` once
+ * {@link isEarnExecuteReview} narrows it.
+ */
+interface EarnExecuteAuthorizationReview {
+    /** Always {@link EARN_EXECUTE_REVIEW_KIND}. */
+    readonly kind: typeof EARN_EXECUTE_REVIEW_KIND;
+    /** Verified EarnKit semantic review data. */
+    readonly data: EarnExecuteReview;
+}
 /**
  * Source-fee quote expiry metadata returned by bridge prepare.
  *
@@ -17816,6 +18199,49 @@ declare class EarnServiceProvider implements EarningProvider {
     getClaimRewardsQuote<T extends AdapterCapabilities>(params: GetClaimRewardsQuoteServiceParams<T>): Promise<ClaimRewardsQuoteInfo>;
 }
 
+/**
+ * Lazy `earn.execute` authorization-review factory for same-chain EarnKit
+ * operations.
+ *
+ * @remarks
+ * The provider attaches the {@link buildEarnExecuteDescriptor} descriptor to
+ * the final earn adapter action. The adapter's shared authorization gate runs
+ * the descriptor's `createReview` factory only when the application configured
+ * an `onBeforeAuthorize` hook, so the decode + consistency check are skipped
+ * entirely otherwise. The factory fails closed: it decodes the exact calldata
+ * about to be authorized and asserts every instruction matches the
+ * service-signed parameters, so a populated `earn.execute` review is proof the
+ * preview matches what is signed rather than a best-effort guess.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Type guard: narrow an adapter authorization review to an EarnKit
+ * `earn.execute` review.
+ *
+ * Use this inside an adapter `onBeforeAuthorize` hook to detect whether the
+ * request carries EarnKit semantic data before reading it, instead of
+ * comparing `review.kind` by hand. Robust against plain-JavaScript callers:
+ * accepts `unknown` and checks the shape at runtime.
+ *
+ * @param review - The `review` field from an `AuthorizationRequest`, or any
+ *   value.
+ * @returns `true` when `review` is an `earn.execute` review with the expected
+ *   `{ encoded, decoded }` data shape.
+ *
+ * @example
+ * ```typescript
+ * onBeforeAuthorize: async ({ review }) => {
+ *   if (isEarnExecuteReview(review)) {
+ *     await showEarnConfirmation(review.data.decoded.summary)
+ *   }
+ *   return 'approve'
+ * }
+ * ```
+ */
+declare function isEarnExecuteReview(review: unknown): review is EarnExecuteAuthorizationReview;
+
 /**
  * Estimated gas details for one transaction in a kit-level Earn quote, with
  * every amount as a decimal string so quote results stay JSON-serializable.
@@ -17904,6 +18330,24 @@ interface EarnConfig {
      * Format: `KIT_KEY:<keyId>:<keySecret>`
      */
     readonly kitKey?: string | undefined;
+    /**
+     * Optional base URL override for the Earn Service API.
+     *
+     * Defaults to `https://api.circle.com` when omitted. Override for testing
+     * against staging or local environments.
+     */
+    readonly baseUrl?: string | undefined;
+    /**
+     * Enable or disable atomic batched transaction execution.
+     *
+     * When `true` (or `undefined` / omitted), same-chain deposit and withdraw
+     * bundle the approve and execute calls into one adapter-native atomic batch
+     * when the connected wallet supports it. Set to `false` to force the
+     * sequential approve → execute flow.
+     *
+     * @defaultValue `undefined` (batching attempted when the wallet supports it)
+     */
+    readonly batchTransactions?: boolean | undefined;
 }
 /**
  * Parameters for fetching vault information.
@@ -20263,10 +20707,16 @@ declare const getVaultsParamsSchema: z.ZodObject<{
     }>, "many">;
     config: z.ZodOptional<z.ZodObject<{
         kitKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        batchTransactions: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     vaults: {
@@ -20346,6 +20796,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
     }[];
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
 }, {
     vaults: {
@@ -20425,6 +20877,8 @@ declare const getVaultsParamsSchema: z.ZodObject<{
     }[];
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
 }>;
 /**
@@ -20941,10 +21395,16 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
     pageSize: z.ZodOptional<z.ZodNumber>;
     config: z.ZodOptional<z.ZodObject<{
         kitKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        batchTransactions: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     chain: string | {
@@ -21021,6 +21481,8 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
     };
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     protocol?: string | undefined;
     asset?: string | undefined;
@@ -21104,6 +21566,8 @@ declare const exploreVaultsParamsSchema: z.ZodObject<{
     };
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     protocol?: string | undefined;
     asset?: string | undefined;
@@ -21629,10 +22093,16 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
     pageSize: z.ZodOptional<z.ZodNumber>;
     config: z.ZodOptional<z.ZodObject<{
         kitKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        batchTransactions: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }>>;
 }, "page">, "strip", z.ZodTypeAny, {
     chain: string | {
@@ -21709,6 +22179,8 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
     };
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     protocol?: string | undefined;
     asset?: string | undefined;
@@ -21791,6 +22263,8 @@ declare const exploreVaultsIteratorParamsSchema: z.ZodObject<Omit<{
     };
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     protocol?: string | undefined;
     asset?: string | undefined;
@@ -21817,21 +22291,31 @@ declare const getPositionParamsSchema: z.ZodObject<{
     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>;
     config: z.ZodOptional<z.ZodObject<{
         kitKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        batchTransactions: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     vaultAddress: `0x${string}`;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
 }, {
     vaultAddress: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
 }>;
@@ -22508,10 +22992,16 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
     transferSpeed: z.ZodOptional<z.ZodEnum<["FAST", "SLOW"]>>;
     config: z.ZodOptional<z.ZodObject<{
         kitKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        batchTransactions: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }>>;
 }, "strict", z.ZodTypeAny, {
     vaultAddress: `0x${string}`;
@@ -22594,6 +23084,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
     maxFee: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
     transferSpeed?: "FAST" | "SLOW" | undefined;
@@ -22678,6 +23170,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
     maxFee: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
     transferSpeed?: "FAST" | "SLOW" | undefined;
@@ -22688,16 +23182,24 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
     amount: z.ZodEffects<z.ZodPipeline<z.ZodString, z.ZodType<string, z.ZodTypeDef, string>>, string, string>;
     config: z.ZodOptional<z.ZodObject<{
         kitKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        batchTransactions: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }>>;
 }, "strict", z.ZodTypeAny, {
     vaultAddress: `0x${string}`;
     amount: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
     to?: undefined;
@@ -22706,6 +23208,8 @@ declare const anyDepositParamsSchema: z.ZodUnion<[z.ZodObject<{
     amount: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
     to?: undefined;
@@ -22733,16 +23237,24 @@ declare const depositParamsSchema: z.ZodObject<{
     amount: z.ZodEffects<z.ZodPipeline<z.ZodString, z.ZodType<string, z.ZodTypeDef, string>>, string, string>;
     config: z.ZodOptional<z.ZodObject<{
         kitKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        batchTransactions: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     vaultAddress: `0x${string}`;
     amount: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
 }, {
@@ -22750,6 +23262,8 @@ declare const depositParamsSchema: z.ZodObject<{
     amount: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
 }>;
@@ -22769,20 +23283,30 @@ declare const getCrossChainDepositStatusParamsSchema: z.ZodObject<{
     execId: z.ZodString;
     config: z.ZodOptional<z.ZodObject<{
         kitKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        batchTransactions: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     execId: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
 }, {
     execId: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
 }>;
 /**
@@ -22803,10 +23327,16 @@ declare const waitForCrossChainDepositParamsSchema: z.ZodObject<{
     execId: z.ZodString;
     config: z.ZodOptional<z.ZodObject<{
         kitKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        batchTransactions: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }>>;
     pollIntervalMs: z.ZodOptional<z.ZodNumber>;
     maxWaitMs: z.ZodOptional<z.ZodNumber>;
@@ -22815,6 +23345,8 @@ declare const waitForCrossChainDepositParamsSchema: z.ZodObject<{
     execId: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     pollIntervalMs?: number | undefined;
     maxWaitMs?: number | undefined;
@@ -22823,6 +23355,8 @@ declare const waitForCrossChainDepositParamsSchema: z.ZodObject<{
     execId: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     pollIntervalMs?: number | undefined;
     maxWaitMs?: number | undefined;
@@ -22848,16 +23382,24 @@ declare const withdrawParamsSchema: z.ZodObject<{
     amount: z.ZodEffects<z.ZodPipeline<z.ZodString, z.ZodType<string, z.ZodTypeDef, string>>, string, string>;
     config: z.ZodOptional<z.ZodObject<{
         kitKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        batchTransactions: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     vaultAddress: `0x${string}`;
     amount: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
 }, {
@@ -22865,6 +23407,8 @@ declare const withdrawParamsSchema: z.ZodObject<{
     amount: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
 }>;
@@ -22888,21 +23432,31 @@ declare const claimRewardsParamsSchema: z.ZodObject<{
     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>;
     config: z.ZodOptional<z.ZodObject<{
         kitKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        batchTransactions: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     vaultAddress: `0x${string}`;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
 }, {
     vaultAddress: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
 }>;
@@ -22952,16 +23506,24 @@ declare const getWithdrawalQuoteParamsSchema: z.ZodObject<{
     amount: z.ZodEffects<z.ZodPipeline<z.ZodString, z.ZodType<string, z.ZodTypeDef, string>>, string, string>;
     config: z.ZodOptional<z.ZodObject<{
         kitKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        batchTransactions: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     vaultAddress: `0x${string}`;
     amount: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
 }, {
@@ -22969,6 +23531,8 @@ declare const getWithdrawalQuoteParamsSchema: z.ZodObject<{
     amount: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
 }>;
@@ -22992,21 +23556,31 @@ declare const getClaimRewardsQuoteParamsSchema: z.ZodObject<{
     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>;
     config: z.ZodOptional<z.ZodObject<{
         kitKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        batchTransactions: z.ZodOptional<z.ZodBoolean>;
     }, "strict", z.ZodTypeAny, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }, {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     vaultAddress: `0x${string}`;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
 }, {
     vaultAddress: string;
     config?: {
         kitKey?: string | undefined;
+        baseUrl?: string | undefined;
+        batchTransactions?: boolean | undefined;
     } | undefined;
     from?: any;
 }>;
@@ -24615,956 +25189,828 @@ interface IGatewayProvider<TProviderActions = GatewayV1Actions> {
 }
 
 /**
- * A custom token contract address string.
- *
- * This type represents token addresses that are not known aliases.
- * It uses a branded type pattern to preserve IDE autocomplete for TokenAlias
- * while still accepting arbitrary address strings.
- */
-type TokenAddress = string & {
-    readonly __tokenAddress?: never;
-};
-/**
- * Known token aliases supported by AppKit.
- *
- * These aliases map to chain-specific token addresses. `USDC`, `USDT`, and
- * `NATIVE` have dedicated transfer actions in the adapter layer. `EURC` has no
- * dedicated action — it resolves to the chain's `eurcAddress` and is sent via
- * the generic token transfer action, so it is only supported on chains where
- * `eurcAddress` is set.
+ * Destination for a Gateway spend (mint) operation.
  *
  * @remarks
- * For swap operations, see {@link SupportedToken} in SwapKit which supports
- * additional tokens (DAI, USDE, PYUSD).
- */
-type TokenAlias = 'USDC' | 'USDT' | 'NATIVE' | 'EURC';
-/**
- * Operation types that support the `getFee`/`getFeeRecipient` hooks.
- */
-type FeeOperationType = 'bridge' | 'swap';
-/**
- * Union type of all supported operation types in the AppKit.
- *
- * This type ensures type safety when specifying operation types and enables
- * proper parameter validation based on the selected operation.
- */
-type OperationType = FeeOperationType | 'earn' | 'unifiedBalance';
-/**
- * Maps operation types to their corresponding parameter interfaces.
- *
- * This interface maps operation types to their parameter structures for
- * compile-time validation in shared AppKit helpers.
+ * Omitting `recipientAddress` causes funds to be minted to the
+ * address resolved from the adapter.  Providing it overrides the
+ * default destination.
  *
- * @remarks `earn` is included so consumers can refer to the full EarnKit
- * operation-parameter union through AppKit types. Developer fee hooks
- * intentionally use {@link FeeOperationType}, so they do not accept earn
- * parameters until EarnKit supports fee-bearing requests.
+ * @typeParam TAdapterCapabilities - Adapter capability constraints.
+ * @typeParam TChainIdentifier - Accepted chain identifier type.
  *
  * @example
  * ```typescript
- * // TypeScript will enforce that bridge operations use BridgeParams
- * type BridgeParamsType = OperationParamsMap['bridge'] // BridgeParams
- * // TypeScript will enforce that swap operations use SwapParams
- * type SwapParamsType = OperationParamsMap['swap'] // SwapParams
- * // TypeScript will enforce that earn operations use EarnOperationParams
- * type EarnParamsType = OperationParamsMap['earn'] // EarnOperationParams
+ * import type { SpendDestination } from '@circle-fin/unified-balance-kit'
+ *
+ * const destination: SpendDestination = {
+ *   adapter: avalancheAdapter,
+ *   chain: 'Avalanche',
+ *   recipientAddress: '0xDEST…abcd',
+ * }
  * ```
  */
-interface OperationParamsMap {
-    bridge: BridgeParams;
-    swap: SwapParams;
-    earn: EarnOperationParams;
-}
+type SpendDestination<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> = {
+    /** The adapter for executing on-chain calls. */
+    adapter: Adapter<TAdapterCapabilities>;
+    /** The destination chain. */
+    chain: TChainIdentifier;
+    /**
+     * Optional custom recipient address.  When omitted the adapter's
+     * resolved address is used.
+     */
+    recipientAddress?: string;
+    /**
+     * Enable Circle's Forwarding Service for automatic mint submission.
+     * When `true`, the Gateway API handles the destination mint via its
+     * relayer and the SDK polls for completion instead of executing a
+     * user-signed mint transaction.
+     */
+    useForwarder?: boolean;
+} & AddressField<ExtractAddressContext<TAdapterCapabilities>>;
 /**
- * Context interface for the AppKit with strongly typed getFee method.
+ * Forwarder-only destination for spend operations.
  *
- * This interface uses TypeScript function overloads to provide type-safe
- * parameter validation based on the operation type. Each operation type
- * maps to specific parameter types, ensuring compile-time safety and
- * excellent developer experience with full IntelliSense support.
+ * Used when Circle's Forwarding Service handles the mint transaction
+ * and no destination adapter is available. Set `useForwarder` to `true`
+ * and provide a `recipientAddress`.
  *
- * The interface supports both direct operation-specific overloads and a
- * generic overload for advanced use cases while maintaining type safety.
+ * @typeParam TChainIdentifier - Accepted chain identifier type.
  *
  * @example
  * ```typescript
- * // Bridge operation - uses BridgeParams
- * const bridgeFee = await context.getFee('bridge', {
- *   from: { adapter: sourceAdapter, chain: 'Ethereum' },
- *   to: { adapter: destAdapter, chain: 'Polygon' },
- *   amount: '100.50'
- * })
+ * import type { ForwarderSpendDestination } from '@circle-fin/unified-balance-kit'
+ *
+ * const destination: ForwarderSpendDestination = {
+ *   chain: 'Base',
+ *   recipientAddress: '0xDEST…abcd',
+ *   useForwarder: true,
+ * }
  * ```
  */
-interface AppKitContext {
-    /**
-     * Get fee estimation for bridge or swap operations.
-     *
-     * Calculate the estimated fees for cross-chain bridge transfers, same-chain
-     * token swaps. Returns the fee amount in smallest token units.
-     *
-     * The function signature uses TypeScript's generic constraint pattern to ensure
-     * type safety: when type is 'bridge', params must be BridgeParams; when type
-     * is 'swap', params must be SwapParams.
-     *
-     * @typeParam T - The fee operation type ('bridge' | 'swap')
-     * @param type - Operation type: 'bridge' for cross-chain transfers, 'swap' for same-chain swaps
-     * @param params - Operation-specific parameters matching the type
-     * @returns Promise resolving to fee amount as string in smallest token units
-     * @throws {@link ValidationError} If operation parameters are invalid
-     * @throws {@link UnsupportedRouteError} If the operation route is not supported
-     *
-     * @example
-     * ```typescript
-     * // Bridge fee
-     * const bridgeFee = await context.getFee?.('bridge', bridgeParams)
-     *
-     * // Swap fee
-     * const swapFee = await context.getFee?.('swap', swapParams)
-     *
-     * // Generic usage
-     * function estimateFee<T extends FeeOperationType>(
-     *   operation: T,
-     *   params: OperationParamsMap[T]
-     * ) {
-     *   return context.getFee(operation, params) // Fully type-safe
-     * }
-     * ```
-     */
-    getFee?<T extends FeeOperationType>(type: T, params: OperationParamsMap[T]): Promise<string>;
-    /**
-     * Get the fee recipient address for a specific operation and chain.
-     *
-     * This method returns the address that will receive protocol fees for
-     * the specified operation type on the given chain. Useful for transparency
-     * and fee tracking purposes.
-     *
-     * @remarks When this hook is used for bridging operations, the `params` object within `info` will be empty.
-     * This is due to a limitation in the underlying `BridgeKit`, which does not provide bridge parameters
-     * to its fee recipient hook.
-     *
-     * @typeParam T - The fee operation type ('bridge' | 'swap')
-     * @param type - The specific operation type
-     * @param info - Object containing chain and parameter information
-     * @returns Promise resolving to the fee recipient address
-     * @throws {@link ValidationError} If parameters are invalid
-     * @throws {@link UnsupportedChainError} If the chain is not supported
-     *
-     * @example
-     * ```typescript
-     * const recipient = await context.getFeeRecipient('bridge', {
-     *   chain: ethereumChain,
-     *   params: bridgeParams
-     * })
-     * ```
-     */
-    getFeeRecipient?<T extends FeeOperationType>(type: T, info: {
-        chain: ChainDefinition;
-        params: OperationParamsMap[T];
-    }): Promise<string>;
-    /**
-     * Event handlers registered for AppKit operations.
-     *
-     * This property stores event handlers that are registered via the AppKit's
-     * `on()` method. Handlers are grouped by operation type. The runtime buckets
-     * are `bridge` and `earn`; the context can add more operation buckets as
-     * AppKit wires action handlers for additional kits.
-     *
-     * Within each operation bucket, handlers are keyed by action name (for
-     * example, `bridge.approve` or `earn.deposit`) or `*` for wildcard handlers.
-     * Each action can have multiple handlers registered, allowing multiple
-     * subscribers to listen to the same event.
-     *
-     * The handlers are stored in the context to allow deferred registration with
-     * underlying operation kits, enabling a clean separation between event
-     * registration and operation execution.
-     *
-     * @example
-     * ```typescript
-     * const context = createContext()
-     * // Handlers registered via kit.on() are stored by operation type
-     * // Bridge handlers are registered with BridgeKit when bridge() runs
-     * // Earn handlers are registered with EarnKit when earn operations run
-     * ```
-     */
-    actions: Record<'bridge' | 'earn', Record<string, ((payload: unknown) => void)[]>>;
-    /**
-     * Disable success analytics for the underlying EarnKit, SwapKit, and
-     * UnifiedBalanceKit.
-     *
-     * When `true`, completed earn, swap, and unified balance operations will not
-     * POST analytics events. This does not disable error reporting; use
-     * {@link AppKitContext.disableErrorReporting} for that. Defaults to `false`.
-     *
-     * @defaultValue false
-     */
-    disableAnalytics?: boolean;
+interface ForwarderSpendDestination<TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
+    /** The destination chain where USDC will be minted. */
+    chain: TChainIdentifier;
+    /** The recipient address that will receive the minted USDC. */
+    recipientAddress: string;
+    /** Enable Circle's Forwarding Service for the destination mint. */
+    useForwarder: boolean;
+}
+/**
+ * Union of spend destination variants.
+ *
+ * @see {@link SpendDestination}
+ * @see {@link ForwarderSpendDestination}
+ */
+type SpendDestinationUnion<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> = SpendDestination<TAdapterCapabilities, TChainIdentifier> | ForwarderSpendDestination<TChainIdentifier>;
+/**
+ * An amount of USDC to pull from a specific chain.
+ *
+ * @example
+ * ```typescript
+ * import type { Allocation } from '@circle-fin/unified-balance-kit'
+ *
+ * const allocation: Allocation = {
+ *   amount: '50',
+ *   chain: 'Ethereum',
+ * }
+ * ```
+ */
+interface Allocation {
     /**
-     * Disable error telemetry for all sub-kits.
-     *
-     * When `true`, none of the underlying kits (BridgeKit, SwapKit, EarnKit,
-     * UnifiedBalanceKit) will POST error details to the telemetry
-     * endpoint when operations throw. Defaults to `false` (enabled).
-     *
-     * @defaultValue false
+     * The amount to pull from this chain (human-readable decimal
+     * string).
      */
-    disableErrorReporting?: boolean;
+    amount: string;
     /**
-     * Custom HTTP headers forwarded with the underlying CCTP provider's
-     * attestation (Iris) API requests made by bridge operations.
+     * The chain from which to pull the funds.
      *
      * @remarks
-     * Headers are merged on top of the SDK defaults (such as `Content-Type`)
-     * rather than replacing them. The header is forwarded as-is to Circle's API;
-     * the SDK does not interpret it.
+     * All allocations in a single spend must be either all mainnet
+     * or all testnet.  Mixing is not allowed.
      */
-    headers?: Record<string, string>;
+    chain: UnifiedBalanceChainIdentifier;
 }
 /**
- * Earn operation namespace exposed as `kit.earn`.
+ * Extends {@link Allocation} with the resolved source Gateway
+ * account address.
  *
- * Mirrors the operations currently available from `@circle-fin/earn-kit`.
- * Step events use the AppKit event API (`kit.on('earn.*')` / `kit.on('*')`).
+ * @example
+ * ```typescript
+ * import type { AllocationResult } from '@circle-fin/unified-balance-kit'
+ *
+ * const result: AllocationResult = {
+ *   amount: '50',
+ *   chain: 'Ethereum',
+ *   sourceAccount: '0x1234…5678',
+ * }
+ * ```
+ */
+interface AllocationResult extends Allocation {
+    /** The Gateway account address from which this amount was pulled. */
+    sourceAccount: string;
+}
+/**
+ * A spend source providing an adapter and optional per-chain allocations.
+ *
+ * @remarks
+ * When `allocations` is omitted the provider's automatic allocation
+ * logic decides which chains to draw from.  A top-level `amount`
+ * field on {@link SpendParams} is **required** in that case.
+ *
+ * When `allocations` is present, every source in the `from` array
+ * must also include `allocations` (all-or-nothing rule).
+ *
+ * @typeParam TAdapterCapabilities - Adapter capability constraints.
  *
  * @example
  * ```typescript
- * import { AppKit, EarnChain } from '@circle-fin/app-kit'
+ * import type { SpendSource } from '@circle-fin/unified-balance-kit'
  *
- * const kit = new AppKit()
+ * // With explicit allocations
+ * const withAlloc: SpendSource = {
+ *   adapter: evmAdapter,
+ *   allocations: [
+ *     { amount: '40', chain: 'Ethereum' },
+ *     { amount: '60', chain: 'Base' },
+ *   ],
+ * }
  *
- * const result = await kit.earn.deposit({
- *   from: { adapter, chain: EarnChain.Arc_Testnet },
- *   vaultAddress: '0x...',
- *   amount: '100.50',
- * })
+ * // Adapter-only (auto-allocation)
+ * const adapterOnly: SpendSource = {
+ *   adapter: evmAdapter,
+ * }
  * ```
  */
-interface AppKitEarnOperations {
+type SpendSource<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> = {
+    /** The adapter for executing on-chain calls. */
+    adapter: Adapter<TAdapterCapabilities>;
     /**
-     * Deposit into an earn vault.
-     *
-     * @param params - Deposit parameters
-     * @returns Promise resolving to the deposit result
-     * @throws If validation, provider lookup, or transaction execution fails
-     *
-     * @example
-     * ```typescript
-     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
-     *
-     * const kit = new AppKit()
-     * const result = await kit.earn.deposit({
-     *   from: { adapter, chain: EarnChain.Arc_Testnet },
-     *   vaultAddress: '0x...',
-     *   amount: '100.50',
-     * })
-     * ```
+     * Optional per-chain allocations describing how much to pull from
+     * each chain.  When omitted the provider computes allocations
+     * automatically.
      */
-    deposit<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: SameChainDepositParams<TFromAdapterCapabilities>): Promise<EarnSameChainDepositResult>;
+    allocations?: Allocation | Allocation[];
     /**
-     * Deposit into an earn vault from another chain through the bridge flow.
+     * Optional Gateway account to pull from (delegate scenarios).
      *
-     * @param params - Cross-chain deposit parameters
-     * @returns Promise resolving to the bridge submission details
-     * @throws If validation, provider lookup, or the bridge flow fails
+     * @remarks
+     * When omitted the adapter's resolved address is used.  When
+     * provided you must be a delegate for this account.
      */
-    deposit<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: CrossChainDepositParams<TFromAdapterCapabilities>): Promise<EarnCrossChainDepositResult>;
+    sourceAccount?: string;
+} & AddressField<ExtractAddressContext<TAdapterCapabilities>>;
+/**
+ * Base fields shared by all spend parameter variants.
+ */
+interface SpendParamsBase<TToAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
+    /** Where to mint the USDC on the destination chain. */
+    to: SpendDestinationUnion<TToAdapterCapabilities, TChainIdentifier>;
     /**
-     * Deposit into an earn vault, on the same chain or cross-chain.
-     *
-     * @param params - Deposit parameters
-     * @returns Promise resolving to same-chain transaction details or
-     *   cross-chain submission details
-     * @throws If validation, provider lookup, or execution fails
+     * The token to spend.  Currently only USDC is supported.
+     * Accepts any case (e.g. `'usdc'`, `'Usdc'`); normalised to uppercase internally.
      */
-    deposit<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: AnyDepositParams<TFromAdapterCapabilities>): Promise<EarnDepositOutcome>;
+    token?: SupportedTokenInput;
     /**
-     * Withdraw from an earn vault.
-     *
-     * @param params - Withdrawal parameters
-     * @returns Promise resolving to the withdrawal result
-     * @throws If validation, provider lookup, or transaction execution fails
-     *
-     * @example
-     * ```typescript
-     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
+     * Total USDC amount to spend (human-readable decimal string).
      *
-     * const kit = new AppKit()
-     * const result = await kit.earn.withdraw({
-     *   from: { adapter, chain: EarnChain.Arc_Testnet },
-     *   vaultAddress: '0x...',
-     *   amount: '50.00',
-     * })
-     * ```
+     * @remarks
+     * Always required. When sources include explicit `allocations`,
+     * `sum(allocations)` must equal `amount`.
      */
-    withdraw<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: WithdrawParams<TFromAdapterCapabilities>): Promise<EarnWithdrawResult>;
+    amount: string;
+    /** Optional configuration for the spend operation. */
+    config?: SpendConfig;
+}
+/**
+ * Standard spend: `from` is required (no retry).
+ */
+interface SpendParamsWithFrom<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> extends SpendParamsBase<TToAdapterCapabilities, TChainIdentifier> {
     /**
-     * Claim available earn rewards.
-     *
-     * @param params - Claim rewards parameters
-     * @returns Promise resolving to the claim rewards result
-     * @throws If validation, provider lookup, or transaction execution fails
-     *
-     * @example
-     * ```typescript
-     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
-     *
-     * const kit = new AppKit()
-     * const result = await kit.earn.claimRewards({
-     *   from: { adapter, chain: EarnChain.Arc_Testnet },
-     *   vaultAddress: '0x...',
-     * })
-     * ```
+     * One or more sources to pull funds from.
      *
-     * @internal
+     * Use an array when spending from multiple adapters (e.g.
+     * combining EVM and non-EVM accounts).
      */
-    claimRewards<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: ClaimRewardsParams<TFromAdapterCapabilities>): Promise<EarnClaimRewardsResult>;
+    from: SpendSource<TFromAdapterCapabilities> | SpendSource<TFromAdapterCapabilities>[];
+}
+/**
+ * Retry spend: `from` is optional because we skip the
+ * estimate/sign/transfer steps and go straight to mint.
+ */
+interface SpendParamsRetry<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> extends SpendParamsBase<TToAdapterCapabilities, TChainIdentifier> {
+    from?: SpendSource<TFromAdapterCapabilities> | SpendSource<TFromAdapterCapabilities>[];
+    config: SpendConfig & {
+        retry: RetryMintConfig;
+    };
+}
+/**
+ * Parameters for spending (minting) USDC on a destination chain from
+ * one or more Gateway account sources.
+ *
+ * @remarks
+ * `from` can be a single source or an array when pulling from
+ * multiple adapters (e.g. an EVM account and a Solana account).
+ *
+ * @typeParam TFromAdapterCapabilities - Source adapter capabilities.
+ * @typeParam TToAdapterCapabilities - Destination adapter capabilities.
+ * @typeParam TChainIdentifier - Accepted chain identifier type.
+ *
+ * @example
+ * ```typescript
+ * import type { SpendParams } from '@circle-fin/unified-balance-kit'
+ *
+ * const params: SpendParams = {
+ *   from: {
+ *     adapter: evmAdapter,
+ *     allocations: { amount: '100', chain: 'Ethereum' },
+ *   },
+ *   to: { adapter: avalancheAdapter, chain: 'Avalanche' },
+ *   amount: '100',
+ *   token: 'USDC',
+ * }
+ * ```
+ */
+type SpendParams<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> = SpendParamsWithFrom<TFromAdapterCapabilities, TToAdapterCapabilities, TChainIdentifier> | SpendParamsRetry<TFromAdapterCapabilities, TToAdapterCapabilities, TChainIdentifier>;
+/**
+ * Result returned after a successful spend (mint) operation.
+ *
+ * @example
+ * ```typescript
+ * import type { SpendResult } from '@circle-fin/unified-balance-kit'
+ *
+ * const result: SpendResult = {
+ *   allocations: [
+ *     { amount: '100', chain: 'Ethereum', sourceAccount: '0x…' },
+ *   ],
+ *   recipientAddress: '0xDEST…abcd',
+ *   destinationChain: 'Avalanche',
+ *   txHash: '0xabcdef…',
+ *   explorerUrl: 'https://snowtrace.io/tx/0xabcdef…',
+ * }
+ * ```
+ */
+interface SpendResult {
     /**
-     * Fetch earn vault information.
-     *
-     * @param params - Vault query parameters
-     * @returns Promise resolving to vault data and per-vault errors
-     * @throws If validation or provider lookup fails
-     *
-     * @example
-     * ```typescript
-     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
-     *
-     * const kit = new AppKit()
-     * const result = await kit.earn.getVaults({
-     *   vaults: [{ chain: EarnChain.Arc_Testnet, vaultAddress: '0x...' }],
-     * })
-     * ```
+     * Flattened list of allocations that were executed, each with its
+     * source Gateway account. Only present for non-retry spends.
      */
-    getVaults(params: GetVaultsParams): Promise<EarnGetVaultsResult>;
+    allocations?: AllocationResult[];
+    /** The address that received the minted USDC. */
+    recipientAddress: string;
+    /** The destination chain on which the recipient received the USDC. */
+    destinationChain: Blockchain;
     /**
-     * Discover earn vaults available on a chain.
-     *
-     * @param params - Discovery parameters with chain and optional filters
-     * @returns Promise resolving to matching vaults with pagination metadata
-     * @throws If validation or provider lookup fails
-     *
-     * @example
-     * ```typescript
-     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
-     *
-     * const kit = new AppKit()
-     * const result = await kit.earn.exploreVaults({
-     *   chain: EarnChain.Arc_Testnet,
-     *   minApy: '0.03',
-     *   sortBy: 'apy',
-     * })
-     * ```
+     * Unique identifier returned by the blockchain once the
+     * transaction is mined.
      */
-    exploreVaults(params: ExploreVaultsParams): Promise<EarnExploreVaultsResult>;
+    txHash: string;
     /**
-     * Lazily iterate every earn vault available on a chain.
-     *
-     * @param params - Discovery parameters (no `page`; the iterator manages it)
-     * @returns An async generator yielding each matching vault
-     * @throws If validation or provider lookup fails
-     *
-     * @example
-     * ```typescript
-     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
+     * Link to view the transaction details on the appropriate
+     * blockchain explorer.
      *
-     * const kit = new AppKit()
-     * for await (const vault of kit.earn.exploreVaultsIterator({
-     *   chain: EarnChain.Arc_Testnet,
-     * })) {
-     *   console.log(vault.name)
-     * }
-     * ```
+     * @remarks
+     * May be `undefined` when the explorer URL cannot be resolved
+     * for the chain.
      */
-    exploreVaultsIterator(params: ExploreVaultsIteratorParams): AsyncGenerator<EarnVaultInfo, void, undefined>;
+    explorerUrl?: string;
     /**
-     * Fetch wallet position information for an earn vault.
-     *
-     * @param params - Position query parameters
-     * @returns Promise resolving to position information
-     * @throws If validation or provider lookup fails
-     *
-     * @example
-     * ```typescript
-     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
-     *
-     * const kit = new AppKit()
-     * const position = await kit.earn.getPosition({
-     *   from: { adapter, chain: EarnChain.Arc_Testnet },
-     *   vaultAddress: '0x...',
-     * })
-     * ```
+     * Fee breakdown (provider, gasFee, optional kit, forwarder) for the
+     * executed spend. Same shape as estimateSpend fees. Omitted when
+     * using config.retry.
      */
-    getPosition<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: GetPositionParams<TFromAdapterCapabilities>): Promise<EarnPositionInfo>;
+    fees?: FeeEntry[];
     /**
-     * Fetch the current status of a cross-chain Earn deposit.
-     *
-     * @param params - Status query parameters identifying the deposit by execId
-     * @returns Promise resolving to the structured cross-chain deposit status
-     * @throws If validation, provider lookup, or the status request fails
+     * Gateway transfer identifier. Present when `useForwarder` is enabled
+     * and can be used to query transfer status via `GET /v1/transfer/{id}`.
      */
-    getCrossChainDepositStatus(params: GetCrossChainDepositStatusParams): Promise<EarnCrossChainDepositStatus>;
+    transferId?: string;
     /**
-     * Poll a cross-chain Earn deposit until it reaches a terminal bridge state.
-     *
-     * @param params - Wait parameters including execId and optional polling knobs
-     * @returns Promise resolving to the wait result and last observed bridge status
-     * @throws If validation, provider lookup, or a status request fails
-     */
-    waitForCrossChainDeposit(params: WaitForCrossChainDepositParams): Promise<EarnCrossChainDepositWaitResult>;
-    /**
-     * Fetch a deposit quote.
-     *
-     * @param params - Deposit quote parameters
-     * @returns Promise resolving to deposit quote information
-     * @throws If validation or provider lookup fails
-     *
-     * @example
-     * ```typescript
-     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
-     *
-     * const kit = new AppKit()
-     * const quote = await kit.earn.getDepositQuote({
-     *   from: { adapter, chain: EarnChain.Arc_Testnet },
-     *   vaultAddress: '0x...',
-     *   amount: '100.50',
-     * })
-     * ```
-     */
-    getDepositQuote<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: GetDepositQuoteParams<TFromAdapterCapabilities>): Promise<EarnDepositQuoteInfo>;
-    /**
-     * Fetch a withdrawal quote.
-     *
-     * @param params - Withdrawal quote parameters
-     * @returns Promise resolving to withdrawal quote information
-     * @throws If validation or provider lookup fails
-     *
-     * @example
-     * ```typescript
-     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
-     *
-     * const kit = new AppKit()
-     * const quote = await kit.earn.getWithdrawalQuote({
-     *   from: { adapter, chain: EarnChain.Arc_Testnet },
-     *   vaultAddress: '0x...',
-     *   amount: '50.00',
-     * })
-     * ```
+     * Block height after which the transfer attestation expires.
+     * Returned by the Gateway transfer API.
      */
-    getWithdrawalQuote<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: GetWithdrawalQuoteParams<TFromAdapterCapabilities>): Promise<EarnWithdrawalQuoteInfo>;
+    expirationBlock?: string;
     /**
-     * Fetch a claim rewards quote.
-     *
-     * @param params - Claim rewards quote parameters
-     * @returns Promise resolving to claim rewards quote information
-     * @throws If validation or provider lookup fails
-     *
-     * @example
-     * ```typescript
-     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
-     *
-     * const kit = new AppKit()
-     * const quote = await kit.earn.getClaimRewardsQuote({
-     *   from: { adapter, chain: EarnChain.Arc_Testnet },
-     *   vaultAddress: '0x...',
-     * })
-     * ```
+     * Ordered list of steps executed during the spend operation.
      *
-     * @internal
+     * @remarks
+     * Each entry records the outcome of one phase of the spend flow.
+     * For a normal spend the order is:
+     * `buildBurnIntents` → `signBurnIntents` → `transfer` → `mint`.
+     * For a retry spend only `mint` is present.
      */
-    getClaimRewardsQuote<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: GetClaimRewardsQuoteParams<TFromAdapterCapabilities>): Promise<EarnClaimRewardsQuoteInfo>;
+    steps?: SpendStep[];
+}
+interface CustomFeeConfig {
+    recipientAddress: string;
+    value: string;
+}
+/**
+ * Data needed to retry a mint that failed after the transfer was
+ * already committed (funds locked).
+ *
+ * Obtain these values from the KitError (TRANSACTION_REVERTED) thrown when
+ * the on-chain mint step fails. The attestation and signature are available
+ * in `error.cause.trace`.
+ */
+interface RetryMintConfig {
+    /** The attestation hex string returned by the Gateway `/v1/transfer` API. */
+    attestation: string;
+    /** The attestation signature hex string returned by `/v1/transfer`. */
+    signature: string;
+}
+interface SpendConfig {
+    customFee?: CustomFeeConfig;
     /**
-     * Resume a multi-phase earn operation that previously failed.
+     * When provided, skips the estimate/sign/transfer steps and proceeds
+     * directly to the on-chain mint using a previously obtained attestation.
      *
-     * Pass the {@link KitError} caught from `deposit`, `withdraw`, or
-     * `claimRewards`. The error carries the original inputs and step
-     * progress, so completed phases (for example a successful token
-     * approval) can be skipped. Call `isRetryableError(error)` first.
+     * Use this to retry a mint that failed due to an RPC or network issue
+     * after the transfer was already committed.
      *
      * @remarks
-     * Retry re-fetches execution params and may re-submit the execute
-     * transaction. Treat this as best-effort recovery: if a prior attempt
-     * broadcast execute but failed before observing the receipt, that
-     * transaction may still be in flight.
-     *
-     * @param error - The error caught from a previous multi-phase earn operation
-     * @returns Promise resolving to the result of the resumed operation
-     * @throws If the error is not retryable or lacks earn retry context
-     *
-     * @example
-     * ```typescript
-     * import { AppKit, isRetryableError } from '@circle-fin/app-kit'
-     *
-     * const kit = new AppKit()
-     *
-     * try {
-     *   await kit.earn.deposit(params)
-     * } catch (error) {
-     *   if (isRetryableError(error)) {
-     *     const result = await kit.earn.retry(error)
-     *   }
-     * }
-     * ```
+     * The `useForwarder` flag on the destination is ignored during retry
+     * because the attestation was already issued — the Forwarding Service
+     * is only involved in the initial transfer, not re-mints.
      */
-    retry(error: unknown): Promise<EarnDepositOutcome | EarnWithdrawResult | EarnClaimRewardsResult>;
+    retry?: RetryMintConfig;
+}
+interface ResolvedAllocation {
+    amount: string;
+    chain: ChainDefinition;
+}
+interface ResolvedSpendSource<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> {
+    adapter: Adapter<TAdapterCapabilities>;
+    allocations: ResolvedAllocation[];
+    address?: string;
+    sourceAccount?: string;
+}
+interface ResolvedSpendDestination<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> {
+    adapter?: Adapter<TAdapterCapabilities>;
+    chain: ChainDefinition;
+    recipientAddress?: string;
+    address?: string;
+    useForwarder?: boolean;
+}
+interface ResolvedSpendParams<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> {
+    from: ResolvedSpendSource<TFromAdapterCapabilities>[];
+    to: ResolvedSpendDestination<TToAdapterCapabilities>;
+    token: SupportedToken;
+    config?: SpendConfig;
 }
 /**
- * Type for event handler functions that can be registered with the AppKit.
+ * Function that computes the fee amount (in human-readable units, e.g. "10.5")
+ * given the resolved spend parameters.
+ */
+type SpendFeeFunction = (params: ResolvedSpendParams) => Promise<string> | string;
+/**
+ * Function that resolves the fee recipient address for a spend.
+ * Called once per spend, against the resolved **destination** chain —
+ * every fee burn intent in a spend mints to that single chain
+ * regardless of which source chain(s) funded it, so only one
+ * recipient address (valid on the destination chain) is ever needed.
+ */
+type SpendFeeRecipientFunction = (destinationChain: ChainDefinition, params: ResolvedSpendParams) => Promise<string> | string;
+/**
+ * Policy for computing and routing custom developer fees.
  *
- * This type extracts the handler function type from the `on` method parameters,
- * ensuring that event handlers have the correct signature and payload types.
- * It enables type-safe event handling by preserving the specific payload types
- * for each action.
+ * **Important:** When the kit invokes `computeFee` and
+ * `resolveFeeRecipientAddress`, the `params` argument may be the
+ * **raw, unresolved** `SpendParams` (cast to `ResolvedSpendParams`).
+ * Fields that only exist after resolution (e.g. per-source allocations)
+ * may be `undefined`.  Implementations should only rely on top-level
+ * fields such as `to`, `token`, and `amount`.
  *
- * Uses a structural type constraint to avoid circular dependencies while still
- * providing full type safety when used with an AppKit instance.
+ * @remarks
+ * `resolveFeeRecipientAddress` is optional when you configure
+ * {@link UnifiedBalanceKit.setFeeRecipients} instead — the declarative
+ * map takes priority over this callback when both are present. Provide
+ * exactly one of the two; a policy with neither throws at spend time.
+ */
+interface CustomFeePolicy {
+    computeFee: SpendFeeFunction;
+    resolveFeeRecipientAddress?: SpendFeeRecipientFunction;
+}
+/**
+ * Chain type group used to key {@link FeeRecipientsConfig}.
  *
- * @typeParam T - A type that has an `on` method matching AppKit's signature
- * @returns The function type for event handlers with proper payload typing
+ * @remarks
+ * Only `'evm'` and `'solana'` are live today (the only chain types the
+ * kit's provider currently supports). This is deliberately a narrow
+ * subset of `@core/chains`' broader `ChainType` union rather than a
+ * hardcoded two-field struct, so that support for additional non-EVM
+ * chain types (e.g. Stellar, Starknet) can be added later by adding
+ * new union members here — no restructuring of `FeeRecipientsConfig`
+ * or its consumers required.
+ */
+type FeeRecipientChainType = 'evm' | 'solana';
+/**
+ * Declarative map of fee recipient addresses, keyed by chain type.
+ *
+ * @remarks
+ * Set via {@link UnifiedBalanceKit.setFeeRecipients}. At spend time the
+ * kit resolves the spend's destination chain to its
+ * {@link FeeRecipientChainType} and looks up the matching entry —
+ * exactly one recipient is used per spend (see
+ * {@link SpendFeeRecipientFunction}). Provide entries for every chain
+ * type you expect to spend to; a spend to a destination chain type
+ * with no matching entry throws before any fee collection is
+ * attempted.
  *
  * @example
  * ```typescript
- * import { AppKit, ActionHandler } from '@circle-fin/app-kit'
- *
- * const kit = new AppKit()
+ * import type { FeeRecipientsConfig } from '@circle-fin/unified-balance-kit'
  *
- * // ActionHandler will be the correct function type for handlers
- * const handler: ActionHandler<typeof kit> = (payload) => {
- *   // payload is properly typed based on the action
+ * const feeRecipients: FeeRecipientsConfig = {
+ *   evm: '0x1234567890123456789012345678901234567890',
+ *   solana: '9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM',
  * }
  * ```
  */
-type ActionHandler<T extends {
-    on: (action: string, handler: (payload: unknown) => void) => void;
-}> = Parameters<T['on']>[1];
+type FeeRecipientsConfig = Partial<Record<FeeRecipientChainType, string>>;
 /**
- * Parameters for sending USDC, USDT, native tokens, or custom ERC-20/SPL tokens.
- *
- * This interface is the canonical input for send operations in App Kit. It supports
- * sending to either a destination {@link Adapter} (recipient derives from the adapter's
- * default account) or an explicit recipient `string` address.
- *
- * - The `from` field provides the source signing context and chain.
- * - The `to` field identifies the destination as an adapter or an explicit address.
- * - The `amount` field is a human-readable decimal string (for example, `'10.5'`).
- * - The `token` field selects the asset to move and defaults to `'USDC'`.
- *
- * @remarks
- * When `to` is a `string`, the address must be a valid address. When `to` is an
- * {@link Adapter}, the recipient is derived from the adapter's active account.
+ * Fee category describing the origin of a fee line item.
  *
- * The `token` field accepts both supported token aliases ('USDC', 'USDT', 'NATIVE', 'EURC') and custom token
- * contract addresses.
+ * - `'provider'`  — Fee charged by the cross-chain provider (e.g. protocol fee).
+ * - `'gasFee'`    — On-chain gas cost denominated in the transfer token (e.g. USDC).
+ * - `'kit'`       — Fee charged by the kit / developer integration.
+ * - `'forwarder'` — Fee charged by Circle's Forwarding Service for automatic mint.
+ */
+type FeeType = 'provider' | 'gasFee' | 'kit' | 'forwarder';
+/**
+ * Per-chain breakdown of a fee amount.
  *
  * @example
  * ```typescript
- * // Send USDC to a recipient adapter (address derived on-chain)
- * const params: SendParams = {
- *   from: { adapter: sourceAdapter, chain: 'Ethereum' },
- *   to: recipientAdapter,
- *   amount: '10.5',
- *   token: 'USDC'
- * }
+ * import type { FeeAllocation } from '@circle-fin/unified-balance-kit'
  *
- * // Send using a custom token address (DAI on Ethereum)
- * const paramsCustomToken: SendParams = {
- *   from: { adapter: sourceAdapter, chain: 'Ethereum' },
- *   to: '0x1234...abcd',
- *   amount: '100.0',
- *   token: '0x6B175474E89094C44Da98b954EedeAC495271d0F'
+ * const allocation: FeeAllocation = {
+ *   chain: 'Ethereum',
+ *   amount: '0.00005',
  * }
  * ```
  */
-interface SendParams {
-    /**
-     * The source adapter context (wallet and chain) for the transfer.
-     */
-    from: AdapterContext;
-    /**
-     * The destination for the transfer, supporting explicit or derived recipient addresses.
-     */
-    to: Adapter | string;
-    /**
-     * The amount to transfer.
-     */
+interface FeeAllocation {
+    /** The chain to which this portion of the fee applies. */
+    chain: Blockchain;
+    /** The fee amount on this chain (human-readable decimal string). */
     amount: string;
-    /**
-     * The token to transfer. Defaults to 'USDC'.
-     * If omitted, the provider will use 'USDC' by default.
-     *
-     * Supports both known aliases and custom token contract addresses:
-     * - Known aliases: 'USDC', 'USDT', 'NATIVE', 'EURC' ('EURC' requires the
-     *   chain to have an `eurcAddress` configured)
-     * - Custom token addresses: EVM addresses or Solana SPL token mint addresses
-     *
-     * @example
-     * ```typescript
-     * // Using an alias
-     * token: 'USDC'
-     *
-     * // Using a custom ERC-20 address (DAI on Ethereum)
-     * token: '0x6B175474E89094C44Da98b954EedeAC495271d0F'
-     *
-     * // Using a custom SPL token mint (Solana)
-     * token: 'So11111111111111111111111111111111111111112'
-     * ```
-     */
-    token?: TokenAlias | TokenAddress;
 }
 /**
- * Extract action types from BridgeKit's actionDispatcher.
- *
- * This utility type extracts the action map type from a BridgeKit instance
- * by inspecting its actionDispatcher property.
- *
- * @typeParam T - The BridgeKit instance type
- */
-type ExtractBridgeKitActions<T extends BridgeKit> = T extends BridgeKit ? T['actionDispatcher'] extends Actionable<infer Actions> ? Actions : never : never;
-/**
- * Prefix action names with a namespace.
- *
- * Transforms an action map by prefixing all keys with the specified namespace.
- * For example, `{ approve: Payload }` becomes `{ 'bridge.approve': Payload }`.
+ * A single fee line item within an estimate.
  *
- * @typeParam Actions - The original action map
- * @typeParam Prefix - The prefix to apply (e.g., 'bridge')
- */
-type PrefixActions<Prefix extends string, Actions> = {
-    [K in keyof Actions as K extends string ? `${Prefix}.${K}` : never]: Actions[K];
-};
-/**
- * Default BridgeKit instance type (no extra providers).
- */
-type DefaultBridgeKit = BridgeKit;
-/**
- * Extract actions from default BridgeKit.
- */
-type DefaultBridgeKitActions = ExtractBridgeKitActions<DefaultBridgeKit>;
-/**
- * Prefixed bridge actions for AppKit.
+ * @remarks
+ * Each entry describes a fee category (`type`), the token it is
+ * denominated in, the aggregate `amount`, and an optional per-chain
+ * `allocations` breakdown.
  *
- * All BridgeKit events are prefixed with 'bridge.' to namespace them
- * within the AppKit event system.
- */
-type AppKitBridgeActions = PrefixActions<'bridge', DefaultBridgeKitActions>;
-/**
- * Prefixed unified balance actions for AppKit.
+ * @example
+ * ```typescript
+ * import type { FeeEntry } from '@circle-fin/unified-balance-kit'
  *
- * All UnifiedBalanceKit (Gateway) events are prefixed with 'unifiedBalance.'
- * to namespace them within the AppKit event system.
- */
-type AppKitUnifiedBalanceActions = PrefixActions<'unifiedBalance', GatewayV1Actions>;
-/**
- * Prefixed earn actions for AppKit.
+ * // Fee with per-chain allocation breakdown
+ * const providerFee: FeeEntry = {
+ *   type: 'provider',
+ *   token: 'USDC',
+ *   amount: '0.00011',
+ *   allocations: [
+ *     { chain: 'Ethereum', amount: '0.00005' },
+ *     { chain: 'Polygon', amount: '0.00006' },
+ *   ],
+ * }
  *
- * Earn step events are exposed under the `earn.` namespace (for example
- * `earn.deposit`, `earn.approve`, `earn.withdraw`) so they can be
- * subscribed to via `kit.on()` alongside bridge and unified balance
- * events.
- */
-type AppKitEarnActions = PrefixActions<'earn', EarnActions>;
-/**
- * Union of all AppKit action names.
- */
-type AppKitActionName = keyof AppKitBridgeActions | keyof AppKitUnifiedBalanceActions | keyof AppKitEarnActions;
-/**
- * All actions available in AppKit.
+ * // Flat fee without allocations (e.g. forwarder)
+ * const forwarderFee: FeeEntry = {
+ *   type: 'forwarder',
+ *   token: 'USDC',
+ *   amount: '0.005',
+ * }
+ * ```
  */
-type AppKitActions = AppKitBridgeActions & AppKitUnifiedBalanceActions & AppKitEarnActions;
-
+interface FeeEntry {
+    /** The category of this fee. */
+    type: FeeType;
+    /** The token in which this fee is denominated (e.g. `'USDC'`, `'ETH'`). */
+    token: string;
+    /** Aggregate fee amount (human-readable decimal string). */
+    amount: string;
+    /** Per-chain breakdown of the fee. Omitted for flat fees (e.g. forwarder). */
+    allocations?: FeeAllocation[];
+    /**
+     * When `type === 'kit'`, the address that receives the kit fee.
+     * Omitted for other fee types.
+     */
+    recipientAddress?: string;
+}
 /**
- * Parameters for creating a AppKit context.
+ * Cost estimation for a spend (mint) operation.
  *
- * This type allows partial customization of the context while ensuring
- * that all required properties have sensible defaults. Users can override
- * specific methods while keeping the rest intact. Action handler buckets
- * may also be supplied partially; missing buckets default to empty maps.
+ * @remarks
+ * Returned by the provider's `estimateSpend` method to give callers
+ * visibility into the expected fees *before* executing a spend.
+ * Each entry in `fees` represents a distinct fee category with its
+ * per-chain allocation breakdown.
  *
  * @example
  * ```typescript
- * const customContext = createContext({
- *   getFee: async (type, params) => {
- *     // Custom fee calculation logic
- *     return { totalFee: '0.05', networkFee: '0.05' }
- *   }
- * })
+ * import type { EstimateSpendResult } from '@circle-fin/unified-balance-kit'
+ *
+ * const estimate: EstimateSpendResult = {
+ *   fees: [
+ *     {
+ *       type: 'provider',
+ *       token: 'USDC',
+ *       amount: '0.00011',
+ *       allocations: [
+ *         { chain: 'Ethereum', amount: '0.00005' },
+ *         { chain: 'Polygon', amount: '0.00006' },
+ *       ],
+ *     },
+ *     {
+ *       type: 'gasFee',
+ *       token: 'USDC',
+ *       amount: '0.0025',
+ *       allocations: [
+ *         { chain: 'Ethereum', amount: '0.0015' },
+ *         { chain: 'Polygon', amount: '0.0010' },
+ *       ],
+ *     },
+ *     {
+ *       type: 'kit',
+ *       token: 'USDC',
+ *       amount: '0.05',
+ *       allocations: [
+ *         { chain: 'Ethereum', amount: '0.05' },
+ *       ],
+ *     },
+ *   ],
+ * }
  * ```
  */
-type CreateContextParams = Omit<Partial<AppKitContext>, 'actions'> & {
-    actions?: Partial<AppKitContext['actions']>;
-};
+interface EstimateSpendResult {
+    /** Itemised fee breakdown for the spend operation. */
+    fees: FeeEntry[];
+}
 
 /**
- * Destination for a Gateway spend (mint) operation.
- *
- * @remarks
- * Omitting `recipientAddress` causes funds to be minted to the
- * address resolved from the adapter.  Providing it overrides the
- * default destination.
- *
- * @typeParam TAdapterCapabilities - Adapter capability constraints.
- * @typeParam TChainIdentifier - Accepted chain identifier type.
+ * Runtime array of token identifiers supported by the unified-balance-kit.
  *
  * @example
  * ```typescript
- * import type { SpendDestination } from '@circle-fin/unified-balance-kit'
+ * import { SUPPORTED_TOKENS } from '@circle-fin/unified-balance-kit'
  *
- * const destination: SpendDestination = {
- *   adapter: avalancheAdapter,
- *   chain: 'Avalanche',
- *   recipientAddress: '0xDEST…abcd',
+ * if (SUPPORTED_TOKENS.includes('USDC')) {
+ *   console.log('USDC is supported')
  * }
  * ```
  */
-type SpendDestination<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> = {
-    /** The adapter for executing on-chain calls. */
-    adapter: Adapter<TAdapterCapabilities>;
-    /** The destination chain. */
-    chain: TChainIdentifier;
-    /**
-     * Optional custom recipient address.  When omitted the adapter's
-     * resolved address is used.
-     */
-    recipientAddress?: string;
-    /**
-     * Enable Circle's Forwarding Service for automatic mint submission.
-     * When `true`, the Gateway API handles the destination mint via its
-     * relayer and the SDK polls for completion instead of executing a
-     * user-signed mint transaction.
-     */
-    useForwarder?: boolean;
-} & AddressField<ExtractAddressContext<TAdapterCapabilities>>;
+declare const SUPPORTED_TOKENS: readonly ["USDC"];
 /**
- * Forwarder-only destination for spend operations.
- *
- * Used when Circle's Forwarding Service handles the mint transaction
- * and no destination adapter is available. Set `useForwarder` to `true`
- * and provide a `recipientAddress`.
- *
- * @typeParam TChainIdentifier - Accepted chain identifier type.
+ * Token identifiers supported by the unified-balance-kit.
  *
  * @example
  * ```typescript
- * import type { ForwarderSpendDestination } from '@circle-fin/unified-balance-kit'
+ * import type { SupportedToken } from '@circle-fin/unified-balance-kit'
  *
- * const destination: ForwarderSpendDestination = {
- *   chain: 'Base',
- *   recipientAddress: '0xDEST…abcd',
- *   useForwarder: true,
- * }
+ * const token: SupportedToken = 'USDC'
  * ```
  */
-interface ForwarderSpendDestination<TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
-    /** The destination chain where USDC will be minted. */
-    chain: TChainIdentifier;
-    /** The recipient address that will receive the minted USDC. */
-    recipientAddress: string;
-    /** Enable Circle's Forwarding Service for the destination mint. */
-    useForwarder: boolean;
-}
+type SupportedToken = (typeof SUPPORTED_TOKENS)[number];
 /**
- * Union of spend destination variants.
+ * Case-insensitive variant of {@link SupportedToken} for user-facing input.
  *
- * @see {@link SpendDestination}
- * @see {@link ForwarderSpendDestination}
+ * Accepts the canonical uppercase form, fully lowercase, and title-case
+ * (e.g. `'USDC'`, `'usdc'`, `'Usdc'`). Arbitrary mixed-case input like
+ * `'uSdC'` is handled at runtime by the Zod schema and
+ * {@link normalizeToken}, so exhaustive compile-time permutations are
+ * unnecessary. Avoiding a recursive `CasePermutations` type prevents
+ * 2^N type-literal explosion as the token list grows.
+ *
+ * @example
+ * ```typescript
+ * import type { SupportedTokenInput } from '@circle-fin/unified-balance-kit'
+ *
+ * const token: SupportedTokenInput = 'usdc' // OK
+ * ```
  */
-type SpendDestinationUnion<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> = SpendDestination<TAdapterCapabilities, TChainIdentifier> | ForwarderSpendDestination<TChainIdentifier>;
+type SupportedTokenInput = SupportedToken | Lowercase<SupportedToken> | Capitalize<Lowercase<SupportedToken>>;
 /**
- * An amount of USDC to pull from a specific chain.
+ * Intentional `any` escape hatch so heterogeneous providers can be stored
+ * in a single array while `MergeActions` rebuilds concrete action types.
+ *
+ * Type safety is re-established by the `on()`/`off()` overloads in
+ * {@link UnifiedBalanceKit} — do not remove those overloads.
+ *
+ * Caveat: custom providers whose `TProviderActions` differs from the
+ * default map will have action types erased to `any` unless the consumer
+ * passes the provider tuple as a generic, e.g. `UnifiedBalanceKit<[MyProvider]>`.
+ */
+type FlexibleGatewayProvider = IGatewayProvider<any>;
+/**
+ * Configuration options for initializing a {@link UnifiedBalanceKit} instance.
+ *
+ * When no providers are specified, the kit uses the default Gateway v1
+ * provider. Any additional providers supplied via config are appended
+ * to the defaults.
+ *
+ * @typeParam TExtraProviders - Array type of additional providers
  *
  * @example
  * ```typescript
- * import type { Allocation } from '@circle-fin/unified-balance-kit'
+ * import { UnifiedBalanceKit } from '@circle-fin/unified-balance-kit'
  *
- * const allocation: Allocation = {
- *   amount: '50',
- *   chain: 'Ethereum',
- * }
+ * // Create kit with default providers
+ * const kit = new UnifiedBalanceKit()
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { UnifiedBalanceKit } from '@circle-fin/unified-balance-kit'
+ *
+ * // Create kit with additional providers
+ * const kit = new UnifiedBalanceKit({
+ *   providers: [myCustomProvider],
+ * })
  * ```
  */
-interface Allocation {
+interface UnifiedBalanceKitConfig<TExtraProviders extends FlexibleGatewayProvider[] = []> {
     /**
-     * The amount to pull from this chain (human-readable decimal
-     * string).
+     * Optional array of additional Gateway providers.
+     *
+     * If not provided, default providers will be initialized.
      */
-    amount: string;
+    providers?: TExtraProviders;
     /**
-     * The chain from which to pull the funds.
+     * Disable analytics telemetry (success events with `txHash`).
+     *
+     * When `true`, the SDK will not POST to the telemetry endpoint
+     * after successful verb operations. Defaults to `false` (enabled).
      *
      * @remarks
-     * All allocations in a single spend must be either all mainnet
-     * or all testnet.  Mixing is not allowed.
+     * Only applies to the class-based API (`new UnifiedBalanceKit()`).
+     * The functional API via `createUnifiedBalanceKitContext()` does not
+     * register telemetry handlers.
+     *
+     * @defaultValue false
      */
-    chain: UnifiedBalanceChainIdentifier;
+    disableAnalytics?: boolean;
+    /**
+     * Disable error telemetry.
+     *
+     * When `true`, the SDK will not POST error details to the telemetry
+     * endpoint when public methods throw. Defaults to `false` (enabled).
+     *
+     * @remarks
+     * Only applies to the class-based API (`new UnifiedBalanceKit()`).
+     *
+     * @defaultValue false
+     */
+    disableErrorReporting?: boolean;
+    /**
+     * Skip the built-in default providers when assembling the context.
+     *
+     * By default the kit prepends the standard Gateway v1 provider so
+     * `providers` is treated as additive. Pass `true` to use only the
+     * providers supplied in {@link UnifiedBalanceKitConfig.providers}.
+     *
+     * Useful when stubbing the gateway in integration tests, when running
+     * against a self-hosted gateway replacement, or any time you want full
+     * control over which provider serves a given chain.
+     *
+     * @defaultValue false
+     */
+    excludeDefaultProviders?: boolean;
 }
+
 /**
- * Extends {@link Allocation} with the resolved source Gateway
- * account address.
+ * Token allowance strategy used to authorize a Gateway deposit.
+ *
+ * - `'approve'` — traditional ERC-20 `approve` transaction.
+ * - `'permit'` — gasless EIP-2612 off-chain signature.
+ * - `'authorize'` — EIP-3009 `transferWithAuthorization`.
  *
  * @example
  * ```typescript
- * import type { AllocationResult } from '@circle-fin/unified-balance-kit'
+ * import type { AllowanceStrategy } from '@circle-fin/unified-balance-kit'
  *
- * const result: AllocationResult = {
- *   amount: '50',
- *   chain: 'Ethereum',
- *   sourceAccount: '0x1234…5678',
- * }
+ * const strategy: AllowanceStrategy = 'permit'
  * ```
  */
-interface AllocationResult extends Allocation {
-    /** The Gateway account address from which this amount was pulled. */
-    sourceAccount: string;
-}
+type AllowanceStrategy = 'approve' | 'permit' | 'authorize';
 /**
- * A spend source providing an adapter and optional per-chain allocations.
+ * Parameters for depositing tokens into the caller's own Gateway
+ * account on a specific chain.
  *
  * @remarks
- * When `allocations` is omitted the provider's automatic allocation
- * logic decides which chains to draw from.  A top-level `amount`
- * field on {@link SpendParams} is **required** in that case.
- *
- * When `allocations` is present, every source in the `from` array
- * must also include `allocations` (all-or-nothing rule).
+ * Although a Gateway account can span multiple chains (e.g. all EVM
+ * chains share the same account), every deposit targets exactly one
+ * chain.  The depositor is identified by the adapter context.
  *
  * @typeParam TAdapterCapabilities - Adapter capability constraints.
+ * @typeParam TChainIdentifier - Accepted chain identifier type.
  *
  * @example
  * ```typescript
- * import type { SpendSource } from '@circle-fin/unified-balance-kit'
- *
- * // With explicit allocations
- * const withAlloc: SpendSource = {
- *   adapter: evmAdapter,
- *   allocations: [
- *     { amount: '40', chain: 'Ethereum' },
- *     { amount: '60', chain: 'Base' },
- *   ],
- * }
+ * import type { DepositParams } from '@circle-fin/unified-balance-kit'
  *
- * // Adapter-only (auto-allocation)
- * const adapterOnly: SpendSource = {
- *   adapter: evmAdapter,
+ * const params: DepositParams = {
+ *   from: { adapter: evmAdapter, chain: 'Ethereum' },
+ *   amount: '100',
+ *   token: 'USDC',
+ *   allowanceStrategy: 'permit',
  * }
  * ```
  */
-type SpendSource<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> = {
-    /** The adapter for executing on-chain calls. */
-    adapter: Adapter<TAdapterCapabilities>;
+interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
     /**
-     * Optional per-chain allocations describing how much to pull from
-     * each chain.  When omitted the provider computes allocations
-     * automatically.
+     * The adapter context identifying the depositor and chain.
      */
-    allocations?: Allocation | Allocation[];
+    from: AdapterContext<TAdapterCapabilities, TChainIdentifier>;
     /**
-     * Optional Gateway account to pull from (delegate scenarios).
+     * The amount of tokens to deposit (human-readable decimal string).
      *
-     * @remarks
-     * When omitted the adapter's resolved address is used.  When
-     * provided you must be a delegate for this account.
+     * @example "100", "0.5"
      */
-    sourceAccount?: string;
-} & AddressField<ExtractAddressContext<TAdapterCapabilities>>;
-/**
- * Base fields shared by all spend parameter variants.
- */
-interface SpendParamsBase<TToAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
-    /** Where to mint the USDC on the destination chain. */
-    to: SpendDestinationUnion<TToAdapterCapabilities, TChainIdentifier>;
+    amount: string;
     /**
-     * The token to spend.  Currently only USDC is supported.
+     * The token to deposit.
      * Accepts any case (e.g. `'usdc'`, `'Usdc'`); normalised to uppercase internally.
-     */
-    token?: SupportedTokenInput;
-    /**
-     * Total USDC amount to spend (human-readable decimal string).
      *
-     * @remarks
-     * Always required. When sources include explicit `allocations`,
-     * `sum(allocations)` must equal `amount`.
+     * @defaultValue 'USDC'
      */
-    amount: string;
-    /** Optional configuration for the spend operation. */
-    config?: SpendConfig;
-}
-/**
- * Standard spend: `from` is required (no retry).
- */
-interface SpendParamsWithFrom<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> extends SpendParamsBase<TToAdapterCapabilities, TChainIdentifier> {
+    token?: SupportedTokenInput;
     /**
-     * One or more sources to pull funds from.
+     * The token allowance strategy to authorize the deposit.
      *
-     * Use an array when spending from multiple adapters (e.g.
-     * combining EVM and non-EVM accounts).
+     * @defaultValue 'authorize'
      */
-    from: SpendSource<TFromAdapterCapabilities> | SpendSource<TFromAdapterCapabilities>[];
-}
-/**
- * Retry spend: `from` is optional because we skip the
- * estimate/sign/transfer steps and go straight to mint.
- */
-interface SpendParamsRetry<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> extends SpendParamsBase<TToAdapterCapabilities, TChainIdentifier> {
-    from?: SpendSource<TFromAdapterCapabilities> | SpendSource<TFromAdapterCapabilities>[];
-    config: SpendConfig & {
-        retry: RetryMintConfig;
-    };
+    allowanceStrategy?: AllowanceStrategy;
 }
 /**
- * Parameters for spending (minting) USDC on a destination chain from
- * one or more Gateway account sources.
+ * Parameters for depositing tokens into *another* Gateway account.
  *
  * @remarks
- * `from` can be a single source or an array when pulling from
- * multiple adapters (e.g. an EVM account and a Solana account).
+ * Extends `DepositParams` with a `depositAccount` field that
+ * specifies the Gateway account to credit instead of the caller's
+ * own account. The Gateway contract only supports approval-based
+ * deposit-for (no permit/authorize); allowance strategy is not
+ * configurable and is not part of this type.
  *
- * @typeParam TFromAdapterCapabilities - Source adapter capabilities.
- * @typeParam TToAdapterCapabilities - Destination adapter capabilities.
+ * @typeParam TAdapterCapabilities - Adapter capability constraints.
  * @typeParam TChainIdentifier - Accepted chain identifier type.
  *
  * @example
  * ```typescript
- * import type { SpendParams } from '@circle-fin/unified-balance-kit'
+ * import type { DepositForParams } from '@circle-fin/unified-balance-kit'
  *
- * const params: SpendParams = {
- *   from: {
- *     adapter: evmAdapter,
- *     allocations: { amount: '100', chain: 'Ethereum' },
- *   },
- *   to: { adapter: avalancheAdapter, chain: 'Avalanche' },
+ * const params: DepositForParams = {
+ *   from: { adapter: evmAdapter, chain: 'Ethereum' },
  *   amount: '100',
  *   token: 'USDC',
+ *   depositAccount: '0x1234…abcd',
  * }
  * ```
  */
-type SpendParams<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> = SpendParamsWithFrom<TFromAdapterCapabilities, TToAdapterCapabilities, TChainIdentifier> | SpendParamsRetry<TFromAdapterCapabilities, TToAdapterCapabilities, TChainIdentifier>;
-/**
- * Result returned after a successful spend (mint) operation.
- *
+interface DepositForParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> extends Omit<DepositParams<TAdapterCapabilities, TChainIdentifier>, 'allowanceStrategy'> {
+    /**
+     * The Gateway account address to credit with the deposit.
+     *
+     * When provided the deposit is credited to this account rather
+     * than the caller's own.
+     */
+    depositAccount: string;
+}
+/**
+ * Result returned after a successful deposit operation.
+ *
  * @example
  * ```typescript
- * import type { SpendResult } from '@circle-fin/unified-balance-kit'
+ * import type { DepositResult } from '@circle-fin/unified-balance-kit'
  *
- * const result: SpendResult = {
- *   allocations: [
- *     { amount: '100', chain: 'Ethereum', sourceAccount: '0x…' },
- *   ],
- *   recipientAddress: '0xDEST…abcd',
- *   destinationChain: 'Avalanche',
- *   txHash: '0xabcdef…',
- *   explorerUrl: 'https://snowtrace.io/tx/0xabcdef…',
+ * const result: DepositResult = {
+ *   amount: '100',
+ *   token: 'USDC',
+ *   depositedTo: '0x742d35Cc6634C0532925a3b844Bc9e7595f2bD38',
+ *   depositedBy: '0x8ba1f109551bD432803012645632213Ab0521A3c',
+ *   chain: 'Ethereum',
+ *   txHash:
+ *     '0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3',
+ *   explorerUrl:
+ *     'https://etherscan.io/tx/0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3',
  * }
  * ```
  */
-interface SpendResult {
-    /**
-     * Flattened list of allocations that were executed, each with its
-     * source Gateway account. Only present for non-retry spends.
-     */
-    allocations?: AllocationResult[];
-    /** The address that received the minted USDC. */
-    recipientAddress: string;
-    /** The destination chain on which the recipient received the USDC. */
-    destinationChain: Blockchain;
+interface DepositResult {
+    /** The deposited amount (human-readable decimal string). */
+    amount: string;
+    /** The token that was deposited. */
+    token: SupportedToken;
+    /** The Gateway account address credited by the deposit. */
+    depositedTo: string;
+    /** The address that signed and funded the deposit. */
+    depositedBy: string;
+    /** The chain on which the deposit occurred. */
+    chain: Blockchain;
     /**
      * Unique identifier returned by the blockchain once the
      * transaction is mined.
@@ -25579,543 +26025,518 @@ interface SpendResult {
      * for the chain.
      */
     explorerUrl?: string;
-    /**
-     * Fee breakdown (provider, gasFee, optional kit, forwarder) for the
-     * executed spend. Same shape as estimateSpend fees. Omitted when
-     * using config.retry.
-     */
-    fees?: FeeEntry[];
-    /**
-     * Gateway transfer identifier. Present when `useForwarder` is enabled
-     * and can be used to query transfer status via `GET /v1/transfer/{id}`.
-     */
-    transferId?: string;
-    /**
-     * Block height after which the transfer attestation expires.
-     * Returned by the Gateway transfer API.
-     */
-    expirationBlock?: string;
-    /**
-     * Ordered list of steps executed during the spend operation.
-     *
-     * @remarks
-     * Each entry records the outcome of one phase of the spend flow.
-     * For a normal spend the order is:
-     * `buildBurnIntents` → `signBurnIntents` → `transfer` → `mint`.
-     * For a retry spend only `mint` is present.
-     */
-    steps?: SpendStep[];
-}
-interface CustomFeeConfig {
-    recipientAddress: string;
-    value: string;
 }
+
 /**
- * Data needed to retry a mint that failed after the transfer was
- * already committed (funds locked).
+ * Network type for balance queries when the target chain(s) are not
+ * explicitly specified. Default is mainnet.
+ */
+type NetworkType = 'mainnet' | 'testnet';
+/**
+ * A single balance source identifying an account to query.
  *
- * Obtain these values from the KitError (TRANSACTION_REVERTED) thrown when
- * the on-chain mint step fails. The attestation and signature are available
- * in `error.cause.trace`.
+ * Provide **at least one** of `adapter` or `address`:
+ *
+ * - **Address only** — pass `address` without `adapter` to query by
+ *   raw Gateway account address.
+ * - **Adapter (user-controlled)** — pass `adapter` without `address`;
+ *   the wallet address is resolved automatically.
+ * - **Adapter (developer-controlled)** — pass both `adapter` and
+ *   `address`; the explicit address is required because there is no
+ *   single connected wallet.
+ *
+ * @typeParam TAdapterCapabilities - Adapter capability constraints.
+ *
+ * @example
+ * ```typescript
+ * import type { BalanceSource } from '@circle-fin/unified-balance-kit'
+ *
+ * // Address-only (no adapter needed)
+ * const addrSource: BalanceSource = {
+ *   address: '0x1234…abcd',
+ *   chains: ['Ethereum', 'Base'],
+ * }
+ *
+ * // Adapter (user-controlled wallet)
+ * const adapterSource: BalanceSource = {
+ *   adapter: evmAdapter,
+ *   chains: 'Ethereum',
+ * }
+ *
+ * // Adapter (developer-controlled) — address required
+ * const devSource: BalanceSource = {
+ *   adapter: circleWalletsAdapter,
+ *   address: '0x1234…abcd',
+ *   chains: ['Ethereum'],
+ * }
+ * ```
  */
-interface RetryMintConfig {
-    /** The attestation hex string returned by the Gateway `/v1/transfer` API. */
-    attestation: string;
-    /** The attestation signature hex string returned by `/v1/transfer`. */
-    signature: string;
-}
-interface SpendConfig {
-    customFee?: CustomFeeConfig;
+interface BalanceSource<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> {
+    /** The adapter whose resolved address is used to fetch balances. */
+    adapter?: Adapter<TAdapterCapabilities>;
     /**
-     * When provided, skips the estimate/sign/transfer steps and proceeds
-     * directly to the on-chain mint using a previously obtained attestation.
-     *
-     * Use this to retry a mint that failed due to an RPC or network issue
-     * after the transfer was already committed.
+     * The account address to query balances for.
      *
-     * @remarks
-     * The `useForwarder` flag on the destination is ignored during retry
-     * because the attestation was already issued — the Forwarding Service
-     * is only involved in the initial transfer, not re-mints.
+     * - Required when no `adapter` is provided (address-only query).
+     * - Required for developer-controlled adapters.
+     * - Must be omitted for user-controlled adapters (auto-resolved).
      */
-    retry?: RetryMintConfig;
-}
-interface ResolvedAllocation {
-    amount: string;
-    chain: ChainDefinition;
-}
-interface ResolvedSpendSource<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> {
-    adapter: Adapter<TAdapterCapabilities>;
-    allocations: ResolvedAllocation[];
-    address?: string;
-    sourceAccount?: string;
-}
-interface ResolvedSpendDestination<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> {
-    adapter?: Adapter<TAdapterCapabilities>;
-    chain: ChainDefinition;
-    recipientAddress?: string;
     address?: string;
-    useForwarder?: boolean;
-}
-interface ResolvedSpendParams<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TToAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> {
-    from: ResolvedSpendSource<TFromAdapterCapabilities>[];
-    to: ResolvedSpendDestination<TToAdapterCapabilities>;
-    token: SupportedToken;
-    config?: SpendConfig;
+    /**
+     * Chains to fetch balances from.
+     *
+     * - If omitted, get balances from all supported chains.
+     * - If provided, only get balances for the specified chain(s).
+     */
+    chains?: UnifiedBalanceChainIdentifier | UnifiedBalanceChainIdentifier[];
 }
 /**
- * Function that computes the fee amount (in human-readable units, e.g. "10.5")
- * given the resolved spend parameters.
- */
-type SpendFeeFunction = (params: ResolvedSpendParams) => Promise<string> | string;
-/**
- * Function that resolves the fee recipient address for a spend.
- * Called once per spend, against the resolved **destination** chain —
- * every fee burn intent in a spend mints to that single chain
- * regardless of which source chain(s) funded it, so only one
- * recipient address (valid on the destination chain) is ever needed.
- */
-type SpendFeeRecipientFunction = (destinationChain: ChainDefinition, params: ResolvedSpendParams) => Promise<string> | string;
-/**
- * Policy for computing and routing custom developer fees.
- *
- * **Important:** When the kit invokes `computeFee` and
- * `resolveFeeRecipientAddress`, the `params` argument may be the
- * **raw, unresolved** `SpendParams` (cast to `ResolvedSpendParams`).
- * Fields that only exist after resolution (e.g. per-source allocations)
- * may be `undefined`.  Implementations should only rely on top-level
- * fields such as `to`, `token`, and `amount`.
+ * Accept a single item or an array of items of the same type.
  *
- * @remarks
- * `resolveFeeRecipientAddress` is optional when you configure
- * {@link UnifiedBalanceKit.setFeeRecipients} instead — the declarative
- * map takes priority over this callback when both are present. Provide
- * exactly one of the two; a policy with neither throws at spend time.
+ * @typeParam T - The element type.
  */
-interface CustomFeePolicy {
-    computeFee: SpendFeeFunction;
-    resolveFeeRecipientAddress?: SpendFeeRecipientFunction;
-}
+type OneOrMany<T> = T | T[];
 /**
- * Chain type group used to key {@link FeeRecipientsConfig}.
- *
- * @remarks
- * Only `'evm'` and `'solana'` are live today (the only chain types the
- * kit's provider currently supports). This is deliberately a narrow
- * subset of `@core/chains`' broader `ChainType` union rather than a
- * hardcoded two-field struct, so that support for additional non-EVM
- * chain types (e.g. Stellar, Starknet) can be added later by adding
- * new union members here — no restructuring of `FeeRecipientsConfig`
- * or its consumers required.
+ * One or more balance sources, each of which may be a single object
+ * or an array.
  */
-type FeeRecipientChainType = 'evm' | 'solana';
+type Sources<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> = OneOrMany<BalanceSource<TAdapterCapabilities>>;
 /**
- * Declarative map of fee recipient addresses, keyed by chain type.
+ * Parameters for the balances and pending-deposits API requests.
  *
- * @remarks
- * Set via {@link UnifiedBalanceKit.setFeeRecipients}. At spend time the
- * kit resolves the spend's destination chain to its
- * {@link FeeRecipientChainType} and looks up the matching entry —
- * exactly one recipient is used per spend (see
- * {@link SpendFeeRecipientFunction}). Provide entries for every chain
- * type you expect to spend to; a spend to a destination chain type
- * with no matching entry throws before any fee collection is
- * attempted.
+ * Specify the `token` to query and one or more `sources` identifying
+ * the accounts or adapters whose balances should be retrieved.
+ * When `includePending` is true, the result includes pending balances
+ * and pending transaction details per chain.
  *
  * @example
  * ```typescript
- * import type { FeeRecipientsConfig } from '@circle-fin/unified-balance-kit'
+ * import type { GetBalancesParams } from '@circle-fin/unified-balance-kit'
  *
- * const feeRecipients: FeeRecipientsConfig = {
- *   evm: '0x1234567890123456789012345678901234567890',
- *   solana: '9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM',
+ * // Single adapter source
+ * const params1: GetBalancesParams = {
+ *   token: 'USDC',
+ *   sources: { adapter: evmAdapter },
  * }
- * ```
+ *
+ * // Single address source with pending
+ * const params2: GetBalancesParams = {
+ *   token: 'USDC',
+ *   sources: { address: '0x1234…abcd', chains: 'Ethereum' },
+ *   includePending: true,
+ * }
+ *
+ * // Multiple address sources
+ * const params3: GetBalancesParams = {
+ *   token: 'USDC',
+ *   sources: [
+ *     { address: '0x8f3Cf7…', chains: ['ChainA', 'ChainB'] },
+ *     { address: '0x4B0897…', chains: ['ChainB', 'ChainC'] },
+ *   ],
+ * }
+ *
+ * // Adapter only (confirmed balances only; includePending defaults to false)
+ * const params4: GetBalancesParams = {
+ *   token: 'USDC',
+ *   sources: { adapter: evmAdapter },
+ * }
+ * ```
  */
-type FeeRecipientsConfig = Partial<Record<FeeRecipientChainType, string>>;
+interface GetBalancesParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> {
+    /**
+     * The token to query balances for.
+     * Accepts any case (e.g. `'usdc'`, `'Usdc'`); normalised to uppercase internally.
+     *
+     * @defaultValue 'USDC'
+     */
+    token?: SupportedTokenInput;
+    /**
+     * One or more sources identifying the accounts or adapters to
+     * query.  Accepts a single object or an array.
+     */
+    sources: Sources<TAdapterCapabilities>;
+    /**
+     * When true, the result includes pending balances.
+     * When false or omitted, only confirmed balances
+     * are returned.
+     *
+     * @defaultValue false
+     */
+    includePending?: boolean;
+    /**
+     * Network to use when no chains are specified on a source.
+     * When omitted, mainnet is used when chains cannot be derived.
+     *
+     * @defaultValue 'mainnet'
+     */
+    networkType?: NetworkType;
+}
 /**
- * Fee category describing the origin of a fee line item.
+ * A pending transaction included in {@link GetBalancesResult}
+ * when `includePending` is true.
  *
- * - `'provider'`  — Fee charged by the cross-chain provider (e.g. protocol fee).
- * - `'gasFee'`    — On-chain gas cost denominated in the transfer token (e.g. USDC).
- * - `'kit'`       — Fee charged by the kit / developer integration.
- * - `'forwarder'` — Fee charged by Circle's Forwarding Service for automatic mint.
+ * @example
+ * ```typescript
+ * import type { PendingBalanceTransaction } from '@circle-fin/unified-balance-kit'
+ *
+ * const tx: PendingBalanceTransaction = {
+ *   transactionHash: '0x2c5f3e4a…',
+ *   amount: '50.00',
+ *   blockTimestamp: '2023-11-07T05:31:56Z',
+ * }
+ * ```
  */
-type FeeType = 'provider' | 'gasFee' | 'kit' | 'forwarder';
+interface PendingBalanceTransaction {
+    /** Transaction hash of the pending deposit. */
+    transactionHash: string;
+    /** Pending amount (human-readable decimal string). */
+    amount: string;
+    /** ISO 8601 timestamp of the block. */
+    blockTimestamp: string;
+}
 /**
- * Per-chain breakdown of a fee amount.
+ * Per-chain balance within a breakdown in {@link GetBalancesResult}.
+ *
+ * When `includePending` is true, `pendingBalance` and `pendingTransactions`
+ * are present.
  *
  * @example
  * ```typescript
- * import type { FeeAllocation } from '@circle-fin/unified-balance-kit'
+ * import type { ChainBalanceBreakdown } from '@circle-fin/unified-balance-kit'
  *
- * const allocation: FeeAllocation = {
+ * // Confirmed only (includePending: false)
+ * const chain: ChainBalanceBreakdown = {
+ *   chain: 'Arbitrum',
+ *   confirmedBalance: '1500.00',
+ * }
+ *
+ * // With pending (includePending: true)
+ * const chainWithPending: ChainBalanceBreakdown = {
  *   chain: 'Ethereum',
- *   amount: '0.00005',
+ *   confirmedBalance: '1000.00',
+ *   pendingBalance: '50.00',
+ *   pendingTransactions: [
+ *     { transactionHash: '0x2c5f3e…', amount: '50.00', blockTimestamp: '2023-11-07T05:31:56Z' },
+ *   ],
  * }
  * ```
  */
-interface FeeAllocation {
-    /** The chain to which this portion of the fee applies. */
+interface ChainBalanceBreakdown {
+    /** The chain. */
     chain: Blockchain;
-    /** The fee amount on this chain (human-readable decimal string). */
-    amount: string;
+    /** Confirmed balance (human-readable decimal string). */
+    confirmedBalance: string;
+    /**
+     * Pending balance on this chain.
+     * Present only when {@link GetBalancesParams.includePending} is true.
+     */
+    pendingBalance?: string;
+    /**
+     * Pending deposit transactions on this chain.
+     * Present only when {@link GetBalancesParams.includePending} is true.
+     */
+    pendingTransactions?: PendingBalanceTransaction[];
 }
 /**
- * A single fee line item within an estimate.
+ * Per-account balance breakdown used in {@link GetBalancesResult}.
  *
- * @remarks
- * Each entry describes a fee category (`type`), the token it is
- * denominated in, the aggregate `amount`, and an optional per-chain
- * `allocations` breakdown.
+ * When `includePending` is true, `totalPending` is present and each chain
+ * entry may include `pendingBalance` and `pendingTransactions`.
  *
  * @example
  * ```typescript
- * import type { FeeEntry } from '@circle-fin/unified-balance-kit'
+ * import type { BalanceWithPendingBreakdown } from '@circle-fin/unified-balance-kit'
  *
- * // Fee with per-chain allocation breakdown
- * const providerFee: FeeEntry = {
- *   type: 'provider',
- *   token: 'USDC',
- *   amount: '0.00011',
- *   allocations: [
- *     { chain: 'Ethereum', amount: '0.00005' },
- *     { chain: 'Polygon', amount: '0.00006' },
+ * const entry: BalanceWithPendingBreakdown = {
+ *   depositor: '0x71C765…',
+ *   totalConfirmed: '1000.00',
+ *   totalPending: '50.00',
+ *   breakdown: [
+ *     { chain: 'Ethereum', confirmedBalance: '1000.00', pendingBalance: '50.00', pendingTransactions: [...] },
  *   ],
  * }
- *
- * // Flat fee without allocations (e.g. forwarder)
- * const forwarderFee: FeeEntry = {
- *   type: 'forwarder',
- *   token: 'USDC',
- *   amount: '0.005',
- * }
  * ```
  */
-interface FeeEntry {
-    /** The category of this fee. */
-    type: FeeType;
-    /** The token in which this fee is denominated (e.g. `'USDC'`, `'ETH'`). */
-    token: string;
-    /** Aggregate fee amount (human-readable decimal string). */
-    amount: string;
-    /** Per-chain breakdown of the fee. Omitted for flat fees (e.g. forwarder). */
-    allocations?: FeeAllocation[];
+interface BalanceWithPendingBreakdown {
+    /** Gateway account (depositor) address. */
+    depositor: string;
+    /** Total confirmed balance across chains (human-readable decimal string). */
+    totalConfirmed: string;
     /**
-     * When `type === 'kit'`, the address that receives the kit fee.
-     * Omitted for other fee types.
+     * Total pending balance across chains.
+     * Present only when `includePending` is true.
      */
-    recipientAddress?: string;
+    totalPending?: string;
+    /** Per-chain breakdown for this depositor. */
+    breakdown: ChainBalanceBreakdown[];
 }
 /**
- * Cost estimation for a spend (mint) operation.
+ * Result returned from the provider's `getBalances` method (combined confirmed and pending).
  *
- * @remarks
- * Returned by the provider's `estimateSpend` method to give callers
- * visibility into the expected fees *before* executing a spend.
- * Each entry in `fees` represents a distinct fee category with its
- * per-chain allocation breakdown.
+ * When `includePending` is false (default), only `totalConfirmedBalance` and
+ * `breakdown` with confirmed fields are returned. When `includePending` is true,
+ * `totalPendingBalance` is present and breakdown entries include pending amounts
+ * and `pendingTransactions` per chain.
  *
  * @example
  * ```typescript
- * import type { EstimateSpendResult } from '@circle-fin/unified-balance-kit'
+ * import type { GetBalancesResult } from '@circle-fin/unified-balance-kit'
  *
- * const estimate: EstimateSpendResult = {
- *   fees: [
- *     {
- *       type: 'provider',
- *       token: 'USDC',
- *       amount: '0.00011',
- *       allocations: [
- *         { chain: 'Ethereum', amount: '0.00005' },
- *         { chain: 'Polygon', amount: '0.00006' },
- *       ],
- *     },
+ * // includePending: false
+ * const result: GetBalancesResult = {
+ *   token: 'USDC',
+ *   totalConfirmedBalance: '3500.00',
+ *   breakdown: [
  *     {
- *       type: 'gasFee',
- *       token: 'USDC',
- *       amount: '0.0025',
- *       allocations: [
- *         { chain: 'Ethereum', amount: '0.0015' },
- *         { chain: 'Polygon', amount: '0.0010' },
+ *       depositor: '0xAAAd67…',
+ *       totalConfirmed: '2500.00',
+ *       breakdown: [
+ *         { chain: 'Arbitrum', confirmedBalance: '1500.00' },
+ *         { chain: 'Optimism', confirmedBalance: '1000.00' },
  *       ],
  *     },
+ *   ],
+ * }
+ *
+ * // includePending: true
+ * const resultWithPending: GetBalancesResult = {
+ *   token: 'USDC',
+ *   totalConfirmedBalance: '3500.00',
+ *   totalPendingBalance: '650.00',
+ *   breakdown: [
  *     {
- *       type: 'kit',
- *       token: 'USDC',
- *       amount: '0.05',
- *       allocations: [
- *         { chain: 'Ethereum', amount: '0.05' },
+ *       depositor: '0x71C765…',
+ *       totalConfirmed: '1000.00',
+ *       totalPending: '50.00',
+ *       breakdown: [
+ *         {
+ *           chain: 'Ethereum',
+ *           confirmedBalance: '1000.00',
+ *           pendingBalance: '50.00',
+ *           pendingTransactions: [
+ *             { transactionHash: '0x2c5f3e…', amount: '50.00', blockTimestamp: '2023-11-07T05:31:56Z' },
+ *           ],
+ *         },
  *       ],
  *     },
  *   ],
  * }
  * ```
  */
-interface EstimateSpendResult {
-    /** Itemised fee breakdown for the spend operation. */
-    fees: FeeEntry[];
+interface GetBalancesResult {
+    /** Token that was queried. */
+    token: SupportedToken;
+    /** Total confirmed balance across all accounts and chains (human-readable decimal string). */
+    totalConfirmedBalance: string;
+    /**
+     * Total pending balance across all accounts and chains.
+     * Present only when `includePending` is true.
+     */
+    totalPendingBalance?: string;
+    /** Per-account, per-chain breakdown. */
+    breakdown: BalanceWithPendingBreakdown[];
 }
 
 /**
- * Runtime array of token identifiers supported by the unified-balance-kit.
+ * Parameters for adding or removing a delegate on a Gateway account.
  *
- * @example
- * ```typescript
- * import { SUPPORTED_TOKENS } from '@circle-fin/unified-balance-kit'
- *
- * if (SUPPORTED_TOKENS.includes('USDC')) {
- *   console.log('USDC is supported')
- * }
- * ```
- */
-declare const SUPPORTED_TOKENS: readonly ["USDC"];
-/**
- * Token identifiers supported by the unified-balance-kit.
- *
- * @example
- * ```typescript
- * import type { SupportedToken } from '@circle-fin/unified-balance-kit'
- *
- * const token: SupportedToken = 'USDC'
- * ```
- */
-type SupportedToken = (typeof SUPPORTED_TOKENS)[number];
-/**
- * Case-insensitive variant of {@link SupportedToken} for user-facing input.
+ * @remarks
+ * Delegation allows a different signer to move funds out of the
+ * owner's account.  The delegate must be added explicitly per chain.
  *
- * Accepts the canonical uppercase form, fully lowercase, and title-case
- * (e.g. `'USDC'`, `'usdc'`, `'Usdc'`). Arbitrary mixed-case input like
- * `'uSdC'` is handled at runtime by the Zod schema and
- * {@link normalizeToken}, so exhaustive compile-time permutations are
- * unnecessary. Avoiding a recursive `CasePermutations` type prevents
- * 2^N type-literal explosion as the token list grows.
+ * @typeParam TAdapterCapabilities - Adapter capability constraints.
+ * @typeParam TChainIdentifier - Accepted chain identifier type.
  *
  * @example
  * ```typescript
- * import type { SupportedTokenInput } from '@circle-fin/unified-balance-kit'
+ * import type { UpdateDelegateParams } from '@circle-fin/unified-balance-kit'
  *
- * const token: SupportedTokenInput = 'usdc' // OK
+ * const params: UpdateDelegateParams = {
+ *   from: { adapter: evmAdapter, chain: 'Ethereum' },
+ *   delegateAddress: '0xDELEGATE…1111',
+ * }
  * ```
  */
-type SupportedTokenInput = SupportedToken | Lowercase<SupportedToken> | Capitalize<Lowercase<SupportedToken>>;
-/**
- * Intentional `any` escape hatch so heterogeneous providers can be stored
- * in a single array while `MergeActions` rebuilds concrete action types.
- *
- * Type safety is re-established by the `on()`/`off()` overloads in
- * {@link UnifiedBalanceKit} — do not remove those overloads.
- *
- * Caveat: custom providers whose `TProviderActions` differs from the
- * default map will have action types erased to `any` unless the consumer
- * passes the provider tuple as a generic, e.g. `UnifiedBalanceKit<[MyProvider]>`.
- */
-type FlexibleGatewayProvider = IGatewayProvider<any>;
+interface UpdateDelegateParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
+    /**
+     * The owner's adapter context identifying the account and chain
+     * to which the delegate will be authorized.
+     */
+    from: AdapterContext<TAdapterCapabilities, TChainIdentifier>;
+    /**
+     * The address being added or removed as an authorized delegate.
+     */
+    delegateAddress: string;
+    /**
+     * The token for which delegation applies.
+     * Accepts any case (e.g. `'usdc'`, `'Usdc'`); normalised to uppercase internally.
+     *
+     * @defaultValue 'USDC'
+     */
+    token?: SupportedTokenInput;
+}
 /**
- * Configuration options for initializing a {@link UnifiedBalanceKit} instance.
- *
- * When no providers are specified, the kit uses the default Gateway v1
- * provider. Any additional providers supplied via config are appended
- * to the defaults.
- *
- * @typeParam TExtraProviders - Array type of additional providers
- *
- * @example
- * ```typescript
- * import { UnifiedBalanceKit } from '@circle-fin/unified-balance-kit'
- *
- * // Create kit with default providers
- * const kit = new UnifiedBalanceKit()
- * ```
+ * Result returned after a successful add or remove delegate
+ * operation.
  *
  * @example
  * ```typescript
- * import { UnifiedBalanceKit } from '@circle-fin/unified-balance-kit'
+ * import type { UpdateDelegateResult } from '@circle-fin/unified-balance-kit'
  *
- * // Create kit with additional providers
- * const kit = new UnifiedBalanceKit({
- *   providers: [myCustomProvider],
- * })
+ * const result: UpdateDelegateResult = {
+ *   account: '0xOWNER…1234',
+ *   delegateAddress: '0xDELEGATE…1111',
+ *   chain: 'Ethereum',
+ *   state: 'added',
+ *   txHash: '0xabc…',
+ *   explorerUrl: 'https://etherscan.io/tx/0xabc…',
+ * }
  * ```
  */
-interface UnifiedBalanceKitConfig<TExtraProviders extends FlexibleGatewayProvider[] = []> {
-    /**
-     * Optional array of additional Gateway providers.
-     *
-     * If not provided, default providers will be initialized.
-     */
-    providers?: TExtraProviders;
+interface UpdateDelegateResult {
+    /** The Gateway account that was modified. */
+    account: string;
+    /** The delegate address that was added or removed. */
+    delegateAddress: string;
     /**
-     * Disable analytics telemetry (success events with `txHash`).
-     *
-     * When `true`, the SDK will not POST to the telemetry endpoint
-     * after successful verb operations. Defaults to `false` (enabled).
+     * The chain on which the delegate was updated.
      *
      * @remarks
-     * Only applies to the class-based API (`new UnifiedBalanceKit()`).
-     * The functional API via `createUnifiedBalanceKitContext()` does not
-     * register telemetry handlers.
-     *
-     * @defaultValue false
+     * Delegates must be added explicitly per chain.  You cannot
+     * authorize a delegate for all chains at once.
      */
-    disableAnalytics?: boolean;
+    chain: Blockchain;
+    /** Whether the delegate was added or removed. */
+    state: 'added' | 'removed';
     /**
-     * Disable error telemetry.
-     *
-     * When `true`, the SDK will not POST error details to the telemetry
-     * endpoint when public methods throw. Defaults to `false` (enabled).
-     *
-     * @remarks
-     * Only applies to the class-based API (`new UnifiedBalanceKit()`).
-     *
-     * @defaultValue false
+     * Unique identifier returned by the blockchain once the
+     * transaction is mined.
      */
-    disableErrorReporting?: boolean;
+    txHash: string;
     /**
-     * Skip the built-in default providers when assembling the context.
-     *
-     * By default the kit prepends the standard Gateway v1 provider so
-     * `providers` is treated as additive. Pass `true` to use only the
-     * providers supplied in {@link UnifiedBalanceKitConfig.providers}.
-     *
-     * Useful when stubbing the gateway in integration tests, when running
-     * against a self-hosted gateway replacement, or any time you want full
-     * control over which provider serves a given chain.
+     * Link to view the transaction details on the appropriate
+     * blockchain explorer.
      *
-     * @defaultValue false
+     * @remarks
+     * May be `undefined` when the explorer URL cannot be resolved
+     * for the chain.
      */
-    excludeDefaultProviders?: boolean;
+    explorerUrl?: string;
 }
-
 /**
- * Token allowance strategy used to authorize a Gateway deposit.
- *
- * - `'approve'` — traditional ERC-20 `approve` transaction.
- * - `'permit'` — gasless EIP-2612 off-chain signature.
- * - `'authorize'` — EIP-3009 `transferWithAuthorization`.
- *
- * @example
- * ```typescript
- * import type { AllowanceStrategy } from '@circle-fin/unified-balance-kit'
+ * The finality-aware status of a delegate on a Gateway account.
  *
- * const strategy: AllowanceStrategy = 'permit'
- * ```
+ * - `'none'`    — not a delegate on-chain.
+ * - `'pending'` — delegate set on-chain but Gateway hasn't finalized it yet;
+ *                 spend will fail until the status advances to `'ready'`.
+ * - `'ready'`   — finalized at Gateway; spend will succeed.
  */
-type AllowanceStrategy = 'approve' | 'permit' | 'authorize';
+type DelegateStatus = 'none' | 'pending' | 'ready';
 /**
- * Parameters for depositing tokens into the caller's own Gateway
- * account on a specific chain.
- *
- * @remarks
- * Although a Gateway account can span multiple chains (e.g. all EVM
- * chains share the same account), every deposit targets exactly one
- * chain.  The depositor is identified by the adapter context.
+ * Parameters for checking the delegate status of an address on a
+ * Gateway account.
  *
  * @typeParam TAdapterCapabilities - Adapter capability constraints.
  * @typeParam TChainIdentifier - Accepted chain identifier type.
  *
  * @example
  * ```typescript
- * import type { DepositParams } from '@circle-fin/unified-balance-kit'
+ * import type { GetDelegateStatusParams } from '@circle-fin/unified-balance-kit'
  *
- * const params: DepositParams = {
+ * const params: GetDelegateStatusParams = {
  *   from: { adapter: evmAdapter, chain: 'Ethereum' },
- *   amount: '100',
- *   token: 'USDC',
- *   allowanceStrategy: 'permit',
+ *   delegateAddress: '0xDELEGATE…1111',
  * }
  * ```
  */
-interface DepositParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
-    /**
-     * The adapter context identifying the depositor and chain.
-     */
+interface GetDelegateStatusParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
+    /** The adapter context identifying the account owner and chain. */
     from: AdapterContext<TAdapterCapabilities, TChainIdentifier>;
+    /** The address to check for delegate status. */
+    delegateAddress: string;
     /**
-     * The amount of tokens to deposit (human-readable decimal string).
-     *
-     * @example "100", "0.5"
-     */
-    amount: string;
-    /**
-     * The token to deposit.
+     * The token for which delegation is checked.
      * Accepts any case (e.g. `'usdc'`, `'Usdc'`); normalised to uppercase internally.
      *
      * @defaultValue 'USDC'
      */
     token?: SupportedTokenInput;
-    /**
-     * The token allowance strategy to authorize the deposit.
-     *
-     * @defaultValue 'authorize'
-     */
-    allowanceStrategy?: AllowanceStrategy;
 }
+
 /**
- * Parameters for depositing tokens into *another* Gateway account.
+ * Parameters for initiating a delayed recovery fund removal from a Gateway
+ * account.
  *
  * @remarks
- * Extends `DepositParams` with a `depositAccount` field that
- * specifies the Gateway account to credit instead of the caller's
- * own account. The Gateway contract only supports approval-based
- * deposit-for (no permit/authorize); allowance strategy is not
- * configurable and is not part of this type.
+ * Use fund removal only as a trustless fallback when the normal spend flow is
+ * unavailable. For day-to-day movement out of a Unified Balance, use `spend`.
+ *
+ * Fund removals have a mandatory 7-day delay before they can be
+ * completed.  Only one removal may be pending per chain at a
+ * time.  Initiating a second removal on the same chain adds the
+ * requested amount to the existing pending removal and restarts
+ * the 7-day timer.
  *
  * @typeParam TAdapterCapabilities - Adapter capability constraints.
  * @typeParam TChainIdentifier - Accepted chain identifier type.
  *
  * @example
  * ```typescript
- * import type { DepositForParams } from '@circle-fin/unified-balance-kit'
+ * import type { InitiateRemoveFundParams } from '@circle-fin/unified-balance-kit'
  *
- * const params: DepositForParams = {
+ * const params: InitiateRemoveFundParams = {
  *   from: { adapter: evmAdapter, chain: 'Ethereum' },
  *   amount: '100',
- *   token: 'USDC',
- *   depositAccount: '0x1234…abcd',
  * }
  * ```
  */
-interface DepositForParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> extends Omit<DepositParams<TAdapterCapabilities, TChainIdentifier>, 'allowanceStrategy'> {
+interface InitiateRemoveFundParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
     /**
-     * The Gateway account address to credit with the deposit.
-     *
-     * When provided the deposit is credited to this account rather
-     * than the caller's own.
+     * The account owner's adapter context identifying the account,
+     * chain, and address.
      */
-    depositAccount: string;
-}
-/**
- * Result returned after a successful deposit operation.
- *
- * @example
- * ```typescript
- * import type { DepositResult } from '@circle-fin/unified-balance-kit'
+    from: AdapterContext<TAdapterCapabilities, TChainIdentifier>;
+    /** The amount to remove (human-readable decimal string). */
+    amount: string;
+    /**
+     * The token to remove.
+     * Accepts any case (e.g. `'usdc'`, `'Usdc'`); normalised to uppercase internally.
+     * @defaultValue 'USDC'
+     */
+    token?: SupportedTokenInput;
+}
+/**
+ * Result returned after successfully initiating a fund removal.
  *
- * const result: DepositResult = {
+ * @example
+ * ```typescript
+ * import type { InitiateRemoveFundResult } from '@circle-fin/unified-balance-kit'
+ *
+ * const result: InitiateRemoveFundResult = {
  *   amount: '100',
  *   token: 'USDC',
- *   depositedTo: '0x742d35Cc6634C0532925a3b844Bc9e7595f2bD38',
- *   depositedBy: '0x8ba1f109551bD432803012645632213Ab0521A3c',
+ *   account: '0xOWNER…1234',
  *   chain: 'Ethereum',
- *   txHash:
- *     '0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3',
- *   explorerUrl:
- *     'https://etherscan.io/tx/0xd4e56740f876aef8c010b86a40d5f56745a118d0906a34e69aec8c0db1cb8fa3',
+ *   withdrawingBalance: '100',
+ *   withdrawalBlock: 19_500_000,
+ *   txHash: '0xabc…',
+ *   explorerUrl: 'https://etherscan.io/tx/0xabc…',
  * }
  * ```
  */
-interface DepositResult {
-    /** The deposited amount (human-readable decimal string). */
+interface InitiateRemoveFundResult {
+    /** The amount requested for removal. */
     amount: string;
-    /** The token that was deposited. */
+    /** The token type (always USDC). */
     token: SupportedToken;
-    /** The Gateway account address credited by the deposit. */
-    depositedTo: string;
-    /** The address that signed and funded the deposit. */
-    depositedBy: string;
-    /** The chain on which the deposit occurred. */
+    /** The Gateway account from which this removal will occur. */
+    account: string;
+    /** The chain on which this removal was initiated. */
     chain: Blockchain;
+    /** The balance currently in the withdrawing state for this account. */
+    withdrawingBalance: string;
+    /** The block number at which the removal can be completed. */
+    withdrawalBlock: number;
     /**
      * Unique identifier returned by the blockchain once the
      * transaction is mined.
@@ -26131,623 +26552,818 @@ interface DepositResult {
      */
     explorerUrl?: string;
 }
-
-/**
- * Network type for balance queries when the target chain(s) are not
- * explicitly specified. Default is mainnet.
- */
-type NetworkType = 'mainnet' | 'testnet';
 /**
- * A single balance source identifying an account to query.
- *
- * Provide **at least one** of `adapter` or `address`:
+ * Parameters for completing a recovery fund removal after the withdrawal
+ * delay.
  *
- * - **Address only** — pass `address` without `adapter` to query by
- *   raw Gateway account address.
- * - **Adapter (user-controlled)** — pass `adapter` without `address`;
- *   the wallet address is resolved automatically.
- * - **Adapter (developer-controlled)** — pass both `adapter` and
- *   `address`; the explicit address is required because there is no
- *   single connected wallet.
+ * @remarks
+ * Use fund removal only as a trustless fallback when the normal spend flow is
+ * unavailable. For day-to-day movement out of a Unified Balance, use `spend`.
  *
  * @typeParam TAdapterCapabilities - Adapter capability constraints.
+ * @typeParam TChainIdentifier - Accepted chain identifier type.
  *
  * @example
  * ```typescript
- * import type { BalanceSource } from '@circle-fin/unified-balance-kit'
- *
- * // Address-only (no adapter needed)
- * const addrSource: BalanceSource = {
- *   address: '0x1234…abcd',
- *   chains: ['Ethereum', 'Base'],
- * }
- *
- * // Adapter (user-controlled wallet)
- * const adapterSource: BalanceSource = {
- *   adapter: evmAdapter,
- *   chains: 'Ethereum',
- * }
+ * import type { RemoveFundParams } from '@circle-fin/unified-balance-kit'
  *
- * // Adapter (developer-controlled) — address required
- * const devSource: BalanceSource = {
- *   adapter: circleWalletsAdapter,
- *   address: '0x1234…abcd',
- *   chains: ['Ethereum'],
+ * const params: RemoveFundParams = {
+ *   from: { adapter: evmAdapter, chain: 'Ethereum' },
  * }
  * ```
  */
-interface BalanceSource<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> {
-    /** The adapter whose resolved address is used to fetch balances. */
-    adapter?: Adapter<TAdapterCapabilities>;
+interface RemoveFundParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
     /**
-     * The account address to query balances for.
-     *
-     * - Required when no `adapter` is provided (address-only query).
-     * - Required for developer-controlled adapters.
-     * - Must be omitted for user-controlled adapters (auto-resolved).
+     * The account owner's adapter context.  Must match the one
+     * used when initiating the fund removal.
      */
-    address?: string;
+    from: AdapterContext<TAdapterCapabilities, TChainIdentifier>;
     /**
-     * Chains to fetch balances from.
+     * The token to remove.
+     * Accepts any case (e.g. `'usdc'`, `'Usdc'`); normalised to uppercase internally.
      *
-     * - If omitted, get balances from all supported chains.
-     * - If provided, only get balances for the specified chain(s).
+     * @defaultValue 'USDC'
      */
-    chains?: UnifiedBalanceChainIdentifier | UnifiedBalanceChainIdentifier[];
+    token?: SupportedTokenInput;
 }
 /**
- * Accept a single item or an array of items of the same type.
- *
- * @typeParam T - The element type.
- */
-type OneOrMany<T> = T | T[];
-/**
- * One or more balance sources, each of which may be a single object
- * or an array.
- */
-type Sources<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> = OneOrMany<BalanceSource<TAdapterCapabilities>>;
-/**
- * Parameters for the balances and pending-deposits API requests.
- *
- * Specify the `token` to query and one or more `sources` identifying
- * the accounts or adapters whose balances should be retrieved.
- * When `includePending` is true, the result includes pending balances
- * and pending transaction details per chain.
+ * Result returned after successfully completing a fund removal.
  *
  * @example
  * ```typescript
- * import type { GetBalancesParams } from '@circle-fin/unified-balance-kit'
- *
- * // Single adapter source
- * const params1: GetBalancesParams = {
- *   token: 'USDC',
- *   sources: { adapter: evmAdapter },
- * }
- *
- * // Single address source with pending
- * const params2: GetBalancesParams = {
- *   token: 'USDC',
- *   sources: { address: '0x1234…abcd', chains: 'Ethereum' },
- *   includePending: true,
- * }
- *
- * // Multiple address sources
- * const params3: GetBalancesParams = {
- *   token: 'USDC',
- *   sources: [
- *     { address: '0x8f3Cf7…', chains: ['ChainA', 'ChainB'] },
- *     { address: '0x4B0897…', chains: ['ChainB', 'ChainC'] },
- *   ],
- * }
+ * import type { RemoveFundResult } from '@circle-fin/unified-balance-kit'
  *
- * // Adapter only (confirmed balances only; includePending defaults to false)
- * const params4: GetBalancesParams = {
+ * const result: RemoveFundResult = {
+ *   amount: '100',
  *   token: 'USDC',
- *   sources: { adapter: evmAdapter },
+ *   account: '0xOWNER…1234',
+ *   chain: 'Ethereum',
+ *   txHash: '0xdef…',
+ *   explorerUrl: 'https://etherscan.io/tx/0xdef…',
  * }
  * ```
  */
-interface GetBalancesParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities> {
-    /**
-     * The token to query balances for.
-     * Accepts any case (e.g. `'usdc'`, `'Usdc'`); normalised to uppercase internally.
-     *
-     * @defaultValue 'USDC'
-     */
-    token?: SupportedTokenInput;
+interface RemoveFundResult {
+    /** The final removed amount. */
+    amount: string;
+    /** The token type (always USDC). */
+    token: SupportedToken;
+    /** The Gateway account from which the tokens were removed. */
+    account: string;
+    /** The chain on which the removal occurred. */
+    chain: Blockchain;
     /**
-     * One or more sources identifying the accounts or adapters to
-     * query.  Accepts a single object or an array.
+     * Unique identifier returned by the blockchain once the
+     * transaction is mined.
      */
-    sources: Sources<TAdapterCapabilities>;
+    txHash: string;
     /**
-     * When true, the result includes pending balances.
-     * When false or omitted, only confirmed balances
-     * are returned.
+     * Link to view the transaction details on the appropriate
+     * blockchain explorer.
      *
-     * @defaultValue false
+     * @remarks
+     * May be `undefined` when the explorer URL cannot be resolved
+     * for the chain.
      */
-    includePending?: boolean;
+    explorerUrl?: string;
+}
+
+/**
+ * Options for filtering supported chains.
+ */
+interface GetSupportedChainsOptions {
     /**
-     * Network to use when no chains are specified on a source.
-     * When omitted, mainnet is used when chains cannot be derived.
+     * Filter chains by forwarder support. When set, only chains whose
+     * `gateway.forwarderSupported.source` or `gateway.forwarderSupported.destination`
+     * matches the specified value are returned.
      *
-     * @defaultValue 'mainnet'
+     * - `undefined` (default) — no forwarder filtering; all supported chains are returned.
+     * - `'source'` — only chains that support forwarding as a source.
+     * - `'destination'` — only chains that support forwarding as a destination.
      */
-    networkType?: NetworkType;
+    forwarderSupported?: 'source' | 'destination';
 }
+
 /**
- * A pending transaction included in {@link GetBalancesResult}
- * when `includePending` is true.
- *
- * @example
- * ```typescript
- * import type { PendingBalanceTransaction } from '@circle-fin/unified-balance-kit'
+ * A custom token contract address string.
  *
- * const tx: PendingBalanceTransaction = {
- *   transactionHash: '0x2c5f3e4a…',
- *   amount: '50.00',
- *   blockTimestamp: '2023-11-07T05:31:56Z',
- * }
- * ```
+ * This type represents token addresses that are not known aliases.
+ * It uses a branded type pattern to preserve IDE autocomplete for TokenAlias
+ * while still accepting arbitrary address strings.
  */
-interface PendingBalanceTransaction {
-    /** Transaction hash of the pending deposit. */
-    transactionHash: string;
-    /** Pending amount (human-readable decimal string). */
-    amount: string;
-    /** ISO 8601 timestamp of the block. */
-    blockTimestamp: string;
-}
+type TokenAddress = string & {
+    readonly __tokenAddress?: never;
+};
 /**
- * Per-chain balance within a breakdown in {@link GetBalancesResult}.
- *
- * When `includePending` is true, `pendingBalance` and `pendingTransactions`
- * are present.
+ * Known token aliases supported by AppKit.
  *
- * @example
- * ```typescript
- * import type { ChainBalanceBreakdown } from '@circle-fin/unified-balance-kit'
+ * These aliases map to chain-specific token addresses. `USDC`, `USDT`, and
+ * `NATIVE` have dedicated transfer actions in the adapter layer. `EURC` has no
+ * dedicated action — it resolves to the chain's `eurcAddress` and is sent via
+ * the generic token transfer action, so it is only supported on chains where
+ * `eurcAddress` is set.
  *
- * // Confirmed only (includePending: false)
- * const chain: ChainBalanceBreakdown = {
- *   chain: 'Arbitrum',
- *   confirmedBalance: '1500.00',
- * }
- *
- * // With pending (includePending: true)
- * const chainWithPending: ChainBalanceBreakdown = {
- *   chain: 'Ethereum',
- *   confirmedBalance: '1000.00',
- *   pendingBalance: '50.00',
- *   pendingTransactions: [
- *     { transactionHash: '0x2c5f3e…', amount: '50.00', blockTimestamp: '2023-11-07T05:31:56Z' },
- *   ],
- * }
- * ```
+ * @remarks
+ * For swap operations, see {@link SupportedToken} in SwapKit which supports
+ * additional tokens (DAI, USDE, PYUSD).
  */
-interface ChainBalanceBreakdown {
-    /** The chain. */
-    chain: Blockchain;
-    /** Confirmed balance (human-readable decimal string). */
-    confirmedBalance: string;
-    /**
-     * Pending balance on this chain.
-     * Present only when {@link GetBalancesParams.includePending} is true.
-     */
-    pendingBalance?: string;
-    /**
-     * Pending deposit transactions on this chain.
-     * Present only when {@link GetBalancesParams.includePending} is true.
-     */
-    pendingTransactions?: PendingBalanceTransaction[];
-}
+type TokenAlias = 'USDC' | 'USDT' | 'NATIVE' | 'EURC';
 /**
- * Per-account balance breakdown used in {@link GetBalancesResult}.
- *
- * When `includePending` is true, `totalPending` is present and each chain
- * entry may include `pendingBalance` and `pendingTransactions`.
- *
- * @example
- * ```typescript
- * import type { BalanceWithPendingBreakdown } from '@circle-fin/unified-balance-kit'
+ * Operation types that support the `getFee`/`getFeeRecipient` hooks.
+ */
+type FeeOperationType = 'bridge' | 'swap';
+/**
+ * Union type of all supported operation types in the AppKit.
  *
- * const entry: BalanceWithPendingBreakdown = {
- *   depositor: '0x71C765…',
- *   totalConfirmed: '1000.00',
- *   totalPending: '50.00',
- *   breakdown: [
- *     { chain: 'Ethereum', confirmedBalance: '1000.00', pendingBalance: '50.00', pendingTransactions: [...] },
- *   ],
- * }
- * ```
+ * This type ensures type safety when specifying operation types and enables
+ * proper parameter validation based on the selected operation.
  */
-interface BalanceWithPendingBreakdown {
-    /** Gateway account (depositor) address. */
-    depositor: string;
-    /** Total confirmed balance across chains (human-readable decimal string). */
-    totalConfirmed: string;
-    /**
-     * Total pending balance across chains.
-     * Present only when `includePending` is true.
-     */
-    totalPending?: string;
-    /** Per-chain breakdown for this depositor. */
-    breakdown: ChainBalanceBreakdown[];
-}
+type OperationType = FeeOperationType | 'earn' | 'unifiedBalance';
 /**
- * Result returned from the provider's `getBalances` method (combined confirmed and pending).
+ * Maps operation types to their corresponding parameter interfaces.
  *
- * When `includePending` is false (default), only `totalConfirmedBalance` and
- * `breakdown` with confirmed fields are returned. When `includePending` is true,
- * `totalPendingBalance` is present and breakdown entries include pending amounts
- * and `pendingTransactions` per chain.
+ * This interface maps operation types to their parameter structures for
+ * compile-time validation in shared AppKit helpers.
+ *
+ * @remarks `earn` is included so consumers can refer to the full EarnKit
+ * operation-parameter union through AppKit types. Developer fee hooks
+ * intentionally use {@link FeeOperationType}, so they do not accept earn
+ * parameters until EarnKit supports fee-bearing requests.
  *
  * @example
  * ```typescript
- * import type { GetBalancesResult } from '@circle-fin/unified-balance-kit'
- *
- * // includePending: false
- * const result: GetBalancesResult = {
- *   token: 'USDC',
- *   totalConfirmedBalance: '3500.00',
- *   breakdown: [
- *     {
- *       depositor: '0xAAAd67…',
- *       totalConfirmed: '2500.00',
- *       breakdown: [
- *         { chain: 'Arbitrum', confirmedBalance: '1500.00' },
- *         { chain: 'Optimism', confirmedBalance: '1000.00' },
- *       ],
- *     },
- *   ],
- * }
- *
- * // includePending: true
- * const resultWithPending: GetBalancesResult = {
- *   token: 'USDC',
- *   totalConfirmedBalance: '3500.00',
- *   totalPendingBalance: '650.00',
- *   breakdown: [
- *     {
- *       depositor: '0x71C765…',
- *       totalConfirmed: '1000.00',
- *       totalPending: '50.00',
- *       breakdown: [
- *         {
- *           chain: 'Ethereum',
- *           confirmedBalance: '1000.00',
- *           pendingBalance: '50.00',
- *           pendingTransactions: [
- *             { transactionHash: '0x2c5f3e…', amount: '50.00', blockTimestamp: '2023-11-07T05:31:56Z' },
- *           ],
- *         },
- *       ],
- *     },
- *   ],
- * }
+ * // TypeScript will enforce that bridge operations use BridgeParams
+ * type BridgeParamsType = OperationParamsMap['bridge'] // BridgeParams
+ * // TypeScript will enforce that swap operations use SwapParams
+ * type SwapParamsType = OperationParamsMap['swap'] // SwapParams
+ * // TypeScript will enforce that earn operations use EarnOperationParams
+ * type EarnParamsType = OperationParamsMap['earn'] // EarnOperationParams
  * ```
  */
-interface GetBalancesResult {
-    /** Token that was queried. */
-    token: SupportedToken;
-    /** Total confirmed balance across all accounts and chains (human-readable decimal string). */
-    totalConfirmedBalance: string;
-    /**
-     * Total pending balance across all accounts and chains.
-     * Present only when `includePending` is true.
-     */
-    totalPendingBalance?: string;
-    /** Per-account, per-chain breakdown. */
-    breakdown: BalanceWithPendingBreakdown[];
+interface OperationParamsMap {
+    bridge: BridgeParams;
+    swap: SwapParams;
+    earn: EarnOperationParams;
 }
-
 /**
- * Parameters for adding or removing a delegate on a Gateway account.
- *
- * @remarks
- * Delegation allows a different signer to move funds out of the
- * owner's account.  The delegate must be added explicitly per chain.
+ * Operation-scoped custom fee policies configured at the AppKit level.
  *
- * @typeParam TAdapterCapabilities - Adapter capability constraints.
- * @typeParam TChainIdentifier - Accepted chain identifier type.
+ * Each property is optional so consumers can enable custom fees only for the
+ * operation they use. AppKit forwards the supplied policy to the matching
+ * underlying kit when that operation runs.
  *
  * @example
  * ```typescript
- * import type { UpdateDelegateParams } from '@circle-fin/unified-balance-kit'
- *
- * const params: UpdateDelegateParams = {
- *   from: { adapter: evmAdapter, chain: 'Ethereum' },
- *   delegateAddress: '0xDELEGATE…1111',
+ * const policy: AppKitCustomFeePolicy = {
+ *   bridge: {
+ *     computeFee: () => '1.00',
+ *     resolveFeeRecipientAddress: () => '0x1234567890123456789012345678901234567890',
+ *   },
  * }
  * ```
  */
-interface UpdateDelegateParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
-    /**
-     * The owner's adapter context identifying the account and chain
-     * to which the delegate will be authorized.
-     */
-    from: AdapterContext<TAdapterCapabilities, TChainIdentifier>;
-    /**
-     * The address being added or removed as an authorized delegate.
-     */
-    delegateAddress: string;
-    /**
-     * The token for which delegation applies.
-     * Accepts any case (e.g. `'usdc'`, `'Usdc'`); normalised to uppercase internally.
-     *
-     * @defaultValue 'USDC'
-     */
-    token?: SupportedTokenInput;
+interface AppKitCustomFeePolicy {
+    /** Custom fee policy forwarded to BridgeKit bridge operations. */
+    bridge?: CustomFeePolicy$2;
+    /** Custom fee policy forwarded to SwapKit swap operations. */
+    swap?: CustomFeePolicy$1;
+    /** Custom fee policy forwarded to UnifiedBalanceKit spend operations. */
+    unifiedBalance?: CustomFeePolicy;
 }
 /**
- * Result returned after a successful add or remove delegate
- * operation.
+ * Operation name whose AppKit-level custom fee policy can be removed.
  *
  * @example
  * ```typescript
- * import type { UpdateDelegateResult } from '@circle-fin/unified-balance-kit'
- *
- * const result: UpdateDelegateResult = {
- *   account: '0xOWNER…1234',
- *   delegateAddress: '0xDELEGATE…1111',
- *   chain: 'Ethereum',
- *   state: 'added',
- *   txHash: '0xabc…',
- *   explorerUrl: 'https://etherscan.io/tx/0xabc…',
- * }
+ * const operation: AppKitCustomFeePolicyScope = 'bridge'
  * ```
  */
-interface UpdateDelegateResult {
-    /** The Gateway account that was modified. */
-    account: string;
-    /** The delegate address that was added or removed. */
-    delegateAddress: string;
-    /**
-     * The chain on which the delegate was updated.
-     *
-     * @remarks
-     * Delegates must be added explicitly per chain.  You cannot
-     * authorize a delegate for all chains at once.
-     */
-    chain: Blockchain;
-    /** Whether the delegate was added or removed. */
-    state: 'added' | 'removed';
-    /**
-     * Unique identifier returned by the blockchain once the
-     * transaction is mined.
-     */
-    txHash: string;
-    /**
-     * Link to view the transaction details on the appropriate
-     * blockchain explorer.
-     *
-     * @remarks
-     * May be `undefined` when the explorer URL cannot be resolved
-     * for the chain.
-     */
-    explorerUrl?: string;
-}
+type AppKitCustomFeePolicyScope = keyof AppKitCustomFeePolicy;
 /**
- * The finality-aware status of a delegate on a Gateway account.
+ * Context interface for the AppKit with strongly typed getFee method.
  *
- * - `'none'`    — not a delegate on-chain.
- * - `'pending'` — delegate set on-chain but Gateway hasn't finalized it yet;
- *                 spend will fail until the status advances to `'ready'`.
- * - `'ready'`   — finalized at Gateway; spend will succeed.
- */
-type DelegateStatus = 'none' | 'pending' | 'ready';
-/**
- * Parameters for checking the delegate status of an address on a
- * Gateway account.
+ * This interface uses TypeScript function overloads to provide type-safe
+ * parameter validation based on the operation type. Each operation type
+ * maps to specific parameter types, ensuring compile-time safety and
+ * excellent developer experience with full IntelliSense support.
  *
- * @typeParam TAdapterCapabilities - Adapter capability constraints.
- * @typeParam TChainIdentifier - Accepted chain identifier type.
+ * The interface supports both direct operation-specific overloads and a
+ * generic overload for advanced use cases while maintaining type safety.
  *
  * @example
  * ```typescript
- * import type { GetDelegateStatusParams } from '@circle-fin/unified-balance-kit'
- *
- * const params: GetDelegateStatusParams = {
- *   from: { adapter: evmAdapter, chain: 'Ethereum' },
- *   delegateAddress: '0xDELEGATE…1111',
- * }
+ * // Bridge operation - uses BridgeParams
+ * const bridgeFee = await context.getFee('bridge', {
+ *   from: { adapter: sourceAdapter, chain: 'Ethereum' },
+ *   to: { adapter: destAdapter, chain: 'Polygon' },
+ *   amount: '100.50'
+ * })
  * ```
  */
-interface GetDelegateStatusParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
-    /** The adapter context identifying the account owner and chain. */
-    from: AdapterContext<TAdapterCapabilities, TChainIdentifier>;
-    /** The address to check for delegate status. */
-    delegateAddress: string;
+interface AppKitContext {
     /**
-     * The token for which delegation is checked.
-     * Accepts any case (e.g. `'usdc'`, `'Usdc'`); normalised to uppercase internally.
+     * Get fee estimation for bridge or swap operations.
      *
-     * @defaultValue 'USDC'
+     * Calculate the estimated fees for cross-chain bridge transfers, same-chain
+     * token swaps. Returns the fee amount in smallest token units.
+     *
+     * The function signature uses TypeScript's generic constraint pattern to ensure
+     * type safety: when type is 'bridge', params must be BridgeParams; when type
+     * is 'swap', params must be SwapParams.
+     *
+     * @typeParam T - The fee operation type ('bridge' | 'swap')
+     * @param type - Operation type: 'bridge' for cross-chain transfers, 'swap' for same-chain swaps
+     * @param params - Operation-specific parameters matching the type
+     * @returns Promise resolving to fee amount as string in smallest token units
+     * @throws {@link ValidationError} If operation parameters are invalid
+     * @throws {@link UnsupportedRouteError} If the operation route is not supported
+     *
+     * @example
+     * ```typescript
+     * // Bridge fee
+     * const bridgeFee = await context.getFee?.('bridge', bridgeParams)
+     *
+     * // Swap fee
+     * const swapFee = await context.getFee?.('swap', swapParams)
+     *
+     * // Generic usage
+     * function estimateFee<T extends FeeOperationType>(
+     *   operation: T,
+     *   params: OperationParamsMap[T]
+     * ) {
+     *   return context.getFee(operation, params) // Fully type-safe
+     * }
+     * ```
      */
-    token?: SupportedTokenInput;
+    getFee?<T extends FeeOperationType>(type: T, params: OperationParamsMap[T]): Promise<string>;
+    /**
+     * Get the fee recipient address for a specific operation and chain.
+     *
+     * This method returns the address that will receive protocol fees for
+     * the specified operation type on the given chain. Useful for transparency
+     * and fee tracking purposes.
+     *
+     * @remarks When this hook is used for bridging operations, the `params` object within `info` will be empty.
+     * This is due to a limitation in the underlying `BridgeKit`, which does not provide bridge parameters
+     * to its fee recipient hook.
+     *
+     * @typeParam T - The fee operation type ('bridge' | 'swap')
+     * @param type - The specific operation type
+     * @param info - Object containing chain and parameter information
+     * @returns Promise resolving to the fee recipient address
+     * @throws {@link ValidationError} If parameters are invalid
+     * @throws {@link UnsupportedChainError} If the chain is not supported
+     *
+     * @example
+     * ```typescript
+     * const recipient = await context.getFeeRecipient('bridge', {
+     *   chain: ethereumChain,
+     *   params: bridgeParams
+     * })
+     * ```
+     */
+    getFeeRecipient?<T extends FeeOperationType>(type: T, info: {
+        chain: ChainDefinition;
+        params: OperationParamsMap[T];
+    }): Promise<string>;
+    /**
+     * Operation-scoped custom fee policies.
+     *
+     * Prefer {@link AppKit.setCustomFeePolicy} for runtime configuration. This
+     * context property is read by the internal kit factories when AppKit creates
+     * BridgeKit and SwapKit instances for each operation.
+     */
+    customFeePolicy?: AppKitCustomFeePolicy;
+    /**
+     * Event handlers registered for AppKit operations.
+     *
+     * This property stores event handlers that are registered via the AppKit's
+     * `on()` method. Handlers are grouped by operation type. The runtime buckets
+     * are `bridge` and `earn`; the context can add more operation buckets as
+     * AppKit wires action handlers for additional kits.
+     *
+     * Within each operation bucket, handlers are keyed by action name (for
+     * example, `bridge.approve` or `earn.deposit`) or `*` for wildcard handlers.
+     * Each action can have multiple handlers registered, allowing multiple
+     * subscribers to listen to the same event.
+     *
+     * The handlers are stored in the context to allow deferred registration with
+     * underlying operation kits, enabling a clean separation between event
+     * registration and operation execution.
+     *
+     * @example
+     * ```typescript
+     * const context = createContext()
+     * // Handlers registered via kit.on() are stored by operation type
+     * // Bridge handlers are registered with BridgeKit when bridge() runs
+     * // Earn handlers are registered with EarnKit when earn operations run
+     * ```
+     */
+    actions: Record<'bridge' | 'earn', Record<string, ((payload: unknown) => void)[]>>;
+    /**
+     * Disable success analytics for the underlying EarnKit, SwapKit, and
+     * UnifiedBalanceKit.
+     *
+     * When `true`, completed earn, swap, and unified balance operations will not
+     * POST analytics events. This does not disable error reporting; use
+     * {@link AppKitContext.disableErrorReporting} for that. Defaults to `false`.
+     *
+     * @defaultValue false
+     */
+    disableAnalytics?: boolean;
+    /**
+     * Disable error telemetry for all sub-kits.
+     *
+     * When `true`, none of the underlying kits (BridgeKit, SwapKit, EarnKit,
+     * UnifiedBalanceKit) will POST error details to the telemetry
+     * endpoint when operations throw. Defaults to `false` (enabled).
+     *
+     * @defaultValue false
+     */
+    disableErrorReporting?: boolean;
+    /**
+     * Custom HTTP headers forwarded with the underlying CCTP provider's
+     * attestation (Iris) API requests made by bridge operations.
+     *
+     * @remarks
+     * Headers are merged on top of the SDK defaults (such as `Content-Type`)
+     * rather than replacing them. The header is forwarded as-is to Circle's API;
+     * the SDK does not interpret it.
+     */
+    headers?: Record<string, string>;
 }
-
 /**
- * Parameters for initiating a delayed recovery fund removal from a Gateway
- * account.
- *
- * @remarks
- * Use fund removal only as a trustless fallback when the normal spend flow is
- * unavailable. For day-to-day movement out of a Unified Balance, use `spend`.
- *
- * Fund removals have a mandatory 7-day delay before they can be
- * completed.  Only one removal may be pending per chain at a
- * time.  Initiating a second removal on the same chain adds the
- * requested amount to the existing pending removal and restarts
- * the 7-day timer.
+ * Earn operation namespace exposed as `kit.earn`.
  *
- * @typeParam TAdapterCapabilities - Adapter capability constraints.
- * @typeParam TChainIdentifier - Accepted chain identifier type.
+ * Mirrors the operations currently available from `@circle-fin/earn-kit`.
+ * Step events use the AppKit event API (`kit.on('earn.*')` / `kit.on('*')`).
  *
  * @example
  * ```typescript
- * import type { InitiateRemoveFundParams } from '@circle-fin/unified-balance-kit'
+ * import { AppKit, EarnChain } from '@circle-fin/app-kit'
  *
- * const params: InitiateRemoveFundParams = {
- *   from: { adapter: evmAdapter, chain: 'Ethereum' },
- *   amount: '100',
- * }
+ * const kit = new AppKit()
+ *
+ * const result = await kit.earn.deposit({
+ *   from: { adapter, chain: EarnChain.Arc_Testnet },
+ *   vaultAddress: '0x...',
+ *   amount: '100.50',
+ * })
  * ```
  */
-interface InitiateRemoveFundParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
+interface AppKitEarnOperations {
     /**
-     * The account owner's adapter context identifying the account,
-     * chain, and address.
+     * Deposit into an earn vault.
+     *
+     * @param params - Deposit parameters
+     * @returns Promise resolving to the deposit result
+     * @throws If validation, provider lookup, or transaction execution fails
+     *
+     * @example
+     * ```typescript
+     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
+     *
+     * const kit = new AppKit()
+     * const result = await kit.earn.deposit({
+     *   from: { adapter, chain: EarnChain.Arc_Testnet },
+     *   vaultAddress: '0x...',
+     *   amount: '100.50',
+     * })
+     * ```
      */
-    from: AdapterContext<TAdapterCapabilities, TChainIdentifier>;
-    /** The amount to remove (human-readable decimal string). */
-    amount: string;
+    deposit<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: SameChainDepositParams<TFromAdapterCapabilities>): Promise<EarnSameChainDepositResult>;
     /**
-     * The token to remove.
-     * Accepts any case (e.g. `'usdc'`, `'Usdc'`); normalised to uppercase internally.
-     * @defaultValue 'USDC'
+     * Deposit into an earn vault from another chain through the bridge flow.
+     *
+     * @param params - Cross-chain deposit parameters
+     * @returns Promise resolving to the bridge submission details
+     * @throws If validation, provider lookup, or the bridge flow fails
      */
-    token?: SupportedTokenInput;
-}
-/**
- * Result returned after successfully initiating a fund removal.
- *
- * @example
- * ```typescript
- * import type { InitiateRemoveFundResult } from '@circle-fin/unified-balance-kit'
- *
- * const result: InitiateRemoveFundResult = {
- *   amount: '100',
- *   token: 'USDC',
- *   account: '0xOWNER…1234',
- *   chain: 'Ethereum',
- *   withdrawingBalance: '100',
- *   withdrawalBlock: 19_500_000,
- *   txHash: '0xabc…',
- *   explorerUrl: 'https://etherscan.io/tx/0xabc…',
- * }
- * ```
- */
-interface InitiateRemoveFundResult {
-    /** The amount requested for removal. */
-    amount: string;
-    /** The token type (always USDC). */
-    token: SupportedToken;
-    /** The Gateway account from which this removal will occur. */
-    account: string;
-    /** The chain on which this removal was initiated. */
-    chain: Blockchain;
-    /** The balance currently in the withdrawing state for this account. */
-    withdrawingBalance: string;
-    /** The block number at which the removal can be completed. */
-    withdrawalBlock: number;
+    deposit<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: CrossChainDepositParams<TFromAdapterCapabilities>): Promise<EarnCrossChainDepositResult>;
     /**
-     * Unique identifier returned by the blockchain once the
-     * transaction is mined.
+     * Deposit into an earn vault, on the same chain or cross-chain.
+     *
+     * @param params - Deposit parameters
+     * @returns Promise resolving to same-chain transaction details or
+     *   cross-chain submission details
+     * @throws If validation, provider lookup, or execution fails
      */
-    txHash: string;
+    deposit<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: AnyDepositParams<TFromAdapterCapabilities>): Promise<EarnDepositOutcome>;
     /**
-     * Link to view the transaction details on the appropriate
-     * blockchain explorer.
+     * Withdraw from an earn vault.
+     *
+     * @param params - Withdrawal parameters
+     * @returns Promise resolving to the withdrawal result
+     * @throws If validation, provider lookup, or transaction execution fails
+     *
+     * @example
+     * ```typescript
+     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
+     *
+     * const kit = new AppKit()
+     * const result = await kit.earn.withdraw({
+     *   from: { adapter, chain: EarnChain.Arc_Testnet },
+     *   vaultAddress: '0x...',
+     *   amount: '50.00',
+     * })
+     * ```
+     */
+    withdraw<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: WithdrawParams<TFromAdapterCapabilities>): Promise<EarnWithdrawResult>;
+    /**
+     * Claim available earn rewards.
+     *
+     * @param params - Claim rewards parameters
+     * @returns Promise resolving to the claim rewards result
+     * @throws If validation, provider lookup, or transaction execution fails
+     *
+     * @example
+     * ```typescript
+     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
+     *
+     * const kit = new AppKit()
+     * const result = await kit.earn.claimRewards({
+     *   from: { adapter, chain: EarnChain.Arc_Testnet },
+     *   vaultAddress: '0x...',
+     * })
+     * ```
+     *
+     * @internal
+     */
+    claimRewards<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: ClaimRewardsParams<TFromAdapterCapabilities>): Promise<EarnClaimRewardsResult>;
+    /**
+     * Fetch earn vault information.
+     *
+     * @param params - Vault query parameters
+     * @returns Promise resolving to vault data and per-vault errors
+     * @throws If validation or provider lookup fails
+     *
+     * @example
+     * ```typescript
+     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
+     *
+     * const kit = new AppKit()
+     * const result = await kit.earn.getVaults({
+     *   vaults: [{ chain: EarnChain.Arc_Testnet, vaultAddress: '0x...' }],
+     * })
+     * ```
+     */
+    getVaults(params: GetVaultsParams): Promise<EarnGetVaultsResult>;
+    /**
+     * Discover earn vaults available on a chain.
+     *
+     * @param params - Discovery parameters with chain and optional filters
+     * @returns Promise resolving to matching vaults with pagination metadata
+     * @throws If validation or provider lookup fails
+     *
+     * @example
+     * ```typescript
+     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
+     *
+     * const kit = new AppKit()
+     * const result = await kit.earn.exploreVaults({
+     *   chain: EarnChain.Arc_Testnet,
+     *   minApy: '0.03',
+     *   sortBy: 'apy',
+     * })
+     * ```
+     */
+    exploreVaults(params: ExploreVaultsParams): Promise<EarnExploreVaultsResult>;
+    /**
+     * Lazily iterate every earn vault available on a chain.
+     *
+     * @param params - Discovery parameters (no `page`; the iterator manages it)
+     * @returns An async generator yielding each matching vault
+     * @throws If validation or provider lookup fails
+     *
+     * @example
+     * ```typescript
+     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
+     *
+     * const kit = new AppKit()
+     * for await (const vault of kit.earn.exploreVaultsIterator({
+     *   chain: EarnChain.Arc_Testnet,
+     * })) {
+     *   console.log(vault.name)
+     * }
+     * ```
+     */
+    exploreVaultsIterator(params: ExploreVaultsIteratorParams): AsyncGenerator<EarnVaultInfo, void, undefined>;
+    /**
+     * Fetch wallet position information for an earn vault.
+     *
+     * @param params - Position query parameters
+     * @returns Promise resolving to position information
+     * @throws If validation or provider lookup fails
+     *
+     * @example
+     * ```typescript
+     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
+     *
+     * const kit = new AppKit()
+     * const position = await kit.earn.getPosition({
+     *   from: { adapter, chain: EarnChain.Arc_Testnet },
+     *   vaultAddress: '0x...',
+     * })
+     * ```
+     */
+    getPosition<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: GetPositionParams<TFromAdapterCapabilities>): Promise<EarnPositionInfo>;
+    /**
+     * Fetch the current status of a cross-chain Earn deposit.
+     *
+     * @param params - Status query parameters identifying the deposit by execId
+     * @returns Promise resolving to the structured cross-chain deposit status
+     * @throws If validation, provider lookup, or the status request fails
+     */
+    getCrossChainDepositStatus(params: GetCrossChainDepositStatusParams): Promise<EarnCrossChainDepositStatus>;
+    /**
+     * Poll a cross-chain Earn deposit until it reaches a terminal bridge state.
+     *
+     * @param params - Wait parameters including execId and optional polling knobs
+     * @returns Promise resolving to the wait result and last observed bridge status
+     * @throws If validation, provider lookup, or a status request fails
+     */
+    waitForCrossChainDeposit(params: WaitForCrossChainDepositParams): Promise<EarnCrossChainDepositWaitResult>;
+    /**
+     * Fetch a deposit quote.
+     *
+     * @param params - Deposit quote parameters
+     * @returns Promise resolving to deposit quote information
+     * @throws If validation or provider lookup fails
+     *
+     * @example
+     * ```typescript
+     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
+     *
+     * const kit = new AppKit()
+     * const quote = await kit.earn.getDepositQuote({
+     *   from: { adapter, chain: EarnChain.Arc_Testnet },
+     *   vaultAddress: '0x...',
+     *   amount: '100.50',
+     * })
+     * ```
+     */
+    getDepositQuote<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: GetDepositQuoteParams<TFromAdapterCapabilities>): Promise<EarnDepositQuoteInfo>;
+    /**
+     * Fetch a withdrawal quote.
+     *
+     * @param params - Withdrawal quote parameters
+     * @returns Promise resolving to withdrawal quote information
+     * @throws If validation or provider lookup fails
+     *
+     * @example
+     * ```typescript
+     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
+     *
+     * const kit = new AppKit()
+     * const quote = await kit.earn.getWithdrawalQuote({
+     *   from: { adapter, chain: EarnChain.Arc_Testnet },
+     *   vaultAddress: '0x...',
+     *   amount: '50.00',
+     * })
+     * ```
+     */
+    getWithdrawalQuote<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: GetWithdrawalQuoteParams<TFromAdapterCapabilities>): Promise<EarnWithdrawalQuoteInfo>;
+    /**
+     * Fetch a claim rewards quote.
+     *
+     * @param params - Claim rewards quote parameters
+     * @returns Promise resolving to claim rewards quote information
+     * @throws If validation or provider lookup fails
+     *
+     * @example
+     * ```typescript
+     * import { AppKit, EarnChain } from '@circle-fin/app-kit'
+     *
+     * const kit = new AppKit()
+     * const quote = await kit.earn.getClaimRewardsQuote({
+     *   from: { adapter, chain: EarnChain.Arc_Testnet },
+     *   vaultAddress: '0x...',
+     * })
+     * ```
+     *
+     * @internal
+     */
+    getClaimRewardsQuote<TFromAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities>(params: GetClaimRewardsQuoteParams<TFromAdapterCapabilities>): Promise<EarnClaimRewardsQuoteInfo>;
+    /**
+     * Resume a multi-phase earn operation that previously failed.
+     *
+     * Pass the {@link KitError} caught from `deposit`, `withdraw`, or
+     * `claimRewards`. The error carries the original inputs and step
+     * progress, so completed phases (for example a successful token
+     * approval) can be skipped. Call `isRetryableError(error)` first.
+     *
+     * @remarks
+     * Retry re-fetches execution params and may re-submit the execute
+     * transaction. Treat this as best-effort recovery: if a prior attempt
+     * broadcast execute but failed before observing the receipt, that
+     * transaction may still be in flight.
+     *
+     * @param error - The error caught from a previous multi-phase earn operation
+     * @returns Promise resolving to the result of the resumed operation
+     * @throws If the error is not retryable or lacks earn retry context
+     *
+     * @example
+     * ```typescript
+     * import { AppKit, isRetryableError } from '@circle-fin/app-kit'
      *
-     * @remarks
-     * May be `undefined` when the explorer URL cannot be resolved
-     * for the chain.
+     * const kit = new AppKit()
+     *
+     * try {
+     *   await kit.earn.deposit(params)
+     * } catch (error) {
+     *   if (isRetryableError(error)) {
+     *     const result = await kit.earn.retry(error)
+     *   }
+     * }
+     * ```
      */
-    explorerUrl?: string;
+    retry(error: unknown): Promise<EarnDepositOutcome | EarnWithdrawResult | EarnClaimRewardsResult>;
 }
 /**
- * Parameters for completing a recovery fund removal after the withdrawal
- * delay.
+ * Type for event handler functions that can be registered with the AppKit.
  *
- * @remarks
- * Use fund removal only as a trustless fallback when the normal spend flow is
- * unavailable. For day-to-day movement out of a Unified Balance, use `spend`.
+ * This type extracts the handler function type from the `on` method parameters,
+ * ensuring that event handlers have the correct signature and payload types.
+ * It enables type-safe event handling by preserving the specific payload types
+ * for each action.
  *
- * @typeParam TAdapterCapabilities - Adapter capability constraints.
- * @typeParam TChainIdentifier - Accepted chain identifier type.
+ * Uses a structural type constraint to avoid circular dependencies while still
+ * providing full type safety when used with an AppKit instance.
+ *
+ * @typeParam T - A type that has an `on` method matching AppKit's signature
+ * @returns The function type for event handlers with proper payload typing
  *
  * @example
  * ```typescript
- * import type { RemoveFundParams } from '@circle-fin/unified-balance-kit'
+ * import { AppKit, ActionHandler } from '@circle-fin/app-kit'
  *
- * const params: RemoveFundParams = {
- *   from: { adapter: evmAdapter, chain: 'Ethereum' },
+ * const kit = new AppKit()
+ *
+ * // ActionHandler will be the correct function type for handlers
+ * const handler: ActionHandler<typeof kit> = (payload) => {
+ *   // payload is properly typed based on the action
  * }
  * ```
  */
-interface RemoveFundParams<TAdapterCapabilities extends AdapterCapabilities = AdapterCapabilities, TChainIdentifier extends UnifiedBalanceChainIdentifier = UnifiedBalanceChainIdentifier> {
-    /**
-     * The account owner's adapter context.  Must match the one
-     * used when initiating the fund removal.
-     */
-    from: AdapterContext<TAdapterCapabilities, TChainIdentifier>;
-    /**
-     * The token to remove.
-     * Accepts any case (e.g. `'usdc'`, `'Usdc'`); normalised to uppercase internally.
-     *
-     * @defaultValue 'USDC'
-     */
-    token?: SupportedTokenInput;
-}
+type ActionHandler<T extends {
+    on: (action: string, handler: (payload: unknown) => void) => void;
+}> = Parameters<T['on']>[1];
 /**
- * Result returned after successfully completing a fund removal.
+ * Parameters for sending USDC, USDT, native tokens, or custom ERC-20/SPL tokens.
+ *
+ * This interface is the canonical input for send operations in App Kit. It supports
+ * sending to either a destination {@link Adapter} (recipient derives from the adapter's
+ * default account) or an explicit recipient `string` address.
+ *
+ * - The `from` field provides the source signing context and chain.
+ * - The `to` field identifies the destination as an adapter or an explicit address.
+ * - The `amount` field is a human-readable decimal string (for example, `'10.5'`).
+ * - The `token` field selects the asset to move and defaults to `'USDC'`.
+ *
+ * @remarks
+ * When `to` is a `string`, the address must be a valid address. When `to` is an
+ * {@link Adapter}, the recipient is derived from the adapter's active account.
+ *
+ * The `token` field accepts both supported token aliases ('USDC', 'USDT', 'NATIVE', 'EURC') and custom token
+ * contract addresses.
  *
  * @example
  * ```typescript
- * import type { RemoveFundResult } from '@circle-fin/unified-balance-kit'
+ * // Send USDC to a recipient adapter (address derived on-chain)
+ * const params: SendParams = {
+ *   from: { adapter: sourceAdapter, chain: 'Ethereum' },
+ *   to: recipientAdapter,
+ *   amount: '10.5',
+ *   token: 'USDC'
+ * }
  *
- * const result: RemoveFundResult = {
- *   amount: '100',
- *   token: 'USDC',
- *   account: '0xOWNER…1234',
- *   chain: 'Ethereum',
- *   txHash: '0xdef…',
- *   explorerUrl: 'https://etherscan.io/tx/0xdef…',
+ * // Send using a custom token address (DAI on Ethereum)
+ * const paramsCustomToken: SendParams = {
+ *   from: { adapter: sourceAdapter, chain: 'Ethereum' },
+ *   to: '0x1234...abcd',
+ *   amount: '100.0',
+ *   token: '0x6B175474E89094C44Da98b954EedeAC495271d0F'
  * }
  * ```
  */
-interface RemoveFundResult {
-    /** The final removed amount. */
-    amount: string;
-    /** The token type (always USDC). */
-    token: SupportedToken;
-    /** The Gateway account from which the tokens were removed. */
-    account: string;
-    /** The chain on which the removal occurred. */
-    chain: Blockchain;
+interface SendParams {
     /**
-     * Unique identifier returned by the blockchain once the
-     * transaction is mined.
+     * The source adapter context (wallet and chain) for the transfer.
      */
-    txHash: string;
+    from: AdapterContext;
     /**
-     * Link to view the transaction details on the appropriate
-     * blockchain explorer.
+     * The destination for the transfer, supporting explicit or derived recipient addresses.
+     */
+    to: Adapter | string;
+    /**
+     * The amount to transfer.
+     */
+    amount: string;
+    /**
+     * The token to transfer. Defaults to 'USDC'.
+     * If omitted, the provider will use 'USDC' by default.
      *
-     * @remarks
-     * May be `undefined` when the explorer URL cannot be resolved
-     * for the chain.
+     * Supports both known aliases and custom token contract addresses:
+     * - Known aliases: 'USDC', 'USDT', 'NATIVE', 'EURC' ('EURC' requires the
+     *   chain to have an `eurcAddress` configured)
+     * - Custom token addresses: EVM addresses or Solana SPL token mint addresses
+     *
+     * @example
+     * ```typescript
+     * // Using an alias
+     * token: 'USDC'
+     *
+     * // Using a custom ERC-20 address (DAI on Ethereum)
+     * token: '0x6B175474E89094C44Da98b954EedeAC495271d0F'
+     *
+     * // Using a custom SPL token mint (Solana)
+     * token: 'So11111111111111111111111111111111111111112'
+     * ```
      */
-    explorerUrl?: string;
+    token?: TokenAlias | TokenAddress;
 }
+/**
+ * Extract action types from BridgeKit's actionDispatcher.
+ *
+ * This utility type extracts the action map type from a BridgeKit instance
+ * by inspecting its actionDispatcher property.
+ *
+ * @typeParam T - The BridgeKit instance type
+ */
+type ExtractBridgeKitActions<T extends BridgeKit> = T extends BridgeKit ? T['actionDispatcher'] extends Actionable<infer Actions> ? Actions : never : never;
+/**
+ * Prefix action names with a namespace.
+ *
+ * Transforms an action map by prefixing all keys with the specified namespace.
+ * For example, `{ approve: Payload }` becomes `{ 'bridge.approve': Payload }`.
+ *
+ * @typeParam Actions - The original action map
+ * @typeParam Prefix - The prefix to apply (e.g., 'bridge')
+ */
+type PrefixActions<Prefix extends string, Actions> = {
+    [K in keyof Actions as K extends string ? `${Prefix}.${K}` : never]: Actions[K];
+};
+/**
+ * Default BridgeKit instance type (no extra providers).
+ */
+type DefaultBridgeKit = BridgeKit;
+/**
+ * Extract actions from default BridgeKit.
+ */
+type DefaultBridgeKitActions = ExtractBridgeKitActions<DefaultBridgeKit>;
+/**
+ * Prefixed bridge actions for AppKit.
+ *
+ * All BridgeKit events are prefixed with 'bridge.' to namespace them
+ * within the AppKit event system.
+ */
+type AppKitBridgeActions = PrefixActions<'bridge', DefaultBridgeKitActions>;
+/**
+ * Prefixed unified balance actions for AppKit.
+ *
+ * All UnifiedBalanceKit (Gateway) events are prefixed with 'unifiedBalance.'
+ * to namespace them within the AppKit event system.
+ */
+type AppKitUnifiedBalanceActions = PrefixActions<'unifiedBalance', GatewayV1Actions>;
+/**
+ * Prefixed earn actions for AppKit.
+ *
+ * Earn step events are exposed under the `earn.` namespace (for example
+ * `earn.deposit`, `earn.approve`, `earn.withdraw`) so they can be
+ * subscribed to via `kit.on()` alongside bridge and unified balance
+ * events.
+ */
+type AppKitEarnActions = PrefixActions<'earn', EarnActions>;
+/**
+ * Union of all AppKit action names.
+ */
+type AppKitActionName = keyof AppKitBridgeActions | keyof AppKitUnifiedBalanceActions | keyof AppKitEarnActions;
+/**
+ * All actions available in AppKit.
+ */
+type AppKitActions = AppKitBridgeActions & AppKitUnifiedBalanceActions & AppKitEarnActions;
 
 /**
- * Options for filtering supported chains.
+ * Parameters for creating a AppKit context.
+ *
+ * This type allows partial customization of the context while ensuring
+ * that all required properties have sensible defaults. Users can override
+ * specific methods while keeping the rest intact. Action handler buckets
+ * may also be supplied partially; missing buckets default to empty maps.
+ *
+ * @example
+ * ```typescript
+ * const customContext = createContext({
+ *   getFee: async (type, params) => {
+ *     // Custom fee calculation logic
+ *     return { totalFee: '0.05', networkFee: '0.05' }
+ *   }
+ * })
+ * ```
  */
-interface GetSupportedChainsOptions {
-    /**
-     * Filter chains by forwarder support. When set, only chains whose
-     * `gateway.forwarderSupported.source` or `gateway.forwarderSupported.destination`
-     * matches the specified value are returned.
-     *
-     * - `undefined` (default) — no forwarder filtering; all supported chains are returned.
-     * - `'source'` — only chains that support forwarding as a source.
-     * - `'destination'` — only chains that support forwarding as a destination.
-     */
-    forwarderSupported?: 'source' | 'destination';
-}
+type CreateContextParams = Omit<Partial<AppKitContext>, 'actions'> & {
+    actions?: Partial<AppKitContext['actions']>;
+};
 
 /**
  * Namespace object that exposes UnifiedBalanceKit operations through AppKit.
@@ -27679,6 +28295,46 @@ declare class AppKit {
      * ```
      */
     getSupportedChains(operationType?: OperationType): ChainDefinition[];
+    /**
+     * Set operation-scoped custom fee policies.
+     *
+     * Configure custom fees for only the operations that need them. Bridge and
+     * swap policies are forwarded to the underlying kits when those operations
+     * run. Unified balance policies are applied immediately to the namespaced
+     * Unified Balance Kit.
+     *
+     * @param policy - Partial custom fee policy grouped by operation.
+     * @returns Nothing.
+     * @throws \{KitError\} If `policy` or a provided operation policy is invalid.
+     *
+     * @example
+     * ```typescript
+     * kit.setCustomFeePolicy({
+     *   bridge: {
+     *     computeFee: () => '1.00',
+     *     resolveFeeRecipientAddress: () => '0x1234567890123456789012345678901234567890',
+     *   },
+     * })
+     * ```
+     */
+    setCustomFeePolicy(policy: AppKitCustomFeePolicy): void;
+    /**
+     * Remove an AppKit-level custom fee policy for one operation.
+     *
+     * Bridge and swap policies are removed from AppKit's persistent context so
+     * future operations fall back to legacy fee hooks. Unified balance policies
+     * are also removed from the namespaced Unified Balance Kit.
+     *
+     * @param operation - Operation whose custom fee policy should be removed.
+     * @returns Nothing.
+     * @throws \{KitError\} If `operation` is invalid.
+     *
+     * @example
+     * ```typescript
+     * kit.removeCustomFeePolicy('bridge')
+     * ```
+     */
+    removeCustomFeePolicy(operation: AppKitCustomFeePolicyScope): void;
     /**
      * Register an event handler for a specific AppKit action.
      *
@@ -27881,5 +28537,5 @@ declare function isTokenAddress(token: string, chain: ChainDefinition): token is
  */
 declare function validateToken(token: string, chain: ChainDefinition): TokenValidationResult;
 
-export { AppKit, AppKitUnifiedBalance, BalanceError, Blockchain, BridgeChain, EarnChain, EarnError, EarnKit, InputError, KitError, NetworkError, OnchainError, RateLimitError, RpcError, ServiceError, SwapChain, TOKEN_ALIASES, TransferSpeed, UnifiedBalanceChain, anyDepositParamsSchema, claimRewardsParamsSchema, createEarnKitContext, depositParamsSchema, claimRewards as earnClaimRewards, deposit as earnDeposit, exploreVaults as earnExploreVaults, exploreVaultsIterator as earnExploreVaultsIterator, getClaimRewardsQuote as earnGetClaimRewardsQuote, getCrossChainDepositStatus as earnGetCrossChainDepositStatus, getCrossChainDepositStatusOutcome as earnGetCrossChainDepositStatusOutcome, getDepositQuote as earnGetDepositQuote, getPosition as earnGetPosition, getSupportedChains as earnGetSupportedChains, getVaults as earnGetVaults, getWithdrawalQuote as earnGetWithdrawalQuote, waitForCrossChainDeposit as earnWaitForCrossChainDeposit, withdraw as earnWithdraw, exploreVaultsIteratorParamsSchema, exploreVaultsParamsSchema, getClaimRewardsQuoteParamsSchema, getCrossChainDepositStatusParamsSchema, getDepositQuoteParamsSchema, getErrorCode, getErrorMessage, getPositionParamsSchema, getTokenDecimals, getVaultsParamsSchema, getWithdrawalQuoteParamsSchema, isBalanceError, isFatalError, isInputError, isKitError, isNetworkError, isOnchainError, isRateLimitError, isRetryableError, isRpcError, isServiceError, isTerminalCrossChainDepositStatus as isTerminalEarnCrossChainDepositStatus, isTokenAddress, isTokenAlias, isUserCancellationError, setExternalPrefix, validateToken, waitForCrossChainDepositParamsSchema, withdrawParamsSchema };
-export type { ActionHandler, AdapterContext, AllowanceStrategy$2 as AllowanceStrategy, AppKitActionName, AppKitActions, AppKitBridgeActions, AppKitConfig, AppKitContext, AppKitEarnActions, AppKitEarnOperations, AppKitUnifiedBalanceActions, BaseChainDefinition, BridgeConfig, CustomFeePolicy$2 as BridgeCustomFeePolicy, BridgeParams, BridgeResult, BridgeStep, CCTPConfig, CCTPMergedConfig, CCTPSplitConfig, ChainDefinition, Currency, DelegateStatus, DepositForParams, DepositParams, DepositResult, DeveloperFeeHooks, EVMChainDefinition, EarnAccruedRewardInfo, EarnAdapterContext, AnyDepositParams as EarnAnyDepositParams, EarnAssetAmount, EarnBridgeCctpStatus, EarnBridgeHopStatus, EarnBridgeQuoteExpiry, ClaimRewardsParams as EarnClaimRewardsParams, EarnClaimRewardsQuoteInfo, EarnClaimRewardsResult, EarnClaimedAmount, EarnClaimedRewardsResult, EarnConfig, EarnCrossChainDepositDestination, CrossChainDepositParams as EarnCrossChainDepositParams, EarnCrossChainDepositResult, EarnCrossChainDepositStatus, EarnCrossChainDepositWaitOutcome, EarnCrossChainDepositWaitResult, CrossChainGetDepositQuoteParams as EarnCrossChainGetDepositQuoteParams, EarnDepositOutcome, DepositParams$2 as EarnDepositParams, EarnDepositQuoteInfo, EarnDepositResult, ExploreVaultsIteratorParams as EarnExploreVaultsIteratorParams, ExploreVaultsPagination as EarnExploreVaultsPagination, ExploreVaultsParams as EarnExploreVaultsParams, EarnExploreVaultsResult, ExploreVaultsSortBy as EarnExploreVaultsSortBy, EarnGasFeeEstimate, EarnGasFeeEstimateBase, GetClaimRewardsQuoteParams as EarnGetClaimRewardsQuoteParams, GetCrossChainDepositStatusParams as EarnGetCrossChainDepositStatusParams, GetDepositQuoteParams as EarnGetDepositQuoteParams, GetPositionParams as EarnGetPositionParams, GetVaultsParams as EarnGetVaultsParams, EarnGetVaultsResult, GetWithdrawalQuoteParams as EarnGetWithdrawalQuoteParams, EarnKitConfig, EarnKitContext, EarnOperationParams, EarnPositionInfo, EarnPositionPnLInfo, EarningProvider as EarnProvider, SameChainDepositParams as EarnSameChainDepositParams, EarnSameChainDepositResult, SameChainGetDepositQuoteParams as EarnSameChainGetDepositQuoteParams, EarnServiceConfig, EarnVaultInfo, VaultQuery as EarnVaultQuery, WaitForCrossChainDepositParams as EarnWaitForCrossChainDepositParams, WithdrawParams as EarnWithdrawParams, EarnWithdrawResult, EarnWithdrawalQuoteInfo, ErrorDetails, EstimateResult$1 as EstimateResult, EstimateSpendResult, EstimatedGas, FeeOperationType, GetBalancesParams, GetBalancesResult, GetDelegateStatusParams, GetSupportedChainsOptions, GetSwapStatusParams, GetTokenRatesParams, GetTokenRatesResult, InitiateRemoveFundParams, InitiateRemoveFundResult, KitContractType, NonEVMChainDefinition, OperationParamsMap, OperationType, Recoverability, RemoveFundParams, RemoveFundResult, RetryContext, SendParams, SpendDestination, SpendParams, SpendResult, SwapConfig, CustomFeePolicy$1 as SwapCustomFeePolicy, SwapDestinationLeg, SwapEstimate, SwapFeeContext, SwapKitConfig, SwapKitContext, SwapParams, SwapProgress, SwapResult, SwapSourceLeg, SwapStatus, SwapStatusResult, SwapTerminalStatus, TokenInfo, TokenRate, UnifiedBalanceChainIdentifier, CustomFeePolicy as UnifiedBalanceCustomFeePolicy, FeeRecipientsConfig as UnifiedBalanceFeeRecipientsConfig, UnifiedBalanceKitConfig, SupportedToken as UnifiedBalanceSupportedToken, UpdateDelegateParams, UpdateDelegateResult, VersionConfig, WaitForSwapDiscreteParams, WaitForSwapParams, WaitForSwapResultParams };
+export { AppKit, AppKitUnifiedBalance, BalanceError, Blockchain, BridgeChain, EARN_EXECUTE_REVIEW_KIND, EarnChain, EarnError, EarnKit, InputError, KitError, NetworkError, OnchainError, RateLimitError, RpcError, ServiceError, SwapChain, TOKEN_ALIASES, TransferSpeed, UnifiedBalanceChain, anyDepositParamsSchema, claimRewardsParamsSchema, createEarnKitContext, depositParamsSchema, claimRewards as earnClaimRewards, deposit as earnDeposit, exploreVaults as earnExploreVaults, exploreVaultsIterator as earnExploreVaultsIterator, getClaimRewardsQuote as earnGetClaimRewardsQuote, getCrossChainDepositStatus as earnGetCrossChainDepositStatus, getCrossChainDepositStatusOutcome as earnGetCrossChainDepositStatusOutcome, getDepositQuote as earnGetDepositQuote, getPosition as earnGetPosition, getSupportedChains as earnGetSupportedChains, getVaults as earnGetVaults, getWithdrawalQuote as earnGetWithdrawalQuote, waitForCrossChainDeposit as earnWaitForCrossChainDeposit, withdraw as earnWithdraw, exploreVaultsIteratorParamsSchema, exploreVaultsParamsSchema, getClaimRewardsQuoteParamsSchema, getCrossChainDepositStatusParamsSchema, getDepositQuoteParamsSchema, getErrorCode, getErrorMessage, getPositionParamsSchema, getTokenDecimals, getVaultsParamsSchema, getWithdrawalQuoteParamsSchema, isBalanceError, isEarnExecuteReview, isFatalError, isInputError, isKitError, isNetworkError, isOnchainError, isRateLimitError, isRetryableError, isRpcError, isServiceError, isTerminalCrossChainDepositStatus as isTerminalEarnCrossChainDepositStatus, isTokenAddress, isTokenAlias, isUserCancellationError, setExternalPrefix, validateToken, waitForCrossChainDepositParamsSchema, withdrawParamsSchema };
+export type { ActionHandler, AdapterContext, AllowanceStrategy$2 as AllowanceStrategy, AppKitActionName, AppKitActions, AppKitBridgeActions, AppKitConfig, AppKitContext, AppKitCustomFeePolicy, AppKitCustomFeePolicyScope, AppKitEarnActions, AppKitEarnOperations, AppKitUnifiedBalanceActions, BaseChainDefinition, BridgeConfig, CustomFeePolicy$2 as BridgeCustomFeePolicy, BridgeParams, BridgeResult, BridgeStep, CCTPConfig, CCTPMergedConfig, CCTPSplitConfig, ChainDefinition, Currency, DecodedEarnTx, DelegateStatus, DepositForParams, DepositParams, DepositResult, DeveloperFeeHooks, EVMChainDefinition, EarnAccruedRewardInfo, EarnAdapterContext, AnyDepositParams as EarnAnyDepositParams, EarnAssetAmount, EarnBridgeCctpStatus, EarnBridgeHopStatus, EarnBridgeQuoteExpiry, ClaimRewardsParams as EarnClaimRewardsParams, EarnClaimRewardsQuoteInfo, EarnClaimRewardsResult, EarnClaimedAmount, EarnClaimedRewardsResult, EarnConfig, EarnCrossChainDepositDestination, CrossChainDepositParams as EarnCrossChainDepositParams, EarnCrossChainDepositResult, EarnCrossChainDepositStatus, EarnCrossChainDepositWaitOutcome, EarnCrossChainDepositWaitResult, CrossChainGetDepositQuoteParams as EarnCrossChainGetDepositQuoteParams, EarnDepositOutcome, DepositParams$2 as EarnDepositParams, EarnDepositQuoteInfo, EarnDepositResult, EarnEncodedTransaction, EarnExecuteAuthorizationReview, EarnExecuteReview, ExploreVaultsIteratorParams as EarnExploreVaultsIteratorParams, ExploreVaultsPagination as EarnExploreVaultsPagination, ExploreVaultsParams as EarnExploreVaultsParams, EarnExploreVaultsResult, ExploreVaultsSortBy as EarnExploreVaultsSortBy, EarnGasFeeEstimate, EarnGasFeeEstimateBase, GetClaimRewardsQuoteParams as EarnGetClaimRewardsQuoteParams, GetCrossChainDepositStatusParams as EarnGetCrossChainDepositStatusParams, GetDepositQuoteParams as EarnGetDepositQuoteParams, GetPositionParams as EarnGetPositionParams, GetVaultsParams as EarnGetVaultsParams, EarnGetVaultsResult, GetWithdrawalQuoteParams as EarnGetWithdrawalQuoteParams, EarnKitConfig, EarnKitContext, EarnOperationParams, EarnPositionInfo, EarnPositionPnLInfo, EarningProvider as EarnProvider, SameChainDepositParams as EarnSameChainDepositParams, EarnSameChainDepositResult, SameChainGetDepositQuoteParams as EarnSameChainGetDepositQuoteParams, EarnServiceConfig, EarnVaultInfo, VaultQuery as EarnVaultQuery, WaitForCrossChainDepositParams as EarnWaitForCrossChainDepositParams, WithdrawParams as EarnWithdrawParams, EarnWithdrawResult, EarnWithdrawalQuoteInfo, ErrorDetails, EstimateResult$1 as EstimateResult, EstimateSpendResult, EstimatedGas, FeeOperationType, GetBalancesParams, GetBalancesResult, GetDelegateStatusParams, GetSupportedChainsOptions, GetSwapStatusParams, GetTokenRatesParams, GetTokenRatesResult, InitiateRemoveFundParams, InitiateRemoveFundResult, KitContractType, NonEVMChainDefinition, OperationParamsMap, OperationType, Recoverability, RemoveFundParams, RemoveFundResult, RetryContext, SendParams, SpendDestination, SpendParams, SpendResult, SwapConfig, CustomFeePolicy$1 as SwapCustomFeePolicy, SwapDestinationLeg, SwapEstimate, SwapFeeContext, SwapKitConfig, SwapKitContext, SwapParams, SwapProgress, SwapResult, SwapSourceLeg, SwapStatus, SwapStatusResult, SwapTerminalStatus, TokenInfo, TokenRate, UnifiedBalanceChainIdentifier, CustomFeePolicy as UnifiedBalanceCustomFeePolicy, FeeRecipientsConfig as UnifiedBalanceFeeRecipientsConfig, UnifiedBalanceKitConfig, SupportedToken as UnifiedBalanceSupportedToken, UpdateDelegateParams, UpdateDelegateResult, VersionConfig, WaitForSwapDiscreteParams, WaitForSwapParams, WaitForSwapResultParams };