@alchemy/smart-accounts 0.0.0-alpha.0

package/dist/esm/ma-v2/decorators/installValidation.d.ts

@@ -0,0 +1,71 @@
+import { type Address, type Client, type Hex, type IsUndefined, type Chain, type Transport } from "viem";
+import type { HookConfig, ValidationConfig } from "../types.js";
+import type { ModularAccountV2 } from "../accounts/account.js";
+import type { GetAccountParameter } from "../../types.js";
+import { type SmartAccount } from "viem/account-abstraction";
+export type InstallValidationParams<TAccount extends SmartAccount | undefined = SmartAccount | undefined> = {
+    validationConfig: ValidationConfig;
+    selectors: Hex[];
+    installData: Hex;
+    hooks: {
+        hookConfig: HookConfig;
+        initData: Hex;
+    }[];
+} & GetAccountParameter<TAccount, ModularAccountV2>;
+export type UninstallValidationParams<TAccount extends SmartAccount | undefined = SmartAccount | undefined> = {
+    moduleAddress: Address;
+    entityId: number;
+    uninstallData: Hex;
+    hookUninstallDatas: Hex[];
+} & GetAccountParameter<TAccount, ModularAccountV2>;
+export type InstallValidationActions<TAccount extends SmartAccount | undefined = SmartAccount | undefined> = {
+    encodeInstallValidation: (args: InstallValidationParams<TAccount>) => Promise<Hex>;
+    installValidation: (args: InstallValidationParams<TAccount>) => Promise<Hex>;
+    encodeUninstallValidation: (args: UninstallValidationParams<TAccount>) => Promise<Hex>;
+    uninstallValidation: (args: UninstallValidationParams<TAccount>) => Promise<Hex>;
+};
+/**
+ * Provides validation installation and uninstallation functionalities for a MA v2 client, ensuring compatibility with `SmartAccountClient`.
+ *
+ * @example
+ * ```ts
+ * import { createModularAccountV2Client, installValidationActions, getDefaultSingleSignerValidationModuleAddress, SingleSignerValidationModule } from "@alchemy/smart-accounts";
+ * import { Address } from "viem";
+ *
+ * const client = (await createModularAccountV2Client({ ... })).extend(installValidationActions);
+ * const sessionKeyAddress: Address = "0x1234";
+ * const sessionKeyEntityId: number = 1;
+ *
+ * await client.installValidation({
+ *   validationConfig: {
+ *     moduleAddress: getDefaultSingleSignerValidationModuleAddress(
+ *       client.chain
+ *     ),
+ *     entityId: sessionKeyEntityId,
+ *     isGlobal: true,
+ *     isSignatureValidation: false,
+ *     isUserOpValidation: true,
+ *   },
+ *   selectors: [],
+ *   installData: SingleSignerValidationModule.encodeOnInstallData({
+ *     entityId: sessionKeyEntityId,
+ *     signer: sessionKeyAddress,
+ *   }),
+ *   hooks: [],
+ * });
+ *
+ * await client.uninstallValidation({
+ *   moduleAddress: sessionKeyAddress,
+ *   entityId: sessionKeyEntityId,
+ *   uninstallData: SingleSignerValidationModule.encodeOnUninstallData({
+ *     entityId: sessionKeyEntityId,
+ *   }),
+ *   hookUninstallDatas: [],
+ * });
+ *
+ * ```
+ *
+ * @param {object} client - The client instance which provides account and sendUserOperation functionality.
+ * @returns {object} - An object containing two methods, `installValidation` and `uninstallValidation`.
+ */
+export declare function installValidationActions<TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartAccount | undefined = SmartAccount | undefined>(client: Client<TTransport, TChain, TAccount>): InstallValidationActions<IsUndefined<TAccount> extends true ? undefined : ModularAccountV2>;

package/dist/esm/ma-v2/decorators/installValidation.js

