@zerodev/sdk 4.0.0

package/dist/types/kernel-zerodev/validator-provider/types.d.ts

@@ -0,0 +1,22 @@
+import type { ECDSAValidatorParams } from "../validator/ecdsa-validator.js";
+import type { ERC165SessionKeyValidatorParams } from "../validator/erc165-session-key-validator.js";
+import type { KillSwitchValidatorParams } from "../validator/kill-switch-validator.js";
+import type { SupportedValidators } from "../validator/types.js";
+import type { ExtendedValidatorProviderParams } from "./base.js";
+import type { ECDSAProvider } from "./ecdsa-provider.js";
+import type { ERC165SessionKeyProvider } from "./erc165-session-key-provider.js";
+import type { KillSwitchProvider } from "./kill-switch-provider.js";
+export type ValidatorProviderTypeMap = {
+    ECDSA: ECDSAProvider;
+    KILL_SWITCH: KillSwitchProvider;
+    ERC165_SESSION_KEY: ERC165SessionKeyProvider;
+};
+export type ValidatorProviderParamsMap = {
+    ECDSA: ExtendedValidatorProviderParams<ECDSAValidatorParams>;
+    KILL_SWITCH: ExtendedValidatorProviderParams<KillSwitchValidatorParams>;
+    ERC165_SESSION_KEY: ExtendedValidatorProviderParams<ERC165SessionKeyValidatorParams>;
+};
+export type ValidatorProviderMap = {
+    [V in SupportedValidators]: new (params: ValidatorProviderParamsMap[V]) => ValidatorProviderTypeMap[V];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/kernel-zerodev/validator-provider/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/kernel-zerodev/validator-provider/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,8CAA8C,CAAC;AACpG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,aAAa,CAAC;IACrB,WAAW,EAAE,kBAAkB,CAAC;IAChC,kBAAkB,EAAE,wBAAwB,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,KAAK,EAAE,+BAA+B,CAAC,oBAAoB,CAAC,CAAC;IAC7D,WAAW,EAAE,+BAA+B,CAAC,yBAAyB,CAAC,CAAC;IACxE,kBAAkB,EAAE,+BAA+B,CAAC,+BAA+B,CAAC,CAAC;CACtF,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;KAChC,CAAC,IAAI,mBAAmB,GAAG,KAC1B,MAAM,EAAE,0BAA0B,CAAC,CAAC,CAAC,KAClC,wBAAwB,CAAC,CAAC,CAAC;CACjC,CAAC"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@zerodev/sdk",
+  "version": "4.0.0",
+  "description": "A collection of ERC-4337 compliant smart contract account interfaces",
+  "author": "ZeroDev",
+  "license": "MIT",
+  "private": false,
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "typings": "./dist/types/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "passkey",
+    "dist",
+    "src/**/*.ts",
+    "!dist/**/*.tsbuildinfo",
+    "!vitest.config.ts",
+    "!.env",
+    "!src/**/*.test.ts",
+    "!src/__tests__/**/*"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "default": "./dist/cjs/index.js"
+    },
+    "./passkey": {
+      "import": "./dist/esm/kernel-zerodev/owner/passkey/index.js",
+      "default": "./dist/cjs/kernel-zerodev/owner/passkey/index.js",
+      "types": "./dist/types/kernel-zerodev/owner/passkey/index.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "yarn clean && yarn build:cjs && yarn build:esm && yarn build:types",
+    "build:cjs": "tsc --project tsconfig.build.json --module commonjs --outDir ./dist/cjs --removeComments --verbatimModuleSyntax false && echo > ./dist/cjs/package.json '{\"type\":\"commonjs\"}'",
+    "build:esm": "tsc --project tsconfig.build.json --module es2020 --outDir ./dist/esm --removeComments && echo > ./dist/esm/package.json '{\"type\":\"module\"}'",
+    "build:types": "tsc --project tsconfig.build.json --module esnext --declarationDir ./dist/types --emitDeclarationOnly --declaration --declarationMap",
+    "clean": "rm -rf ./dist",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:run-e2e": "vitest run --config vitest.config.e2e.ts"
+  },
+  "devDependencies": {
+    "@alchemy/aa-core": "^0.1.0-alpha.23",
+    "@alchemy/aa-ethers": "^0.1.0-alpha.23",
+    "@turnkey/ethers": "^0.16.5",
+    "typescript": "^5.0.4",
+    "typescript-template": "*",
+    "vitest": "^0.31.0"
+  },
+  "peerDependencies": {
+    "@alchemy/aa-core": "^0.1.0-alpha.23",
+    "@alchemy/aa-ethers": "^0.1.0-alpha.23"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zerodevapp/aa-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zerodevapp/aa-sdk/issues"
+  },
+  "homepage": "https://github.com/zerodevapp/aa-sdk/blob/zd-provider/packages/accounts/src/kernel-zerodev/README.md#readme",
+  "gitHead": "19ba05a77e4f7a0e04f44f34eaecf675fe2c12f2",
+  "dependencies": {
+    "axios": "^1.4.0",
+    "viem": "^1.5.3"
+  }
+}

