@account-kit/smart-contracts 4.7.0 → 4.8.0

package/dist/esm/src/ma-v2/account/semiModularAccountV2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semiModularAccountV2.js","sourceRoot":"","sources":["../../../../../src/ma-v2/account/semiModularAccountV2.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  EntryPointDef,\n  SmartAccountSigner,\n  AccountOp,\n  SmartContractAccountWithSigner,\n  ToSmartContractAccountParams,\n} from \"@aa-sdk/core\";\nimport {\n  createBundlerClient,\n  getEntryPoint,\n  toSmartContractAccount,\n  InvalidEntityIdError,\n  InvalidNonceKeyError,\n  getAccountAddress,\n} from \"@aa-sdk/core\";\nimport {\n  concatHex,\n  encodeFunctionData,\n  getContract,\n  maxUint32,\n  maxUint152,\n  zeroAddress,\n  type Address,\n  type Chain,\n  type Hex,\n  type Transport,\n} from \"viem\";\nimport { accountFactoryAbi } from \"../abis/accountFactoryAbi.js\";\nimport {\n  getDefaultMAV2FactoryAddress,\n  DEFAULT_OWNER_ENTITY_ID,\n} from \"../utils.js\";\nimport { singleSignerMessageSigner } from \"../modules/single-signer-validation/signer.js\";\nimport { nativeSMASigner } from \"./nativeSMASigner.js\";\nimport { modularAccountAbi } from \"../abis/modularAccountAbi.js\";\nimport { serializeModuleEntity } from \"../actions/common/utils.js\";\n\nconst executeUserOpSelector: Hex = \"0x8DD7712F\";\n\nexport type SignerEntity = {\n  isGlobalValidation: boolean;\n  entityId: number;\n};\n\nexport type ExecutionDataView = {\n  module: Address;\n  skipRuntimeValidation: boolean;\n  allowGlobalValidation: boolean;\n  executionHooks: readonly Hex[];\n};\n\nexport type ValidationDataView = {\n  validationHooks: readonly Hex[];\n  executionHooks: readonly Hex[];\n  selectors: readonly Hex[];\n  validationFlags: number;\n};\n\nexport type ValidationDataParams =\n  | {\n      validationModuleAddress: Address;\n      entityId?: never;\n    }\n  | {\n      validationModuleAddress?: never;\n      entityId: number;\n    };\n\nexport type MAV2Account<\n  TSigner extends SmartAccountSigner = SmartAccountSigner\n> = SmartContractAccountWithSigner<\"MAV2Account\", TSigner, \"0.7.0\"> & {\n  signerEntity: SignerEntity;\n  getExecutionData: (selector: Hex) => Promise<ExecutionDataView>;\n  getValidationData: (\n    args: ValidationDataParams\n  ) => Promise<ValidationDataView>;\n  encodeCallData: (callData: Hex) => Promise<Hex>;\n};\n\nexport type CreateSMAV2AccountParams<\n  TTransport extends Transport = Transport,\n  TSigner extends SmartAccountSigner = SmartAccountSigner\n> = Pick<\n  ToSmartContractAccountParams<\"MAV2Account\", TTransport, Chain, \"0.7.0\">,\n  \"transport\" | \"chain\" | \"accountAddress\"\n> & {\n  signer: TSigner;\n  salt?: bigint;\n  factoryAddress?: Address;\n  initCode?: Hex;\n  initialOwner?: Address;\n  entryPoint?: EntryPointDef<\"0.7.0\", Chain>;\n  signerEntity?: SignerEntity;\n};\n\nexport async function createSMAV2Account<\n  TTransport extends Transport = Transport,\n  TSigner extends SmartAccountSigner = SmartAccountSigner\n>(\n  config: CreateSMAV2AccountParams<TTransport, TSigner>\n): Promise<MAV2Account<TSigner>>;\n\n/**\n * Creates an SMAV2 account using defined parameters including chain, signer, salt, factory address, and more.\n * Handles account initialization code, nonce generation, transaction encoding, and more to construct a modular account with optional validation hooks.\n *\n * @param {CreateSMAV2AccountParams} config Configuration parameters for creating an SMAV2 account. Includes chain details, signer, salt, factory address, and more.\n * @returns {Promise<MAV2Account>} A promise that resolves to an `MAV2Account` providing methods for nonce retrieval, transaction execution, and more.\n */\nexport async function createSMAV2Account(\n  config: CreateSMAV2AccountParams\n): Promise<MAV2Account> {\n  const {\n    transport,\n    chain,\n    signer,\n    salt = 0n,\n    factoryAddress = getDefaultMAV2FactoryAddress(chain),\n    initCode,\n    initialOwner,\n    accountAddress,\n    entryPoint = getEntryPoint(chain, { version: \"0.7.0\" }),\n    signerEntity = {\n      isGlobalValidation: true,\n      entityId: DEFAULT_OWNER_ENTITY_ID,\n    },\n    signerEntity: {\n      isGlobalValidation = true,\n      entityId = DEFAULT_OWNER_ENTITY_ID,\n    } = {},\n  } = config;\n\n  if (entityId > Number(maxUint32)) {\n    throw new InvalidEntityIdError(entityId);\n  }\n\n  const client = createBundlerClient({\n    transport,\n    chain,\n  });\n\n  const getAccountInitCode = async () => {\n    if (initCode) {\n      return initCode;\n    }\n\n    // If an initial owner is not provided, use the signer's address\n    const ownerAddress = initialOwner ?? (await signer.getAddress());\n\n    return concatHex([\n      factoryAddress,\n      encodeFunctionData({\n        abi: accountFactoryAbi,\n        functionName: \"createSemiModularAccount\",\n        args: [ownerAddress, salt],\n      }),\n    ]);\n  };\n\n  const encodeExecute: (tx: AccountOp) => Promise<Hex> = async ({\n    target,\n    data,\n    value,\n  }) =>\n    await encodeCallData(\n      encodeFunctionData({\n        abi: modularAccountAbi,\n        functionName: \"execute\",\n        args: [target, value ?? 0n, data],\n      })\n    );\n\n  const encodeBatchExecute: (txs: AccountOp[]) => Promise<Hex> = async (txs) =>\n    await encodeCallData(\n      encodeFunctionData({\n        abi: modularAccountAbi,\n        functionName: \"executeBatch\",\n        args: [\n          txs.map((tx) => ({\n            target: tx.target,\n            data: tx.data,\n            value: tx.value ?? 0n,\n          })),\n        ],\n      })\n    );\n\n  const _accountAddress = await getAccountAddress({\n    client,\n    entryPoint,\n    accountAddress,\n    getAccountInitCode,\n  });\n\n  const baseAccount = await toSmartContractAccount({\n    transport,\n    chain,\n    entryPoint,\n    accountAddress: _accountAddress,\n    source: `MAV2Account`,\n    encodeExecute,\n    encodeBatchExecute,\n    getAccountInitCode,\n    ...(entityId === DEFAULT_OWNER_ENTITY_ID\n      ? nativeSMASigner(signer, chain, _accountAddress)\n      : singleSignerMessageSigner(signer, chain, _accountAddress, entityId)),\n  });\n\n  // TODO: add deferred action flag\n  const getAccountNonce = async (nonceKey: bigint = 0n): Promise<bigint> => {\n    if (nonceKey > maxUint152) {\n      throw new InvalidNonceKeyError(nonceKey);\n    }\n\n    const entryPointContract = getContract({\n      address: entryPoint.address,\n      abi: entryPoint.abi,\n      client,\n    });\n\n    const fullNonceKey: bigint =\n      (nonceKey << 40n) +\n      BigInt(entityId << 8) +\n      (isGlobalValidation ? 1n : 0n);\n\n    return entryPointContract.read.getNonce([\n      _accountAddress,\n      fullNonceKey,\n    ]) as Promise<bigint>;\n  };\n\n  const accountContract = getContract({\n    address: _accountAddress,\n    abi: modularAccountAbi,\n    client,\n  });\n\n  const getExecutionData = async (selector: Hex) => {\n    if (!(await baseAccount.isAccountDeployed())) {\n      return {\n        module: zeroAddress,\n        skipRuntimeValidation: false,\n        allowGlobalValidation: false,\n        executionHooks: [],\n      };\n    }\n\n    return await accountContract.read.getExecutionData([selector]);\n  };\n\n  const getValidationData = async (args: ValidationDataParams) => {\n    if (!(await baseAccount.isAccountDeployed())) {\n      return {\n        validationHooks: [],\n        executionHooks: [],\n        selectors: [],\n        validationFlags: 0,\n      };\n    }\n\n    const { validationModuleAddress, entityId } = args;\n    return await accountContract.read.getValidationData([\n      serializeModuleEntity({\n        moduleAddress: validationModuleAddress ?? zeroAddress,\n        entityId: entityId ?? Number(maxUint32),\n      }),\n    ]);\n  };\n\n  const encodeCallData = async (callData: Hex): Promise<Hex> => {\n    const validationData = await getValidationData({\n      entityId: Number(entityId),\n    });\n\n    return validationData.executionHooks.length\n      ? concatHex([executeUserOpSelector, callData])\n      : callData;\n  };\n\n  return {\n    ...baseAccount,\n    getAccountNonce,\n    getSigner: () => signer,\n    signerEntity,\n    getExecutionData,\n    getValidationData,\n    encodeCallData,\n  };\n}\n"]}

