@alchemy/smart-accounts 5.0.0-beta.3 → 5.0.0-beta.31

package/src/ma-v2/decorators/installValidation.ts

@@ -13,8 +13,7 @@ import type { HookConfig, ValidationConfig } from "../types.js";
 import type { ModularAccountV2 } from "../accounts/account.js";
 import type { GetAccountParameter } from "../../types.js";
 import { semiModularAccountBytecodeAbi } from "../abis/semiModularAccountBytecodeAbi.js";
-import { type SmartAccount, sendUserOperation } from "viem/account-abstraction";
-import { getAction } from "viem/utils";
+import type { SmartAccount } from "viem/account-abstraction";
 import { AccountNotFoundError } from "@alchemy/common";
 import { EntityIdOverrideError } from "../../errors/EntityIdOverrideError.js";
 import {
@@ -54,33 +53,26 @@ export type InstallValidationActions<
   encodeInstallValidation: (
     args: InstallValidationParams<TAccount>,
   ) => Promise<Hex>;
-  installValidation: (args: InstallValidationParams<TAccount>) => Promise<Hex>;
   encodeUninstallValidation: (
     args: UninstallValidationParams<TAccount>,
   ) => Promise<Hex>;
-  uninstallValidation: (
-    args: UninstallValidationParams<TAccount>,
-  ) => Promise<Hex>;
 };
 
-// TODO(v5): update jsdoc
 /**
- * Provides validation installation and uninstallation functionalities for a MA v2 client, ensuring compatibility with `SmartAccountClient`.
+ * Provides validation installation and uninstallation encoding functionalities for a MA v2 client.
  *
  * @example
  * ```ts
- * import { createModularAccountV2Client, installValidationActions, getDefaultSingleSignerValidationModuleAddress, SingleSignerValidationModule } from "@alchemy/smart-accounts";
+ * import { installValidationActions, 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({
+ * const callData = await client.encodeInstallValidation({
  *   validationConfig: {
- *     moduleAddress: getDefaultSingleSignerValidationModuleAddress(
- *       client.chain
- *     ),
+ *     moduleAddress: getDefaultSingleSignerValidationModuleAddress(client.chain),
  *     entityId: sessionKeyEntityId,
  *     isGlobal: true,
  *     isSignatureValidation: false,
@@ -94,19 +86,11 @@ export type InstallValidationActions<
  *   hooks: [],
  * });
  *
- * await client.uninstallValidation({
- *   moduleAddress: sessionKeyAddress,
- *   entityId: sessionKeyEntityId,
- *   uninstallData: SingleSignerValidationModule.encodeOnUninstallData({
- *     entityId: sessionKeyEntityId,
- *   }),
- *   hookUninstallDatas: [],
- * });
- *
+ * await client.sendUserOperation({ callData, account });
  * ```
  *
- * @param {object} client - The client instance which provides account and sendUserOperation functionality.
- * @returns {object} - An object containing two methods, `installValidation` and `uninstallValidation`.
+ * @param {object} client - The client instance which provides account functionality.
+ * @returns {object} - An object containing `encodeInstallValidation` and `encodeUninstallValidation`.
  */
 export function installValidationActions<
   TTransport extends Transport = Transport,
@@ -194,64 +178,5 @@ export function installValidationActions<
   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;
-    },
   };
 }

package/src/ma-v2/mav2StaticImpl.ts