package/passkey/package.json

@@ -0,0 +1,5 @@
+{
+  "main": "../dist/cjs/kernel-zerodev/owner/passkey/index.js",
+  "module": "../dist/esm/kernel-zerodev/owner/passkey/index.js",
+  "types": "../dist/types/kernel-zerodev/owner/passkey/index.d.ts"
+}

package/src/index.ts

@@ -0,0 +1,43 @@
+// Add you exports here, make sure to export types separately from impls and use the `type` keyword when exporting them
+// Don't use wildcard exports, instead use named exports
+
+//kernel exports
+export * from "./kernel-zerodev/abis/index.js";
+
+// Validator exports
+export {
+  ValidatorMode,
+  KernelBaseValidator,
+} from "./kernel-zerodev/validator/base.js";
+export * from "./kernel-zerodev/validator/index.js";
+export type * from "./kernel-zerodev/validator/types.js";
+export type { ECDSAValidatorParams } from "./kernel-zerodev/validator/ecdsa-validator.js";
+export type { KillSwitchValidatorParams } from "./kernel-zerodev/validator/kill-switch-validator.js";
+export type { ERC165SessionKeyValidatorParams } from "./kernel-zerodev/validator/erc165-session-key-validator.js";
+export type { KernelBaseValidatorParams } from "./kernel-zerodev/validator/base.js";
+
+// Validator Provider exports
+export { ValidatorProvider } from "./kernel-zerodev/validator-provider/base.js";
+export type {
+  ValidatorProviderParams,
+  ValidatorProviderParamsOpts,
+  ExtendedValidatorProviderParams,
+} from "./kernel-zerodev/validator-provider/base.js";
+export type * from "./kernel-zerodev/validator-provider/types.js";
+export * from "./kernel-zerodev/validator-provider/index.js";
+
+// Core exports
+export type * from "./kernel-zerodev/paymaster/types.js";
+export { KernelSmartContractAccount } from "./kernel-zerodev/account.js";
+export type { KernelSmartAccountParams } from "./kernel-zerodev/account.js";
+export { ZeroDevProvider } from "./kernel-zerodev/provider.js";
+
+// Utils exports
+export * from "./kernel-zerodev/utils.js";
+export { getChainId } from "./kernel-zerodev/api/index.js";
+export { ZeroDevEthersProvider } from "./kernel-zerodev/ethers-provider/ethers-provider.js";
+
+export * as constants from "./kernel-zerodev/constants.js";
+
+// Owner exports
+export * from "./kernel-zerodev/owner/index.js";

package/src/kernel-zerodev/__tests__/mocks/mock-signer.ts

