@dynamic-labs/global-wallet-client 4.20.0 → 4.20.1

package/CHANGELOG.md

@@ -1,4 +1,16 @@
 
+### [4.20.1](https://github.com/dynamic-labs/dynamic-auth/compare/v4.20.0...v4.20.1) (2025-06-09)
+
+
+### Features
+
+* **global-wallet:** new createKernelClient method to native api ([#8883](https://github.com/dynamic-labs/dynamic-auth/issues/8883)) ([005b34c](https://github.com/dynamic-labs/dynamic-auth/commit/005b34c230ceb5e945547e129231c108a6cec444))
+
+
+### Bug Fixes
+
+* default embedded wallet chain enum ([#8917](https://github.com/dynamic-labs/dynamic-auth/issues/8917)) ([e9fd715](https://github.com/dynamic-labs/dynamic-auth/commit/e9fd715506598bfabbc71454421885d05a06a3ec))
+
 ## [4.20.0](https://github.com/dynamic-labs/dynamic-auth/compare/v4.19.7...v4.20.0) (2025-06-09)
 
 

package/package.cjs

@@ -3,6 +3,6 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "4.20.0";
+var version = "4.20.1";
 
 exports.version = version;

package/package.js

@@ -1,4 +1,4 @@
 'use client'
-var version = "4.20.0";
+var version = "4.20.1";
 
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dynamic-labs/global-wallet-client",
-  "version": "4.20.0",
+  "version": "4.20.1",
   "description": "Core package for building Dynamic's Global Wallet",
   "author": "Dynamic Labs, Inc.",
   "license": "MIT",
@@ -22,6 +22,9 @@
       ],
       "zksync": [
         "./src/zksync.d.ts"
+      ],
+      "zerodev": [
+        "./src/zerodev.d.ts"
       ]
     }
   },
@@ -51,16 +54,21 @@
       "import": "./src/zksync.js",
       "default": "./src/zksync.cjs"
     },
+    "./zerodev": {
+      "types": "./src/zerodev.d.ts",
+      "import": "./src/zerodev.js",
+      "default": "./src/zerodev.cjs"
+    },
     "./package.json": "./package.json"
   },
   "homepage": "https://www.dynamic.xyz/",
   "dependencies": {
-    "@dynamic-labs/assert-package-version": "4.20.0",
-    "@dynamic-labs/logger": "4.20.0",
-    "@dynamic-labs/message-transport": "4.20.0",
-    "@dynamic-labs/store": "4.20.0",
-    "@dynamic-labs/types": "4.20.0",
-    "@dynamic-labs/utils": "4.20.0",
+    "@dynamic-labs/assert-package-version": "4.20.1",
+    "@dynamic-labs/logger": "4.20.1",
+    "@dynamic-labs/message-transport": "4.20.1",
+    "@dynamic-labs/store": "4.20.1",
+    "@dynamic-labs/types": "4.20.1",
+    "@dynamic-labs/utils": "4.20.1",
     "eventemitter3": "5.0.1"
   },
   "peerDependencies": {
@@ -70,7 +78,9 @@
     "@wallet-standard/features": "^1.0.3",
     "@wallet-standard/base": "^1.0.1",
     "zksync-sso": "0.2.0",
-    "@wallet-standard/wallet": "^1.1.0"
+    "@wallet-standard/wallet": "^1.1.0",
+    "@zerodev/sdk": "5.4.36",
+    "@dynamic-labs/ethereum-aa": "4.20.1"
   },
   "peerDependenciesMeta": {
     "viem": {
@@ -93,6 +103,12 @@
     },
     "@wallet-standard/wallet": {
       "optional": true
+    },
+    "@zerodev/sdk": {
+      "optional": true
+    },
+    "@dynamic-labs/ethereum-aa": {
+      "optional": true
     }
   }
 }

package/src/lib/functions/createKernelClient/createKernelClient.cjs

