@zerodev/sdk 4.7.3 → 5.0.0-alpha-0

package/_types/types/kernel.d.ts

@@ -0,0 +1,136 @@
+import type { EntryPoint } from "permissionless/types";
+import type { GetEntryPointVersion } from "permissionless/types/entrypoint";
+import type { UserOperation, UserOperationWithBigIntAsHex } from "permissionless/types/userOperation";
+import { type Address, type Hex, type LocalAccount } from "viem";
+import type { PartialBy } from "viem/types/utils";
+import { VALIDATOR_TYPE } from "../constants.js";
+export type ZeroDevPaymasterRpcSchema<entryPoint extends EntryPoint> = [
+    {
+        Method: "zd_sponsorUserOperation";
+        Parameters: [
+            {
+                chainId: number;
+                userOp: GetEntryPointVersion<entryPoint> extends "v0.6" ? PartialBy<UserOperationWithBigIntAsHex<"v0.6">, "callGasLimit" | "preVerificationGas" | "verificationGasLimit"> : PartialBy<UserOperationWithBigIntAsHex<"v0.7">, "callGasLimit" | "preVerificationGas" | "verificationGasLimit" | "paymasterVerificationGasLimit" | "paymasterPostOpGasLimit">;
+                entryPointAddress: Address;
+                gasTokenData?: {
+                    tokenAddress: Hex;
+                };
+                shouldOverrideFee?: boolean;
+                manualGasEstimation?: boolean;
+                shouldConsume?: boolean;
+            }
+        ];
+        ReturnType: GetEntryPointVersion<entryPoint> extends "v0.6" ? {
+            paymasterAndData: Hex;
+            preVerificationGas: Hex;
+            verificationGasLimit: Hex;
+            callGasLimit: Hex;
+            maxFeePerGas: Hex;
+            maxPriorityFeePerGas: Hex;
+            paymaster?: never;
+            paymasterVerificationGasLimit?: never;
+            paymasterPostOpGasLimit?: never;
+            paymasterData?: never;
+        } : {
+            preVerificationGas: Hex;
+            verificationGasLimit: Hex;
+            callGasLimit: Hex;
+            paymaster: Address;
+            paymasterVerificationGasLimit: Hex;
+            paymasterPostOpGasLimit: Hex;
+            paymasterData: Hex;
+            paymasterAndData?: never;
+        };
+    },
+    {
+        Method: "zd_pm_accounts";
+        Parameters: [
+            {
+                chainId: number;
+                entryPointAddress: Address;
+            }
+        ];
+        ReturnType: Address[];
+    },
+    {
+        Method: "stackup_getERC20TokenQuotes";
+        Parameters: [
+            {
+                chainId: number;
+                userOp: UserOperationWithBigIntAsHex<"v0.6">;
+                entryPointAddress: Address;
+                tokenAddress: Address;
+            }
+        ];
+        ReturnType: {
+            maxGasCostToken: string;
+            tokenDecimals: string;
+        };
+    }
+];
+export type ValidatorType = keyof typeof VALIDATOR_TYPE;
+export type KernelValidator<entryPoint extends EntryPoint, Name extends string = string, type extends ValidatorType = "SUDO"> = type extends "PERMISSION" ? LocalAccount<Name> & {
+    getNonceKey: (accountAddress?: Address) => Promise<bigint>;
+    getDummySignature(userOperation: UserOperation<GetEntryPointVersion<entryPoint>>, pluginEnableSignature?: Hex): Promise<Hex>;
+    signUserOperation: (userOperation: UserOperation<GetEntryPointVersion<entryPoint>>, pluginEnableSignature?: Hex) => Promise<Hex>;
+    getEnableData(accountAddress?: Address): Promise<Hex>;
+    isEnabled(accountAddress: Address, selector: Hex): Promise<boolean>;
+    isPermissionValidator: boolean;
+    getPermissionId: () => Hex;
+} : LocalAccount<Name> & {
+    getNonceKey: (accountAddress?: Address) => Promise<bigint>;
+    getDummySignature(userOperation: UserOperation<GetEntryPointVersion<entryPoint>>, pluginEnableSignature?: Hex): Promise<Hex>;
+    signUserOperation: (userOperation: UserOperation<GetEntryPointVersion<entryPoint>>, pluginEnableSignature?: Hex) => Promise<Hex>;
+    getEnableData(accountAddress?: Address): Promise<Hex>;
+    isEnabled(accountAddress: Address, selector: Hex): Promise<boolean>;
+    isPermissionValidator: boolean;
+};
+export type ValidatorInitData = {
+    validatorAddress: Address;
+    enableData: Hex;
+};
+export type KernelPluginManager<entryPoint extends EntryPoint> = KernelValidator<entryPoint> & {
+    getPluginEnableSignature(accountAddress: Address): Promise<Hex>;
+    getValidatorInitData(): Promise<ValidatorInitData>;
+    getExecutorData(): ExecutorData;
+    getValidityData(): PluginValidityData;
+};
+export type KernelPluginManagerParams<entryPoint extends EntryPoint> = {
+    sudo?: KernelValidator<entryPoint>;
+    regular?: KernelValidator<entryPoint>;
+    pluginEnableSignature?: Hex;
+    validatorInitData?: ValidatorInitData;
+    executorData?: ExecutorData;
+    entryPoint: entryPoint;
+} & Partial<PluginValidityData>;
+export type ExecutorData = {
+    executor: Address;
+    selector: Hex;
+};
+export type PluginValidityData = {
+    validUntil: number;
+    validAfter: number;
+};
+export declare enum ValidatorMode {
+    sudo = "0x00000000",
+    plugin = "0x00000001",
+    enable = "0x00000002"
+}
+export type CallType = "call" | "delegatecall";
+export type KernelEncodeCallDataArgs = {
+    to: Address;
+    value: bigint;
+    data: Hex;
+    callType: CallType | undefined;
+} | {
+    to: Address;
+    value: bigint;
+    data: Hex;
+    callType: CallType | undefined;
+}[];
+export type Execution = {
+    target: Address;
+    value: bigint;
+    callData: Hex;
+};
+//# sourceMappingURL=kernel.d.ts.map

