@zerodev/sdk 5.4.9 → 5.4.11

package/accounts/kernel/createKernelAccount.ts

@@ -1,4 +1,5 @@
 import {
+    http,
     type Address,
     type Assign,
     type Client,
@@ -6,8 +7,10 @@ import {
     type Hex,
     type SignableMessage,
     type TypedDataDefinition,
+    concat,
     concatHex,
     createNonceManager,
+    createWalletClient,
     encodeFunctionData,
     getTypesForEIP712Domain,
     hashMessage,
@@ -26,11 +29,17 @@ import {
     entryPoint07Address,
     toSmartAccount
 } from "viem/account-abstraction"
-import { getChainId } from "viem/actions"
+import {
+    type SignAuthorizationReturnType,
+    privateKeyToAccount
+} from "viem/accounts"
+import { getChainId, getCode, writeContract } from "viem/actions"
+import { odysseyTestnet } from "viem/chains"
 import { getAction } from "viem/utils"
 import {
     getAccountNonce,
-    getSenderAddress
+    getSenderAddress,
+    isPluginInstalled
 } from "../../actions/public/index.js"
 import {
     KernelVersionToAddressesMap,
@@ -42,7 +51,8 @@ import type {
     GetEntryPointAbi,
     GetKernelVersion,
     KernelPluginManager,
-    KernelPluginManagerParams
+    KernelPluginManagerParams,
+    PluginMigrationData
 } from "../../types/kernel.js"
 import { KERNEL_FEATURES, hasKernelFeature } from "../../utils.js"
 import { validateKernelVersionWithEntryPoint } from "../../utils.js"
@@ -51,7 +61,10 @@ import {
     toKernelPluginManager
 } from "../utils/toKernelPluginManager.js"
 import { KernelInitAbi } from "./abi/KernelAccountAbi.js"
-import { KernelV3InitAbi } from "./abi/kernel_v_3_0_0/KernelAccountAbi.js"
+import {
+    KernelV3AccountAbi,
+    KernelV3InitAbi
+} from "./abi/kernel_v_3_0_0/KernelAccountAbi.js"
 import { KernelV3FactoryAbi } from "./abi/kernel_v_3_0_0/KernelFactoryAbi.js"
 import { KernelFactoryStakerAbi } from "./abi/kernel_v_3_0_0/KernelFactoryStakerAbi.js"
 import { KernelV3_1AccountAbi } from "./abi/kernel_v_3_1/KernelAccountAbi.js"
@@ -61,6 +74,7 @@ import { encodeCallData as encodeCallDataEpV07 } from "./utils/account/ep0_7/enc
 import { encodeDeployCallData as encodeDeployCallDataV07 } from "./utils/account/ep0_7/encodeDeployCallData.js"
 import { accountMetadata } from "./utils/common/accountMetadata.js"
 import { eip712WrapHash } from "./utils/common/eip712WrapHash.js"
+import { getPluginInstallCallData } from "./utils/plugins/ep0_7/getPluginInstallCallData.js"
 
 type SignMessageParameters = {
     message: SignableMessage
@@ -91,6 +105,7 @@ export type KernelSmartAccountImplementation<
             bytecode
         }: EncodeDeployDataParameters) => Promise<Hex>
         signMessage: (parameters: SignMessageParameters) => Promise<Hex>
+        eip7702Auth?: SignAuthorizationReturnType
     }
 >
 
@@ -117,6 +132,8 @@ export type CreateKernelAccountParameters<
     kernelVersion: GetKernelVersion<entryPointVersion>
     initConfig?: KernelVerion extends "0.3.1" ? Hex[] : never
     useMetaFactory?: boolean
+    eip7702Auth?: SignAuthorizationReturnType
+    pluginMigrations?: PluginMigrationData[]
 }
 
 /**
@@ -329,6 +346,11 @@ const getDefaultAddresses = <entryPointVersion extends EntryPointVersion>(
     }
 }
 
+type PluginInstallationCache = {
+    pendingPlugins: PluginMigrationData[]
+    allInstalled: boolean
+}
+
 /**
  * Build a kernel smart account from a private key, that use the ECDSA signer behind the scene
  * @param client
@@ -355,7 +377,9 @@ export async function createKernelAccount<
         address,
         kernelVersion,
         initConfig,
-        useMetaFactory = true
+        useMetaFactory = true,
+        eip7702Auth,
+        pluginMigrations
     }: CreateKernelAccountParameters<entryPointVersion, KernelVersion>
 ): Promise<CreateKernelAccountReturnType<entryPointVersion>> {
     const { accountImplementationAddress, factoryAddress, metaFactoryAddress } =
@@ -449,7 +473,82 @@ export async function createKernelAccount<
         version: entryPoint?.version ?? "0.7"
     } as const
 
+    if (eip7702Auth && client.chain && client.chain.id === odysseyTestnet.id) {
+        let code = await getCode(client, { address: accountAddress })
+        const isEip7702Authorized =
+            code?.length && code.length > 0 && code.startsWith("0xef")
+        console.log("Code before:", code)
+        console.log("Is Eip7702 Authorized:", isEip7702Authorized)
+        if (!isEip7702Authorized) {
+            const sponsorWalletClient = createWalletClient({
+                account: privateKeyToAccount(
+                    // NOTE: Don't worry about this private key, it's just for testing
+                    "0x688b84097239bc2bca41079d02fae599964a5844bc9e64f524206ad53a927bb9"
+                ),
+                chain: client.chain,
+                transport: http()
+            })
+            console.log("Authorizing eip7702 account...")
+            const txHash = await writeContract(sponsorWalletClient, {
+                address: accountAddress,
+                abi: KernelV3AccountAbi,
+                functionName: "initialize",
+                args: [
+                    concat([
+                        "0x01",
+                        "0x845ADb2C711129d4f3966735eD98a9F09fC4cE57"
+                    ]),
+                    zeroAddress,
+                    accountAddress,
+                    "0x"
+                ],
+                authorizationList: [eip7702Auth]
+            })
+            console.log(
+                `Authorized eip7702 account: https://explorer-odyssey.t.conduit.xyz/tx/${txHash}`
+            )
+            code = await getCode(client, { address: accountAddress })
+            while (code?.length === undefined || code.length === 0) {
+                code = await getCode(client, { address: accountAddress })
+            }
+            console.log("Code after:", code)
+        }
+    }
+
+    // Cache for plugin installation status
+    const pluginCache: PluginInstallationCache = {
+        pendingPlugins: pluginMigrations || [],
+        allInstalled: false
+    }
+
+    const checkPluginInstallationStatus = async () => {
+        // Skip if no plugins or all are installed
+        if (!pluginCache.pendingPlugins.length || pluginCache.allInstalled) {
+            pluginCache.allInstalled = true
+            return
+        }
+
+        // Check all pending plugins in parallel
+        const installationResults = await Promise.all(
+            pluginCache.pendingPlugins.map((plugin) =>
+                isPluginInstalled(client, {
+                    address: accountAddress,
+                    plugin
+                })
+            )
+        )
+
+        // Filter out installed plugins
+        pluginCache.pendingPlugins = pluginCache.pendingPlugins.filter(
+            (_, index) => !installationResults[index]
+        )
+        pluginCache.allInstalled = pluginCache.pendingPlugins.length === 0
+    }
+
+    await checkPluginInstallationStatus()
+
     return toSmartAccount<KernelSmartAccountImplementation<entryPointVersion>>({
+        eip7702Auth,
         kernelVersion,
         kernelPluginManager,
         factoryAddress: (await getFactoryArgs()).factory,
@@ -487,6 +586,25 @@ export async function createKernelAccount<
             return encodeDeployCallDataV07(_tx)
         },
         async encodeCalls(calls, callType) {
+            // Check plugin status only if we have pending plugins
+            await checkPluginInstallationStatus()
+
+            // Add plugin installation calls if needed
+            if (
+                pluginCache.pendingPlugins.length > 0 &&
+                entryPoint.version === "0.7" &&
+                kernelPluginManager.activeValidatorMode === "sudo"
+            ) {
+                const pluginInstallCalls = pluginCache.pendingPlugins.map(
+                    (plugin) => getPluginInstallCallData(accountAddress, plugin)
+                )
+                return encodeCallDataEpV07(
+                    [...calls, ...pluginInstallCalls],
+                    callType,
+                    plugins.hook ? true : undefined
+                )
+            }
+
             if (
                 calls.length === 1 &&
                 (!callType || callType === "call") &&

package/accounts/kernel/utils/plugins/ep0_7/getPluginInstallCallData.ts

@@ -0,0 +1,19 @@
+import { type Address, encodeFunctionData } from "viem"
+import type { PluginMigrationData } from "../../../../../types/kernel.js"
+import { KernelModuleInstallAbi } from "../../../abi/kernel_v_3_0_0/KernelModuleAbi.js"
+import type { CallArgs } from "../../types.js"
+
+export const getPluginInstallCallData = (
+    accountAddress: Address,
+    plugin: PluginMigrationData
+): CallArgs => {
+    const data = encodeFunctionData({
+        abi: KernelModuleInstallAbi,
+        functionName: "installModule",
+        args: [plugin.type, plugin.address, plugin.data]
+    })
+    return {
+        to: accountAddress,
+        data
+    }
+}

package/accounts/utils/toKernelPluginManager.ts

@@ -264,6 +264,7 @@ export async function toKernelPluginManager<
     return {
         sudoValidator: sudo,
         regularValidator: regular,
+        activeValidatorMode: sudo && !regular ? "sudo" : "regular",
         ...activeValidator,
         hook,
         getIdentifier,

package/actions/public/index.ts

@@ -9,3 +9,4 @@ export {
 } from "./getSenderAddress.js"
 export { isSmartAccountDeployed } from "./isSmartAccountDeployed.js"
 export { getKernelImplementationAddress } from "./getKernelImplementationAddress.js"
+export { isPluginInstalled } from "./isPluginInstalled.js"

package/actions/public/isPluginInstalled.ts

@@ -0,0 +1,62 @@
+import type { Address, Client, Hex } from "viem"
+import { readContract } from "viem/actions"
+import { getAction } from "viem/utils"
+import { KernelModuleIsModuleInstalledAbi } from "../../accounts/kernel/abi/kernel_v_3_0_0/KernelModuleAbi.js"
+import type { PLUGIN_TYPE } from "../../constants.js"
+
+export type IsPluginInstalledParams = {
+    address: Address
+    plugin: {
+        type: (typeof PLUGIN_TYPE)[keyof typeof PLUGIN_TYPE]
+        address: Address
+        data?: Hex
+    }
+}
+
+/**
+ * Returns whether a plugin is installed on the account.
+ *
+ * @param client - Client to use
+ * @param args - {@link IsPluginInstalledParams} address and plugin details
+ * @returns boolean indicating if plugin is installed
+ *
+ * @example
+ * import { createPublicClient } from "viem"
+ * import { isPluginInstalled } from "@zerodev/sdk"
+ *
+ * const client = createPublicClient({
+ *      chain: mainnet,
+ *      transport: http()
+ * })
+ *
+ * const isInstalled = await isPluginInstalled(client, {
+ *      address: accountAddress,
+ *      plugin: {
+ *          type: PLUGIN_TYPE.VALIDATOR,
+ *          address: validatorAddress,
+ *          data: "0x"
+ *      }
+ * })
+ */
+export const isPluginInstalled = async (
+    client: Client,
+    args: IsPluginInstalledParams
+): Promise<boolean> => {
+    const { address, plugin } = args
+    const { type, address: pluginAddress, data = "0x" } = plugin
+
+    try {
+        return await getAction(
+            client,
+            readContract,
+            "readContract"
+        )({
+            address,
+            abi: KernelModuleIsModuleInstalledAbi,
+            functionName: "isModuleInstalled",
+            args: [BigInt(type), pluginAddress, data]
+        })
+    } catch (error) {
+        return false
+    }
+}