@@ -0,0 +1,99 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../../_virtual/_tslib.cjs');
+var viem = require('viem');
+var chains = require('viem/chains');
+var constants = require('@zerodev/sdk/constants');
+var ethereumAa = require('@dynamic-labs/ethereum-aa');
+var getEoaWalletForSmartWallet = require('../getEoaWalletForSmartWallet/getEoaWalletForSmartWallet.cjs');
+var logger = require('../../constants/logger.cjs');
+var createEIP1193Provider = require('../../ethereum/functions/eip1193Provider/createEIP1193Provider.cjs');
+require('eventemitter3');
+require('@dynamic-labs/logger');
+require('@dynamic-labs/store');
+require('../../errors/DisconnectError.cjs');
+require('@dynamic-labs/utils');
+var getClient = require('../../client/getClient/getClient.cjs');
+var getKernelAccountSettings = require('../getKernelAccountSettings/getKernelAccountSettings.cjs');
+var getCurrentEthereumNetworkId = require('../getCurrentEthereumNetworkId/getCurrentEthereumNetworkId.cjs');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n["default"] = e;
+  return Object.freeze(n);
+}
+
+var chains__namespace = /*#__PURE__*/_interopNamespace(chains);
+
+const getChainById = (chainId) => {
+    if (!chainId) {
+        throw new Error('Chain with id undefined not found');
+    }
+    const idNumber = typeof chainId === 'string' ? parseInt(chainId) : chainId;
+    const chain = Object.values(chains__namespace).find((chain) => chain.id === idNumber);
+    if (!chain) {
+        throw new Error(`Chain with id ${chainId} not found`);
+    }
+    return chain;
+};
+const createKernelClient = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ wallet, chainId, bundlerProvider, bundlerRpc, paymasterRpc, paymaster, }) {
+    var _b;
+    try {
+        const eoaWallet = getEoaWalletForSmartWallet.getEoaWalletForSmartWallet({
+            smartWallet: wallet,
+        });
+        if (!eoaWallet) {
+            throw new Error('EOA wallet not found');
+        }
+        const client = getClient.getClient(wallet);
+        const chain = chainId !== null && chainId !== void 0 ? chainId : getCurrentEthereumNetworkId.getCurrentEthereumNetworkId(client);
+        if (!chain) {
+            throw new Error('No chain specified');
+        }
+        const provider = createEIP1193Provider.createEIP1193Provider(client);
+        const walletClient = yield viem.createWalletClient({
+            account: eoaWallet.address,
+            chain: getChainById(chain),
+            transport: viem.custom(provider),
+        });
+        const accountSettings = yield getKernelAccountSettings.getKernelAccountSettings({ chainId, wallet });
+        const params = {
+            apiKernelVersion: accountSettings.kernelVersion,
+            bundlerRpc,
+            chain: getChainById(accountSettings.chainId),
+            enableKernelV3Migration: false,
+            entryPoint: accountSettings.entryPoint,
+            kernelVersion: accountSettings.kernelVersion,
+            paymaster: paymaster !== null && paymaster !== void 0 ? paymaster : ethereumAa.PaymasterTypeEnum.NONE,
+            paymasterRpc,
+            projectId: accountSettings.projectId,
+            provider: bundlerProvider,
+            signer: walletClient,
+        };
+        if (accountSettings.enableEIP7702) {
+            return ethereumAa.createEcdsaKernelAccountClientWith7702(Object.assign(Object.assign({}, params), { kernelVersion: constants.KERNEL_V3_3 }));
+        }
+        return ethereumAa.createEcdsaKernelAccountClient(Object.assign(Object.assign({}, params), { ecdsaValidator: ethereumAa.getEcdsaValidator((_b = accountSettings.ecdsaProviderType) !== null && _b !== void 0 ? _b : undefined) }));
+    }
+    catch (error) {
+        logger.logger.error(error);
+        throw error;
+    }
+});
+
+exports.createKernelClient = createKernelClient;

package/src/lib/functions/createKernelClient/createKernelClient.d.ts