@@ -0,0 +1,137 @@
+import { zeroAddress, concatHex, encodeFunctionData, } from "viem";
+import { semiModularAccountBytecodeAbi } from "../abis/semiModularAccountBytecodeAbi.js";
+import { sendUserOperation } from "viem/account-abstraction";
+import { getAction } from "viem/utils";
+import { AccountNotFoundError } from "@alchemy/common";
+import { EntityIdOverrideError } from "../../errors/EntityIdOverrideError.js";
+import { serializeHookConfig, serializeValidationConfig, } from "../utils/hooks.js";
+import { DEFAULT_OWNER_ENTITY_ID, isModularAccountV2, serializeModuleEntity, } from "../utils/account.js";
+// TODO(v5): update jsdoc
+/**
+ * Provides validation installation and uninstallation functionalities for a MA v2 client, ensuring compatibility with `SmartAccountClient`.
+ *
+ * @example
+ * ```ts
+ * import { createModularAccountV2Client, installValidationActions, getDefaultSingleSignerValidationModuleAddress, SingleSignerValidationModule } from "@alchemy/smart-accounts";
+ * import { Address } from "viem";
+ *
+ * const client = (await createModularAccountV2Client({ ... })).extend(installValidationActions);
+ * const sessionKeyAddress: Address = "0x1234";
+ * const sessionKeyEntityId: number = 1;
+ *
+ * await client.installValidation({
+ *   validationConfig: {
+ *     moduleAddress: getDefaultSingleSignerValidationModuleAddress(
+ *       client.chain
+ *     ),
+ *     entityId: sessionKeyEntityId,
+ *     isGlobal: true,
+ *     isSignatureValidation: false,
+ *     isUserOpValidation: true,
+ *   },
+ *   selectors: [],
+ *   installData: SingleSignerValidationModule.encodeOnInstallData({
+ *     entityId: sessionKeyEntityId,
+ *     signer: sessionKeyAddress,
+ *   }),
+ *   hooks: [],
+ * });
+ *
+ * await client.uninstallValidation({
+ *   moduleAddress: sessionKeyAddress,
+ *   entityId: sessionKeyEntityId,
+ *   uninstallData: SingleSignerValidationModule.encodeOnUninstallData({
+ *     entityId: sessionKeyEntityId,
+ *   }),
+ *   hookUninstallDatas: [],
+ * });
+ *
+ * ```
+ *
+ * @param {object} client - The client instance which provides account and sendUserOperation functionality.
+ * @returns {object} - An object containing two methods, `installValidation` and `uninstallValidation`.
+ */
+export function installValidationActions(client) {
+    const encodeInstallValidation = async (args) => {
+        const { validationConfig, selectors, installData, hooks, account = client.account, } = args;
+        if (!account || !isModularAccountV2(account)) {
+            throw new AccountNotFoundError();
+        }
+        // An entityId of zero is only allowed if we're installing or uninstalling hooks on the fallback validation.
+        if (validationConfig.entityId === DEFAULT_OWNER_ENTITY_ID &&
+            validationConfig.moduleAddress !== zeroAddress) {
+            throw new EntityIdOverrideError();
+        }
+        return account.encodeCallData(encodeFunctionData({
+            abi: semiModularAccountBytecodeAbi,
+            functionName: "installValidation",
+            args: [
+                serializeValidationConfig(validationConfig),
+                selectors,
+                installData,
+                hooks.map((hook) => concatHex([serializeHookConfig(hook.hookConfig), hook.initData])),
+            ],
+        }));
+    };
+    const encodeUninstallValidation = async (args) => {
+        const { moduleAddress, entityId, uninstallData, hookUninstallDatas, account = client.account, } = args;
+        if (!account || !isModularAccountV2(account)) {
+            throw new AccountNotFoundError();
+        }
+        return account.encodeCallData(encodeFunctionData({
+            abi: semiModularAccountBytecodeAbi,
+            functionName: "uninstallValidation",
+            args: [
+                serializeModuleEntity({
+                    moduleAddress,
+                    entityId,
+                }),
+                uninstallData,
+                hookUninstallDatas,
+            ],
+        }));
+    };
+    return {
+        encodeInstallValidation,
+        encodeUninstallValidation,
+        installValidation: async (args) => {
+            const { validationConfig, selectors, installData, hooks, account = client.account, } = args;
+            if (!account || !isModularAccountV2(account)) {
+                throw new AccountNotFoundError();
+            }
+            const callData = await encodeInstallValidation({
+                validationConfig,
+                selectors,
+                installData,
+                hooks,
+                account,
+            });
+            const action = getAction(client, sendUserOperation, "sendUserOperation");
+            const result = await action({
+                callData,
+                account,
+            });
+            return result;
+        },
+        uninstallValidation: async (args) => {
+            const { moduleAddress, entityId, uninstallData, hookUninstallDatas, account = client.account, } = args;
+            if (!account || !isModularAccountV2(account)) {
+                throw new AccountNotFoundError();
+            }
+            const callData = await encodeUninstallValidation({
+                moduleAddress,
+                entityId,
+                uninstallData,
+                hookUninstallDatas,
+                account,
+            });
+            const action = getAction(client, sendUserOperation, "sendUserOperation");
+            const result = await action({
+                callData,
+                account,
+            });
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=installValidation.js.map

package/dist/esm/ma-v2/decorators/installValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installValidation.js","sourceRoot":"","sources":["../../../../src/ma-v2/decorators/installValidation.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type Address,\n  type Client,\n  type Hex,\n  type IsUndefined,\n  type Chain,\n  type Transport,\n  zeroAddress,\n  concatHex,\n  encodeFunctionData,\n} from \"viem\";\nimport type { HookConfig, ValidationConfig } from \"../types.js\";\nimport type { ModularAccountV2 } from \"../accounts/account.js\";\nimport type { GetAccountParameter } from \"../../types.js\";\nimport { semiModularAccountBytecodeAbi } from \"../abis/semiModularAccountBytecodeAbi.js\";\nimport { type SmartAccount, sendUserOperation } from \"viem/account-abstraction\";\nimport { getAction } from \"viem/utils\";\nimport { AccountNotFoundError } from \"@alchemy/common\";\nimport { EntityIdOverrideError } from \"../../errors/EntityIdOverrideError.js\";\nimport {\n  serializeHookConfig,\n  serializeValidationConfig,\n} from \"../utils/hooks.js\";\nimport {\n  DEFAULT_OWNER_ENTITY_ID,\n  isModularAccountV2,\n  serializeModuleEntity,\n} from \"../utils/account.js\";\n\nexport type InstallValidationParams<\n  TAccount extends SmartAccount | undefined = SmartAccount | undefined,\n> = {\n  validationConfig: ValidationConfig;\n  selectors: Hex[];\n  installData: Hex;\n  hooks: {\n    hookConfig: HookConfig;\n    initData: Hex;\n  }[];\n} & GetAccountParameter<TAccount, ModularAccountV2>;\n\nexport type UninstallValidationParams<\n  TAccount extends SmartAccount | undefined = SmartAccount | undefined,\n> = {\n  moduleAddress: Address;\n  entityId: number;\n  uninstallData: Hex;\n  hookUninstallDatas: Hex[];\n} & GetAccountParameter<TAccount, ModularAccountV2>;\n\nexport type InstallValidationActions<\n  TAccount extends SmartAccount | undefined = SmartAccount | undefined,\n> = {\n  encodeInstallValidation: (\n    args: InstallValidationParams<TAccount>,\n  ) => Promise<Hex>;\n  installValidation: (args: InstallValidationParams<TAccount>) => Promise<Hex>;\n  encodeUninstallValidation: (\n    args: UninstallValidationParams<TAccount>,\n  ) => Promise<Hex>;\n  uninstallValidation: (\n    args: UninstallValidationParams<TAccount>,\n  ) => Promise<Hex>;\n};\n\n// TODO(v5): update jsdoc\n/**\n * Provides validation installation and uninstallation functionalities for a MA v2 client, ensuring compatibility with `SmartAccountClient`.\n *\n * @example\n * ```ts\n * import { createModularAccountV2Client, installValidationActions, getDefaultSingleSignerValidationModuleAddress, SingleSignerValidationModule } from \"@alchemy/smart-accounts\";\n * import { Address } from \"viem\";\n *\n * const client = (await createModularAccountV2Client({ ... })).extend(installValidationActions);\n * const sessionKeyAddress: Address = \"0x1234\";\n * const sessionKeyEntityId: number = 1;\n *\n * await client.installValidation({\n *   validationConfig: {\n *     moduleAddress: getDefaultSingleSignerValidationModuleAddress(\n *       client.chain\n *     ),\n *     entityId: sessionKeyEntityId,\n *     isGlobal: true,\n *     isSignatureValidation: false,\n *     isUserOpValidation: true,\n *   },\n *   selectors: [],\n *   installData: SingleSignerValidationModule.encodeOnInstallData({\n *     entityId: sessionKeyEntityId,\n *     signer: sessionKeyAddress,\n *   }),\n *   hooks: [],\n * });\n *\n * await client.uninstallValidation({\n *   moduleAddress: sessionKeyAddress,\n *   entityId: sessionKeyEntityId,\n *   uninstallData: SingleSignerValidationModule.encodeOnUninstallData({\n *     entityId: sessionKeyEntityId,\n *   }),\n *   hookUninstallDatas: [],\n * });\n *\n * ```\n *\n * @param {object} client - The client instance which provides account and sendUserOperation functionality.\n * @returns {object} - An object containing two methods, `installValidation` and `uninstallValidation`.\n */\nexport function installValidationActions<\n  TTransport extends Transport = Transport,\n  TChain extends Chain | undefined = Chain | undefined,\n  TAccount extends SmartAccount | undefined = SmartAccount | undefined,\n>(\n  client: Client<TTransport, TChain, TAccount>,\n): InstallValidationActions<\n  IsUndefined<TAccount> extends true ? undefined : ModularAccountV2\n> {\n  const encodeInstallValidation = async (\n    args: InstallValidationParams<\n      IsUndefined<TAccount> extends true ? undefined : ModularAccountV2\n    >,\n  ) => {\n    const {\n      validationConfig,\n      selectors,\n      installData,\n      hooks,\n      account = client.account,\n    } = args;\n\n    if (!account || !isModularAccountV2(account)) {\n      throw new AccountNotFoundError();\n    }\n\n    // An entityId of zero is only allowed if we're installing or uninstalling hooks on the fallback validation.\n    if (\n      validationConfig.entityId === DEFAULT_OWNER_ENTITY_ID &&\n      validationConfig.moduleAddress !== zeroAddress\n    ) {\n      throw new EntityIdOverrideError();\n    }\n\n    return account.encodeCallData(\n      encodeFunctionData({\n        abi: semiModularAccountBytecodeAbi,\n        functionName: \"installValidation\",\n        args: [\n          serializeValidationConfig(validationConfig),\n          selectors,\n          installData,\n          hooks.map((hook: { hookConfig: HookConfig; initData: Hex }) =>\n            concatHex([serializeHookConfig(hook.hookConfig), hook.initData]),\n          ),\n        ],\n      }),\n    );\n  };\n\n  const encodeUninstallValidation = async (\n    args: UninstallValidationParams<\n      IsUndefined<TAccount> extends true ? undefined : ModularAccountV2\n    >,\n  ) => {\n    const {\n      moduleAddress,\n      entityId,\n      uninstallData,\n      hookUninstallDatas,\n      account = client.account,\n    } = args;\n\n    if (!account || !isModularAccountV2(account)) {\n      throw new AccountNotFoundError();\n    }\n\n    return account.encodeCallData(\n      encodeFunctionData({\n        abi: semiModularAccountBytecodeAbi,\n        functionName: \"uninstallValidation\",\n        args: [\n          serializeModuleEntity({\n            moduleAddress,\n            entityId,\n          }),\n          uninstallData,\n          hookUninstallDatas,\n        ],\n      }),\n    );\n  };\n\n  return {\n    encodeInstallValidation,\n    encodeUninstallValidation,\n    installValidation: async (args) => {\n      const {\n        validationConfig,\n        selectors,\n        installData,\n        hooks,\n        account = client.account,\n      } = args;\n\n      if (!account || !isModularAccountV2(account)) {\n        throw new AccountNotFoundError();\n      }\n\n      const callData = await encodeInstallValidation({\n        validationConfig,\n        selectors,\n        installData,\n        hooks,\n        account,\n      });\n\n      const action = getAction(client, sendUserOperation, \"sendUserOperation\");\n      const result = await action({\n        callData,\n        account,\n      });\n\n      return result;\n    },\n\n    uninstallValidation: async (args) => {\n      const {\n        moduleAddress,\n        entityId,\n        uninstallData,\n        hookUninstallDatas,\n        account = client.account,\n      } = args;\n\n      if (!account || !isModularAccountV2(account)) {\n        throw new AccountNotFoundError();\n      }\n\n      const callData = await encodeUninstallValidation({\n        moduleAddress,\n        entityId,\n        uninstallData,\n        hookUninstallDatas,\n        account,\n      });\n\n      const action = getAction(client, sendUserOperation, \"sendUserOperation\");\n      const result = await action({\n        callData,\n        account,\n      });\n\n      return result;\n    },\n  };\n}\n"]}