package/dist/esm/src/ma-v2/actions/common/types.d.ts

@@ -0,0 +1,31 @@
+import type { Address, Hex } from "viem";
+export type ModuleEntity = {
+    moduleAddress: Address;
+    entityId: number;
+};
+export type ValidationConfig = {
+    moduleAddress: Address;
+    entityId: number;
+    isGlobal: boolean;
+    isSignatureValidation: boolean;
+    isUserOpValidation: boolean;
+};
+export declare enum HookType {
+    EXECUTION = "0x00",
+    VALIDATION = "0x01"
+}
+export type HookConfig = {
+    address: Address;
+    entityId: number;
+    hookType: HookType;
+    hasPreHooks: boolean;
+    hasPostHooks: boolean;
+};
+export type ValidationData = {
+    isGlobal: boolean;
+    isSignatureValidation: boolean;
+    isUserOpValidation: boolean;
+    validationHooks: HookConfig[];
+    executionHooks: Hex[];
+    selectors: Hex[];
+};

package/dist/esm/src/ma-v2/actions/common/types.js

@@ -0,0 +1,6 @@
+export var HookType;
+(function (HookType) {
+    HookType["EXECUTION"] = "0x00";
+    HookType["VALIDATION"] = "0x01";
+})(HookType || (HookType = {}));
+//# sourceMappingURL=types.js.map

package/dist/esm/src/ma-v2/actions/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/ma-v2/actions/common/types.ts"],"names":[],"mappings":"AAeA,MAAM,CAAN,IAAY,QAGX;AAHD,WAAY,QAAQ;IAClB,8BAAkB,CAAA;IAClB,+BAAmB,CAAA;AACrB,CAAC,EAHW,QAAQ,KAAR,QAAQ,QAGnB","sourcesContent":["import type { Address, Hex } from \"viem\";\n\nexport type ModuleEntity = {\n  moduleAddress: Address;\n  entityId: number;\n};\n\nexport type ValidationConfig = {\n  moduleAddress: Address;\n  entityId: number; // uint32\n  isGlobal: boolean;\n  isSignatureValidation: boolean;\n  isUserOpValidation: boolean;\n};\n\nexport enum HookType {\n  EXECUTION = \"0x00\",\n  VALIDATION = \"0x01\",\n}\n\nexport type HookConfig = {\n  address: Address;\n  entityId: number; // uint32\n  hookType: HookType;\n  hasPreHooks: boolean;\n  hasPostHooks: boolean;\n};\n\n// maps to type ValidationStorage in MAv2 implementation\nexport type ValidationData = {\n  isGlobal: boolean; // validation flag\n  isSignatureValidation: boolean; // validation flag\n  isUserOpValidation: boolean;\n  validationHooks: HookConfig[];\n  executionHooks: Hex[];\n  selectors: Hex[];\n};\n"]}

