@circle-fin/adapter-ethers-v6 1.6.6 → 1.8.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @circle-fin/adapter-ethers-v6
 
+## 1.8.0
+
+### Minor Changes
+
+- Improves the error you get when attempting a Gateway spend with a smart-contract account (SCA) as the signer. The failure previously surfaced as a confusing `invalid integer value <nil>/<nil> for type uint256` response from the Circle Wallets backend; you now get a clear `INPUT_UNSUPPORTED_ACTION` error up front that points at the delegate workflow (`kit.unifiedBalance.addDelegate` + `kit.unifiedBalance.spend` with the delegate EOA as `from.address` and the SCA as `from.sourceAccount`).
+
+### Patch Changes
+
+- Fix excessive MetaMask mobile app-switching prompts during bridge estimation and support chain switching for WalletConnect/Dynamic mobile wallet providers
+
+## 1.7.0
+
+### Minor Changes
+
+- Add support for bridging USDC to and from Injective (mainnet and testnet) via CCTP v2. Both networks are now available as source and destination options in Bridge Kit.
+
 ## 1.6.6
 
 ### Patch Changes

package/index.cjs

@@ -1733,6 +1733,8 @@ exports.Blockchain = void 0;
     Blockchain["Hedera_Testnet"] = "Hedera_Testnet";
     Blockchain["HyperEVM"] = "HyperEVM";
     Blockchain["HyperEVM_Testnet"] = "HyperEVM_Testnet";
+    Blockchain["Injective"] = "Injective";
+    Blockchain["Injective_Testnet"] = "Injective_Testnet";
     Blockchain["Ink"] = "Ink";
     Blockchain["Ink_Testnet"] = "Ink_Testnet";
     Blockchain["Linea"] = "Linea";
@@ -1952,6 +1954,7 @@ var BridgeChain;
     BridgeChain["Edge"] = "Edge";
     BridgeChain["Ethereum"] = "Ethereum";
     BridgeChain["HyperEVM"] = "HyperEVM";
+    BridgeChain["Injective"] = "Injective";
     BridgeChain["Ink"] = "Ink";
     BridgeChain["Linea"] = "Linea";
     BridgeChain["Monad"] = "Monad";
@@ -1975,6 +1978,7 @@ var BridgeChain;
     BridgeChain["Edge_Testnet"] = "Edge_Testnet";
     BridgeChain["Ethereum_Sepolia"] = "Ethereum_Sepolia";
     BridgeChain["HyperEVM_Testnet"] = "HyperEVM_Testnet";
+    BridgeChain["Injective_Testnet"] = "Injective_Testnet";
     BridgeChain["Ink_Testnet"] = "Ink_Testnet";
     BridgeChain["Linea_Sepolia"] = "Linea_Sepolia";
     BridgeChain["Monad_Testnet"] = "Monad_Testnet";
@@ -3394,6 +3398,98 @@ const HyperEVMTestnet = defineChain({
     },
 });
 
