WIP: feat: add an EIP-7702 impl of single owner LA

Author: dancoombs

docs-site

@@ -39,8 +39,12 @@ export {
   lightAccountStaticImplV1_0_2,
   lightAccountStaticImplV1_1_0,
   lightAccountStaticImplV2_0_0,
+  lightAccountStaticImplV2_1_0,
+  lightAccountStaticImplV2_2_0,
+  lightAccountStaticImpl7702V2_1_0,
   multiOwnerLightAccountStaticImplV2_0_0,
 } from "./light-account/lightAccountStaticImpl.js";
+export type { LightAccountStaticImpl7702V2_1_0 } from "./light-account/lightAccountStaticImpl.js";
 
 // ModularAccountV1
 export type * from "./ma-v1/accounts/base.js";

packages/smart-accounts/src/index.ts

@@ -6,9 +6,11 @@ import {
   type Hex,
   type JsonRpcAccount,
   type LocalAccount,
+  type PrivateKeyAccount,
   type Transport,
 } from "viem";
 import { readContract } from "viem/actions";
+import type { ToSmartAccountParameters } from "viem/account-abstraction";
 import { LightAccountAbi_v1 } from "../abis/LightAccountAbi_v1.js";
 import { LightAccountAbi_v2 } from "../abis/LightAccountAbi_v2.js";
 import { LightAccountFactoryAbi_v1 } from "../abis/LightAccountFactoryAbi_v1.js";
@@ -27,6 +29,10 @@ import { toLightAccountBase, type LightAccountBase } from "./base.js";
 import { BaseError, lowerAddress } from "@alchemy/common";
 import { getAction } from "viem/utils";
 import { LOGGER } from "../../logger.js";
+import { InvalidOwnerError } from "../../errors/InvalidOwnerError.js";
+import { lightAccountStaticImpl7702V2_1_0 } from "../lightAccountStaticImpl.js";
+
+type LightAccountMode = "default" | "7702";
 
 export type LightAccount<
   TLightAccountVersion extends
@@ -39,15 +45,24 @@ export type LightAccount<
 export type ToLightAccountParams<
   TLightAccountVersion extends
     LightAccountVersion<"LightAccount"> = LightAccountVersion<"LightAccount">,