package/dist/esm/ma-v2/mav2StaticImpl.d.ts

@@ -0,0 +1,37 @@
+import { type Address, type Hex } from "viem";
+import { entryPoint07Abi } from "viem/account-abstraction";
+import type { StaticSmartAccountImplementation } from "../types.js";
+import { semiModularAccountBytecodeAbi } from "./abis/semiModularAccountBytecodeAbi.js";
+import { accountFactoryAbi } from "./abis/accountFactoryAbi.js";
+import { webAuthnFactoryAbi } from "./abis/webAuthnFactoryAbi.js";
+import { modularAccountAbi } from "./abis/modularAccountAbi.js";
+export type SemiModularAccountV2FactoryArgs = {
+    owner: Address;
+    salt: bigint;
+};
+export type SemiModularAccountV2StaticImpl = StaticSmartAccountImplementation<false, "0.7", SemiModularAccountV2FactoryArgs, typeof entryPoint07Abi, typeof semiModularAccountBytecodeAbi, typeof accountFactoryAbi>;
+/**
+ * Static implementation logic for SemiModularAccountV2.
+ *
+ * TODO(v5): update JSDoc format when doc-gen supports structs or records.
+ */
+export declare const semiModularAccountV2StaticImpl: SemiModularAccountV2StaticImpl;
+export type SemiModularAccount7702StaticImpl = StaticSmartAccountImplementation<true, "0.7", SemiModularAccountV2FactoryArgs, typeof entryPoint07Abi, typeof semiModularAccountBytecodeAbi, typeof accountFactoryAbi>;
+/**
+ * Static implementation logic for SemiModularAccount7702.
+ *
+ * TODO(v5): update JSDoc format when doc-gen supports structs or records.
+ */
+export declare const semiModularAccount7702StaticImpl: SemiModularAccount7702StaticImpl;
+export type WebAuthnModularAccountV2FactoryArgs = {
+    ownerPublicKey: Hex;
+    salt: bigint;
+    entityId: number;
+};
+export type WebAuthnModularAccountV2StaticImpl = StaticSmartAccountImplementation<false, "0.7", WebAuthnModularAccountV2FactoryArgs, typeof entryPoint07Abi, typeof modularAccountAbi, typeof webAuthnFactoryAbi>;
+/**
+ * Static implementation logic for WebAuthnModularAccountV2.
+ *
+ * TODO(v5): update JSDoc format when doc-gen supports structs or records.
+ */
+export declare const webAuthnModularAccountV2StaticImpl: WebAuthnModularAccountV2StaticImpl;

