@getpara/aa-zerodev 2.16.0

package/dist/action.d.ts

@@ -0,0 +1,24 @@
+import { type KernelAccountClient } from '@zerodev/sdk';
+import type { SmartAccount4337, SmartAccount7702 } from '@getpara/viem-v2-integration';
+import type { CreateZeroDevSmartAccountParams } from './types.js';
+export type { CreateZeroDevSmartAccountParams, ZeroDevTransactionOptions } from './types.js';
+/**
+ * Returns the ZeroDev RPC URL for a given project ID and chain.
+ */
+export declare function getZeroDevRpcUrl(projectId: string, chainId: number): string;
+/**
+ * Creates a ZeroDev smart account using Para for signing.
+ *
+ * Returns a unified SmartAccount interface. Supports gas sponsorship via ZeroDev's
+ * paymaster with EntryPoint v0.7.
+ *
+ * @param params - Configuration parameters
+ * @returns Unified SmartAccount interface (4337 or 7702) or null if no EVM wallet exists
+ */
+export declare function createZeroDevSmartAccount(params: CreateZeroDevSmartAccountParams & {
+    mode: '7702';
+}): Promise<SmartAccount7702<KernelAccountClient> | null>;
+export declare function createZeroDevSmartAccount(params: CreateZeroDevSmartAccountParams & {
+    mode?: '4337';
+}): Promise<SmartAccount4337<KernelAccountClient> | null>;
+export declare function createZeroDevSmartAccount(params: CreateZeroDevSmartAccountParams): Promise<SmartAccount4337<KernelAccountClient> | SmartAccount7702<KernelAccountClient> | null>;

package/dist/action.js

@@ -0,0 +1,104 @@
+import {
+  createKernelAccount,
+  createKernelAccountClient,
+  createZeroDevPaymasterClient
+} from "@zerodev/sdk";
+import { KERNEL_V3_1, KERNEL_V3_3, KERNEL_7702_DELEGATION_ADDRESS } from "@zerodev/sdk/constants";
+import { signerToEcdsaValidator } from "@zerodev/ecdsa-validator";
+import { createParaAccount } from "@getpara/viem-v2-integration";
+import { SmartAccountError, wrapProviderError, resolveWalletIdentifier } from "@getpara/viem-v2-integration";
+import { createPublicClient, http } from "viem";
+function getZeroDevRpcUrl(projectId, chainId) {
+  return `https://rpc.zerodev.app/api/v3/${projectId}/chain/${chainId}`;
+}
+const ENTRYPOINT_V07 = {
+  address: "0x0000000071727De22E5E9d8BAf0edAc6f37da032",
+  version: "0.7"
+};
+async function createZeroDevSmartAccount(params) {
+  const { para, projectId, chain, rpcUrl, bundlerUrl, paymasterUrl, mode } = params;
+  const walletAddress = resolveWalletIdentifier(para, params);
+  if (!walletAddress) return null;
+  const viemAccount = createParaAccount(para, walletAddress);
+  const _rpcUrl = rpcUrl || getZeroDevRpcUrl(projectId, chain.id);
+  const publicClient = createPublicClient({ chain, transport: http(_rpcUrl) });
+  const ecdsaValidator = await signerToEcdsaValidator(publicClient, {
+    signer: viemAccount,
+    entryPoint: ENTRYPOINT_V07,
+    kernelVersion: mode === "7702" ? KERNEL_V3_3 : KERNEL_V3_1
+  });
+  const kernelAccount = await createKernelAccount(publicClient, {
+    plugins: {
+      sudo: ecdsaValidator
+    },
+    entryPoint: ENTRYPOINT_V07,
+    kernelVersion: mode === "7702" ? KERNEL_V3_3 : KERNEL_V3_1,
+    ...mode === "7702" && {
+      eip7702Account: viemAccount
+    }
+  });
+  const zeroDevRpcUrl = getZeroDevRpcUrl(projectId, chain.id);
+  const _bundlerUrl = bundlerUrl || zeroDevRpcUrl;
+  const _paymasterUrl = paymasterUrl || zeroDevRpcUrl;
+  const kernelClient = createKernelAccountClient({
+    account: kernelAccount,
+    chain,
+    bundlerTransport: http(_bundlerUrl),
+    client: publicClient,
+    paymaster: {
+      getPaymasterData: async (userOperation) => {
+        const zerodevPaymaster = createZeroDevPaymasterClient({
+          chain,
+          transport: http(_paymasterUrl)
+        });
+        return zerodevPaymaster.sponsorUserOperation({ userOperation });
+      }
+    }
+  });
+  if (!kernelClient.account?.address) {
+    throw new SmartAccountError({
+      code: "MISSING_ACCOUNT_ADDRESS",
+      message: "ZeroDev client must have an account address",
+      provider: "ZERODEV"
+    });
+  }
+  const accountAddress = kernelClient.account.address;
+  const doSendAndWait = async (calls) => {
+    if (!("sendUserOperation" in kernelClient && typeof kernelClient.sendUserOperation === "function")) {
+      throw new SmartAccountError({
+        code: "INVALID_CONFIG",
+        message: "sendUserOperation not available on client",
+        provider: "ZERODEV"
+      });
+    }
+    try {
+      const hash = await kernelClient.sendUserOperation({ calls });
+      if ("waitForUserOperationReceipt" in kernelClient && typeof kernelClient.waitForUserOperationReceipt === "function") {
+        const result = await kernelClient.waitForUserOperationReceipt({ hash });
+        return result.receipt;
+      }
+      return publicClient.getTransactionReceipt({ hash });
+    } catch (error) {
+      throw wrapProviderError(error, "ZERODEV");
+    }
+  };
+  return {
+    smartAccountAddress: accountAddress,
+    signer: viemAccount,
+    chain,
+    mode: mode || "4337",
+    provider: "ZERODEV",
+    ...mode === "7702" && { delegationAddress: KERNEL_7702_DELEGATION_ADDRESS },
+    async sendTransaction({ to, value, data }) {
+      return doSendAndWait([{ to, value: value || BigInt(0), data: data || "0x" }]);
+    },
+    async sendBatchTransaction(calls) {
+      return doSendAndWait(calls.map((c) => ({ to: c.to, value: c.value || BigInt(0), data: c.data || "0x" })));
+    },
+    client: kernelClient
+  };
+}
+export {
+  createZeroDevSmartAccount,
+  getZeroDevRpcUrl
+};

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { createZeroDevSmartAccount, getZeroDevRpcUrl } from './action.js';
+export type { ZeroDevSmartAccountConfig, CreateZeroDevSmartAccountParams, UseZeroDevSmartAccountParams, ZeroDevTransactionOptions, } from './types.js';