@@ -36,8 +36,6 @@ const semiModularAccountBase = {
 
 /**
  * Static implementation logic for SemiModularAccountV2.
- *
- * TODO(v5): update JSDoc format when doc-gen supports structs or records.
  */
 export const semiModularAccountV2StaticImpl: SemiModularAccountV2StaticImpl = {
   ...semiModularAccountBase,
@@ -73,8 +71,6 @@ export type SemiModularAccount7702StaticImpl = StaticSmartAccountImplementation<
 
 /**
  * Static implementation logic for SemiModularAccount7702.
- *
- * TODO(v5): update JSDoc format when doc-gen supports structs or records.
  */
 export const semiModularAccount7702StaticImpl: SemiModularAccount7702StaticImpl =
   {

package/src/ma-v2/permissionBuilder.ts

@@ -44,6 +44,46 @@ const ERC20_APPROVE_SELECTOR = "0x095ea7b3";
 const ERC20_TRANSFER_SELECTOR = "0xa9059cbb";
 const ACCOUNT_EXECUTE_SELECTOR = "0xb61d27f6";
 const ACCOUNT_EXECUTEBATCH_SELECTOR = "0x34fcd5be";
+const ACCOUNT_PERFORM_CREATE_SELECTOR = "0x5998db5c";
+const ACCOUNT_EXECUTE_WITH_RUNTIME_VALIDATION_SELECTOR = "0xf2680c0f";
+const ACCOUNT_INSTALL_VALIDATION_SELECTOR = "0x1bbf564c";
+const ACCOUNT_UNINSTALL_VALIDATION_SELECTOR = "0xb6b1ccfe";
+const ACCOUNT_INSTALL_EXECUTION_SELECTOR = "0x1d37e7d6";
+const ACCOUNT_UNINSTALL_EXECUTION_SELECTOR = "0x0b7cad71";
+const ACCOUNT_UPGRADE_TO_AND_CALL_SELECTOR = "0x4f1ef286";
+// Wrapped native functions that must not be added to a session key's selector allowlist.
+const PRIVILEGED_SELECTORS: Record<string, string> = {
+  [ACCOUNT_PERFORM_CREATE_SELECTOR]: "performCreate",
+  [ACCOUNT_EXECUTE_WITH_RUNTIME_VALIDATION_SELECTOR]:
+    "executeWithRuntimeValidation",
+  [ACCOUNT_INSTALL_VALIDATION_SELECTOR]: "installValidation",
+  [ACCOUNT_UNINSTALL_VALIDATION_SELECTOR]: "uninstallValidation",
+  [ACCOUNT_INSTALL_EXECUTION_SELECTOR]: "installExecution",
+  [ACCOUNT_UNINSTALL_EXECUTION_SELECTOR]: "uninstallExecution",
+  [ACCOUNT_UPGRADE_TO_AND_CALL_SELECTOR]: "upgradeToAndCall",
+};
+
+// Auto-added by translatePermissions when a PREVAL_ALLOWLIST hook exists.
+// Blocked from manual addition to ensure they're only added with proper hook context.
+const SYSTEM_MANAGED_SELECTORS: Record<string, string> = {
+  [ACCOUNT_EXECUTE_SELECTOR]: "execute",
+  [ACCOUNT_EXECUTEBATCH_SELECTOR]: "executeBatch",
+};
+
+function assertNotForbiddenSelector(selector: Hex): void {
+  const normalized = selector.toLowerCase();
+  const match =
+    PRIVILEGED_SELECTORS[normalized] ?? SYSTEM_MANAGED_SELECTORS[normalized];
+  if (match != null) {
+    throw new SelectorNotAllowed(match);
+  }
+}
+
+function assertNoForbiddenSelectors(selectors: Hex[]): void {
+  for (const selector of selectors) {
+    assertNotForbiddenSelector(selector);
+  }
+}
 
 /**
  * A pseudo-enum for permission types.
@@ -277,7 +317,10 @@ export class PermissionBuilder {
       signer: key.publicKey,
     });
     this.nonce = nonce;
-    if (selectors) this.selectors = selectors;
+    if (selectors) {
+      assertNoForbiddenSelectors(selectors);
+      this.selectors = selectors;
+    }
     if (hooks) this.hooks = hooks;
     if (deadline) this.deadline = deadline;
   }
@@ -289,6 +332,7 @@ export class PermissionBuilder {
    * @returns {this} The permission builder instance.
    */
   addSelector({ selector }: { selector: Hex }): this {
+    assertNotForbiddenSelector(selector);
     this.selectors.push(selector);
     return this;
   }
@@ -351,14 +395,7 @@ export class PermissionBuilder {
       if (permission.data.functions.length === 0) {
         throw new NoFunctionsProvidedError(permission);
       }
-      // Explicitly disallow adding execute & executeBatch
-      if (permission.data.functions.includes(ACCOUNT_EXECUTE_SELECTOR)) {
-        throw new SelectorNotAllowed("execute");
-      } else if (
-        permission.data.functions.includes(ACCOUNT_EXECUTEBATCH_SELECTOR)
-      ) {
-        throw new SelectorNotAllowed("executeBatch");
-      }
+      assertNoForbiddenSelectors(permission.data.functions);
       this.selectors = [...this.selectors, ...permission.data.functions];
     }
 
@@ -384,11 +421,11 @@ export class PermissionBuilder {
   /**
    * Compiles the deferred action typed data to sign.
    *
-   * @returns {Promise<{typedData: DeferredActionTypedData, fullPreSignatureDeferredActionDigest: Hex}>} The deferred action typed data and the full pre-signature deferred action digest.
+   * @returns {Promise<{typedData: DeferredActionTypedData, fullPreSignatureDeferredActionPayload: Hex}>} The deferred action typed data and the full pre-signature deferred action payload.
    */
   async compileDeferred(): Promise<{
     typedData: DeferredActionTypedData;
-    fullPreSignatureDeferredActionDigest: Hex;
+    fullPreSignatureDeferredActionPayload: Hex;
   }> {
     // Add time range module hook via expiry
     if (this.deadline !== 0) {
@@ -421,20 +458,20 @@ export class PermissionBuilder {
       nonce: this.nonce,
     });
 
-    const preSignatureDigest = deferralActions(
+    const preSignaturePayload = deferralActions(
       this.client,
-    ).buildPreSignatureDeferredActionDigest({ typedData });
+    ).buildPreSignatureDeferredActionPayload({ typedData });
 
-    // Encode additional information to build the full pre-signature digest
-    const fullPreSignatureDeferredActionDigest: `0x${string}` = `0x0${
+    // Encode additional information to build the full pre-signature payload
+    const fullPreSignatureDeferredActionPayload: `0x${string}` = `0x0${
       this.hasAssociatedExecHooks ? "1" : "0"
     }${toHex(this.nonce, {
       size: 32,
-    }).slice(2)}${preSignatureDigest.slice(2)}`;
+    }).slice(2)}${preSignaturePayload.slice(2)}`;
 
     return {
       typedData,
-      fullPreSignatureDeferredActionDigest,
+      fullPreSignatureDeferredActionPayload,
     };
   }
 

package/src/ma-v2/utils/account.ts

@@ -64,8 +64,6 @@ export async function getMAV2UpgradeToData(
   return {
     implAddress: DefaultAddress.SMAV2_STORAGE,
     initializationData: initData,
-    // TODO(v5): do we need `createModularAccountV2FromExisting()` in the return type here like we had in v4 or no?
-    // Almost certainly not, but we need to clean up other parts in SDK for client-side upgrades.
   };
 }
 

package/src/ma-v2/utils/deferredActions.ts

@@ -34,31 +34,31 @@ export const parseDeferredAction = (
   };
 };
 
-export type BuildDeferredActionDigestParams = {
-  fullPreSignatureDeferredActionDigest: Hex;
+export type EncodeDeferredActionWithSignatureParams = {
+  fullPreSignatureDeferredActionPayload: Hex;
   sig: Hex;
   signaturePrefix?: SignaturePrefix;
 };
 
 /**
- * Creates the digest which must be prepended to the userOp signature.
+ * Encodes the deferred action with its signature, producing the payload to prepend to the userOp signature.
  *
  * Assumption: The client this extends is used to sign the typed data.
  *
- * @param {BuildDeferredActionDigestParams} params - The parameters for building the deferred action digest.
- * @returns {Hex} The encoded digest to be prepended to the userOp signature.
+ * @param {EncodeDeferredActionWithSignatureParams} params - The parameters for encoding the deferred action with its signature.
+ * @returns {Hex} The encoded payload to be prepended to the userOp signature.
  */
-export const buildDeferredActionDigest = ({
-  fullPreSignatureDeferredActionDigest,
+export const encodeDeferredActionWithSignature = ({
+  fullPreSignatureDeferredActionPayload,
   sig,
-}: BuildDeferredActionDigestParams): Hex => {
+}: EncodeDeferredActionWithSignatureParams): Hex => {
   // 6492 sigs don't work here.
   const _sig = parseErc6492Signature(sig).signature;
 
   const sigLength = size(_sig);
 
   const encodedData = concatHex([
-    fullPreSignatureDeferredActionDigest,
+    fullPreSignatureDeferredActionPayload,
     toHex(sigLength, { size: 4 }),
     _sig,
   ]);

package/src/version.ts

@@ -1,3 +1,3 @@
 // This file is autogenerated by inject-version.ts. Any changes will be
 // overwritten on commit!
-export const VERSION = "5.0.0-beta.3";
+export const VERSION = "5.0.0-beta.31";

package/dist/esm/light-account/decorators/multiOwner.d.ts

@@ -1,17 +0,0 @@
-import type { Address, Chain, Client, Hex, IsUndefined, Transport } from "viem";
-import { type SmartAccount } from "viem/account-abstraction";
-import type { GetAccountParameter } from "../../types.js";
-import type { MultiOwnerLightAccount } from "../accounts/multi-owner-account.js";
-export type MultiOwnerLightAccountActions<TAccount extends MultiOwnerLightAccount | undefined = MultiOwnerLightAccount | undefined> = {
-    updateOwners: (args: {
-        ownersToAdd: Address[];
-        ownersToRemove: Address[];
-    } & GetAccountParameter<TAccount, MultiOwnerLightAccount>) => Promise<Hex>;
-};
-/**
- * Generates client actions for a multi-owner light account, including the ability to update owners.
- *
- * @param {Client<TTransport, TChain, TAccount>} client The client instance used to interact with the account
- * @returns {MultiOwnerLightAccountActions<TAccount>} An object containing the client actions specifically for a multi-owner light account
- */
-export declare function multiOwnerLightAccountActions<TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartAccount | undefined = SmartAccount | undefined>(client: Client<TTransport, TChain, TAccount>): MultiOwnerLightAccountActions<IsUndefined<TAccount> extends true ? undefined : MultiOwnerLightAccount>;

package/dist/esm/light-account/decorators/multiOwner.js

@@ -1,39 +0,0 @@
-import { sendUserOperation } from "viem/account-abstraction";
-import { getAction } from "viem/utils";
-import { AccountNotFoundError } from "@alchemy/common";
-function isMultiOwnerLightAccount(account) {
-    return ("smartAccountType" in account &&
-        account.smartAccountType === "MultiOwnerLightAccount");
-}
-/**
- * Generates client actions for a multi-owner light account, including the ability to update owners.
- *
- * @param {Client<TTransport, TChain, TAccount>} client The client instance used to interact with the account
- * @returns {MultiOwnerLightAccountActions<TAccount>} An object containing the client actions specifically for a multi-owner light account
- */
-export function multiOwnerLightAccountActions(client) {
-    return {
-        // TODO(v5): Another pattern I think we should consider deprecating for v5 - actions that
-        // implicitly do a sendUserOperation internally. These are non-composable with batching
-        // and have a number of other issues that are solved with viem writeContract.
-        updateOwners: async (args) => {
-            const { ownersToAdd, ownersToRemove, account = client.account } = args;
-            if (!account || !isMultiOwnerLightAccount(account)) {
-                throw new AccountNotFoundError();
-            }
-            const data = account.encodeUpdateOwners(ownersToAdd, ownersToRemove);
-            const action = getAction(client, sendUserOperation, "sendUserOperation");
-            const result = await action({
-                calls: [
-                    {
-                        to: account.address,
-                        data,
-                    },
-                ],
-                account,
-            });
-            return result;
-        },
-    };
-}
-//# sourceMappingURL=multiOwner.js.map

package/dist/esm/light-account/decorators/multiOwner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"multiOwner.js","sourceRoot":"","sources":["../../../../src/light-account/decorators/multiOwner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAqB,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAevD,SAAS,wBAAwB,CAC/B,OAAqB;IAErB,OAAO,CACL,kBAAkB,IAAI,OAAO;QAC7B,OAAO,CAAC,gBAAgB,KAAK,wBAAwB,CACtD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAK3C,MAA4C;IAI5C,OAAO;QACL,yFAAyF;QACzF,uFAAuF;QACvF,6EAA6E;QAC7E,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC3B,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;YAEvE,IAAI,CAAC,OAAO,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnD,MAAM,IAAI,oBAAoB,EAAE,CAAC;YACnC,CAAC;YAED,MAAM,IAAI,GAAG,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;YAErE,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,mBAAmB,CAAC,CAAC;YACzE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC;gBAC1B,KAAK,EAAE;oBACL;wBACE,EAAE,EAAE,OAAO,CAAC,OAAO;wBACnB,IAAI;qBACL;iBACF;gBACD,OAAO;aACR,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { Address, Chain, Client, Hex, IsUndefined, Transport } from \"viem\";\nimport { sendUserOperation, type SmartAccount } from \"viem/account-abstraction\";\nimport { getAction } from \"viem/utils\";\nimport type { GetAccountParameter } from \"../../types.js\";\nimport type { MultiOwnerLightAccount } from \"../accounts/multi-owner-account.js\";\nimport { AccountNotFoundError } from \"@alchemy/common\";\n\nexport type MultiOwnerLightAccountActions<\n  TAccount extends MultiOwnerLightAccount | undefined =\n    | MultiOwnerLightAccount\n    | undefined,\n> = {\n  updateOwners: (\n    args: {\n      ownersToAdd: Address[];\n      ownersToRemove: Address[];\n    } & GetAccountParameter<TAccount, MultiOwnerLightAccount>,\n  ) => Promise<Hex>;\n};\n\nfunction isMultiOwnerLightAccount(\n  account: SmartAccount,\n): account is MultiOwnerLightAccount {\n  return (\n    \"smartAccountType\" in account &&\n    account.smartAccountType === \"MultiOwnerLightAccount\"\n  );\n}\n\n/**\n * Generates client actions for a multi-owner light account, including the ability to update owners.\n *\n * @param {Client<TTransport, TChain, TAccount>} client The client instance used to interact with the account\n * @returns {MultiOwnerLightAccountActions<TAccount>} An object containing the client actions specifically for a multi-owner light account\n */\nexport function multiOwnerLightAccountActions<\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): MultiOwnerLightAccountActions<\n  IsUndefined<TAccount> extends true ? undefined : MultiOwnerLightAccount\n> {\n  return {\n    // TODO(v5): Another pattern I think we should consider deprecating for v5 - actions that\n    // implicitly do a sendUserOperation internally. These are non-composable with batching\n    // and have a number of other issues that are solved with viem writeContract.\n    updateOwners: async (args) => {\n      const { ownersToAdd, ownersToRemove, account = client.account } = args;\n\n      if (!account || !isMultiOwnerLightAccount(account)) {\n        throw new AccountNotFoundError();\n      }\n\n      const data = account.encodeUpdateOwners(ownersToAdd, ownersToRemove);\n\n      const action = getAction(client, sendUserOperation, \"sendUserOperation\");\n      const result = await action({\n        calls: [\n          {\n            to: account.address,\n            data,\n          },\n        ],\n        account,\n      });\n\n      return result;\n    },\n  };\n}\n"]}

package/dist/esm/light-account/decorators/singleOwner.d.ts

@@ -1,16 +0,0 @@
-import type { Address, Chain, Client, Hex, IsUndefined, Transport } from "viem";
-import { type SmartAccount } from "viem/account-abstraction";
-import type { GetAccountParameter } from "../../types.js";
-import type { LightAccount } from "../accounts/account.js";
-export type LightAccountActions<TAccount extends LightAccount | undefined = LightAccount | undefined> = {
-    transferOwnership: (args: {
-        newOwner: Address;
-    } & GetAccountParameter<TAccount, LightAccount>) => Promise<Hex>;
-};
-/**
- * A decorator that can be used with viem's bundler client to add light account actions to the client
- *
- * @param {BundlerClient<TTransport, TChain, TAccount>} client The client instance for which to provide the light account actions
- * @returns {LightAccountActions<TAccount>} An object containing the available light account actions
- */
-export declare function singleOwnerLightAccountActions<TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartAccount | undefined = SmartAccount | undefined>(client: Client<TTransport, TChain, TAccount>): LightAccountActions<IsUndefined<TAccount> extends true ? undefined : LightAccount>;

package/dist/esm/light-account/decorators/singleOwner.js

@@ -1,35 +0,0 @@
-import { AccountNotFoundError } from "@alchemy/common";
-import { sendUserOperation } from "viem/account-abstraction";
-import { getAction } from "viem/utils";
-function isLightAccount(account) {
-    return ("smartAccountType" in account && account.smartAccountType === "LightAccount");
-}
-/**
- * A decorator that can be used with viem's bundler client to add light account actions to the client
- *
- * @param {BundlerClient<TTransport, TChain, TAccount>} client The client instance for which to provide the light account actions
- * @returns {LightAccountActions<TAccount>} An object containing the available light account actions
- */
-export function singleOwnerLightAccountActions(client) {
-    return {
-        transferOwnership: async (args) => {
-            const { newOwner, account = client.account } = args;
-            if (!account || !isLightAccount(account)) {
-                throw new AccountNotFoundError();
-            }
-            const data = account.encodeTransferOwnership(newOwner);
-            const action = getAction(client, sendUserOperation, "sendUserOperation");
-            const result = await action({
-                calls: [
-                    {
-                        to: account.address,
-                        data,
-                    },
-                ],
-                account,
-            });
-            return result;
-        },
-    };
-}
-//# sourceMappingURL=singleOwner.js.map

package/dist/esm/light-account/decorators/singleOwner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"singleOwner.js","sourceRoot":"","sources":["../../../../src/light-account/decorators/singleOwner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAqB,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAcvC,SAAS,cAAc,CAAC,OAAqB;IAC3C,OAAO,CACL,kBAAkB,IAAI,OAAO,IAAI,OAAO,CAAC,gBAAgB,KAAK,cAAc,CAC7E,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAK5C,MAA4C;IAI5C,OAAO;QACL,iBAAiB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAChC,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;YAEpD,IAAI,CAAC,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzC,MAAM,IAAI,oBAAoB,EAAE,CAAC;YACnC,CAAC;YAED,MAAM,IAAI,GAAG,OAAO,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;YAEvD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,mBAAmB,CAAC,CAAC;YACzE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC;gBAC1B,KAAK,EAAE;oBACL;wBACE,EAAE,EAAE,OAAO,CAAC,OAAO;wBACnB,IAAI;qBACL;iBACF;gBACD,OAAO;aACR,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import { AccountNotFoundError } from \"@alchemy/common\";\nimport type { Address, Chain, Client, Hex, IsUndefined, Transport } from \"viem\";\nimport { sendUserOperation, type SmartAccount } from \"viem/account-abstraction\";\nimport { getAction } from \"viem/utils\";\nimport type { GetAccountParameter } from \"../../types.js\";\nimport type { LightAccount } from \"../accounts/account.js\";\n\nexport type LightAccountActions<\n  TAccount extends LightAccount | undefined = LightAccount | undefined,\n> = {\n  transferOwnership: (\n    args: {\n      newOwner: Address;\n    } & GetAccountParameter<TAccount, LightAccount>,\n  ) => Promise<Hex>;\n};\n\nfunction isLightAccount(account: SmartAccount): account is LightAccount {\n  return (\n    \"smartAccountType\" in account && account.smartAccountType === \"LightAccount\"\n  );\n}\n\n/**\n * A decorator that can be used with viem's bundler client to add light account actions to the client\n *\n * @param {BundlerClient<TTransport, TChain, TAccount>} client The client instance for which to provide the light account actions\n * @returns {LightAccountActions<TAccount>} An object containing the available light account actions\n */\nexport function singleOwnerLightAccountActions<\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): LightAccountActions<\n  IsUndefined<TAccount> extends true ? undefined : LightAccount\n> {\n  return {\n    transferOwnership: async (args) => {\n      const { newOwner, account = client.account } = args;\n\n      if (!account || !isLightAccount(account)) {\n        throw new AccountNotFoundError();\n      }\n\n      const data = account.encodeTransferOwnership(newOwner);\n\n      const action = getAction(client, sendUserOperation, \"sendUserOperation\");\n      const result = await action({\n        calls: [\n          {\n            to: account.address,\n            data,\n          },\n        ],\n        account,\n      });\n\n      return result;\n    },\n  };\n}\n"]}

package/dist/esm/ma-v1/decorators/multiOwner.d.ts

@@ -1,17 +0,0 @@
-import type { Address, Chain, Client, Hex, IsUndefined, Transport } from "viem";
-import { type SmartAccount } from "viem/account-abstraction";
-import type { GetAccountParameter } from "../../types.js";
-import type { MultiOwnerModularAccountV1 } from "../accounts/multi-owner-account.js";
-export type MultiOwnerModularAccountV1Actions<TAccount extends MultiOwnerModularAccountV1 | undefined = MultiOwnerModularAccountV1 | undefined> = {
-    updateOwners: (args: {
-        ownersToAdd: Address[];
-        ownersToRemove: Address[];
-    } & GetAccountParameter<TAccount, MultiOwnerModularAccountV1>) => Promise<Hex>;
-};
-/**
- * Generates client actions for a multi-owner MAv1 account, including the ability to update owners.
- *
- * @param {Client<TTransport, TChain, TAccount>} client The client instance used to interact with the account
- * @returns {MultiOwnerLightAccountActions<TAccount>} An object containing the client actions specifically for a multi-owner modular account
- */
-export declare function multiOwnerModularAccountV1Actions<TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartAccount | undefined = SmartAccount | undefined>(client: Client<TTransport, TChain, TAccount>): MultiOwnerModularAccountV1Actions<IsUndefined<TAccount> extends true ? undefined : MultiOwnerModularAccountV1>;

package/dist/esm/ma-v1/decorators/multiOwner.js

@@ -1,39 +0,0 @@
-import { sendUserOperation } from "viem/account-abstraction";
-import { getAction } from "viem/utils";
-import { AccountNotFoundError } from "@alchemy/common";
-function isMultiOwnerModularAccountV1(account) {
-    return ("smartAccountType" in account &&
-        account.smartAccountType === "MultiOwnerModularAccountV1");
-}
-/**
- * Generates client actions for a multi-owner MAv1 account, including the ability to update owners.
- *
- * @param {Client<TTransport, TChain, TAccount>} client The client instance used to interact with the account
- * @returns {MultiOwnerLightAccountActions<TAccount>} An object containing the client actions specifically for a multi-owner modular account
- */
-export function multiOwnerModularAccountV1Actions(client) {
-    return {
-        // TODO(v5): Another pattern I think we should consider deprecating for v5 - actions that
-        // implicitly do a sendUserOperation internally. These are non-composable with batching
-        // and have a number of other issues that are solved with viem writeContract.
-        updateOwners: async (args) => {
-            const { ownersToAdd, ownersToRemove, account = client.account } = args;
-            if (!account || !isMultiOwnerModularAccountV1(account)) {
-                throw new AccountNotFoundError();
-            }
-            const data = account.encodeUpdateOwners(ownersToAdd, ownersToRemove);
-            const action = getAction(client, sendUserOperation, "sendUserOperation");
-            const result = await action({
-                calls: [
-                    {
-                        to: account.address,
-                        data,
-                    },
-                ],
-                account,
-            });
-            return result;
-        },
-    };
-}
-//# sourceMappingURL=multiOwner.js.map

package/dist/esm/ma-v1/decorators/multiOwner.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"multiOwner.js","sourceRoot":"","sources":["../../../../src/ma-v1/decorators/multiOwner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAqB,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAgBvD,SAAS,4BAA4B,CACnC,OAAqB;IAErB,OAAO,CACL,kBAAkB,IAAI,OAAO;QAC7B,OAAO,CAAC,gBAAgB,KAAK,4BAA4B,CAC1D,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAK/C,MAA4C;IAI5C,OAAO;QACL,yFAAyF;QACzF,uFAAuF;QACvF,6EAA6E;QAC7E,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC3B,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC;YAEvE,IAAI,CAAC,OAAO,IAAI,CAAC,4BAA4B,CAAC,OAAO,CAAC,EAAE,CAAC;gBACvD,MAAM,IAAI,oBAAoB,EAAE,CAAC;YACnC,CAAC;YAED,MAAM,IAAI,GAAG,OAAO,CAAC,kBAAkB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;YAErE,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,iBAAiB,EAAE,mBAAmB,CAAC,CAAC;YACzE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC;gBAC1B,KAAK,EAAE;oBACL;wBACE,EAAE,EAAE,OAAO,CAAC,OAAO;wBACnB,IAAI;qBACL;iBACF;gBACD,OAAO;aACR,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { Address, Chain, Client, Hex, IsUndefined, Transport } from \"viem\";\nimport { sendUserOperation, type SmartAccount } from \"viem/account-abstraction\";\nimport { getAction } from \"viem/utils\";\nimport type { GetAccountParameter } from \"../../types.js\";\nimport { AccountNotFoundError } from \"@alchemy/common\";\nimport type { MultiOwnerModularAccountV1 } from \"../accounts/multi-owner-account.js\";\n\nexport type MultiOwnerModularAccountV1Actions<\n  TAccount extends MultiOwnerModularAccountV1 | undefined =\n    | MultiOwnerModularAccountV1\n    | undefined,\n> = {\n  updateOwners: (\n    args: {\n      ownersToAdd: Address[];\n      ownersToRemove: Address[];\n    } & GetAccountParameter<TAccount, MultiOwnerModularAccountV1>,\n  ) => Promise<Hex>;\n};\n\nfunction isMultiOwnerModularAccountV1(\n  account: SmartAccount,\n): account is MultiOwnerModularAccountV1 {\n  return (\n    \"smartAccountType\" in account &&\n    account.smartAccountType === \"MultiOwnerModularAccountV1\"\n  );\n}\n\n/**\n * Generates client actions for a multi-owner MAv1 account, including the ability to update owners.\n *\n * @param {Client<TTransport, TChain, TAccount>} client The client instance used to interact with the account\n * @returns {MultiOwnerLightAccountActions<TAccount>} An object containing the client actions specifically for a multi-owner modular account\n */\nexport function multiOwnerModularAccountV1Actions<\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): MultiOwnerModularAccountV1Actions<\n  IsUndefined<TAccount> extends true ? undefined : MultiOwnerModularAccountV1\n> {\n  return {\n    // TODO(v5): Another pattern I think we should consider deprecating for v5 - actions that\n    // implicitly do a sendUserOperation internally. These are non-composable with batching\n    // and have a number of other issues that are solved with viem writeContract.\n    updateOwners: async (args) => {\n      const { ownersToAdd, ownersToRemove, account = client.account } = args;\n\n      if (!account || !isMultiOwnerModularAccountV1(account)) {\n        throw new AccountNotFoundError();\n      }\n\n      const data = account.encodeUpdateOwners(ownersToAdd, ownersToRemove);\n\n      const action = getAction(client, sendUserOperation, \"sendUserOperation\");\n      const result = await action({\n        calls: [\n          {\n            to: account.address,\n            data,\n          },\n        ],\n        account,\n      });\n\n      return result;\n    },\n  };\n}\n"]}

package/dist/types/light-account/decorators/multiOwner.d.ts

@@ -1,18 +0,0 @@
-import type { Address, Chain, Client, Hex, IsUndefined, Transport } from "viem";
-import { type SmartAccount } from "viem/account-abstraction";
-import type { GetAccountParameter } from "../../types.js";
-import type { MultiOwnerLightAccount } from "../accounts/multi-owner-account.js";
-export type MultiOwnerLightAccountActions<TAccount extends MultiOwnerLightAccount | undefined = MultiOwnerLightAccount | undefined> = {
-    updateOwners: (args: {
-        ownersToAdd: Address[];
-        ownersToRemove: Address[];
-    } & GetAccountParameter<TAccount, MultiOwnerLightAccount>) => Promise<Hex>;
-};
-/**
- * Generates client actions for a multi-owner light account, including the ability to update owners.
- *
- * @param {Client<TTransport, TChain, TAccount>} client The client instance used to interact with the account
- * @returns {MultiOwnerLightAccountActions<TAccount>} An object containing the client actions specifically for a multi-owner light account
- */
-export declare function multiOwnerLightAccountActions<TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartAccount | undefined = SmartAccount | undefined>(client: Client<TTransport, TChain, TAccount>): MultiOwnerLightAccountActions<IsUndefined<TAccount> extends true ? undefined : MultiOwnerLightAccount>;
-//# sourceMappingURL=multiOwner.d.ts.map

package/dist/types/light-account/decorators/multiOwner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"multiOwner.d.ts","sourceRoot":"","sources":["../../../../src/light-account/decorators/multiOwner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAChF,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAGjF,MAAM,MAAM,6BAA6B,CACvC,QAAQ,SAAS,sBAAsB,GAAG,SAAS,GAC/C,sBAAsB,GACtB,SAAS,IACX;IACF,YAAY,EAAE,CACZ,IAAI,EAAE;QACJ,WAAW,EAAE,OAAO,EAAE,CAAC;QACvB,cAAc,EAAE,OAAO,EAAE,CAAC;KAC3B,GAAG,mBAAmB,CAAC,QAAQ,EAAE,sBAAsB,CAAC,KACtD,OAAO,CAAC,GAAG,CAAC,CAAC;CACnB,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,SAAS,SAAS,GAAG,SAAS,EACxC,MAAM,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,EACpD,QAAQ,SAAS,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,EAEpE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,GAC3C,6BAA6B,CAC9B,WAAW,CAAC,QAAQ,CAAC,SAAS,IAAI,GAAG,SAAS,GAAG,sBAAsB,CACxE,CA4BA"}

package/dist/types/light-account/decorators/singleOwner.d.ts

@@ -1,17 +0,0 @@
-import type { Address, Chain, Client, Hex, IsUndefined, Transport } from "viem";
-import { type SmartAccount } from "viem/account-abstraction";
-import type { GetAccountParameter } from "../../types.js";
-import type { LightAccount } from "../accounts/account.js";
-export type LightAccountActions<TAccount extends LightAccount | undefined = LightAccount | undefined> = {
-    transferOwnership: (args: {
-        newOwner: Address;
-    } & GetAccountParameter<TAccount, LightAccount>) => Promise<Hex>;
-};
-/**
- * A decorator that can be used with viem's bundler client to add light account actions to the client
- *
- * @param {BundlerClient<TTransport, TChain, TAccount>} client The client instance for which to provide the light account actions
- * @returns {LightAccountActions<TAccount>} An object containing the available light account actions
- */
-export declare function singleOwnerLightAccountActions<TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartAccount | undefined = SmartAccount | undefined>(client: Client<TTransport, TChain, TAccount>): LightAccountActions<IsUndefined<TAccount> extends true ? undefined : LightAccount>;
-//# sourceMappingURL=singleOwner.d.ts.map

package/dist/types/light-account/decorators/singleOwner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"singleOwner.d.ts","sourceRoot":"","sources":["../../../../src/light-account/decorators/singleOwner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAChF,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,MAAM,mBAAmB,CAC7B,QAAQ,SAAS,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,IAClE;IACF,iBAAiB,EAAE,CACjB,IAAI,EAAE;QACJ,QAAQ,EAAE,OAAO,CAAC;KACnB,GAAG,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,KAC5C,OAAO,CAAC,GAAG,CAAC,CAAC;CACnB,CAAC;AAQF;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,SAAS,SAAS,GAAG,SAAS,EACxC,MAAM,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,EACpD,QAAQ,SAAS,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,EAEpE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,GAC3C,mBAAmB,CACpB,WAAW,CAAC,QAAQ,CAAC,SAAS,IAAI,GAAG,SAAS,GAAG,YAAY,CAC9D,CAyBA"}

package/dist/types/ma-v1/decorators/multiOwner.d.ts

@@ -1,18 +0,0 @@
-import type { Address, Chain, Client, Hex, IsUndefined, Transport } from "viem";
-import { type SmartAccount } from "viem/account-abstraction";
-import type { GetAccountParameter } from "../../types.js";
-import type { MultiOwnerModularAccountV1 } from "../accounts/multi-owner-account.js";
-export type MultiOwnerModularAccountV1Actions<TAccount extends MultiOwnerModularAccountV1 | undefined = MultiOwnerModularAccountV1 | undefined> = {
-    updateOwners: (args: {
-        ownersToAdd: Address[];
-        ownersToRemove: Address[];
-    } & GetAccountParameter<TAccount, MultiOwnerModularAccountV1>) => Promise<Hex>;
-};
-/**
- * Generates client actions for a multi-owner MAv1 account, including the ability to update owners.
- *
- * @param {Client<TTransport, TChain, TAccount>} client The client instance used to interact with the account
- * @returns {MultiOwnerLightAccountActions<TAccount>} An object containing the client actions specifically for a multi-owner modular account
- */
-export declare function multiOwnerModularAccountV1Actions<TTransport extends Transport = Transport, TChain extends Chain | undefined = Chain | undefined, TAccount extends SmartAccount | undefined = SmartAccount | undefined>(client: Client<TTransport, TChain, TAccount>): MultiOwnerModularAccountV1Actions<IsUndefined<TAccount> extends true ? undefined : MultiOwnerModularAccountV1>;
-//# sourceMappingURL=multiOwner.d.ts.map

package/dist/types/ma-v1/decorators/multiOwner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"multiOwner.d.ts","sourceRoot":"","sources":["../../../../src/ma-v1/decorators/multiOwner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAChF,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAEhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAErF,MAAM,MAAM,iCAAiC,CAC3C,QAAQ,SAAS,0BAA0B,GAAG,SAAS,GACnD,0BAA0B,GAC1B,SAAS,IACX;IACF,YAAY,EAAE,CACZ,IAAI,EAAE;QACJ,WAAW,EAAE,OAAO,EAAE,CAAC;QACvB,cAAc,EAAE,OAAO,EAAE,CAAC;KAC3B,GAAG,mBAAmB,CAAC,QAAQ,EAAE,0BAA0B,CAAC,KAC1D,OAAO,CAAC,GAAG,CAAC,CAAC;CACnB,CAAC;AAWF;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,UAAU,SAAS,SAAS,GAAG,SAAS,EACxC,MAAM,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,EACpD,QAAQ,SAAS,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,EAEpE,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,GAC3C,iCAAiC,CAClC,WAAW,CAAC,QAAQ,CAAC,SAAS,IAAI,GAAG,SAAS,GAAG,0BAA0B,CAC5E,CA4BA"}