package/dist/esm/ma-v2/mav2StaticImpl.js

@@ -0,0 +1,88 @@
+import { encodeFunctionData } from "viem";
+import { entryPoint07Abi, entryPoint07Address } from "viem/account-abstraction";
+import { lowerAddress } from "@alchemy/common";
+import { semiModularAccountBytecodeAbi } from "./abis/semiModularAccountBytecodeAbi.js";
+import { accountFactoryAbi } from "./abis/accountFactoryAbi.js";
+import { webAuthnFactoryAbi } from "./abis/webAuthnFactoryAbi.js";
+import { DefaultAddress as DefaultMAV2Address } from "./utils/account.js";
+import { predictModularAccountV2Address } from "./predictAddress.js";
+import { modularAccountAbi } from "./abis/modularAccountAbi.js";
+import { parsePublicKey } from "webauthn-p256";
+// Shared entryPoint configuration across all modular account v2 implementations
+const entryPoint = {
+    abi: entryPoint07Abi,
+    address: entryPoint07Address,
+    version: "0.7",
+};
+// Shared base for semi-modular account implementations (SMA and 7702)
+const semiModularAccountBase = {
+    entryPoint,
+    accountAbi: semiModularAccountBytecodeAbi,
+};
+/**
+ * Static implementation logic for SemiModularAccountV2.
+ *
+ * TODO(v5): update JSDoc format when doc-gen supports structs or records.
+ */
+export const semiModularAccountV2StaticImpl = {
+    ...semiModularAccountBase,
+    accountImplementation: lowerAddress(DefaultMAV2Address.SMAV2_BYTECODE),
+    factoryAddress: lowerAddress(DefaultMAV2Address.MAV2_FACTORY),
+    factoryAbi: accountFactoryAbi,
+    getFactoryData: (args) => {
+        return encodeFunctionData({
+            abi: accountFactoryAbi,
+            functionName: "createSemiModularAccount",
+            args: [args.owner, args.salt],
+        });
+    },
+    predictAccountAddress: (args) => {
+        return predictModularAccountV2Address({
+            factoryAddress: DefaultMAV2Address.MAV2_FACTORY,
+            implementationAddress: DefaultMAV2Address.SMAV2_BYTECODE,
+            type: "SMA",
+            salt: args.salt,
+            ownerAddress: args.owner,
+        });
+    },
+};
+/**
+ * Static implementation logic for SemiModularAccount7702.
+ *
+ * TODO(v5): update JSDoc format when doc-gen supports structs or records.
+ */
+export const semiModularAccount7702StaticImpl = {
+    ...semiModularAccountBase,
+    delegationAddress: lowerAddress(DefaultMAV2Address.SMAV2_7702),
+};
+/**
+ * Static implementation logic for WebAuthnModularAccountV2.
+ *
+ * TODO(v5): update JSDoc format when doc-gen supports structs or records.
+ */
+export const webAuthnModularAccountV2StaticImpl = {
+    entryPoint,
+    accountAbi: modularAccountAbi,
+    accountImplementation: lowerAddress(DefaultMAV2Address.MAV2),
+    factoryAddress: lowerAddress(DefaultMAV2Address.MAV2_FACTORY_WEBAUTHN),
+    factoryAbi: webAuthnFactoryAbi,
+    getFactoryData: (args) => {
+        const { x, y } = parsePublicKey(args.ownerPublicKey);
+        return encodeFunctionData({
+            abi: webAuthnFactoryAbi,
+            functionName: "createWebAuthnAccount",
+            args: [x, y, args.salt, args.entityId],
+        });
+    },
+    predictAccountAddress: (args) => {
+        return predictModularAccountV2Address({
+            factoryAddress: DefaultMAV2Address.MAV2_FACTORY_WEBAUTHN,
+            implementationAddress: DefaultMAV2Address.MAV2,
+            type: "WebAuthn",
+            salt: args.salt,
+            ownerPublicKey: args.ownerPublicKey,
+            entityId: args.entityId,
+        });
+    },
+};
+//# sourceMappingURL=mav2StaticImpl.js.map