package/_types/types/kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../../types/kernel.ts"],"names":[],"mappings":"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"}

package/_types/utils.d.ts

@@ -0,0 +1,22 @@
+import type { EntryPoint } from "permissionless/types/entrypoint";
+import { type Address, type Hex } from "viem";
+import type { ZeroDevPaymasterClient } from "./clients/paymasterClient.js";
+import { CALL_TYPE, EXEC_TYPE } from "./constants.js";
+export declare const getKernelVersion: <entryPoint extends EntryPoint>(entryPointAddress: entryPoint, kernelImpl?: Address) => string;
+export declare enum KERNEL_FEATURES {
+    ERC1271_SIG_WRAPPER = "ERC1271_SIG_WRAPPER",
+    ERC1271_WITH_VALIDATOR = "ERC1271_WITH_VALIDATOR",
+    ERC1271_SIG_WRAPPER_WITH_WRAPPED_HASH = "ERC1271_SIG_WRAPPER_WITH_WRAPPED_HASH"
+}
+export declare const hasKernelFeature: (feature: KERNEL_FEATURES, version: string) => boolean;
+export declare const getERC20PaymasterApproveCall: (client: ZeroDevPaymasterClient<EntryPoint>, { gasToken, approveAmount }: {
+    gasToken: Address;
+    approveAmount: bigint;
+}) => Promise<{
+    to: Address;
+    value: bigint;
+    data: Hex;
+}>;
+export declare const fixSignedData: (sig: Hex) => Hex;
+export declare const getExecMode: (callType: CALL_TYPE, execType: EXEC_TYPE) => Hex;
+//# sourceMappingURL=utils.d.ts.map

package/_types/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAEjE,OAAO,EACH,KAAK,OAAO,EACZ,KAAK,GAAG,EASX,MAAM,MAAM,CAAA;AAEb,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EACH,SAAS,EACT,SAAS,EAGZ,MAAM,gBAAgB,CAAA;AAEvB,eAAO,MAAM,gBAAgB,8EAEZ,OAAO,KACrB,MAQF,CAAA;AAED,oBAAY,eAAe;IACvB,mBAAmB,wBAAwB;IAC3C,sBAAsB,2BAA2B;IACjD,qCAAqC,0CAA0C;CAClF;AAQD,eAAO,MAAM,gBAAgB,YAChB,eAAe,WACf,MAAM,KAChB,OAMF,CAAA;AAED,eAAO,MAAM,4BAA4B,WAC7B,uBAAuB,UAAU,CAAC;cAK5B,OAAO;mBACF,MAAM;MAE1B,QAAQ;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAmBnD,CAAA;AAED,eAAO,MAAM,aAAa,QAAS,GAAG,KAAG,GAaxC,CAAA;AAED,eAAO,MAAM,WAAW,aAAc,SAAS,YAAY,SAAS,KAAG,GAQtE,CAAA"}

package/accounts/addressToEmptyAccount.ts

@@ -0,0 +1,24 @@
+import type { Address, LocalAccount } from "viem"
+import { toAccount } from "viem/accounts"
+
+export type EmptyAccount = LocalAccount<"empty">
+export function addressToEmptyAccount(address: Address): EmptyAccount {
+    const account = toAccount({
+        address,
+        async signMessage() {
+            throw new Error("Method not supported")
+        },
+        async signTransaction(_transaction) {
+            throw new Error("Method not supported")
+        },
+        async signTypedData(_typedData) {
+            throw new Error("Method not supported")
+        }
+    })
+
+    return {
+        ...account,
+        publicKey: "0x",
+        source: "empty"
+    }
+}

package/accounts/index.ts

@@ -0,0 +1,9 @@
+export {
+    createKernelAccount,
+    type KernelSmartAccount,
+    KERNEL_ADDRESSES,
+    EIP1271ABI
+} from "./kernel/createKernelAccount.js"
+export { createKernelV1Account } from "./kernel/v1/createKernelV1Account.js"
+export { addressToEmptyAccount } from "./addressToEmptyAccount.js"
+export * from "./utils/index.js"