+/**
+ * Injective Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Injective blockchain.
+ * Injective is a high-performance, interoperable Layer-1 blockchain built for
+ * finance, with an EVM execution layer on top of a Cosmos SDK base and
+ * sub-second block finality.
+ */
+const Injective = defineChain({
+    type: 'evm',
+    chain: exports.Blockchain.Injective,
+    name: 'Injective',
+    title: 'Injective Mainnet',
+    nativeCurrency: {
+        name: 'Injective',
+        symbol: 'INJ',
+        decimals: 18,
+    },
+    chainId: 1776,
+    isTestnet: false,
+    explorerUrl: 'https://injscan.com/transaction/{hash}',
+    rpcEndpoints: ['https://sentry.evm-rpc.injective.network'],
+    eurcAddress: null,
+    usdcAddress: '0xa00C59fF5a080D2b954d0c75e46E22a0c371235a',
+    usdtAddress: null,
+    cctp: {
+        domain: 29,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+                confirmations: 1,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+    },
+});
+
+/**
+ * Injective Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Injective blockchain.
+ * Injective is a high-performance, interoperable Layer-1 blockchain built for
+ * finance, with an EVM execution layer on top of a Cosmos SDK base and
+ * sub-second block finality.
+ */
+const InjectiveTestnet = defineChain({
+    type: 'evm',
+    chain: exports.Blockchain.Injective_Testnet,
+    name: 'Injective Testnet',
+    title: 'Injective Testnet',
+    nativeCurrency: {
+        name: 'Injective',
+        symbol: 'INJ',
+        decimals: 18,
+    },
+    chainId: 1439,
+    isTestnet: true,
+    explorerUrl: 'https://testnet.explorer.injective.network/transaction/{hash}',
+    rpcEndpoints: ['https://k8s.testnet.json-rpc.injective.network'],
+    eurcAddress: null,
+    usdcAddress: '0x0C382e685bbeeFE5d3d9C29e29E341fEE8E84C5d',
+    usdtAddress: null,
+    cctp: {
+        domain: 29,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
+                confirmations: 1,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_TESTNET,
+    },
+});
+
 /**
  * Ink Mainnet chain definition
  * @remarks
@@ -5236,6 +5332,8 @@ var Blockchains = {
     HederaTestnet: HederaTestnet,
     HyperEVM: HyperEVM,
     HyperEVMTestnet: HyperEVMTestnet,
+    Injective: Injective,
+    InjectiveTestnet: InjectiveTestnet,
     Ink: Ink,
     InkTestnet: InkTestnet,
     Linea: Linea,
@@ -6806,6 +6904,7 @@ const USDC = {
         [exports.Blockchain.Ethereum]: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
         [exports.Blockchain.Hedera]: '0.0.456858',
         [exports.Blockchain.HyperEVM]: '0xb88339CB7199b77E23DB6E890353E22632Ba630f',
+        [exports.Blockchain.Injective]: '0xa00C59fF5a080D2b954d0c75e46E22a0c371235a',
         [exports.Blockchain.Ink]: '0x2D270e6886d130D724215A266106e6832161EAEd',
         [exports.Blockchain.Linea]: '0x176211869ca2b568f2a7d4ee941e073a821ee1ff',
         [exports.Blockchain.Monad]: '0x754704Bc059F8C67012fEd69BC8A327a5aafb603',
@@ -6838,6 +6937,7 @@ const USDC = {
         [exports.Blockchain.Ethereum_Sepolia]: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
         [exports.Blockchain.Hedera_Testnet]: '0.0.429274',
         [exports.Blockchain.HyperEVM_Testnet]: '0x2B3370eE501B4a559b57D449569354196457D8Ab',
+        [exports.Blockchain.Injective_Testnet]: '0x0C382e685bbeeFE5d3d9C29e29E341fEE8E84C5d',
         [exports.Blockchain.Ink_Testnet]: '0xFabab97dCE620294D2B0b0e46C68964e326300Ac',
         [exports.Blockchain.Linea_Sepolia]: '0xfece4462d57bd51a6a552365a011b95f0e16d9b7',
         [exports.Blockchain.Monad_Testnet]: '0x534b2f3A21130d7a60830c2Df862319e593943A3',
@@ -17002,41 +17102,37 @@ function isBrowserWithEthereum() {
     return (typeof window !== 'undefined' && !!window.ethereum);
 }
 /**
- * Attempts to switch the connected chain in a browser wallet, or adds the chain if it is not recognized.
- *
- * @param signer - The current Ethers.js Signer instance, expected to be connected to a browser provider.
- * @param chain - The EVM chain definition to switch to.
- * @returns A promise resolving to the new Signer instance connected to the target chain.
- *
- * @remarks
- * This function uses the EIP-3326 `wallet_switchEthereumChain` and EIP-3085 `wallet_addEthereumChain` methods
- * to prompt the user to switch or add the specified chain in their browser wallet.
+ * Switch or add a chain via an EIP-1193 provider, then return a fresh signer.
  *
- * @throws {Error} If the provider does not support chain switching, or if the user rejects the request,
- * or if the operation fails for any other reason.
+ * @param provider - An EIP-1193 compatible provider with a `send` method.
+ * @param chain - The target EVM chain definition.
+ * @returns A promise resolving to a new Signer connected to the target chain.
+ * @throws When the user rejects the switch or the provider fails.
  */