package/dist/esm/src/ma-v2/actions/common/utils.d.ts

@@ -0,0 +1,76 @@
+import { type Hex } from "viem";
+import type { ValidationConfig, HookConfig, ModuleEntity } from "./types";
+/**
+ * Serializes a validation configuration into a hexadecimal string representation. This involves converting boolean flags into bitwise representation and combining them with serialized module entity data.
+ *
+ * @example
+ * ```ts
+ * import { serializeValidationConfig } from "@account-kit/smart-contracts";
+ * import { Address } from "viem";
+ *
+ * const moduleAddress: Address = "0x1234";
+ * const entityId: number = 1234;
+ * const isGlobal: boolean = true;
+ * const isSignatureValidation: boolean = false;
+ * const isUserOpValidation: boolean = true;
+ *
+ * const validationConfigHex = serializeValidationConfig({
+ *  moduleAddress,
+ *  entityId
+ *  isGlobal,
+ *  isSignatureValidation,
+ *  isUserOpValidation
+ * });
+ * ```
+ * @param {ValidationConfig} config The validation configuration object containing details to serialize
+ * @returns {Hex} A hexadecimal string representing the serialized configuration
+ */
+export declare function serializeValidationConfig(config: ValidationConfig): Hex;
+/**
+ * Serializes a `HookConfig` object into a `Hex` format by encoding the hook type, presence of post/pre hooks, address, and entity ID.
+ *
+ * @example
+ * ```ts
+ * import { type HookType, serializeHookConfig } from "@account-kit/smart-contracts";
+ * import { Address } from "viem";
+ *
+ * const moduleAddress: Address = "0x1234";
+ * const entityId: number = 1234;
+ * const hookType: HookType = HookType.Validation;
+ * const hasPostHooks: boolean = false;
+ * const hasPreHooks: boolean = true;
+ *
+ * const hookConfigHex = serializeHookConfig({
+ *  moduleAddress,
+ *  entityId
+ *  hookType,
+ *  hasPostHooks,
+ *  hasPreHooks
+ * });
+ * ```
+ *
+ * @param {HookConfig} config The hook configuration containing address, entity ID, hook type, and post/pre hook indicators
+ * @returns {Hex} The serialized hook configuration in hexadecimal format
+ */
+export declare function serializeHookConfig(config: HookConfig): Hex;
+/**
+ * Serializes a module entity into a hexadecimal format by concatenating the module address and entity ID.
+ *
+ * @example
+ * ```ts
+ * import { serializeModuleEntity } from "@account-kit/smart-contracts";
+ * import { Address } from "viem";
+ *
+ * const moduleAddress: Address = "0x1234";
+ * const entityId: number = 1234;
+ *
+ * const moduleEntityHex = serializeModuleEntity({
+ *  moduleAddress,
+ *  entityId
+ * });
+ * ```
+ *
+ * @param {ModuleEntity} config The module entity configuration containing the module address and entity ID
+ * @returns {Hex} A hexadecimal string representation of the serialized module entity
+ */
+export declare function serializeModuleEntity(config: ModuleEntity): Hex;

package/dist/esm/src/ma-v2/actions/common/utils.js