package/constants.ts

@@ -120,6 +120,15 @@ export enum EXEC_TYPE {
     TRY_EXEC = "0x01"
 }
 
+export const PLUGIN_TYPE = {
+    VALIDATOR: 1,
+    EXECUTOR: 2,
+    FALLBACK: 3,
+    HOOK: 4,
+    POLICY: 5,
+    SIGNER: 6
+}
+
 // Safe's library for create and create2: https://github.com/safe-global/safe-contracts/blob/0acdd35a203299585438f53885df630f9d486a86/contracts/libraries/CreateCall.sol
 // Address was found here: https://github.com/safe-global/safe-deployments/blob/926ec6bbe2ebcac3aa2c2c6c0aff74aa590cbc6a/src/assets/v1.4.1/create_call.json
 export const safeCreateCallAddress =
@@ -147,3 +156,6 @@ export const getEntryPoint = <TEntryPointVersion extends EntryPointVersion>(
         version: entryPointVersion
     }
 }
+
+export const KERNEL_7702_DELEGATION_ADDRESS =
+    "0x94F097E1ebEB4ecA3AAE54cabb08905B239A7D27"

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zerodev/sdk",
-    "version": "5.4.9",
+    "version": "5.4.11",
     "author": "ZeroDev",
     "main": "./_cjs/index.js",
     "module": "./_esm/index.js",