+  TMode extends LightAccountMode | undefined = LightAccountMode | undefined,
 > = {
   client: Client<Transport, Chain, JsonRpcAccount | LocalAccount | undefined>;
   owner: JsonRpcAccount | LocalAccount;
-  salt?: bigint;
   accountAddress?: Address;
-  factory?: Address;
-  factoryData?: Hex;
   version?: TLightAccountVersion;
-};
+  mode?: TMode;
+} & (TMode extends "7702"
+  ? {
+      salt?: never;
+      factory?: never;
+      factoryData?: never;
+    }
+  : {
+      salt?: bigint;
+      factory?: Address;
+      factoryData?: Hex;
+    });
 
 /**
  * Creates a light account.
@@ -58,6 +73,7 @@ export type ToLightAccountParams<
 export async function toLightAccount<
   TLightAccountVersion extends
     LightAccountVersion<"LightAccount"> = LightAccountVersion<"LightAccount">,
+  TMode extends LightAccountMode = LightAccountMode,
 >({
   client,
   owner,
@@ -66,11 +82,15 @@ export async function toLightAccount<
   version = defaultLightAccountVersion() as TLightAccountVersion,
   factory = AccountVersionRegistry.LightAccount[version].factoryAddress,
   factoryData: factoryData_,
-}: ToLightAccountParams<TLightAccountVersion>): Promise<
+  mode,
+}: ToLightAccountParams<TLightAccountVersion, TMode>): Promise<
   LightAccount<TLightAccountVersion>
 > {
+  const is7702 = mode === "7702";
+
   LOGGER.debug("toLightAccount:start", {
     version,
+    mode,
     hasAccountAddress: !!accountAddress_,
   });
 
@@ -87,16 +107,26 @@ export async function toLightAccount<
 
   const accountAddress =
     accountAddress_ ??
-    predictLightAccountAddress({
-      factoryAddress: factory,
-      salt,
-      ownerAddress: owner.address,
-      version,
-    });
+    (is7702 && owner.type === "local"
+      ? owner.address
+      : predictLightAccountAddress({
+          factoryAddress: factory,
+          salt,
+          ownerAddress: owner.address,
+          version,
+        }));
 
-  LOGGER.debug("toLightAccount:address-resolved", { accountAddress });
+  LOGGER.debug("toLightAccount:address-resolved", { accountAddress, is7702 });
 
   const getFactoryArgs = async () => {
+    if (is7702) {
+      // EIP-7702 uses special factory address for EP 0.8
+      return {
+        factory: "0x7702000000000000000000000000000000000000" as Address,
+        factoryData: "0x" as Hex,
+      } as const;
+    }
+
     const factoryData =
       factoryData_ ??
       encodeFunctionData({
@@ -111,6 +141,29 @@ export async function toLightAccount<
     };
   };
 
+  let authorization: ToSmartAccountParameters["authorization"];
+  if (is7702) {
+    LOGGER.debug("toLightAccount:7702-mode");
+    if (owner.type !== "local") {
+      LOGGER.error("toLightAccount:invalid-owner-type", {
+        ownerType: owner.type,
+      });
+      throw new InvalidOwnerError(
+        `Owner of type ${owner.type} is unsupported for 7702 mode.`,
+      );
+    }
+    if (owner.signAuthorization == null) {
+      LOGGER.error("toLightAccount:missing-signAuthorization");
+      throw new InvalidOwnerError(
+        "Owner must implement `signAuthorization` to be used with 7702 mode.",
+      );
+    }
+    authorization = {
+      account: owner as PrivateKeyAccount,
+      address: lightAccountStaticImpl7702V2_1_0.delegationAddress,
+    };
+  }
+
   const baseAccount = await toLightAccountBase({
     client,
     owner,
@@ -119,6 +172,7 @@ export async function toLightAccount<
     type: "LightAccount",
     version,
     getFactoryArgs,
+    authorization,
   });
 
   return {

packages/smart-accounts/src/light-account/accounts/account.ts

@@ -20,6 +20,7 @@ import {
   getUserOperationTypedData,
   toSmartAccount,
   type SmartAccountImplementation,
+  type ToSmartAccountParameters,
 } from "viem/account-abstraction";
 import { getStorageAt, signMessage, signTypedData } from "viem/actions";
 import type {
@@ -67,7 +68,7 @@ export type BaseLightAccountImplementation<
     prepareSignature: (request: SignatureRequest) => Promise<SignatureRequest>;
     formatSignature: (signature: Hex) => Promise<Hex>;
   },
-  false
+  boolean
 >;
 
 export type LightAccountBase<
@@ -94,6 +95,7 @@ export type ToLightAccountBaseParams<
     factory?: Address | undefined;
     factoryData?: Hex | undefined;
   }>;
+  authorization?: ToSmartAccountParameters["authorization"];
 };
 
 export async function toLightAccountBase<
@@ -109,6 +111,7 @@ export async function toLightAccountBase<
   type,
   version,
   getFactoryArgs,
+  authorization,
 }: ToLightAccountBaseParams<
   TLightAccountType,
   TLightAccountVersion,
@@ -232,6 +235,7 @@ export async function toLightAccountBase<
     getFactoryArgs,
     client,
     entryPoint,
+    authorization,
 
     async getAddress() {
       return accountAddress;

packages/smart-accounts/src/light-account/accounts/base.ts

@@ -174,6 +174,15 @@ export const multiOwnerLightAccountStaticImplV2_0_0: StaticSmartAccountImplement
   },
 };
 
+const lightAccountBaseV2_1_0 = {
+  entryPoint: {
+    abi: entryPoint08Abi,
+    address: entryPoint08Address,
+    version: "0.8",
+  },
+  accountAbi: LightAccountAbi_v2,
+} as const;
+
 export const lightAccountStaticImplV2_1_0: StaticSmartAccountImplementation<
   false,
   "0.8",
@@ -182,12 +191,7 @@ export const lightAccountStaticImplV2_1_0: StaticSmartAccountImplementation<
   typeof LightAccountAbi_v2,
   typeof LightAccountFactoryAbi_v2
 > = {
-  entryPoint: {
-    abi: entryPoint08Abi,
-    address: entryPoint08Address,
-    version: "0.8",
-  },
-  accountAbi: LightAccountAbi_v2,
+  ...lightAccountBaseV2_1_0,
   accountImplementation: lowerAddress(
     "0x2c53D0bD33A60db8881c7b049Df6fd762A1f059C",
   ),
@@ -209,6 +213,23 @@ export const lightAccountStaticImplV2_1_0: StaticSmartAccountImplementation<
   },
 };
 
+export type LightAccountStaticImpl7702V2_1_0 = StaticSmartAccountImplementation<
+  true,
+  "0.8",
+  {},
+  typeof entryPoint08Abi,
+  typeof LightAccountAbi_v2,
+  never
+>;
+
+export const lightAccountStaticImpl7702V2_1_0: LightAccountStaticImpl7702V2_1_0 =
+  {
+    ...lightAccountBaseV2_1_0,
+    delegationAddress: lowerAddress(
+      "0x82CfFc0f83A66F016f1273CdD5C43f86E78d2478",
+    ),
+  };
+
 export const lightAccountStaticImplV2_2_0: StaticSmartAccountImplementation<
   false,
   "0.9",