@@ -0,0 +1,100 @@
+import { toHex, concatHex } from "viem";
+import { HookType } from "./types.js";
+/**
+ * Serializes a validation configuration into a hexadecimal string representation. This involves converting boolean flags into bitwise representation and combining them with serialized module entity data.
+ *
+ * @example
+ * ```ts
+ * import { serializeValidationConfig } from "@account-kit/smart-contracts";
+ * import { Address } from "viem";
+ *
+ * const moduleAddress: Address = "0x1234";
+ * const entityId: number = 1234;
+ * const isGlobal: boolean = true;
+ * const isSignatureValidation: boolean = false;
+ * const isUserOpValidation: boolean = true;
+ *
+ * const validationConfigHex = serializeValidationConfig({
+ *  moduleAddress,
+ *  entityId
+ *  isGlobal,
+ *  isSignatureValidation,
+ *  isUserOpValidation
+ * });
+ * ```
+ * @param {ValidationConfig} config The validation configuration object containing details to serialize
+ * @returns {Hex} A hexadecimal string representing the serialized configuration
+ */
+export function serializeValidationConfig(config) {
+    const isUserOpValidationBit = config.isUserOpValidation ? 1 : 0;
+    const isSignatureValidationBit = config.isSignatureValidation ? 2 : 0;
+    const isGlobalBit = config.isGlobal ? 4 : 0;
+    return concatHex([
+        serializeModuleEntity(config),
+        toHex(isUserOpValidationBit + isSignatureValidationBit + isGlobalBit, {
+            size: 1,
+        }),
+    ]);
+}
+/**
+ * Serializes a `HookConfig` object into a `Hex` format by encoding the hook type, presence of post/pre hooks, address, and entity ID.
+ *
+ * @example
+ * ```ts
+ * import { type HookType, serializeHookConfig } from "@account-kit/smart-contracts";
+ * import { Address } from "viem";
+ *
+ * const moduleAddress: Address = "0x1234";
+ * const entityId: number = 1234;
+ * const hookType: HookType = HookType.Validation;
+ * const hasPostHooks: boolean = false;
+ * const hasPreHooks: boolean = true;
+ *
+ * const hookConfigHex = serializeHookConfig({
+ *  moduleAddress,
+ *  entityId
+ *  hookType,
+ *  hasPostHooks,
+ *  hasPreHooks
+ * });
+ * ```
+ *
+ * @param {HookConfig} config The hook configuration containing address, entity ID, hook type, and post/pre hook indicators
+ * @returns {Hex} The serialized hook configuration in hexadecimal format
+ */
+export function serializeHookConfig(config) {
+    const hookTypeBit = config.hookType === HookType.VALIDATION ? 1 : 0;
+    const hasPostHooksBit = config.hasPostHooks ? 2 : 0;
+    const hasPreHooksBit = config.hasPreHooks ? 4 : 0;
+    return concatHex([
+        config.address,
+        toHex(config.entityId, { size: 4 }),
+        toHex(hookTypeBit + hasPostHooksBit + hasPreHooksBit, {
+            size: 1,
+        }),
+    ]);
+}
+/**
+ * Serializes a module entity into a hexadecimal format by concatenating the module address and entity ID.
+ *
+ * @example
+ * ```ts
+ * import { serializeModuleEntity } from "@account-kit/smart-contracts";
+ * import { Address } from "viem";
+ *
+ * const moduleAddress: Address = "0x1234";
+ * const entityId: number = 1234;
+ *
+ * const moduleEntityHex = serializeModuleEntity({
+ *  moduleAddress,
+ *  entityId
+ * });
+ * ```
+ *
+ * @param {ModuleEntity} config The module entity configuration containing the module address and entity ID
+ * @returns {Hex} A hexadecimal string representation of the serialized module entity
+ */
+export function serializeModuleEntity(config) {
+    return concatHex([config.moduleAddress, toHex(config.entityId, { size: 4 })]);
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/src/ma-v2/actions/common/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../../src/ma-v2/actions/common/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAwB;IAChE,MAAM,qBAAqB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,MAAM,wBAAwB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,OAAO,SAAS,CAAC;QACf,qBAAqB,CAAC,MAAM,CAAC;QAC7B,KAAK,CAAC,qBAAqB,GAAG,wBAAwB,GAAG,WAAW,EAAE;YACpE,IAAI,EAAE,CAAC;SACR,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAkB;IACpD,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,eAAe,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,MAAM,cAAc,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO,SAAS,CAAC;QACf,MAAM,CAAC,OAAO;QACd,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,WAAW,GAAG,eAAe,GAAG,cAAc,EAAE;YACpD,IAAI,EAAE,CAAC;SACR,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AAChF,CAAC","sourcesContent":["import { type Hex, toHex, concatHex } from \"viem\";\nimport type { ValidationConfig, HookConfig, ModuleEntity } from \"./types\";\nimport { HookType } from \"./types.js\";\n\n/**\n * Serializes a validation configuration into a hexadecimal string representation. This involves converting boolean flags into bitwise representation and combining them with serialized module entity data.\n *\n * @example\n * ```ts\n * import { serializeValidationConfig } from \"@account-kit/smart-contracts\";\n * import { Address } from \"viem\";\n *\n * const moduleAddress: Address = \"0x1234\";\n * const entityId: number = 1234;\n * const isGlobal: boolean = true;\n * const isSignatureValidation: boolean = false;\n * const isUserOpValidation: boolean = true;\n *\n * const validationConfigHex = serializeValidationConfig({\n *  moduleAddress,\n *  entityId\n *  isGlobal,\n *  isSignatureValidation,\n *  isUserOpValidation\n * });\n * ```\n * @param {ValidationConfig} config The validation configuration object containing details to serialize\n * @returns {Hex} A hexadecimal string representing the serialized configuration\n */\nexport function serializeValidationConfig(config: ValidationConfig): Hex {\n  const isUserOpValidationBit = config.isUserOpValidation ? 1 : 0;\n  const isSignatureValidationBit = config.isSignatureValidation ? 2 : 0;\n  const isGlobalBit = config.isGlobal ? 4 : 0;\n  return concatHex([\n    serializeModuleEntity(config),\n    toHex(isUserOpValidationBit + isSignatureValidationBit + isGlobalBit, {\n      size: 1,\n    }),\n  ]);\n}\n\n/**\n * Serializes a `HookConfig` object into a `Hex` format by encoding the hook type, presence of post/pre hooks, address, and entity ID.\n *\n * @example\n * ```ts\n * import { type HookType, serializeHookConfig } from \"@account-kit/smart-contracts\";\n * import { Address } from \"viem\";\n *\n * const moduleAddress: Address = \"0x1234\";\n * const entityId: number = 1234;\n * const hookType: HookType = HookType.Validation;\n * const hasPostHooks: boolean = false;\n * const hasPreHooks: boolean = true;\n *\n * const hookConfigHex = serializeHookConfig({\n *  moduleAddress,\n *  entityId\n *  hookType,\n *  hasPostHooks,\n *  hasPreHooks\n * });\n * ```\n *\n * @param {HookConfig} config The hook configuration containing address, entity ID, hook type, and post/pre hook indicators\n * @returns {Hex} The serialized hook configuration in hexadecimal format\n */\nexport function serializeHookConfig(config: HookConfig): Hex {\n  const hookTypeBit = config.hookType === HookType.VALIDATION ? 1 : 0;\n  const hasPostHooksBit = config.hasPostHooks ? 2 : 0;\n  const hasPreHooksBit = config.hasPreHooks ? 4 : 0;\n  return concatHex([\n    config.address,\n    toHex(config.entityId, { size: 4 }),\n    toHex(hookTypeBit + hasPostHooksBit + hasPreHooksBit, {\n      size: 1,\n    }),\n  ]);\n}\n\n/**\n * Serializes a module entity into a hexadecimal format by concatenating the module address and entity ID.\n *\n * @example\n * ```ts\n * import { serializeModuleEntity } from \"@account-kit/smart-contracts\";\n * import { Address } from \"viem\";\n *\n * const moduleAddress: Address = \"0x1234\";\n * const entityId: number = 1234;\n *\n * const moduleEntityHex = serializeModuleEntity({\n *  moduleAddress,\n *  entityId\n * });\n * ```\n *\n * @param {ModuleEntity} config The module entity configuration containing the module address and entity ID\n * @returns {Hex} A hexadecimal string representation of the serialized module entity\n */\nexport function serializeModuleEntity(config: ModuleEntity): Hex {\n  return concatHex([config.moduleAddress, toHex(config.entityId, { size: 4 })]);\n}\n"]}

package/dist/esm/src/ma-v2/actions/install-validation/installValidation.d.ts