-async function switchOrAddChainInBrowser(signer, chain) {
-    const win = window;
-    const signerWithProvider = signer;
-    if (!signerWithProvider?.provider?.send) {
-        throw new Error('Browser provider does not support chain switching');
-    }
+async function switchOrAddViaProvider(provider, chain) {
     try {
-        await signerWithProvider.provider.send('wallet_switchEthereumChain', [
+        await provider.send('wallet_switchEthereumChain', [
             { chainId: `0x${chain.chainId.toString(16)}` },
         ]);
-        return await getBrowserSigner(win);
     }
     catch (error) {
         if (typeof error === 'object' &&
             error !== null &&
             'code' in error &&
             error.code === UNRECOGNIZED_CHAIN_ID_ERROR_CODE) {
-            await addChainInBrowser(signerWithProvider, chain);
-            return await getBrowserSigner(win);
+            await addChainInBrowser({ provider }, chain);
+            await provider.send('wallet_switchEthereumChain', [
+                { chainId: `0x${chain.chainId.toString(16)}` },
+            ]);
+        }
+        else {
+            throw error;
         }
-        throw error;
     }
+    const browserProvider = provider instanceof ethers.BrowserProvider
+        ? provider
+        : new ethers.BrowserProvider(provider);
+    return await browserProvider.getSigner();
 }
 /**
  * Adds a new EVM chain to the user's browser wallet using the EIP-3085 `wallet_addEthereumChain` method.
@@ -17051,9 +17147,9 @@ async function switchOrAddChainInBrowser(signer, chain) {
  *
  * @throws {Error} If the provider does not support the `send` method or if the request fails.
  */
-async function addChainInBrowser(signerWithProvider, chain) {
+async function addChainInBrowser(providerLike, chain) {
     const rpcUrl = chain.rpcEndpoints[0];
-    await signerWithProvider.provider.send('wallet_addEthereumChain', [
+    await providerLike.provider.send('wallet_addEthereumChain', [
         {
             chainId: `0x${chain.chainId.toString(16)}`,
             chainName: chain.name,
@@ -17065,24 +17161,9 @@ async function addChainInBrowser(signerWithProvider, chain) {
         },
     ]);
 }
-/**
- * Returns a Signer instance from the browser's injected Ethereum provider.
- *
- * @param win - The browser window object with an injected `ethereum` provider.
- * @returns  A promise resolving Signer instance connected to the browser's provider.
- *
- * @remarks
- * This function wraps the Ethers.js `BrowserProvider` to obtain a Signer for user interaction.
- *
- * @throws {Error} If the `ethereum` provider is not available or if the signer cannot be retrieved.
- */
-async function getBrowserSigner(win) {
-    const browserProvider = new ethers.BrowserProvider(win.ethereum);
-    return await browserProvider.getSigner();
-}
 /**
  * Switches the chain for the given signer and returns a new signer for the target chain.
- * Handles both browser and server-side environments.
+ * Handles browser (injected + WalletConnect/Dynamic) and server-side environments.
  *
  * @param signer - The current signer instance
  * @param chain - The target chain definition
@@ -17090,8 +17171,21 @@ async function getBrowserSigner(win) {
  * @throws If switching fails or the environment is unsupported
  */
 async function switchChain(signer, chain) {
+    // Injected browser wallet (window.ethereum present)
     if (isBrowserWithEthereum()) {
-        return switchOrAddChainInBrowser(signer, chain);
+        const signerWithProvider = signer;
+        if (!signerWithProvider?.provider?.send) {
+            throw new Error('Browser provider does not support chain switching');
+        }
+        return switchOrAddViaProvider(signerWithProvider.provider, chain);
+    }
+    // Browser without window.ethereum (e.g., WalletConnect/Dynamic mobile wallets)
+    const signerWithProvider = signer;
+    const signerProvider = signerWithProvider.provider;
+    if (globalThis.window !== undefined &&
+        signerProvider &&
+        'send' in signerProvider) {
+        return switchOrAddViaProvider(signerProvider, chain);
     }
     // Server-side: recreate the provider and signer
     const rpcUrl = chain.rpcEndpoints[0];
@@ -18067,6 +18161,36 @@ class EthersAdapter extends EvmAdapter {
             });
         }
     }
+    /**
+     * Reads the on-chain bytecode for a given address via ethers' `getCode`.
+     *
+     * Returns the hex-encoded bytecode when the address is a contract, or
+     * `'0x'` when the address has no code (EOA). Used by Gateway burn-intent
+     * signing to detect smart-contract accounts, which are not supported by
+     * Gateway's ecrecover-based verification path.
+     */
+    async readBytecode(address, chain) {
+        const provider = await this.getProvider(chain);
+        try {
+            const code = await provider.getCode(address);
+            return code;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new KitError({
+                ...RpcError.ENDPOINT_ERROR,
+                recoverability: 'RETRYABLE',
+                message: `Failed to read bytecode for ${address}: ${errorMessage}`,
+                cause: {
+                    trace: {
+                        operation: 'readBytecode',
+                        address,
+                        chain: chain.name,
+                    },
+                },
+            });
+        }
+    }
     /**
      * Signs EIP-712 typed data using the configured signer with OperationContext.
      *

package/index.d.ts

@@ -668,6 +668,8 @@ declare enum Blockchain {
     Hedera_Testnet = "Hedera_Testnet",
     HyperEVM = "HyperEVM",
     HyperEVM_Testnet = "HyperEVM_Testnet",
+    Injective = "Injective",
+    Injective_Testnet = "Injective_Testnet",
     Ink = "Ink",
     Ink_Testnet = "Ink_Testnet",
     Linea = "Linea",
@@ -3972,6 +3974,37 @@ declare abstract class EvmAdapter<TAdapterCapabilities extends AdapterCapabiliti
      * @throws Error when balance retrieval fails.
      */
     abstract readNativeBalance(address: string, chain: EVMChainDefinition): Promise<bigint>;
+    /**
+     * Reads the on-chain bytecode for a given address.
+     *
+     * Returns the deployed contract bytecode as a hex string (`0x`-prefixed),
+     * or `'0x'` when the address has no code (i.e. is a plain EOA).
+     * Implementations MUST normalize a "no code" RPC response to `'0x'` so
+     * callers can compare against a single sentinel.
+     *
+     * Useful for detecting smart-contract accounts before attempting an
+     * operation that only supports EOA signing (e.g. Gateway burn intents).
+     *
+     * @param address - The address to read bytecode for.
+     * @param chain - The chain definition to read from.
+     * @returns Promise resolving to `'0x'` for an EOA, or the hex-encoded
+     *   deployed bytecode otherwise.
+     * @throws Error when the underlying RPC call fails.
+     *
+     * @example
+     * ```typescript
+     * import { ViemAdapter } from '@circle-fin/adapter-viem-v2'
+     * import { Ethereum } from '@core/chains'
+     *
+     * const adapter = new ViemAdapter({ publicClient, walletClient })
+     * const code = await adapter.readBytecode('0xabc...', Ethereum)
+     *
+     * if (code !== '0x') {
+     *   throw new Error('signer has on-chain bytecode')
+     * }
+     * ```
+     */
+    abstract readBytecode(address: string, chain: EVMChainDefinition): Promise<`0x${string}`>;
     /**
      * Calculate the total transaction fee including compute cost and buffer for the configured chain.
      *
@@ -4571,6 +4604,15 @@ declare class EthersAdapter<TAdapterCapabilities extends AdapterCapabilities = A
      * ```
      */
     readNativeBalance(address: string, chain: EVMChainDefinition): Promise<bigint>;
+    /**
+     * Reads the on-chain bytecode for a given address via ethers' `getCode`.
+     *
+     * Returns the hex-encoded bytecode when the address is a contract, or
+     * `'0x'` when the address has no code (EOA). Used by Gateway burn-intent
+     * signing to detect smart-contract accounts, which are not supported by
+     * Gateway's ecrecover-based verification path.
+     */
+    readBytecode(address: string, chain: EVMChainDefinition): Promise<`0x${string}`>;
     /**
      * Signs EIP-712 typed data using the configured signer with OperationContext.
      *

package/index.mjs

@@ -1728,6 +1728,8 @@ var Blockchain;
     Blockchain["Hedera_Testnet"] = "Hedera_Testnet";
     Blockchain["HyperEVM"] = "HyperEVM";
     Blockchain["HyperEVM_Testnet"] = "HyperEVM_Testnet";
+    Blockchain["Injective"] = "Injective";
+    Blockchain["Injective_Testnet"] = "Injective_Testnet";
     Blockchain["Ink"] = "Ink";
     Blockchain["Ink_Testnet"] = "Ink_Testnet";
     Blockchain["Linea"] = "Linea";
@@ -1947,6 +1949,7 @@ var BridgeChain;
     BridgeChain["Edge"] = "Edge";
     BridgeChain["Ethereum"] = "Ethereum";
     BridgeChain["HyperEVM"] = "HyperEVM";
+    BridgeChain["Injective"] = "Injective";
     BridgeChain["Ink"] = "Ink";
     BridgeChain["Linea"] = "Linea";
     BridgeChain["Monad"] = "Monad";
@@ -1970,6 +1973,7 @@ var BridgeChain;
     BridgeChain["Edge_Testnet"] = "Edge_Testnet";
     BridgeChain["Ethereum_Sepolia"] = "Ethereum_Sepolia";
     BridgeChain["HyperEVM_Testnet"] = "HyperEVM_Testnet";
+    BridgeChain["Injective_Testnet"] = "Injective_Testnet";
     BridgeChain["Ink_Testnet"] = "Ink_Testnet";
     BridgeChain["Linea_Sepolia"] = "Linea_Sepolia";
     BridgeChain["Monad_Testnet"] = "Monad_Testnet";
@@ -3389,6 +3393,98 @@ const HyperEVMTestnet = defineChain({
     },
 });
 
+/**
+ * Injective Mainnet chain definition
+ * @remarks
+ * This represents the official production network for the Injective blockchain.
+ * Injective is a high-performance, interoperable Layer-1 blockchain built for
+ * finance, with an EVM execution layer on top of a Cosmos SDK base and
+ * sub-second block finality.
+ */
+const Injective = defineChain({
+    type: 'evm',
+    chain: Blockchain.Injective,
+    name: 'Injective',
+    title: 'Injective Mainnet',
+    nativeCurrency: {
+        name: 'Injective',
+        symbol: 'INJ',
+        decimals: 18,
+    },
+    chainId: 1776,
+    isTestnet: false,
+    explorerUrl: 'https://injscan.com/transaction/{hash}',
+    rpcEndpoints: ['https://sentry.evm-rpc.injective.network'],
+    eurcAddress: null,
+    usdcAddress: '0xa00C59fF5a080D2b954d0c75e46E22a0c371235a',
+    usdtAddress: null,
+    cctp: {
+        domain: 29,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d',
+                messageTransmitter: '0x81D40F21F12A8F0E3252Bccb954D722d4c464B64',
+                confirmations: 1,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_MAINNET,
+    },
+});
+
+/**
+ * Injective Testnet chain definition
+ * @remarks
+ * This represents the official test network for the Injective blockchain.
+ * Injective is a high-performance, interoperable Layer-1 blockchain built for
+ * finance, with an EVM execution layer on top of a Cosmos SDK base and
+ * sub-second block finality.
+ */
+const InjectiveTestnet = defineChain({
+    type: 'evm',
+    chain: Blockchain.Injective_Testnet,
+    name: 'Injective Testnet',
+    title: 'Injective Testnet',
+    nativeCurrency: {
+        name: 'Injective',
+        symbol: 'INJ',
+        decimals: 18,
+    },
+    chainId: 1439,
+    isTestnet: true,
+    explorerUrl: 'https://testnet.explorer.injective.network/transaction/{hash}',
+    rpcEndpoints: ['https://k8s.testnet.json-rpc.injective.network'],
+    eurcAddress: null,
+    usdcAddress: '0x0C382e685bbeeFE5d3d9C29e29E341fEE8E84C5d',
+    usdtAddress: null,
+    cctp: {
+        domain: 29,
+        contracts: {
+            v2: {
+                type: 'split',
+                tokenMessenger: '0x8FE6B999Dc680CcFDD5Bf7EB0974218be2542DAA',
+                messageTransmitter: '0xE737e5cEBEEBa77EFE34D4aa090756590b1CE275',
+                confirmations: 1,
+                fastConfirmations: 1,
+            },
+        },
+        forwarderSupported: {
+            source: false,
+            destination: false,
+        },
+    },
+    kitContracts: {
+        bridge: BRIDGE_CONTRACT_EVM_TESTNET,
+    },
+});
+
 /**
  * Ink Mainnet chain definition
  * @remarks
@@ -5231,6 +5327,8 @@ var Blockchains = /*#__PURE__*/Object.freeze({
     HederaTestnet: HederaTestnet,
     HyperEVM: HyperEVM,
     HyperEVMTestnet: HyperEVMTestnet,
+    Injective: Injective,
+    InjectiveTestnet: InjectiveTestnet,
     Ink: Ink,
     InkTestnet: InkTestnet,
     Linea: Linea,
@@ -6801,6 +6899,7 @@ const USDC = {
         [Blockchain.Ethereum]: '0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48',
         [Blockchain.Hedera]: '0.0.456858',
         [Blockchain.HyperEVM]: '0xb88339CB7199b77E23DB6E890353E22632Ba630f',
+        [Blockchain.Injective]: '0xa00C59fF5a080D2b954d0c75e46E22a0c371235a',
         [Blockchain.Ink]: '0x2D270e6886d130D724215A266106e6832161EAEd',
         [Blockchain.Linea]: '0x176211869ca2b568f2a7d4ee941e073a821ee1ff',
         [Blockchain.Monad]: '0x754704Bc059F8C67012fEd69BC8A327a5aafb603',
@@ -6833,6 +6932,7 @@ const USDC = {
         [Blockchain.Ethereum_Sepolia]: '0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238',
         [Blockchain.Hedera_Testnet]: '0.0.429274',
         [Blockchain.HyperEVM_Testnet]: '0x2B3370eE501B4a559b57D449569354196457D8Ab',
+        [Blockchain.Injective_Testnet]: '0x0C382e685bbeeFE5d3d9C29e29E341fEE8E84C5d',
         [Blockchain.Ink_Testnet]: '0xFabab97dCE620294D2B0b0e46C68964e326300Ac',
         [Blockchain.Linea_Sepolia]: '0xfece4462d57bd51a6a552365a011b95f0e16d9b7',
         [Blockchain.Monad_Testnet]: '0x534b2f3A21130d7a60830c2Df862319e593943A3',
@@ -16997,41 +17097,37 @@ function isBrowserWithEthereum() {
     return (typeof window !== 'undefined' && !!window.ethereum);
 }
 /**
- * Attempts to switch the connected chain in a browser wallet, or adds the chain if it is not recognized.
- *
- * @param signer - The current Ethers.js Signer instance, expected to be connected to a browser provider.
- * @param chain - The EVM chain definition to switch to.
- * @returns A promise resolving to the new Signer instance connected to the target chain.
- *
- * @remarks
- * This function uses the EIP-3326 `wallet_switchEthereumChain` and EIP-3085 `wallet_addEthereumChain` methods
- * to prompt the user to switch or add the specified chain in their browser wallet.
+ * Switch or add a chain via an EIP-1193 provider, then return a fresh signer.
  *
- * @throws {Error} If the provider does not support chain switching, or if the user rejects the request,
- * or if the operation fails for any other reason.
+ * @param provider - An EIP-1193 compatible provider with a `send` method.
+ * @param chain - The target EVM chain definition.
+ * @returns A promise resolving to a new Signer connected to the target chain.
+ * @throws When the user rejects the switch or the provider fails.
  */
-async function switchOrAddChainInBrowser(signer, chain) {
-    const win = window;
-    const signerWithProvider = signer;
-    if (!signerWithProvider?.provider?.send) {
-        throw new Error('Browser provider does not support chain switching');
-    }
+async function switchOrAddViaProvider(provider, chain) {
     try {
-        await signerWithProvider.provider.send('wallet_switchEthereumChain', [
+        await provider.send('wallet_switchEthereumChain', [
             { chainId: `0x${chain.chainId.toString(16)}` },
         ]);
-        return await getBrowserSigner(win);
     }
     catch (error) {
         if (typeof error === 'object' &&
             error !== null &&
             'code' in error &&
             error.code === UNRECOGNIZED_CHAIN_ID_ERROR_CODE) {
-            await addChainInBrowser(signerWithProvider, chain);
-            return await getBrowserSigner(win);
+            await addChainInBrowser({ provider }, chain);
+            await provider.send('wallet_switchEthereumChain', [
+                { chainId: `0x${chain.chainId.toString(16)}` },
+            ]);
+        }
+        else {
+            throw error;
         }
-        throw error;
     }
+    const browserProvider = provider instanceof BrowserProvider
+        ? provider
+        : new BrowserProvider(provider);
+    return await browserProvider.getSigner();
 }
 /**
  * Adds a new EVM chain to the user's browser wallet using the EIP-3085 `wallet_addEthereumChain` method.
@@ -17046,9 +17142,9 @@ async function switchOrAddChainInBrowser(signer, chain) {
  *
  * @throws {Error} If the provider does not support the `send` method or if the request fails.
  */
-async function addChainInBrowser(signerWithProvider, chain) {
+async function addChainInBrowser(providerLike, chain) {
     const rpcUrl = chain.rpcEndpoints[0];
-    await signerWithProvider.provider.send('wallet_addEthereumChain', [
+    await providerLike.provider.send('wallet_addEthereumChain', [
         {
             chainId: `0x${chain.chainId.toString(16)}`,
             chainName: chain.name,
@@ -17060,24 +17156,9 @@ async function addChainInBrowser(signerWithProvider, chain) {
         },
     ]);
 }
-/**
- * Returns a Signer instance from the browser's injected Ethereum provider.
- *
- * @param win - The browser window object with an injected `ethereum` provider.
- * @returns  A promise resolving Signer instance connected to the browser's provider.
- *
- * @remarks
- * This function wraps the Ethers.js `BrowserProvider` to obtain a Signer for user interaction.
- *
- * @throws {Error} If the `ethereum` provider is not available or if the signer cannot be retrieved.
- */
-async function getBrowserSigner(win) {
-    const browserProvider = new BrowserProvider(win.ethereum);
-    return await browserProvider.getSigner();
-}
 /**
  * Switches the chain for the given signer and returns a new signer for the target chain.
- * Handles both browser and server-side environments.
+ * Handles browser (injected + WalletConnect/Dynamic) and server-side environments.
  *
  * @param signer - The current signer instance
  * @param chain - The target chain definition
@@ -17085,8 +17166,21 @@ async function getBrowserSigner(win) {
  * @throws If switching fails or the environment is unsupported
  */
 async function switchChain(signer, chain) {
+    // Injected browser wallet (window.ethereum present)
     if (isBrowserWithEthereum()) {
-        return switchOrAddChainInBrowser(signer, chain);
+        const signerWithProvider = signer;
+        if (!signerWithProvider?.provider?.send) {
+            throw new Error('Browser provider does not support chain switching');
+        }
+        return switchOrAddViaProvider(signerWithProvider.provider, chain);
+    }
+    // Browser without window.ethereum (e.g., WalletConnect/Dynamic mobile wallets)
+    const signerWithProvider = signer;
+    const signerProvider = signerWithProvider.provider;
+    if (globalThis.window !== undefined &&
+        signerProvider &&
+        'send' in signerProvider) {
+        return switchOrAddViaProvider(signerProvider, chain);
     }
     // Server-side: recreate the provider and signer
     const rpcUrl = chain.rpcEndpoints[0];
@@ -18062,6 +18156,36 @@ class EthersAdapter extends EvmAdapter {
             });
         }
     }
+    /**
+     * Reads the on-chain bytecode for a given address via ethers' `getCode`.
+     *
+     * Returns the hex-encoded bytecode when the address is a contract, or
+     * `'0x'` when the address has no code (EOA). Used by Gateway burn-intent
+     * signing to detect smart-contract accounts, which are not supported by
+     * Gateway's ecrecover-based verification path.
+     */
+    async readBytecode(address, chain) {
+        const provider = await this.getProvider(chain);
+        try {
+            const code = await provider.getCode(address);
+            return code;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new KitError({
+                ...RpcError.ENDPOINT_ERROR,
+                recoverability: 'RETRYABLE',
+                message: `Failed to read bytecode for ${address}: ${errorMessage}`,
+                cause: {
+                    trace: {
+                        operation: 'readBytecode',
+                        address,
+                        chain: chain.name,
+                    },
+                },
+            });
+        }
+    }
     /**
      * Signs EIP-712 typed data using the configured signer with OperationContext.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@circle-fin/adapter-ethers-v6",
-  "version": "1.6.6",
+  "version": "1.8.0",
   "description": "EVM blockchain adapter powered by Ethers v6",
   "keywords": [
     "circle",