package/types/index.ts

@@ -14,7 +14,8 @@ export type {
     KERNEL_VERSION_TYPE,
     GetKernelVersion,
     GetEntryPointAbi,
-    EntryPointType
+    EntryPointType,
+    PluginMigrationData
 } from "./kernel.js"
 
 export { ValidatorMode } from "./kernel.js"

package/types/kernel.ts

@@ -5,7 +5,7 @@ import type {
     entryPoint06Abi,
     entryPoint07Abi
 } from "viem/account-abstraction"
-import type { VALIDATOR_TYPE } from "../constants.js"
+import type { PLUGIN_TYPE, VALIDATOR_TYPE } from "../constants.js"
 export type ZeroDevPaymasterRpcSchema<
     entryPointVersion extends EntryPointVersion
 > = [
@@ -154,10 +154,13 @@ export type ValidatorInitData = {
     initConfig?: Hex[]
 }
 
+export type ActiveValidatorMode = "sudo" | "regular"
+
 export type KernelPluginManager<entryPointVersion extends EntryPointVersion> =
     KernelValidator & {
         sudoValidator?: KernelValidator
         regularValidator?: KernelValidator
+        activeValidatorMode: ActiveValidatorMode
         hook?: KernelValidatorHook
         getPluginEnableSignature(accountAddress: Address): Promise<Hex>
         getValidatorInitData(): Promise<ValidatorInitData>
@@ -221,6 +224,12 @@ export enum ValidatorMode {
     enable = "0x00000002"
 }
 
+export type PluginMigrationData = {
+    type: (typeof PLUGIN_TYPE)[keyof typeof PLUGIN_TYPE]
+    address: Address
+    data: Hex
+}
+
 export type CallType = "call" | "delegatecall"
 
 export type KernelEncodeCallDataArgs = {