@circle-fin/app-kit 1.0.1 → 1.2.0

package/index.d.ts

@@ -500,6 +500,8 @@ declare enum Blockchain {
     Celo_Alfajores_Testnet = "Celo_Alfajores_Testnet",
     Codex = "Codex",
     Codex_Testnet = "Codex_Testnet",
+    Edge = "Edge",
+    Edge_Testnet = "Edge_Testnet",
     Ethereum = "Ethereum",
     Ethereum_Sepolia = "Ethereum_Sepolia",
     Hedera = "Hedera",
@@ -512,6 +514,8 @@ declare enum Blockchain {
     Linea_Sepolia = "Linea_Sepolia",
     Monad = "Monad",
     Monad_Testnet = "Monad_Testnet",
+    Morph = "Morph",
+    Morph_Testnet = "Morph_Testnet",
     NEAR = "NEAR",
     NEAR_Testnet = "NEAR_Testnet",
     Noble = "Noble",
@@ -731,11 +735,13 @@ declare enum BridgeChain {
     Avalanche = "Avalanche",
     Base = "Base",
     Codex = "Codex",
+    Edge = "Edge",
     Ethereum = "Ethereum",
     HyperEVM = "HyperEVM",
     Ink = "Ink",
     Linea = "Linea",
     Monad = "Monad",
+    Morph = "Morph",
     Optimism = "Optimism",
     Plume = "Plume",
     Polygon = "Polygon",
@@ -750,11 +756,13 @@ declare enum BridgeChain {
     Avalanche_Fuji = "Avalanche_Fuji",
     Base_Sepolia = "Base_Sepolia",
     Codex_Testnet = "Codex_Testnet",
+    Edge_Testnet = "Edge_Testnet",
     Ethereum_Sepolia = "Ethereum_Sepolia",
     HyperEVM_Testnet = "HyperEVM_Testnet",
     Ink_Testnet = "Ink_Testnet",
     Linea_Sepolia = "Linea_Sepolia",
     Monad_Testnet = "Monad_Testnet",
+    Morph_Testnet = "Morph_Testnet",
     Optimism_Sepolia = "Optimism_Sepolia",
     Plume_Testnet = "Plume_Testnet",
     Polygon_Amoy_Testnet = "Polygon_Amoy_Testnet",
@@ -1379,7 +1387,7 @@ declare const Codex: {
         };
         readonly forwarderSupported: {
             readonly source: true;
-            readonly destination: false;
+            readonly destination: true;
         };
     };
     readonly kitContracts: {
@@ -1422,7 +1430,95 @@ declare const CodexTestnet: {
         };
         readonly forwarderSupported: {
             readonly source: true;
-            readonly destination: false;
+            readonly destination: true;
+        };
+    };
+    readonly kitContracts: {
+        readonly bridge: "0xC5567a5E3370d4DBfB0540025078e283e36A363d";
+    };
+};
+
+/**
+ * Edge Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Edge blockchain.
+ * Edge is an EVM-compatible blockchain.
+ */
+declare const Edge: {
+    readonly type: "evm";
+    readonly chain: Blockchain.Edge;
+    readonly name: "Edge";
+    readonly title: "Edge Mainnet";
+    readonly nativeCurrency: {
+        readonly name: "Ether";
+        readonly symbol: "ETH";
+        readonly decimals: 18;
+    };
+    readonly chainId: 3343;
+    readonly isTestnet: false;
+    readonly explorerUrl: "https://pro.edgex.exchange/en-US/explorer/tx/{hash}";
+    readonly rpcEndpoints: readonly ["https://edge-mainnet.g.alchemy.com/public"];
+    readonly eurcAddress: null;
+    readonly usdcAddress: "0x98d2919b9A214E6Fa5384AC81E6864bA686Ad74c";
+    readonly usdtAddress: null;
+    readonly cctp: {
+        readonly domain: 28;
+        readonly contracts: {
+            readonly v2: {
+                readonly type: "split";
+                readonly tokenMessenger: "0x98706A006bc632Df31CAdFCBD43F38887ce2ca5c";
+                readonly messageTransmitter: "0x5b61381Fc9e58E70EfC13a4A97516997019198ee";
+                readonly confirmations: 65;
+                readonly fastConfirmations: 1;
+            };
+        };
+        readonly forwarderSupported: {
+            readonly source: true;
+            readonly destination: true;
+        };
+    };
+    readonly kitContracts: {
+        readonly bridge: "0x6D1AaE1c34Aeb582022916a67f2A655C6f4eDFF2";
+    };
+};
+
+/**
+ * Edge Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Edge blockchain.
+ * Edge is an EVM-compatible blockchain.
+ */
+declare const EdgeTestnet: {
+    readonly type: "evm";
+    readonly chain: Blockchain.Edge_Testnet;
+    readonly name: "Edge Testnet";
+    readonly title: "Edge Testnet";
+    readonly nativeCurrency: {
+        readonly name: "Ether";
+        readonly symbol: "ETH";
+        readonly decimals: 18;
+    };
+    readonly chainId: 33431;
+    readonly isTestnet: true;
+    readonly explorerUrl: "https://edge-testnet.explorer.alchemy.com/tx/{hash}";
+    readonly rpcEndpoints: readonly ["https://edge-testnet.g.alchemy.com/public"];
+    readonly eurcAddress: null;
+    readonly usdcAddress: "0x2d9F7CAD728051AA35Ecdc472a14cf8cDF5CFD6B";
+    readonly usdtAddress: null;
+    readonly cctp: {
+        readonly domain: 28;
+        readonly contracts: {
+            readonly v2: {
+                readonly type: "split";
+                readonly tokenMessenger: "0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA";
+                readonly messageTransmitter: "0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275";
+                readonly confirmations: 65;
+                readonly fastConfirmations: 1;
+            };
+        };
+        readonly forwarderSupported: {
+            readonly source: true;
+            readonly destination: true;
         };
     };
     readonly kitContracts: {
@@ -1596,7 +1692,7 @@ declare const HyperEVM: {
     };
     readonly chainId: 999;
     readonly isTestnet: false;
-    readonly explorerUrl: "https://hyperevmscan.io/tx/{hash}";
+    readonly explorerUrl: "https://app.hyperliquid.xyz/explorer/tx/{hash}";
     readonly rpcEndpoints: readonly ["https://rpc.hyperliquid.xyz/evm"];
     readonly eurcAddress: null;
     readonly usdcAddress: "0xb88339CB7199b77E23DB6E890353E22632Ba630f";
@@ -1641,7 +1737,7 @@ declare const HyperEVMTestnet: {
     };
     readonly chainId: 998;
     readonly isTestnet: true;
-    readonly explorerUrl: "https://testnet.hyperliquid.xyz/explorer/tx/{hash}";
+    readonly explorerUrl: "https://app.hyperliquid-testnet.xyz/explorer/tx/{hash}";
     readonly rpcEndpoints: readonly ["https://rpc.hyperliquid-testnet.xyz/evm"];
     readonly eurcAddress: null;
     readonly usdcAddress: "0x2B3370eE501B4a559b57D449569354196457D8Ab";
@@ -1935,6 +2031,94 @@ declare const MonadTestnet: {
     };
 };
 
+/**
+ * Morph Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Morph blockchain.
+ * Morph is an EVM-compatible Layer-2 blockchain built on the OP Stack.
+ */
+declare const Morph: {
+    readonly type: "evm";
+    readonly chain: Blockchain.Morph;
+    readonly name: "Morph";
+    readonly title: "Morph Mainnet";
+    readonly nativeCurrency: {
+        readonly name: "Ether";
+        readonly symbol: "ETH";
+        readonly decimals: 18;
+    };
+    readonly chainId: 2818;
+    readonly isTestnet: false;
+    readonly explorerUrl: "https://explorer.morph.network/tx/{hash}";
+    readonly rpcEndpoints: readonly ["https://rpc.morphl2.io"];
+    readonly eurcAddress: null;
+    readonly usdcAddress: "0xCfb1186F4e93D60E60a8bDd997427D1F33bc372B";
+    readonly usdtAddress: null;
+    readonly cctp: {
+        readonly domain: 30;
+        readonly contracts: {
+            readonly v2: {
+                readonly type: "split";
+                readonly tokenMessenger: "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d";
+                readonly messageTransmitter: "0x81D40F21F12A8F0E3252Bccb954D722d4c464B64";
+                readonly confirmations: 64;
+                readonly fastConfirmations: 1;
+            };
+        };
+        readonly forwarderSupported: {
+            readonly source: false;
+            readonly destination: false;
+        };
+    };
+    readonly kitContracts: {
+        readonly bridge: "0xB3FA262d0fB521cc93bE83d87b322b8A23DAf3F0";
+    };
+};
+
+/**
+ * Morph Hoodi Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Morph blockchain.
+ * Morph is an EVM-compatible Layer-2 blockchain built on the OP Stack.
+ */
+declare const MorphTestnet: {
+    readonly type: "evm";
+    readonly chain: Blockchain.Morph_Testnet;
+    readonly name: "Morph Hoodi";
+    readonly title: "Morph Hoodi Testnet";
+    readonly nativeCurrency: {
+        readonly name: "Ether";
+        readonly symbol: "ETH";
+        readonly decimals: 18;
+    };
+    readonly chainId: 2910;
+    readonly isTestnet: true;
+    readonly explorerUrl: "https://explorer-hoodi.morphl2.io/tx/{hash}";
+    readonly rpcEndpoints: readonly ["https://rpc-hoodi.morphl2.io"];
+    readonly eurcAddress: null;
+    readonly usdcAddress: "0x7433b41C6c5e1d58D4Da99483609520255ab661B";
+    readonly usdtAddress: null;
+    readonly cctp: {
+        readonly domain: 30;
+        readonly contracts: {
+            readonly v2: {
+                readonly type: "split";
+                readonly tokenMessenger: "0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA";
+                readonly messageTransmitter: "0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275";
+                readonly confirmations: 64;
+                readonly fastConfirmations: 1;
+            };
+        };
+        readonly forwarderSupported: {
+            readonly source: false;
+            readonly destination: false;
+        };
+    };
+    readonly kitContracts: {
+        readonly bridge: "0xC5567a5E3370d4DBfB0540025078e283e36A363d";
+    };
+};
+
 /**
  * NEAR Protocol Mainnet chain definition
  * @remarks
@@ -2193,7 +2377,7 @@ declare const Plume: {
         };
         readonly forwarderSupported: {
             readonly source: true;
-            readonly destination: false;
+            readonly destination: true;
         };
     };
     readonly kitContracts: {
@@ -2238,7 +2422,7 @@ declare const PlumeTestnet: {
         };
         readonly forwarderSupported: {
             readonly source: true;
-            readonly destination: false;
+            readonly destination: true;
         };
     };
     readonly kitContracts: {
@@ -3013,7 +3197,7 @@ declare const XDC: {
         };
         readonly forwarderSupported: {
             readonly source: true;
-            readonly destination: false;
+            readonly destination: true;
         };
     };
     readonly kitContracts: {
@@ -3057,7 +3241,7 @@ declare const XDCApothem: {
         };
         readonly forwarderSupported: {
             readonly source: true;
-            readonly destination: false;
+            readonly destination: true;
         };
     };
     readonly kitContracts: {
@@ -3130,6 +3314,8 @@ declare const Chains_Celo: typeof Celo;
 declare const Chains_CeloAlfajoresTestnet: typeof CeloAlfajoresTestnet;
 declare const Chains_Codex: typeof Codex;
 declare const Chains_CodexTestnet: typeof CodexTestnet;
+declare const Chains_Edge: typeof Edge;
+declare const Chains_EdgeTestnet: typeof EdgeTestnet;
 declare const Chains_Ethereum: typeof Ethereum;
 declare const Chains_EthereumSepolia: typeof EthereumSepolia;
 declare const Chains_Hedera: typeof Hedera;
@@ -3142,6 +3328,8 @@ declare const Chains_Linea: typeof Linea;
 declare const Chains_LineaSepolia: typeof LineaSepolia;
 declare const Chains_Monad: typeof Monad;
 declare const Chains_MonadTestnet: typeof MonadTestnet;
+declare const Chains_Morph: typeof Morph;
+declare const Chains_MorphTestnet: typeof MorphTestnet;
 declare const Chains_NEAR: typeof NEAR;
 declare const Chains_NEARTestnet: typeof NEARTestnet;
 declare const Chains_Noble: typeof Noble;
@@ -3189,6 +3377,8 @@ declare namespace Chains {
     Chains_CeloAlfajoresTestnet as CeloAlfajoresTestnet,
     Chains_Codex as Codex,
     Chains_CodexTestnet as CodexTestnet,
+    Chains_Edge as Edge,
+    Chains_EdgeTestnet as EdgeTestnet,
     Chains_Ethereum as Ethereum,
     Chains_EthereumSepolia as EthereumSepolia,
     Chains_Hedera as Hedera,
@@ -3201,6 +3391,8 @@ declare namespace Chains {
     Chains_LineaSepolia as LineaSepolia,
     Chains_Monad as Monad,
     Chains_MonadTestnet as MonadTestnet,
+    Chains_Morph as Morph,
+    Chains_MorphTestnet as MorphTestnet,
     Chains_NEAR as NEAR,
     Chains_NEARTestnet as NEARTestnet,
     Chains_Noble as Noble,
@@ -3382,6 +3574,32 @@ interface EvmExecuteOverrides extends EvmEstimateOverrides {
      */
     nonce?: number;
 }
+/**
+ * Raw EVM call data tuple for a single contract interaction.
+ *
+ * Represents the minimal data needed to submit an EVM transaction:
+ * the target contract address, the ABI-encoded calldata, and an
+ * optional native token value. Used by EIP-5792 batched execution
+ * to compose multiple calls into a single `wallet_sendCalls` request.
+ *
+ * @interface EvmCallData
+ *
+ * @example
+ * ```typescript
+ * const callData: EvmCallData = {
+ *   to: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48',
+ *   data: '0x095ea7b3000000000000000000000000...',
+ * }
+ * ```
+ */
+interface EvmCallData {
+    /** The target contract address. */
+    to: `0x${string}`;
+    /** The ABI-encoded function calldata. */
+    data: `0x${string}`;
+    /** Optional native token value to send with the call. */
+    value?: bigint | undefined;
+}
 /**
  * Prepared contract execution for EVM chains.
  *
@@ -3410,6 +3628,28 @@ interface EvmPreparedChainRequest {
      * @throws If the execution fails
      */
     execute(overrides?: EvmExecuteOverrides): Promise<string>;
+    /**
+     * Return the raw call tuple without executing or estimating.
+     *
+     * Expose the `{ to, data, value }` triple that would be sent on-chain so
+     * callers can feed it into EIP-5792 `wallet_sendCalls` or other batching
+     * mechanisms. This method is optional -- adapters that do not support
+     * calldata extraction (e.g. Ethers v6) may omit it.
+     *
+     * @returns The raw EVM call data for this prepared request.
+     * @throws Never — synchronous accessor with no failure path.
+     * @since 2.0.0
+     *
+     * @example
+     * ```typescript
+     * const prepared = await adapter.prepare(params, ctx)
+     * if (prepared.getCallData) {
+     *   const { to, data, value } = prepared.getCallData()
+     *   console.log('Target:', to, 'Data:', data)
+     * }
+     * ```
+     */
+    getCallData?(): EvmCallData;
 }
 /**
  * Union type for all supported prepared contract executions.
@@ -8124,6 +8364,21 @@ interface BridgeStep {
      * - `undefined`: Not applicable (non-mint steps)
      */
     forwarded?: boolean;
+    /**
+     * Whether this step was executed as part of an EIP-5792 batched
+     * `wallet_sendCalls` request.
+     *
+     * - `true`: The step was included in a batched call bundle
+     * - `undefined`: The step was executed individually (sequential flow)
+     */
+    batched?: boolean | undefined;
+    /**
+     * The wallet-assigned batch identifier from `wallet_sendCalls`.
+     *
+     * Present only when {@link batched} is `true`. Can be used with
+     * `wallet_getCallsStatus` to query the status of the entire bundle.
+     */
+    batchId?: string | undefined;
     /** Optional human-readable error message */
     errorMessage?: string;
     /** Optional raw error object (can be Viem/Ethers/Chain error) */
@@ -8268,6 +8523,24 @@ interface BridgeConfig {
      * @defaultValue TransferSpeed.FAST
      */
     transferSpeed?: TransferSpeed | `${TransferSpeed}` | undefined;
+    /**
+     * Enable or disable EIP-5792 batched transaction execution.
+     *
+     * When `true` (or `undefined` / omitted), the bridge will attempt to batch
+     * the approve and burn calls into a single `wallet_sendCalls` request if
+     * the connected wallet supports it. Set to `false` to explicitly opt out
+     * and always use the sequential approve -> burn flow.
+     *
+     * @defaultValue `undefined` (batching attempted when the wallet supports it)
+     *
+     * @example
+     * ```typescript
+     * const config: BridgeConfig = {
+     *   batchTransactions: false, // force sequential flow
+     * }
+     * ```
+     */
+    batchTransactions?: boolean | undefined;
     /**
      * The maximum fee to pay for the burn operation.
      *
@@ -12314,34 +12587,34 @@ type ActionHandler<T extends {
  * 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 AdapterContext} (recipient derives from the adapter's
- * default account) or an explicit recipient `string` address on the destination chain.
+ * 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 context or an explicit address.
+ * - 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 valid for the destination chain. When `to` is an
- * {@link AdapterContext}, the recipient is derived from the adapter's active account.
+ * 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') and custom token
  * contract addresses.
  *
  * @example
  * ```typescript
- * // Send using a known alias
+ * // Send USDC to a recipient adapter (address derived on-chain)
  * const params: SendParams = {
- *   from: { adapter: sourceAdapter, chain: sourceChain },
- *   to: { adapter: destAdapter, chain: destChain },
+ *   from: { adapter: sourceAdapter, chain: 'Ethereum' },
+ *   to: recipientAdapter,
  *   amount: '10.5',
  *   token: 'USDC'
  * }
  *
  * // Send using a custom token address (DAI on Ethereum)
  * const paramsCustomToken: SendParams = {
- *   from: { adapter: sourceAdapter, chain: sourceChain },
+ *   from: { adapter: sourceAdapter, chain: 'Ethereum' },
  *   to: '0x1234...abcd',
  *   amount: '100.0',
  *   token: '0x6B175474E89094C44Da98b954EedeAC495271d0F'
@@ -12584,10 +12857,10 @@ declare class AppKit {
      *
      * @example
      * ```typescript
-     * // Send USDC to another adapter
+     * // Send USDC to a recipient adapter (same chain)
      * const result = await kit.send({
-     *   from: sourceAdapter,
-     *   to: { adapter: destAdapter, chain: 'Polygon' },
+     *   from: { adapter: sourceAdapter, chain: 'Ethereum' },
+     *   to: recipientAdapter,
      *   amount: '100.50',
      *   token: 'USDC'
      * })
@@ -12598,7 +12871,7 @@ declare class AppKit {
      * ```typescript
      * // Send a custom token to an explicit address
      * const result = await kit.send({
-     *   from: sourceAdapter,
+     *   from: { adapter: sourceAdapter, chain: 'Ethereum' },
      *   to: '0x742d35Cc4634C0532925a3b8D1d7',
      *   amount: '100.50',
      *   token: '0x6B175474E89094C44Da98b954EedeAC495271d0F' // DAI on Ethereum
@@ -12610,8 +12883,8 @@ declare class AppKit {
      * ```typescript
      * // Send USDT to an explicit address
      * const result = await kit.send({
-     *   from: sourceAdapter,
-     *   to: { address: '0x742d35Cc4634C0532925a3b8D1d7', chain: 'Polygon' },
+     *   from: { adapter: sourceAdapter, chain: 'Ethereum' },
+     *   to: '0x742d35Cc4634C0532925a3b8D1d7',
      *   amount: '50.25',
      *   token: 'USDT'
      * })
@@ -12635,8 +12908,8 @@ declare class AppKit {
      * @example
      * ```typescript
      * const estimate = await kit.estimateSend({
-     *   from: sourceAdapter,
-     *   to: { adapter: destAdapter, chain: 'Polygon' },
+     *   from: { adapter: sourceAdapter, chain: 'Ethereum' },
+     *   to: recipientAdapter,
      *   amount: '100.50',
      *   token: 'USDC'
      * })
@@ -12647,8 +12920,8 @@ declare class AppKit {
      * @example
      * ```typescript
      * const estimate = await kit.estimateSend({
-     *   from: sourceAdapter,
-     *   to: { adapter: destAdapter, chain: 'Polygon' },
+     *   from: { adapter: sourceAdapter, chain: 'Ethereum' },
+     *   to: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
      *   amount: '50.0',
      *   token: 'USDT'
      * })