@@ -0,0 +1,71 @@
+import { type GetEntryPointFromAccount, type SendUserOperationResult, type UserOperationOverridesParameter, type SmartAccountSigner } from "@aa-sdk/core";
+import { type Address, type Hex } from "viem";
+import type { HookConfig, ValidationConfig } from "../common/types.js";
+import { type SMAV2AccountClient } from "../../client/client.js";
+import { type MAV2Account } from "../../account/semiModularAccountV2.js";
+export type InstallValidationParams<TSigner extends SmartAccountSigner = SmartAccountSigner> = {
+    validationConfig: ValidationConfig;
+    selectors: Hex[];
+    installData: Hex;
+    hooks: {
+        hookConfig: HookConfig;
+        initData: Hex;
+    }[];
+    account?: MAV2Account<TSigner> | undefined;
+} & UserOperationOverridesParameter<GetEntryPointFromAccount<MAV2Account<TSigner>>>;
+export type UninstallValidationParams<TSigner extends SmartAccountSigner = SmartAccountSigner> = {
+    moduleAddress: Address;
+    entityId: number;
+    uninstallData: Hex;
+    hookUninstallDatas: Hex[];
+    account?: MAV2Account<TSigner> | undefined;
+} & UserOperationOverridesParameter<GetEntryPointFromAccount<MAV2Account<TSigner>>>;
+export type InstallValidationActions<TSigner extends SmartAccountSigner = SmartAccountSigner> = {
+    installValidation: (args: InstallValidationParams<TSigner>) => Promise<SendUserOperationResult>;
+    uninstallValidation: (args: UninstallValidationParams<TSigner>) => Promise<SendUserOperationResult>;
+};
+/**
+ * Provides validation installation and uninstallation functionalities for a MA v2 client, ensuring compatibility with `SmartAccountClient`.
+ *
+ * @example
+ * ```ts
+ * import { createSMAV2AccountClient, installValidationActions, getDefaultSingleSignerValidationModuleAddress, SingleSignerValidationModule } from "@account-kit/smart-contracts";
+ * import { Address } from "viem";
+ *
+ * const client = (await createSMAV2AccountClient({ ... })).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 const installValidationActions: <TSigner extends SmartAccountSigner = SmartAccountSigner>(client: SMAV2AccountClient<TSigner>) => InstallValidationActions<TSigner>;

package/dist/esm/src/ma-v2/actions/install-validation/installValidation.js

@@ -0,0 +1,109 @@
+import { AccountNotFoundError, IncompatibleClientError, isSmartAccountClient, EntityIdOverrideError, } from "@aa-sdk/core";
+import { encodeFunctionData, concatHex, zeroAddress, } from "viem";
+import { semiModularAccountBytecodeAbi } from "../../abis/semiModularAccountBytecodeAbi.js";
+import { serializeValidationConfig, serializeHookConfig, serializeModuleEntity, } from "../common/utils.js";
+import {} from "../../client/client.js";
+import {} from "../../account/semiModularAccountV2.js";
+import { DEFAULT_OWNER_ENTITY_ID } from "../../utils.js";
+/**
+ * Provides validation installation and uninstallation functionalities for a MA v2 client, ensuring compatibility with `SmartAccountClient`.
+ *
+ * @example
+ * ```ts
+ * import { createSMAV2AccountClient, installValidationActions, getDefaultSingleSignerValidationModuleAddress, SingleSignerValidationModule } from "@account-kit/smart-contracts";
+ * import { Address } from "viem";
+ *
+ * const client = (await createSMAV2AccountClient({ ... })).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 const installValidationActions = (client) => ({
+    installValidation: async ({ validationConfig, selectors, installData, hooks, account = client.account, overrides, }) => {
+        if (!account) {
+            throw new AccountNotFoundError();
+        }
+        if (!isSmartAccountClient(client)) {
+            throw new IncompatibleClientError("SmartAccountClient", "installValidation", client);
+        }
+        // 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();
+        }
+        const { encodeCallData } = account;
+        const callData = await encodeCallData(encodeFunctionData({
+            abi: semiModularAccountBytecodeAbi,
+            functionName: "installValidation",
+            args: [
+                serializeValidationConfig(validationConfig),
+                selectors,
+                installData,
+                hooks.map((hook) => concatHex([serializeHookConfig(hook.hookConfig), hook.initData])),
+            ],
+        }));
+        return client.sendUserOperation({
+            uo: callData,
+            account,
+            overrides,
+        });
+    },
+    uninstallValidation: async ({ moduleAddress, entityId, uninstallData, hookUninstallDatas, account = client.account, overrides, }) => {
+        if (!account) {
+            throw new AccountNotFoundError();
+        }
+        if (!isSmartAccountClient(client)) {
+            throw new IncompatibleClientError("SmartAccountClient", "uninstallValidation", client);
+        }
+        const { encodeCallData } = account;
+        const callData = await encodeCallData(encodeFunctionData({
+            abi: semiModularAccountBytecodeAbi,
+            functionName: "uninstallValidation",
+            args: [
+                serializeModuleEntity({
+                    moduleAddress,
+                    entityId,
+                }),
+                uninstallData,
+                hookUninstallDatas,
+            ],
+        }));
+        return client.sendUserOperation({
+            uo: callData,
+            account,
+            overrides,
+        });
+    },
+});
+//# sourceMappingURL=installValidation.js.map

package/dist/esm/src/ma-v2/actions/install-validation/installValidation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installValidation.js","sourceRoot":"","sources":["../../../../../../src/ma-v2/actions/install-validation/installValidation.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  AccountNotFoundError,\n  IncompatibleClientError,\n  isSmartAccountClient,\n  EntityIdOverrideError,\n  type GetEntryPointFromAccount,\n  type SendUserOperationResult,\n  type UserOperationOverridesParameter,\n  type SmartAccountSigner,\n} from \"@aa-sdk/core\";\nimport {\n  type Address,\n  type Hex,\n  encodeFunctionData,\n  concatHex,\n  zeroAddress,\n} from \"viem\";\n\nimport { semiModularAccountBytecodeAbi } from \"../../abis/semiModularAccountBytecodeAbi.js\";\nimport type { HookConfig, ValidationConfig } from \"../common/types.js\";\nimport {\n  serializeValidationConfig,\n  serializeHookConfig,\n  serializeModuleEntity,\n} from \"../common/utils.js\";\n\nimport { type SMAV2AccountClient } from \"../../client/client.js\";\nimport { type MAV2Account } from \"../../account/semiModularAccountV2.js\";\nimport { DEFAULT_OWNER_ENTITY_ID } from \"../../utils.js\";\n\nexport type InstallValidationParams<\n  TSigner extends SmartAccountSigner = SmartAccountSigner\n> = {\n  validationConfig: ValidationConfig;\n  selectors: Hex[];\n  installData: Hex;\n  hooks: {\n    hookConfig: HookConfig;\n    initData: Hex;\n  }[];\n  account?: MAV2Account<TSigner> | undefined;\n} & UserOperationOverridesParameter<\n  GetEntryPointFromAccount<MAV2Account<TSigner>>\n>;\n\nexport type UninstallValidationParams<\n  TSigner extends SmartAccountSigner = SmartAccountSigner\n> = {\n  moduleAddress: Address;\n  entityId: number;\n  uninstallData: Hex;\n  hookUninstallDatas: Hex[];\n  account?: MAV2Account<TSigner> | undefined;\n} & UserOperationOverridesParameter<\n  GetEntryPointFromAccount<MAV2Account<TSigner>>\n>;\n\nexport type InstallValidationActions<\n  TSigner extends SmartAccountSigner = SmartAccountSigner\n> = {\n  installValidation: (\n    args: InstallValidationParams<TSigner>\n  ) => Promise<SendUserOperationResult>;\n  uninstallValidation: (\n    args: UninstallValidationParams<TSigner>\n  ) => Promise<SendUserOperationResult>;\n};\n\n/**\n * Provides validation installation and uninstallation functionalities for a MA v2 client, ensuring compatibility with `SmartAccountClient`.\n *\n * @example\n * ```ts\n * import { createSMAV2AccountClient, installValidationActions, getDefaultSingleSignerValidationModuleAddress, SingleSignerValidationModule } from \"@account-kit/smart-contracts\";\n * import { Address } from \"viem\";\n *\n * const client = (await createSMAV2AccountClient({ ... })).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 const installValidationActions: <\n  TSigner extends SmartAccountSigner = SmartAccountSigner\n>(\n  client: SMAV2AccountClient<TSigner>\n) => InstallValidationActions<TSigner> = (client) => ({\n  installValidation: async ({\n    validationConfig,\n    selectors,\n    installData,\n    hooks,\n    account = client.account,\n    overrides,\n  }) => {\n    if (!account) {\n      throw new AccountNotFoundError();\n    }\n\n    if (!isSmartAccountClient(client)) {\n      throw new IncompatibleClientError(\n        \"SmartAccountClient\",\n        \"installValidation\",\n        client\n      );\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    const { encodeCallData } = account;\n\n    const callData = await 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    return client.sendUserOperation({\n      uo: callData,\n      account,\n      overrides,\n    });\n  },\n\n  uninstallValidation: async ({\n    moduleAddress,\n    entityId,\n    uninstallData,\n    hookUninstallDatas,\n    account = client.account,\n    overrides,\n  }) => {\n    if (!account) {\n      throw new AccountNotFoundError();\n    }\n\n    if (!isSmartAccountClient(client)) {\n      throw new IncompatibleClientError(\n        \"SmartAccountClient\",\n        \"uninstallValidation\",\n        client\n      );\n    }\n\n    const { encodeCallData } = account;\n\n    const callData = await 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    return client.sendUserOperation({\n      uo: callData,\n      account,\n      overrides,\n    });\n  },\n});\n"]}

package/dist/esm/src/ma-v2/client/client.d.ts

@@ -0,0 +1,6 @@
+import { type SmartAccountClient, type SmartAccountSigner, type SmartAccountClientConfig } from "@aa-sdk/core";
+import { type Chain, type Transport } from "viem";
+import { type CreateSMAV2AccountParams, type MAV2Account } from "../account/semiModularAccountV2.js";
+export type SMAV2AccountClient<TSigner extends SmartAccountSigner = SmartAccountSigner> = SmartAccountClient<Transport, Chain, MAV2Account<TSigner>>;
+export type CreateSMAV2AccountClientParams<TTransport extends Transport = Transport, TChain extends Chain = Chain, TSigner extends SmartAccountSigner = SmartAccountSigner> = CreateSMAV2AccountParams<TTransport, TSigner> & Omit<SmartAccountClientConfig<TTransport, TChain>, "transport" | "account" | "chain">;
+export declare function createSMAV2AccountClient<TChain extends Chain = Chain, TSigner extends SmartAccountSigner = SmartAccountSigner>(args: CreateSMAV2AccountClientParams<Transport, TChain, TSigner>): Promise<SMAV2AccountClient<TSigner>>;

package/dist/esm/src/ma-v2/client/client.js

@@ -0,0 +1,40 @@
+import { createSmartAccountClient, } from "@aa-sdk/core";
+import {} from "viem";
+import { createSMAV2Account, } from "../account/semiModularAccountV2.js";
+/**
+ * Creates a SMAv2 account client using the provided configuration parameters.
+ *
+ * @example
+ * ```ts
+ * import { http } from "viem";
+ * import { createSMAV2AccountClient } from "@account-kit/smart-contracts";
+ * import { LocalAccountSigner } from "@aa-sdk/core";
+ * import { sepolia } from "@account-kit/infra";
+ *
+ * const MNEMONIC = "...";
+ * const RPC_URL = "...";
+ *
+ * const signer = LocalAccountSigner.mnemonicToAccountSigner(MNEMONIC);
+ *
+ * const chain = sepolia;
+ *
+ * const transport = http(RPC_URL);
+ *
+ * const SMAV2SignerAccountClient = await createSMAV2AccountClient({
+ *  chain,
+ *  signer,
+ *  transport,
+ * });
+ * ```
+ *
+ * @param {CreateSMAV2AccountClientParams} config The configuration parameters required to create the MAv2 account client
+ * @returns {Promise<SmartAccountClient>} A promise that resolves to a `SmartAccountClient` instance
+ */
+export async function createSMAV2AccountClient(config) {
+    const smaV2Account = await createSMAV2Account(config);
+    return createSmartAccountClient({
+        ...config,
+        account: smaV2Account,
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/src/ma-v2/client/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../../src/ma-v2/client/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,GAIzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAA8B,MAAM,MAAM,CAAC;AAElD,OAAO,EACL,kBAAkB,GAGnB,MAAM,oCAAoC,CAAC;AAuB5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAsC;IAEtC,MAAM,YAAY,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAEtD,OAAO,wBAAwB,CAAC;QAC9B,GAAG,MAAM;QACT,OAAO,EAAE,YAAY;KACtB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n  createSmartAccountClient,\n  type SmartAccountClient,\n  type SmartAccountSigner,\n  type SmartAccountClientConfig,\n} from \"@aa-sdk/core\";\nimport { type Chain, type Transport } from \"viem\";\n\nimport {\n  createSMAV2Account,\n  type CreateSMAV2AccountParams,\n  type MAV2Account,\n} from \"../account/semiModularAccountV2.js\";\n\nexport type SMAV2AccountClient<\n  TSigner extends SmartAccountSigner = SmartAccountSigner\n> = SmartAccountClient<Transport, Chain, MAV2Account<TSigner>>;\n\nexport type CreateSMAV2AccountClientParams<\n  TTransport extends Transport = Transport,\n  TChain extends Chain = Chain,\n  TSigner extends SmartAccountSigner = SmartAccountSigner\n> = CreateSMAV2AccountParams<TTransport, TSigner> &\n  Omit<\n    SmartAccountClientConfig<TTransport, TChain>,\n    \"transport\" | \"account\" | \"chain\"\n  >;\n\nexport function createSMAV2AccountClient<\n  TChain extends Chain = Chain,\n  TSigner extends SmartAccountSigner = SmartAccountSigner\n>(\n  args: CreateSMAV2AccountClientParams<Transport, TChain, TSigner>\n): Promise<SMAV2AccountClient<TSigner>>;\n\n/**\n * Creates a SMAv2 account client using the provided configuration parameters.\n *\n * @example\n * ```ts\n * import { http } from \"viem\";\n * import { createSMAV2AccountClient } from \"@account-kit/smart-contracts\";\n * import { LocalAccountSigner } from \"@aa-sdk/core\";\n * import { sepolia } from \"@account-kit/infra\";\n *\n * const MNEMONIC = \"...\";\n * const RPC_URL = \"...\";\n *\n * const signer = LocalAccountSigner.mnemonicToAccountSigner(MNEMONIC);\n *\n * const chain = sepolia;\n *\n * const transport = http(RPC_URL);\n *\n * const SMAV2SignerAccountClient = await createSMAV2AccountClient({\n *  chain,\n *  signer,\n *  transport,\n * });\n * ```\n *\n * @param {CreateSMAV2AccountClientParams} config The configuration parameters required to create the MAv2 account client\n * @returns {Promise<SmartAccountClient>} A promise that resolves to a `SmartAccountClient` instance\n */\nexport async function createSMAV2AccountClient(\n  config: CreateSMAV2AccountClientParams\n): Promise<SmartAccountClient> {\n  const smaV2Account = await createSMAV2Account(config);\n\n  return createSmartAccountClient({\n    ...config,\n    account: smaV2Account,\n  });\n}\n"]}