@@ -0,0 +1,15 @@
+import { KernelAccountClient } from '@zerodev/sdk';
+import { type Chain as ViemChain, Client, RpcSchema, Transport } from 'viem';
+import { SmartAccount } from 'viem/account-abstraction';
+import { BaseWallet, ZerodevBundlerProvider } from '@dynamic-labs/types';
+import { PaymasterType } from '@dynamic-labs/ethereum-aa';
+type CreateKernelAccountClientArgs = {
+    wallet: BaseWallet;
+    chainId?: number;
+    bundlerProvider?: ZerodevBundlerProvider;
+    bundlerRpc?: string;
+    paymasterRpc?: string;
+    paymaster?: PaymasterType;
+};
+export declare const createKernelClient: ({ wallet, chainId, bundlerProvider, bundlerRpc, paymasterRpc, paymaster, }: CreateKernelAccountClientArgs) => Promise<KernelAccountClient<Transport, ViemChain, SmartAccount, Client, RpcSchema>>;
+export {};

package/src/lib/functions/createKernelClient/createKernelClient.js

@@ -0,0 +1,75 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { createWalletClient, custom } from 'viem';
+import * as chains from 'viem/chains';
+import { KERNEL_V3_3 } from '@zerodev/sdk/constants';
+import { PaymasterTypeEnum, createEcdsaKernelAccountClientWith7702, createEcdsaKernelAccountClient, getEcdsaValidator } from '@dynamic-labs/ethereum-aa';
+import { getEoaWalletForSmartWallet } from '../getEoaWalletForSmartWallet/getEoaWalletForSmartWallet.js';
+import { logger } from '../../constants/logger.js';
+import { createEIP1193Provider } from '../../ethereum/functions/eip1193Provider/createEIP1193Provider.js';
+import 'eventemitter3';
+import '@dynamic-labs/logger';
+import '@dynamic-labs/store';
+import '../../errors/DisconnectError.js';
+import '@dynamic-labs/utils';
+import { getClient } from '../../client/getClient/getClient.js';
+import { getKernelAccountSettings } from '../getKernelAccountSettings/getKernelAccountSettings.js';
+import { getCurrentEthereumNetworkId } from '../getCurrentEthereumNetworkId/getCurrentEthereumNetworkId.js';
+
+const getChainById = (chainId) => {
+    if (!chainId) {
+        throw new Error('Chain with id undefined not found');
+    }
+    const idNumber = typeof chainId === 'string' ? parseInt(chainId) : chainId;
+    const chain = Object.values(chains).find((chain) => chain.id === idNumber);
+    if (!chain) {
+        throw new Error(`Chain with id ${chainId} not found`);
+    }
+    return chain;
+};
+const createKernelClient = (_a) => __awaiter(void 0, [_a], void 0, function* ({ wallet, chainId, bundlerProvider, bundlerRpc, paymasterRpc, paymaster, }) {
+    var _b;
+    try {
+        const eoaWallet = getEoaWalletForSmartWallet({
+            smartWallet: wallet,
+        });
+        if (!eoaWallet) {
+            throw new Error('EOA wallet not found');
+        }
+        const client = getClient(wallet);
+        const chain = chainId !== null && chainId !== void 0 ? chainId : getCurrentEthereumNetworkId(client);
+        if (!chain) {
+            throw new Error('No chain specified');
+        }
+        const provider = createEIP1193Provider(client);
+        const walletClient = yield createWalletClient({
+            account: eoaWallet.address,
+            chain: getChainById(chain),
+            transport: custom(provider),
+        });
+        const accountSettings = yield getKernelAccountSettings({ chainId, wallet });
+        const params = {
+            apiKernelVersion: accountSettings.kernelVersion,
+            bundlerRpc,
+            chain: getChainById(accountSettings.chainId),
+            enableKernelV3Migration: false,
+            entryPoint: accountSettings.entryPoint,
+            kernelVersion: accountSettings.kernelVersion,
+            paymaster: paymaster !== null && paymaster !== void 0 ? paymaster : PaymasterTypeEnum.NONE,
+            paymasterRpc,
+            projectId: accountSettings.projectId,
+            provider: bundlerProvider,
+            signer: walletClient,
+        };
+        if (accountSettings.enableEIP7702) {
+            return createEcdsaKernelAccountClientWith7702(Object.assign(Object.assign({}, params), { kernelVersion: KERNEL_V3_3 }));
+        }
+        return createEcdsaKernelAccountClient(Object.assign(Object.assign({}, params), { ecdsaValidator: getEcdsaValidator((_b = accountSettings.ecdsaProviderType) !== null && _b !== void 0 ? _b : undefined) }));
+    }
+    catch (error) {
+        logger.error(error);
+        throw error;
+    }
+});
+
+export { createKernelClient };