@@ -0,0 +1,24 @@
+import type {
+  Address,
+  Hex,
+  SignTypedDataParams,
+  SmartAccountSigner,
+} from "@alchemy/aa-core";
+
+export class MockSigner implements SmartAccountSigner {
+  getAddress(): Promise<Address> {
+    return Promise.resolve("0x48D4d3536cDe7A257087206870c6B6E76e3D4ff4");
+  }
+
+  signMessage(_msg: Uint8Array | Hex | string): Promise<Hex> {
+    return Promise.resolve(
+      "0x4d61c5c27fb64b207cbf3bcf60d78e725659cff5f93db9a1316162117dff72aa631761619d93d4d97dfb761ba00b61f9274c6a4a76e494df644d968dd84ddcdb1c"
+    );
+  }
+
+  signTypedData(_params: SignTypedDataParams): Promise<`0x${string}`> {
+    return Promise.resolve(
+      "0x4d61c5c27fb64b207cbf3bcf60d78e725659cff5f93db9a1316162117dff72aa631761619d93d4d97dfb761ba00b61f9274c6a4a76e494df644d968dd84ddcdb1c"
+    );
+  }
+}

package/src/kernel-zerodev/abis/ERC165SessionKeyValidatorAbi.ts

@@ -0,0 +1,211 @@
+export const ERC165SessionKeyValidatorAbi = [
+  {
+    inputs: [
+      {
+        internalType: "bytes",
+        name: "_data",
+        type: "bytes",
+      },
+    ],
+    name: "disable",
+    outputs: [],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        internalType: "bytes",
+        name: "_data",
+        type: "bytes",
+      },
+    ],
+    name: "enable",
+    outputs: [],
+    stateMutability: "payable",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "sessionKey",
+        type: "address",
+      },
+      {
+        internalType: "address",
+        name: "kernel",
+        type: "address",
+      },
+    ],
+    name: "sessionKeys",
+    outputs: [
+      {
+        internalType: "bool",
+        name: "enabled",
+        type: "bool",
+      },
+      {
+        internalType: "bytes4",
+        name: "selector",
+        type: "bytes4",
+      },
+      {
+        internalType: "bytes4",
+        name: "interfaceId",
+        type: "bytes4",
+      },
+      {
+        internalType: "uint48",
+        name: "validUntil",
+        type: "uint48",
+      },
+      {
+        internalType: "uint48",
+        name: "validAfter",
+        type: "uint48",
+      },
+      {
+        internalType: "uint32",
+        name: "addressOffset",
+        type: "uint32",
+      },
+    ],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        internalType: "address",
+        name: "",
+        type: "address",
+      },
+      {
+        internalType: "bytes",
+        name: "",
+        type: "bytes",
+      },
+    ],
+    name: "validCaller",
+    outputs: [
+      {
+        internalType: "bool",
+        name: "",
+        type: "bool",
+      },
+    ],
+    stateMutability: "pure",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        internalType: "bytes32",
+        name: "",
+        type: "bytes32",
+      },
+      {
+        internalType: "bytes",
+        name: "",
+        type: "bytes",
+      },
+    ],
+    name: "validateSignature",
+    outputs: [
+      {
+        internalType: "uint256",
+        name: "",
+        type: "uint256",
+      },
+    ],
+    stateMutability: "pure",
+    type: "function",
+  },
+  {
+    inputs: [
+      {
+        components: [
+          {
+            internalType: "address",
+            name: "sender",
+            type: "address",
+          },
+          {
+            internalType: "uint256",
+            name: "nonce",
+            type: "uint256",
+          },
+          {
+            internalType: "bytes",
+            name: "initCode",
+            type: "bytes",
+          },
+          {
+            internalType: "bytes",
+            name: "callData",
+            type: "bytes",
+          },
+          {
+            internalType: "uint256",
+            name: "callGasLimit",
+            type: "uint256",
+          },
+          {
+            internalType: "uint256",
+            name: "verificationGasLimit",
+            type: "uint256",
+          },
+          {
+            internalType: "uint256",
+            name: "preVerificationGas",
+            type: "uint256",
+          },
+          {
+            internalType: "uint256",
+            name: "maxFeePerGas",
+            type: "uint256",
+          },
+          {
+            internalType: "uint256",
+            name: "maxPriorityFeePerGas",
+            type: "uint256",
+          },
+          {
+            internalType: "bytes",
+            name: "paymasterAndData",
+            type: "bytes",
+          },
+          {
+            internalType: "bytes",
+            name: "signature",
+            type: "bytes",
+          },
+        ],
+        internalType: "struct UserOperation",
+        name: "_userOp",
+        type: "tuple",
+      },
+      {
+        internalType: "bytes32",
+        name: "_userOpHash",
+        type: "bytes32",
+      },
+      {
+        internalType: "uint256",
+        name: "",
+        type: "uint256",
+      },
+    ],
+    name: "validateUserOp",
+    outputs: [
+      {
+        internalType: "uint256",
+        name: "",
+        type: "uint256",
+      },
+    ],
+    stateMutability: "payable",
+    type: "function",
+  },
+] as const;