package/dist/esm/src/ma-v2/index.d.ts

@@ -0,0 +1,26 @@
+export { accountFactoryAbi } from "./abis/accountFactoryAbi.js";
+export { modularAccountAbi } from "./abis/modularAccountAbi.js";
+export { semiModularAccountBytecodeAbi } from "./abis/semiModularAccountBytecodeAbi.js";
+export { semiModularAccountStorageAbi } from "./abis/semiModularAccountStorageAbi.js";
+export { nativeSMASigner } from "./account/nativeSMASigner.js";
+export type * from "./account/semiModularAccountV2.js";
+export { createSMAV2Account } from "./account/semiModularAccountV2.js";
+export type { ModuleEntity, ValidationConfig, HookConfig, ValidationData, } from "./actions/common/types.js";
+export { HookType } from "./actions/common/types.js";
+export { serializeValidationConfig, serializeHookConfig, serializeModuleEntity, } from "./actions/common/utils.js";
+export type * from "./actions/install-validation/installValidation.js";
+export { installValidationActions } from "./actions/install-validation/installValidation.js";
+export type * from "./client/client.js";
+export { createSMAV2AccountClient } from "./client/client.js";
+export { getDefaultAllowlistModuleAddress, getDefaultNativeTokenLimitModuleAddress, getDefaultPaymasterGuardModuleAddress, getDefaultSingleSignerValidationModuleAddress, getDefaultTimeRangeModuleAddress, getDefaultWebauthnValidationModuleAddress, } from "./modules/utils.js";
+export { allowlistModuleAbi } from "./modules/allowlist-module/abis/allowlistModuleAbi.js";
+export { AllowlistModule } from "./modules/allowlist-module/module.js";
+export { nativeTokenLimitModuleAbi } from "./modules/native-token-limit-module/abis/nativeTokenLimitModuleAbi.js";
+export { NativeTokenLimitModule } from "./modules/native-token-limit-module/module.js";
+export { paymasterGuardModuleAbi } from "./modules/paymaster-guard-module/abis/paymasterGuardModuleAbi.js";
+export { PaymasterGuardModule } from "./modules/paymaster-guard-module/module.js";
+export { singleSignerValidationModuleAbi } from "./modules/single-signer-validation/abis/singleSignerValidationModuleAbi.js";
+export { SingleSignerValidationModule } from "./modules/single-signer-validation/module.js";
+export { timeRangeModuleAbi } from "./modules/time-range-module/abis/timeRangeModuleAbi.js";
+export { TimeRangeModule } from "./modules/time-range-module/module.js";
+export { webauthnValidationModuleAbi } from "./modules/webauthn-validation/abis/webauthnValidationAbi.js";