package/src/lib/functions/createKernelClient/index.d.ts

@@ -0,0 +1 @@
+export { createKernelClient } from './createKernelClient';

package/src/lib/functions/createZksyncSession/createZksyncSession.cjs

@@ -31,7 +31,7 @@ var getCurrentEthereumNetworkId = require('../getCurrentEthereumNetworkId/getCur
  * const { sessionId, expiresAt } = await createZksyncSession(Wallet, { sessionConfig });
  * ```
  */
-const createZksyncSession = (wallet_1, _a) => _tslib.__awaiter(void 0, [wallet_1, _a], void 0, function* (wallet, { sessionConfig }) {
+const createZksyncSession = (wallet_1, _a) => _tslib.__awaiter(void 0, [wallet_1, _a], void 0, function* (wallet, { sessionConfig, addModuleWithPaymaster }) {
     if (!isEthereumWallet.isEthereumWallet(wallet)) {
         throw new Error('Wallet is not an Ethereum wallet');
     }
@@ -40,11 +40,15 @@ const createZksyncSession = (wallet_1, _a) => _tslib.__awaiter(void 0, [wallet_1
     if (!chainId) {
         throw new Error('No chain id found');
     }
+    const params = [wallet.address, { sessionConfig }];
+    if (addModuleWithPaymaster) {
+        params[1].addModuleWithPaymaster = addModuleWithPaymaster;
+    }
     const { data } = yield getCore.getCore(client).request({
         args: {
             chainId,
             method: 'zksync_createSession',
-            params: [wallet.address, sessionConfig],
+            params,
         },
         connection: getActiveConnection.getActiveConnection(client),
         name: 'zksync-request',

package/src/lib/functions/createZksyncSession/createZksyncSession.d.ts

@@ -1,7 +1,9 @@
 import { SessionConfig } from 'zksync-sso/utils';
 import { BaseWallet, ConvertBigIntToString } from '@dynamic-labs/types';
+type SessionConfigAsString = Omit<ConvertBigIntToString<SessionConfig>, 'signer'>;
 type createZksyncSessionParams = {
-    sessionConfig: Omit<ConvertBigIntToString<SessionConfig>, 'signer'>;
+    addModuleWithPaymaster?: boolean;
+    sessionConfig: SessionConfigAsString;
 };
 /**
  * Creates a session with the wallet.
@@ -18,7 +20,7 @@ type createZksyncSessionParams = {
  * const { sessionId, expiresAt } = await createZksyncSession(Wallet, { sessionConfig });
  * ```
  */
-export declare const createZksyncSession: (wallet: BaseWallet, { sessionConfig }: createZksyncSessionParams) => Promise<{
+export declare const createZksyncSession: (wallet: BaseWallet, { sessionConfig, addModuleWithPaymaster }: createZksyncSessionParams) => Promise<{
     sessionId: string;
     expiresAt: string;
 }>;

package/src/lib/functions/createZksyncSession/createZksyncSession.js

@@ -27,7 +27,7 @@ import { getCurrentEthereumNetworkId } from '../getCurrentEthereumNetworkId/getC
  * const { sessionId, expiresAt } = await createZksyncSession(Wallet, { sessionConfig });
  * ```
  */
-const createZksyncSession = (wallet_1, _a) => __awaiter(void 0, [wallet_1, _a], void 0, function* (wallet, { sessionConfig }) {
+const createZksyncSession = (wallet_1, _a) => __awaiter(void 0, [wallet_1, _a], void 0, function* (wallet, { sessionConfig, addModuleWithPaymaster }) {
     if (!isEthereumWallet(wallet)) {
         throw new Error('Wallet is not an Ethereum wallet');
     }
@@ -36,11 +36,15 @@ const createZksyncSession = (wallet_1, _a) => __awaiter(void 0, [wallet_1, _a],
     if (!chainId) {
         throw new Error('No chain id found');
     }
+    const params = [wallet.address, { sessionConfig }];
+    if (addModuleWithPaymaster) {
+        params[1].addModuleWithPaymaster = addModuleWithPaymaster;
+    }
     const { data } = yield getCore(client).request({
         args: {
             chainId,
             method: 'zksync_createSession',
-            params: [wallet.address, sessionConfig],
+            params,
         },
         connection: getActiveConnection(client),
         name: 'zksync-request',

package/src/lib/functions/getKernelAccountSettings/getKernelAccountSettings.cjs

@@ -0,0 +1,61 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _tslib = require('../../../../_virtual/_tslib.cjs');
+var ethereumAa = require('@dynamic-labs/ethereum-aa');
+require('eventemitter3');
+require('@dynamic-labs/logger');
+require('@dynamic-labs/store');
+require('../../errors/DisconnectError.cjs');
+require('@dynamic-labs/utils');
+require('../../constants/logger.cjs');
+var getCore = require('../../client/getCore/getCore.cjs');
+var getClient = require('../../client/getClient/getClient.cjs');
+var getCurrentEthereumNetworkId = require('../getCurrentEthereumNetworkId/getCurrentEthereumNetworkId.cjs');
+
+const getZeroDevClientId = (_a) => _tslib.__awaiter(void 0, [_a], void 0, function* ({ wallet, zeroDevSettings, chainId, }) {
+    var _b;
+    const network = chainId || getCurrentEthereumNetworkId.getCurrentEthereumNetworkId(getClient.getClient(wallet));
+    if (!network) {
+        throw new Error('Network not found');
+    }
+    const chainConfig = (_b = zeroDevSettings.multichainAccountAbstractionProviders) === null || _b === void 0 ? void 0 : _b.find((chainConfig) => chainConfig.chain === network.toString());
+    if (!chainConfig) {
+        throw new Error('Chain config not found');
+    }
+    return chainConfig.clientId;
+});
+const getKernelAccountSettings = (args) => _tslib.__awaiter(void 0, void 0, void 0, function* () {
+    if (!args) {
+        throw new Error('No arguments provided');
+    }
+    const client = getClient.getClient(args.wallet);
+    const core = getCore.getCore(client);
+    const { zeroDevSettings } = core.store.getState().settings;
+    if (!zeroDevSettings) {
+        throw new Error('ZeroDev provider is not enabled');
+    }
+    const clientId = yield getZeroDevClientId({
+        chainId: args === null || args === void 0 ? void 0 : args.chainId,
+        wallet: args === null || args === void 0 ? void 0 : args.wallet,
+        zeroDevSettings,
+    });
+    const { kernelVersion, ecdsaProviderType, entryPointVersion, enableEIP7702 } = zeroDevSettings;
+    if (!clientId) {
+        throw new Error('ZeroDev clientId is not set');
+    }
+    const chain = yield ethereumAa.fetchZeroDevChain(clientId);
+    const entryPoint = ethereumAa.getEntryPoint(entryPointVersion);
+    return {
+        chainId: chain.id,
+        ecdsaProviderType: ecdsaProviderType !== null && ecdsaProviderType !== void 0 ? ecdsaProviderType : null,
+        enableEIP7702,
+        entryPoint,
+        kernelVersion: ethereumAa.getKernelVersion(kernelVersion, entryPoint),
+        projectId: clientId,
+    };
+});
+
+exports.getKernelAccountSettings = getKernelAccountSettings;

package/src/lib/functions/getKernelAccountSettings/getKernelAccountSettings.d.ts

@@ -0,0 +1,5 @@
+import { BaseWallet, KernelAccountSettings } from '@dynamic-labs/types';
+export declare const getKernelAccountSettings: (args: {
+    chainId?: number;
+    wallet: BaseWallet;
+} | void) => Promise<KernelAccountSettings>;

package/src/lib/functions/getKernelAccountSettings/getKernelAccountSettings.js

@@ -0,0 +1,57 @@
+'use client'
+import { __awaiter } from '../../../../_virtual/_tslib.js';
+import { fetchZeroDevChain, getEntryPoint, getKernelVersion } from '@dynamic-labs/ethereum-aa';
+import 'eventemitter3';
+import '@dynamic-labs/logger';
+import '@dynamic-labs/store';
+import '../../errors/DisconnectError.js';
+import '@dynamic-labs/utils';
+import '../../constants/logger.js';
+import { getCore } from '../../client/getCore/getCore.js';
+import { getClient } from '../../client/getClient/getClient.js';
+import { getCurrentEthereumNetworkId } from '../getCurrentEthereumNetworkId/getCurrentEthereumNetworkId.js';
+
+const getZeroDevClientId = (_a) => __awaiter(void 0, [_a], void 0, function* ({ wallet, zeroDevSettings, chainId, }) {
+    var _b;
+    const network = chainId || getCurrentEthereumNetworkId(getClient(wallet));
+    if (!network) {
+        throw new Error('Network not found');
+    }
+    const chainConfig = (_b = zeroDevSettings.multichainAccountAbstractionProviders) === null || _b === void 0 ? void 0 : _b.find((chainConfig) => chainConfig.chain === network.toString());
+    if (!chainConfig) {
+        throw new Error('Chain config not found');
+    }
+    return chainConfig.clientId;
+});
+const getKernelAccountSettings = (args) => __awaiter(void 0, void 0, void 0, function* () {
+    if (!args) {
+        throw new Error('No arguments provided');
+    }
+    const client = getClient(args.wallet);
+    const core = getCore(client);
+    const { zeroDevSettings } = core.store.getState().settings;
+    if (!zeroDevSettings) {
+        throw new Error('ZeroDev provider is not enabled');
+    }
+    const clientId = yield getZeroDevClientId({
+        chainId: args === null || args === void 0 ? void 0 : args.chainId,
+        wallet: args === null || args === void 0 ? void 0 : args.wallet,
+        zeroDevSettings,
+    });
+    const { kernelVersion, ecdsaProviderType, entryPointVersion, enableEIP7702 } = zeroDevSettings;
+    if (!clientId) {
+        throw new Error('ZeroDev clientId is not set');
+    }
+    const chain = yield fetchZeroDevChain(clientId);
+    const entryPoint = getEntryPoint(entryPointVersion);
+    return {
+        chainId: chain.id,
+        ecdsaProviderType: ecdsaProviderType !== null && ecdsaProviderType !== void 0 ? ecdsaProviderType : null,
+        enableEIP7702,
+        entryPoint,
+        kernelVersion: getKernelVersion(kernelVersion, entryPoint),
+        projectId: clientId,
+    };
+});
+
+export { getKernelAccountSettings };

package/src/lib/functions/getKernelAccountSettings/index.d.ts

@@ -0,0 +1 @@
+export { getKernelAccountSettings } from './getKernelAccountSettings';

package/src/zerodev.cjs

@@ -0,0 +1,10 @@
+'use client'
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var createKernelClient = require('./lib/functions/createKernelClient/createKernelClient.cjs');
+
+
+
+exports.createKernelClient = createKernelClient.createKernelClient;

package/src/zerodev.d.ts

@@ -0,0 +1 @@
+export { createKernelClient } from './lib/functions/createKernelClient';

package/src/zerodev.js

@@ -0,0 +1,2 @@
+'use client'
+export { createKernelClient } from './lib/functions/createKernelClient/createKernelClient.js';