package/src/kernel-zerodev/abis/ERC20Abi.ts

@@ -0,0 +1,153 @@
+export const ERC20Abi = [
+  {
+    inputs: [
+      { internalType: "string", name: "name_", type: "string" },
+      { internalType: "string", name: "symbol_", type: "string" },
+      { internalType: "uint8", name: "decimals_", type: "uint8" },
+      { internalType: "uint256", name: "initialBalance_", type: "uint256" },
+      {
+        internalType: "address payable",
+        name: "feeReceiver_",
+        type: "address",
+      },
+    ],
+    stateMutability: "payable",
+    type: "constructor",
+  },
+  {
+    anonymous: false,
+    inputs: [
+      {
+        indexed: true,
+        internalType: "address",
+        name: "owner",
+        type: "address",
+      },
+      {
+        indexed: true,
+        internalType: "address",
+        name: "spender",
+        type: "address",
+      },
+      {
+        indexed: false,
+        internalType: "uint256",
+        name: "value",
+        type: "uint256",
+      },
+    ],
+    name: "Approval",
+    type: "event",
+  },
+  {
+    anonymous: false,
+    inputs: [
+      { indexed: true, internalType: "address", name: "from", type: "address" },
+      { indexed: true, internalType: "address", name: "to", type: "address" },
+      {
+        indexed: false,
+        internalType: "uint256",
+        name: "value",
+        type: "uint256",
+      },
+    ],
+    name: "Transfer",
+    type: "event",
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "owner", type: "address" },
+      { internalType: "address", name: "spender", type: "address" },
+    ],
+    name: "allowance",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "spender", type: "address" },
+      { internalType: "uint256", name: "amount", type: "uint256" },
+    ],
+    name: "approve",
+    outputs: [{ internalType: "bool", name: "", type: "bool" }],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [{ internalType: "address", name: "account", type: "address" }],
+    name: "balanceOf",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "decimals",
+    outputs: [{ internalType: "uint8", name: "", type: "uint8" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "spender", type: "address" },
+      { internalType: "uint256", name: "subtractedValue", type: "uint256" },
+    ],
+    name: "decreaseAllowance",
+    outputs: [{ internalType: "bool", name: "", type: "bool" }],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "spender", type: "address" },
+      { internalType: "uint256", name: "addedValue", type: "uint256" },
+    ],
+    name: "increaseAllowance",
+    outputs: [{ internalType: "bool", name: "", type: "bool" }],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "name",
+    outputs: [{ internalType: "string", name: "", type: "string" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "symbol",
+    outputs: [{ internalType: "string", name: "", type: "string" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [],
+    name: "totalSupply",
+    outputs: [{ internalType: "uint256", name: "", type: "uint256" }],
+    stateMutability: "view",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "recipient", type: "address" },
+      { internalType: "uint256", name: "amount", type: "uint256" },
+    ],
+    name: "transfer",
+    outputs: [{ internalType: "bool", name: "", type: "bool" }],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+  {
+    inputs: [
+      { internalType: "address", name: "sender", type: "address" },
+      { internalType: "address", name: "recipient", type: "address" },
+      { internalType: "uint256", name: "amount", type: "uint256" },
+    ],
+    name: "transferFrom",
+    outputs: [{ internalType: "bool", name: "", type: "bool" }],
+    stateMutability: "nonpayable",
+    type: "function",
+  },
+];