package/dist/esm/src/ma-v2/index.js

@@ -0,0 +1,24 @@
+// ma v2 exports
+export { accountFactoryAbi } from "./abis/accountFactoryAbi.js";
+export { modularAccountAbi } from "./abis/modularAccountAbi.js";
+export { semiModularAccountBytecodeAbi } from "./abis/semiModularAccountBytecodeAbi.js";
+export { semiModularAccountStorageAbi } from "./abis/semiModularAccountStorageAbi.js";
+export { nativeSMASigner } from "./account/nativeSMASigner.js";
+export { createSMAV2Account } from "./account/semiModularAccountV2.js";
+export { HookType } from "./actions/common/types.js";
+export { serializeValidationConfig, serializeHookConfig, serializeModuleEntity, } from "./actions/common/utils.js";
+export { installValidationActions } from "./actions/install-validation/installValidation.js";
+export { createSMAV2AccountClient } from "./client/client.js";
+export { getDefaultAllowlistModuleAddress, getDefaultNativeTokenLimitModuleAddress, getDefaultPaymasterGuardModuleAddress, getDefaultSingleSignerValidationModuleAddress, getDefaultTimeRangeModuleAddress, getDefaultWebauthnValidationModuleAddress, } from "./modules/utils.js";
+export { allowlistModuleAbi } from "./modules/allowlist-module/abis/allowlistModuleAbi.js";
+export { AllowlistModule } from "./modules/allowlist-module/module.js";
+export { nativeTokenLimitModuleAbi } from "./modules/native-token-limit-module/abis/nativeTokenLimitModuleAbi.js";
+export { NativeTokenLimitModule } from "./modules/native-token-limit-module/module.js";
+export { paymasterGuardModuleAbi } from "./modules/paymaster-guard-module/abis/paymasterGuardModuleAbi.js";
+export { PaymasterGuardModule } from "./modules/paymaster-guard-module/module.js";
+export { singleSignerValidationModuleAbi } from "./modules/single-signer-validation/abis/singleSignerValidationModuleAbi.js";
+export { SingleSignerValidationModule } from "./modules/single-signer-validation/module.js";
+export { timeRangeModuleAbi } from "./modules/time-range-module/abis/timeRangeModuleAbi.js";
+export { TimeRangeModule } from "./modules/time-range-module/module.js";
+export { webauthnValidationModuleAbi } from "./modules/webauthn-validation/abis/webauthnValidationAbi.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/src/ma-v2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ma-v2/index.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,yCAAyC,CAAC;AACxF,OAAO,EAAE,4BAA4B,EAAE,MAAM,wCAAwC,CAAC;AAEtF,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAQvE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,wBAAwB,EAAE,MAAM,mDAAmD,CAAC;AAG7F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EACL,gCAAgC,EAChC,uCAAuC,EACvC,qCAAqC,EACrC,6CAA6C,EAC7C,gCAAgC,EAChC,yCAAyC,GAC1C,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,uDAAuD,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uEAAuE,CAAC;AAClH,OAAO,EAAE,sBAAsB,EAAE,MAAM,+CAA+C,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,kEAAkE,CAAC;AAC3G,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAClF,OAAO,EAAE,+BAA+B,EAAE,MAAM,4EAA4E,CAAC;AAC7H,OAAO,EAAE,4BAA4B,EAAE,MAAM,8CAA8C,CAAC;AAC5F,OAAO,EAAE,kBAAkB,EAAE,MAAM,wDAAwD,CAAC;AAC5F,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6DAA6D,CAAC","sourcesContent":["// ma v2 exports\nexport { accountFactoryAbi } from \"./abis/accountFactoryAbi.js\";\nexport { modularAccountAbi } from \"./abis/modularAccountAbi.js\";\nexport { semiModularAccountBytecodeAbi } from \"./abis/semiModularAccountBytecodeAbi.js\";\nexport { semiModularAccountStorageAbi } from \"./abis/semiModularAccountStorageAbi.js\";\n\nexport { nativeSMASigner } from \"./account/nativeSMASigner.js\";\nexport type * from \"./account/semiModularAccountV2.js\";\nexport { createSMAV2Account } from \"./account/semiModularAccountV2.js\";\n\nexport type {\n  ModuleEntity,\n  ValidationConfig,\n  HookConfig,\n  ValidationData,\n} from \"./actions/common/types.js\";\nexport { HookType } from \"./actions/common/types.js\";\nexport {\n  serializeValidationConfig,\n  serializeHookConfig,\n  serializeModuleEntity,\n} from \"./actions/common/utils.js\";\nexport type * from \"./actions/install-validation/installValidation.js\";\nexport { installValidationActions } from \"./actions/install-validation/installValidation.js\";\n\nexport type * from \"./client/client.js\";\nexport { createSMAV2AccountClient } from \"./client/client.js\";\n\nexport {\n  getDefaultAllowlistModuleAddress,\n  getDefaultNativeTokenLimitModuleAddress,\n  getDefaultPaymasterGuardModuleAddress,\n  getDefaultSingleSignerValidationModuleAddress,\n  getDefaultTimeRangeModuleAddress,\n  getDefaultWebauthnValidationModuleAddress,\n} from \"./modules/utils.js\";\nexport { allowlistModuleAbi } from \"./modules/allowlist-module/abis/allowlistModuleAbi.js\";\nexport { AllowlistModule } from \"./modules/allowlist-module/module.js\";\nexport { nativeTokenLimitModuleAbi } from \"./modules/native-token-limit-module/abis/nativeTokenLimitModuleAbi.js\";\nexport { NativeTokenLimitModule } from \"./modules/native-token-limit-module/module.js\";\nexport { paymasterGuardModuleAbi } from \"./modules/paymaster-guard-module/abis/paymasterGuardModuleAbi.js\";\nexport { PaymasterGuardModule } from \"./modules/paymaster-guard-module/module.js\";\nexport { singleSignerValidationModuleAbi } from \"./modules/single-signer-validation/abis/singleSignerValidationModuleAbi.js\";\nexport { SingleSignerValidationModule } from \"./modules/single-signer-validation/module.js\";\nexport { timeRangeModuleAbi } from \"./modules/time-range-module/abis/timeRangeModuleAbi.js\";\nexport { TimeRangeModule } from \"./modules/time-range-module/module.js\";\nexport { webauthnValidationModuleAbi } from \"./modules/webauthn-validation/abis/webauthnValidationAbi.js\";\n"]}