package/dist/esm/ma-v2/mav2StaticImpl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mav2StaticImpl.js","sourceRoot":"","sources":["../../../src/ma-v2/mav2StaticImpl.ts"],"names":[],"mappings":"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","sourcesContent":["import { encodeFunctionData, type Address, type Hex } from \"viem\";\nimport { entryPoint07Abi, entryPoint07Address } from \"viem/account-abstraction\";\nimport { lowerAddress } from \"@alchemy/common\";\nimport type { StaticSmartAccountImplementation } from \"../types.js\";\nimport { semiModularAccountBytecodeAbi } from \"./abis/semiModularAccountBytecodeAbi.js\";\nimport { accountFactoryAbi } from \"./abis/accountFactoryAbi.js\";\nimport { webAuthnFactoryAbi } from \"./abis/webAuthnFactoryAbi.js\";\nimport { DefaultAddress as DefaultMAV2Address } from \"./utils/account.js\";\nimport { predictModularAccountV2Address } from \"./predictAddress.js\";\nimport { modularAccountAbi } from \"./abis/modularAccountAbi.js\";\nimport { parsePublicKey } from \"webauthn-p256\";\n\nexport type SemiModularAccountV2FactoryArgs = {\n  owner: Address;\n  salt: bigint;\n};\n\nexport type SemiModularAccountV2StaticImpl = StaticSmartAccountImplementation<\n  false,\n  \"0.7\",\n  SemiModularAccountV2FactoryArgs,\n  typeof entryPoint07Abi,\n  typeof semiModularAccountBytecodeAbi,\n  typeof accountFactoryAbi\n>;\n\n// Shared entryPoint configuration across all modular account v2 implementations\nconst entryPoint = {\n  abi: entryPoint07Abi,\n  address: entryPoint07Address,\n  version: \"0.7\",\n} as const;\n\n// Shared base for semi-modular account implementations (SMA and 7702)\nconst semiModularAccountBase = {\n  entryPoint,\n  accountAbi: semiModularAccountBytecodeAbi,\n} satisfies Partial<SemiModularAccountV2StaticImpl>;\n\n/**\n * Static implementation logic for SemiModularAccountV2.\n *\n * TODO(v5): update JSDoc format when doc-gen supports structs or records.\n */\nexport const semiModularAccountV2StaticImpl: SemiModularAccountV2StaticImpl = {\n  ...semiModularAccountBase,\n  accountImplementation: lowerAddress(DefaultMAV2Address.SMAV2_BYTECODE),\n  factoryAddress: lowerAddress(DefaultMAV2Address.MAV2_FACTORY),\n  factoryAbi: accountFactoryAbi,\n  getFactoryData: (args: SemiModularAccountV2FactoryArgs) => {\n    return encodeFunctionData({\n      abi: accountFactoryAbi,\n      functionName: \"createSemiModularAccount\",\n      args: [args.owner, args.salt],\n    });\n  },\n  predictAccountAddress: (args: SemiModularAccountV2FactoryArgs) => {\n    return predictModularAccountV2Address({\n      factoryAddress: DefaultMAV2Address.MAV2_FACTORY,\n      implementationAddress: DefaultMAV2Address.SMAV2_BYTECODE,\n      type: \"SMA\",\n      salt: args.salt,\n      ownerAddress: args.owner,\n    });\n  },\n};\n\nexport type SemiModularAccount7702StaticImpl = StaticSmartAccountImplementation<\n  true,\n  \"0.7\",\n  SemiModularAccountV2FactoryArgs,\n  typeof entryPoint07Abi,\n  typeof semiModularAccountBytecodeAbi,\n  typeof accountFactoryAbi\n>;\n\n/**\n * Static implementation logic for SemiModularAccount7702.\n *\n * TODO(v5): update JSDoc format when doc-gen supports structs or records.\n */\nexport const semiModularAccount7702StaticImpl: SemiModularAccount7702StaticImpl =\n  {\n    ...semiModularAccountBase,\n    delegationAddress: lowerAddress(DefaultMAV2Address.SMAV2_7702),\n  };\n\nexport type WebAuthnModularAccountV2FactoryArgs = {\n  ownerPublicKey: Hex;\n  salt: bigint;\n  entityId: number;\n};\n\nexport type WebAuthnModularAccountV2StaticImpl =\n  StaticSmartAccountImplementation<\n    false,\n    \"0.7\",\n    WebAuthnModularAccountV2FactoryArgs,\n    typeof entryPoint07Abi,\n    typeof modularAccountAbi,\n    typeof webAuthnFactoryAbi\n  >;\n\n/**\n * Static implementation logic for WebAuthnModularAccountV2.\n *\n * TODO(v5): update JSDoc format when doc-gen supports structs or records.\n */\nexport const webAuthnModularAccountV2StaticImpl: WebAuthnModularAccountV2StaticImpl =\n  {\n    entryPoint,\n    accountAbi: modularAccountAbi,\n    accountImplementation: lowerAddress(DefaultMAV2Address.MAV2),\n    factoryAddress: lowerAddress(DefaultMAV2Address.MAV2_FACTORY_WEBAUTHN),\n    factoryAbi: webAuthnFactoryAbi,\n    getFactoryData: (args: WebAuthnModularAccountV2FactoryArgs) => {\n      const { x, y } = parsePublicKey(args.ownerPublicKey);\n      return encodeFunctionData({\n        abi: webAuthnFactoryAbi,\n        functionName: \"createWebAuthnAccount\",\n        args: [x, y, args.salt, args.entityId],\n      });\n    },\n    predictAccountAddress: (args: WebAuthnModularAccountV2FactoryArgs) => {\n      return predictModularAccountV2Address({\n        factoryAddress: DefaultMAV2Address.MAV2_FACTORY_WEBAUTHN,\n        implementationAddress: DefaultMAV2Address.MAV2,\n        type: \"WebAuthn\",\n        salt: args.salt,\n        ownerPublicKey: args.ownerPublicKey,\n        entityId: args.entityId,\n      });\n    },\n  };\n"]}