package/dist/index.js

@@ -0,0 +1,5 @@
+import { createZeroDevSmartAccount, getZeroDevRpcUrl } from "./action.js";
+export {
+  createZeroDevSmartAccount,
+  getZeroDevRpcUrl
+};

package/dist/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/types.d.ts

@@ -0,0 +1,50 @@
+import type { PaymasterSmartAccountConfig, CreateSmartAccountParams, SmartAccountModeParam } from '@getpara/viem-v2-integration';
+/**
+ * Configuration for ZeroDev smart account.
+ *
+ * Supports both EIP-4337 and EIP-7702 modes. Uses ZeroDev's Kernel account
+ * with ECDSA validation and gas sponsorship via EntryPoint v0.7.
+ *
+ * @example
+ * ```ts
+ * const config: ZeroDevSmartAccountConfig = {
+ *   projectId: 'YOUR_ZERODEV_PROJECT_ID',
+ *   chain: sepolia,
+ * };
+ * ```
+ */
+export interface ZeroDevSmartAccountConfig extends Omit<PaymasterSmartAccountConfig, 'rpcUrl'>, SmartAccountModeParam {
+    /** ZeroDev project ID */
+    projectId: string;
+    /**
+     * RPC URL for the chain. If not provided, defaults to ZeroDev's RPC
+     * (`https://rpc.zerodev.app/api/v3/{projectId}/chain/{chainId}`).
+     */
+    rpcUrl?: string;
+}
+/**
+ * Parameters for `createZeroDevSmartAccount`.
+ * Includes all config fields plus `para` (the Para SDK instance).
+ */
+export type CreateZeroDevSmartAccountParams = CreateSmartAccountParams<ZeroDevSmartAccountConfig>;
+/**
+ * Parameters for the `useZeroDevSmartAccount` hook.
+ * Same as {@link ZeroDevSmartAccountConfig} — `para` is provided automatically via context.
+ */
+export type UseZeroDevSmartAccountParams = ZeroDevSmartAccountConfig;
+/**
+ * ZeroDev-specific transaction options.
+ * Pass as the second argument to `sendTransaction` or `sendBatchTransaction`.
+ */
+export interface ZeroDevTransactionOptions {
+    /** Custom sponsorship middleware */
+    middleware?: {
+        sponsorUserOperation?: (args: {
+            userOperation: any;
+        }) => Promise<any>;
+    };
+    /** Override paymaster address */
+    paymasterAddress?: `0x${string}`;
+    /** Override paymaster data */
+    paymasterData?: `0x${string}`;
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@getpara/aa-zerodev",
+  "version": "2.16.0",
+  "description": "ZeroDev smart account integration for Para",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "package.json"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "rm -rf dist && yarn typegen && node ./scripts/build.mjs",
+    "typegen": "tsc --emitDeclarationOnly --outDir dist",
+    "test": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@getpara/viem-v2-integration": "2.16.0",
+    "@zerodev/ecdsa-validator": "^5.4.3",
+    "@zerodev/sdk": "^5.4.3"
+  },
+  "peerDependencies": {
+    "viem": ">=2.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "fbe96a062b308d04105213378c12c38ee973c798"
+}