@circle-fin/app-kit 1.1.0 → 1.2.1

package/index.d.ts

@@ -1387,7 +1387,7 @@ declare const Codex: {
         };
         readonly forwarderSupported: {
             readonly source: true;
-            readonly destination: false;
+            readonly destination: true;
         };
     };
     readonly kitContracts: {
@@ -1430,7 +1430,7 @@ declare const CodexTestnet: {
         };
         readonly forwarderSupported: {
             readonly source: true;
-            readonly destination: false;
+            readonly destination: true;
         };
     };
     readonly kitContracts: {
@@ -1692,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";
@@ -1737,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";
@@ -2377,7 +2377,7 @@ declare const Plume: {
         };
         readonly forwarderSupported: {
             readonly source: true;
-            readonly destination: false;
+            readonly destination: true;
         };
     };
     readonly kitContracts: {
@@ -2422,7 +2422,7 @@ declare const PlumeTestnet: {
         };
         readonly forwarderSupported: {
             readonly source: true;
-            readonly destination: false;
+            readonly destination: true;
         };
     };
     readonly kitContracts: {
@@ -2794,7 +2794,7 @@ declare const Solana: {
         };
         readonly forwarderSupported: {
             readonly source: true;
-            readonly destination: false;
+            readonly destination: true;
         };
     };
     readonly kitContracts: {
@@ -2841,7 +2841,7 @@ declare const SolanaDevnet: {
         };
         readonly forwarderSupported: {
             readonly source: true;
-            readonly destination: false;
+            readonly destination: true;
         };
     };
     readonly kitContracts: {
@@ -3197,7 +3197,7 @@ declare const XDC: {
         };
         readonly forwarderSupported: {
             readonly source: true;
-            readonly destination: false;
+            readonly destination: true;
         };
     };
     readonly kitContracts: {
@@ -3241,7 +3241,7 @@ declare const XDCApothem: {
         };
         readonly forwarderSupported: {
             readonly source: true;
-            readonly destination: false;
+            readonly destination: true;
         };
     };
     readonly kitContracts: {
@@ -3574,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.
  *
@@ -3602,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.
@@ -8316,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) */
@@ -8460,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.
      *
@@ -12506,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'
@@ -12776,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'
      * })
@@ -12790,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
@@ -12802,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'
      * })
@@ -12827,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'
      * })
@@ -12839,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'
      * })