@account-kit/smart-contracts 4.23.1 → 4.24.0

package/dist/types/src/ma-v2/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/ma-v2/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,GAAG,EACR,KAAK,KAAK,EACV,KAAK,OAAO,EACZ,KAAK,SAAS,EACf,MAAM,MAAM,CAAC;AAcd,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAEjF,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,8BAA8B,EACnC,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,MAAM,MAAM,qBAAqB,GAAG;IAElC,mBAAmB,EAAE,GAAG,CAAC;CAC1B,CAAC;AAGF,MAAM,MAAM,uBAAuB,GAAG;IACpC,mBAAmB,EAAE,GAAG,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAGF,eAAO,MAAM,eAAe,6BAGzB,qBAAqB,KAAG,GAE1B,CAAC;AAGF,eAAO,MAAM,iBAAiB,uCAG3B,uBAAuB,KAAG,GAQ5B,CAAC;AAEF,eAAO,MAAM,4BAA4B,UAAW,KAAK,KAAG,OAgB3D,CAAC;AAEF,eAAO,MAAM,8BAA8B,UAAW,KAAK,KAAG,OAgB7D,CAAC;AAEF,eAAO,MAAM,6BAA6B,UAAW,KAAK,KAAG,OAgB5D,CAAC;AAEF,eAAO,MAAM,0BAA0B,UAAW,KAAK,KAAG,OAgBzD,CAAC;AAEF,eAAO,MAAM,qBAAqB,UAAW,KAAK,KAAG,OAgBpD,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAC9B,OAAO,SAAS,kBAAkB,GAAG,kBAAkB,EACvD,QAAQ,SACJ,8BAA8B,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/C,SAAS,GAAG,8BAA8B,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,IACzE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAElC;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,SAAS,SAAS,GAAG,SAAS,EACxC,MAAM,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,EACpD,OAAO,SAAS,kBAAkB,GAAG,kBAAkB,EACvD,QAAQ,SACJ,8BAA8B,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/C,SAAS,GAAG,8BAA8B,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAE3E,MAAM,EAAE,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EACxD,IAAI,EAAE,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,GAC5C,OAAO,CACR,aAAa,GAAG;IACd,kCAAkC,EAAE,MAAM,OAAO,CAC/C,gBAAgB,CAAC,OAAO,CAAC,CAC1B,CAAC;CACH,CACF,CA8BA;AAED,eAAO,MAAM,8BAA8B,y+EAC67E,CAAC;AAEz+E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,iBAAiB,kEAK3B,gBAAgB,KAAG,MAOrB,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/ma-v2/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,GAAG,EACR,KAAK,KAAK,EACV,KAAK,OAAO,EACZ,KAAK,SAAS,EAEf,MAAM,MAAM,CAAC;AAcd,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAEjF,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,8BAA8B,EACnC,KAAK,aAAa,EACnB,MAAM,cAAc,CAAC;AAEtB,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,MAAM,MAAM,qBAAqB,GAAG;IAElC,mBAAmB,EAAE,GAAG,CAAC;CAC1B,CAAC;AAGF,MAAM,MAAM,uBAAuB,GAAG;IACpC,mBAAmB,EAAE,GAAG,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAGF,eAAO,MAAM,eAAe,6BAGzB,qBAAqB,KAAG,GAE1B,CAAC;AAGF,eAAO,MAAM,iBAAiB,uCAG3B,uBAAuB,KAAG,GAQ5B,CAAC;AAEF,eAAO,MAAM,4BAA4B,UAAW,KAAK,KAAG,OAgB3D,CAAC;AAEF,eAAO,MAAM,8BAA8B,UAAW,KAAK,KAAG,OAgB7D,CAAC;AAEF,eAAO,MAAM,6BAA6B,UAAW,KAAK,KAAG,OAgB5D,CAAC;AAEF,eAAO,MAAM,0BAA0B,UAAW,KAAK,KAAG,OAgBzD,CAAC;AAEF,eAAO,MAAM,qBAAqB,UAAW,KAAK,KAAG,OAgBpD,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAC9B,OAAO,SAAS,kBAAkB,GAAG,kBAAkB,EACvD,QAAQ,SACJ,8BAA8B,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/C,SAAS,GAAG,8BAA8B,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,IACzE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAElC;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,SAAS,SAAS,GAAG,SAAS,EACxC,MAAM,SAAS,KAAK,GAAG,SAAS,GAAG,KAAK,GAAG,SAAS,EACpD,OAAO,SAAS,kBAAkB,GAAG,kBAAkB,EACvD,QAAQ,SACJ,8BAA8B,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/C,SAAS,GAAG,8BAA8B,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAE3E,MAAM,EAAE,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EACxD,IAAI,EAAE,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,GAC5C,OAAO,CACR,aAAa,GAAG;IACd,kCAAkC,EAAE,MAAM,OAAO,CAC/C,gBAAgB,CAAC,OAAO,CAAC,CAC1B,CAAC;CACH,CACF,CA8BA;AAED,eAAO,MAAM,8BAA8B,y+EAC67E,CAAC;AAEz+E,eAAO,MAAM,qBAAqB,6hJAC0/I,CAAC;AAE7hJ,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAI3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,iBAAiB,kEAK3B,gBAAgB,KAAG,MAOrB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@account-kit/smart-contracts",
-  "version": "4.23.1",
+  "version": "4.24.0",
   "description": "aa-sdk compatible interfaces for Alchemy Smart Accounts",
   "author": "Alchemy",
   "license": "MIT",
@@ -47,12 +47,13 @@
     "build:esm": "tsc --project tsconfig.build.json --outDir ./dist/esm",
     "build:types": "tsc --project tsconfig.build.json --declarationDir ./dist/types --emitDeclarationOnly --declaration --declarationMap",
     "docs:gen": "node ../../doc-gen/dist/esm/cli.js generate --in ./src/index.ts --out ../../site/pages/reference/account-kit/smart-contracts",
+    "fern:gen": "node ../../doc-gen/dist/esm/cli.js generate --in ./src/index.ts --out ../../docs/pages/reference/account-kit/smart-contracts --fern",
     "clean": "rm -rf ./dist",
     "test": "vitest",
     "test:run": "vitest run"
   },
   "devDependencies": {
-    "@account-kit/plugingen": "^4.23.1",
+    "@account-kit/plugingen": "^4.24.0",
     "change-case": "^5.1.2",
     "dedent": "^1.5.1",
     "dotenv": "^16.3.1",
@@ -72,10 +73,10 @@
     "url": "https://github.com/alchemyplatform/aa-sdk/issues"
   },
   "homepage": "https://github.com/alchemyplatform/aa-sdk#readme",
-  "gitHead": "e35c609723a3d4aae8fd1ebedfdad5ce6db432ff",
+  "gitHead": "2038e3681098bb5e8c2e871c7d64ee1169216706",
   "dependencies": {
-    "@aa-sdk/core": "^4.23.1",
-    "@account-kit/infra": "^4.23.1"
+    "@aa-sdk/core": "^4.24.0",
+    "@account-kit/infra": "^4.24.0"
   },
   "peerDependencies": {
     "viem": "^2.22.6"

package/src/ma-v2/account/common/modularAccountV2Base.ts

@@ -3,6 +3,8 @@ import {
   getEntryPoint,
   InvalidEntityIdError,
   InvalidNonceKeyError,
+  InvalidDeferredActionNonce,
+  InvalidDeferredActionMode,
   toSmartContractAccount,
   type AccountOp,
   type SmartAccountSigner,
@@ -85,6 +87,7 @@ export type CreateMAV2BaseParams<
   signer: TSigner;
   signerEntity?: SignerEntity;
   accountAddress: Address;
+  deferredAction?: Hex;
 };
 
 export type CreateMAV2BaseReturnType<
@@ -108,6 +111,7 @@ export async function createMAv2Base<
       entityId = DEFAULT_OWNER_ENTITY_ID,
     } = {},
     accountAddress,
+    deferredAction,
     ...remainingToSmartContractAccountParams
   } = config;
 
@@ -120,6 +124,39 @@ export async function createMAv2Base<
     chain,
   });
 
+  const entryPointContract = getContract({
+    address: entryPoint.address,
+    abi: entryPoint.abi,
+    client,
+  });
+
+  let useDeferredAction: boolean = false;
+  let nonce: bigint = 0n;
+  let deferredActionData: Hex = "0x";
+  let hasAssociatedExecHooks: boolean = false;
+
+  if (deferredAction) {
+    if (deferredAction.slice(2, 4) !== "00") {
+      throw new InvalidDeferredActionMode();
+    }
+    // Set these values if the deferred action has not been consumed. We check this with the EP
+    const nextNonceForDeferredAction: bigint =
+      (await entryPointContract.read.getNonce([
+        accountAddress,
+        nonce >> 64n,
+      ])) as bigint;
+
+    // we only add the deferred action in if the nonce has not been consumed
+    if (nonce === nextNonceForDeferredAction) {
+      nonce = BigInt(`0x${deferredAction.slice(6, 70)}`);
+      useDeferredAction = true;
+      deferredActionData = `0x${deferredAction.slice(70)}`;
+      hasAssociatedExecHooks = deferredAction[5] === "1";
+    } else if (nonce > nextNonceForDeferredAction) {
+      throw new InvalidDeferredActionNonce();
+    }
+  }
+
   const encodeExecute: (tx: AccountOp) => Promise<Hex> = async ({
     target,
     data,
@@ -150,18 +187,16 @@ export async function createMAv2Base<
 
   const isAccountDeployed: () => Promise<boolean> = async () =>
     !!(await client.getCode({ address: accountAddress }));
-  // TODO: add deferred action flag
+
   const getNonce = async (nonceKey: bigint = 0n): Promise<bigint> => {
+    if (useDeferredAction) {
+      return nonce;
+    }
+
     if (nonceKey > maxUint152) {
       throw new InvalidNonceKeyError(nonceKey);
     }
 
-    const entryPointContract = getContract({
-      address: entryPoint.address,
-      abi: entryPoint.abi,
-      client,
-    });
-
     const fullNonceKey: bigint =
       (nonceKey << 40n) +
       (BigInt(entityId) << 8n) +
@@ -216,7 +251,8 @@ export async function createMAv2Base<
       entityId: Number(entityId),
     });
 
-    return validationData.executionHooks.length
+    return (useDeferredAction && hasAssociatedExecHooks) ||
+      validationData.executionHooks.length
       ? concatHex([executeUserOpSelector, callData])
       : callData;
   };
@@ -231,8 +267,14 @@ export async function createMAv2Base<
     encodeBatchExecute,
     getNonce,
     ...(entityId === DEFAULT_OWNER_ENTITY_ID
-      ? nativeSMASigner(signer, chain, accountAddress)
-      : singleSignerMessageSigner(signer, chain, accountAddress, entityId)),
+      ? nativeSMASigner(signer, chain, accountAddress, deferredActionData)
+      : singleSignerMessageSigner(
+          signer,
+          chain,
+          accountAddress,
+          entityId,
+          deferredActionData
+        )),
   });
 
   return {

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

@@ -36,6 +36,7 @@ export type CreateModularAccountV2Params<
 > & {
   signer: TSigner;
   entryPoint?: EntryPointDef<"0.7.0", Chain>;
+  deferredAction?: Hex;
   signerEntity?: SignerEntity;
 }) &
   (
@@ -103,6 +104,7 @@ export async function createModularAccountV2(
       entityId: DEFAULT_OWNER_ENTITY_ID,
     },
     signerEntity: { entityId = DEFAULT_OWNER_ENTITY_ID } = {},
+    deferredAction,
   } = config;
 
   const client = createBundlerClient({
@@ -183,6 +185,7 @@ export async function createModularAccountV2(
     signer,
     entryPoint,
     signerEntity,
+    deferredAction,
     ...accountFunctions,
   });
 }

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

@@ -9,6 +9,7 @@ import {
   type Chain,
   type Address,
   concat,
+  concatHex,
 } from "viem";
 
 import {
@@ -23,7 +24,6 @@ import { SignatureType } from "../modules/utils.js";
  * @example
  * ```ts
  * import { nativeSMASigner } from "@account-kit/smart-contracts";
- 
  * import { LocalAccountSigner } from "@aa-sdk/core";
  *
  * const MNEMONIC = "...":
@@ -38,31 +38,37 @@ import { SignatureType } from "../modules/utils.js";
  * @param {SmartAccountSigner} signer Signer to use for signing operations
  * @param {Chain} chain Chain object for the signer
  * @param {Address} accountAddress address of the smart account using this signer
+ * @param {Hex} deferredActionData optional deferred action data to prepend to the uo signatures
  * @returns {object} an object with methods for signing operations and managing signatures
  */
 export const nativeSMASigner = (
   signer: SmartAccountSigner,
   chain: Chain,
-  accountAddress: Address
+  accountAddress: Address,
+  deferredActionData?: Hex
 ) => {
   return {
     getDummySignature: (): Hex => {
-      const dummyEcdsaSignature =
-        "0xfffffffffffffffffffffffffffffff0000000000000000000000000000000007aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa1c";
-
-      return packUOSignature({
+      const sig = packUOSignature({
         // orderedHookData: [],
-        validationSignature: dummyEcdsaSignature,
+        validationSignature:
+          "0xfffffffffffffffffffffffffffffff0000000000000000000000000000000007aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa1c",
       });
+
+      return deferredActionData ? concatHex([deferredActionData, sig]) : sig;
     },
 
-    signUserOperationHash: (uoHash: Hex): Promise<Hex> => {
-      return signer.signMessage({ raw: uoHash }).then((signature: Hex) =>
-        packUOSignature({
-          // orderedHookData: [],
-          validationSignature: signature,
-        })
-      );
+    signUserOperationHash: async (uoHash: Hex): Promise<Hex> => {
+      const sig = await signer
+        .signMessage({ raw: uoHash })
+        .then((signature: Hex) =>
+          packUOSignature({
+            // orderedHookData: [],
+            validationSignature: signature,
+          })
+        );
+
+      return deferredActionData ? concatHex([deferredActionData, sig]) : sig;
     },
 
     // we apply the expected 1271 packing here since the account contract will expect it

package/src/ma-v2/actions/deferralActions.ts

@@ -11,7 +11,6 @@ import {
   type Hex,
   concatHex,
   maxUint152,
-  getContract,
   encodePacked,
   size,
   toHex,
@@ -44,22 +43,23 @@ export type DeferredActionTypedData = {
 
 export type DeferredActionReturnData = {
   typedData: DeferredActionTypedData;
-  nonceOverride: bigint;
 };
 
 export type CreateDeferredActionTypedDataParams = {
   callData: Hex;
   deadline: number;
-  entityId: number;
-  isGlobalValidation: boolean;
-  nonceKeyOverride?: bigint;
+  nonce: bigint;
 };
 
 export type BuildDeferredActionDigestParams = {
-  typedData: DeferredActionTypedData;
+  fullPreSignatureDeferredActionDigest: Hex;
   sig: Hex;
 };
 
+export type BuildPreSignatureDeferredActionDigestParams = {
+  typedData: DeferredActionTypedData;
+};
+
 export type BuildUserOperationWithDeferredActionParams = {
   uo: UserOperationCallData | BatchUserOperationCallData;
   signaturePrepend: Hex;
@@ -67,9 +67,10 @@ export type BuildUserOperationWithDeferredActionParams = {
 };
 
 export type EntityIdAndNonceParams = {
-  entityId: number;
-  nonceKey: bigint;
+  entityId?: number;
+  nonceKey?: bigint;
   isGlobalValidation: boolean;
+  isDeferredAction?: boolean;
 };
 
 export type DeferralActions = {
@@ -77,6 +78,9 @@ export type DeferralActions = {
     args: CreateDeferredActionTypedDataParams
   ) => Promise<DeferredActionReturnData>;
   buildDeferredActionDigest: (args: BuildDeferredActionDigestParams) => Hex;
+  buildPreSignatureDeferredActionDigest: (
+    args: BuildPreSignatureDeferredActionDigestParams
+  ) => Hex;
   buildUserOperationWithDeferredAction: (
     args: BuildUserOperationWithDeferredActionParams
   ) => Promise<UserOperationRequest_v7>;
@@ -97,43 +101,17 @@ export const deferralActions: (
   const createDeferredActionTypedDataObject = async ({
     callData,
     deadline,
-    entityId,
-    isGlobalValidation,
-    nonceKeyOverride = 0n,
+    nonce,
   }: CreateDeferredActionTypedDataParams): Promise<DeferredActionReturnData> => {
     if (!client.account) {
       throw new AccountNotFoundError();
     }
 
-    if (nonceKeyOverride > maxUint152) {
-      throw new InvalidNonceKeyError(nonceKeyOverride);
-    }
-
     const entryPoint = client.account.getEntryPoint();
     if (entryPoint === undefined) {
       throw new EntryPointNotFoundError(client.chain, "0.7.0");
     }
 
-    const entryPointContract = getContract({
-      address: entryPoint.address,
-      abi: entryPoint.abi,
-      client: client,
-    });
-
-    // 2 = deferred action flags    0b10
-    // 1 = isGlobal validation flag 0b01
-    const fullNonceKey: bigint = buildFullNonceKey({
-      nonceKey: nonceKeyOverride,
-      entityId,
-      isGlobalValidation,
-      isDeferredAction: true,
-    });
-
-    const nonceOverride = (await entryPointContract.read.getNonce([
-      client.account.address,
-      fullNonceKey,
-    ])) as bigint;
-
     return {
       typedData: {
         domain: {
@@ -149,12 +127,11 @@ export const deferralActions: (
         },
         primaryType: "DeferredAction",
         message: {
-          nonce: nonceOverride,
+          nonce: nonce,
           deadline: deadline,
           call: callData,
         },
       },
-      nonceOverride: nonceOverride,
     };
   };
 
@@ -164,34 +141,42 @@ export const deferralActions: (
    * Assumption: The client this extends is used to sign the typed data.
    *
    * @param {object} args The argument object containing the following:
-   * @param {DeferredActionTypedData} args.typedData The typed data object for the deferred action
+   * @param {Hex} args.fullPreSignatureDeferredActionDigest The The data to append the signature and length to
    * @param {Hex} args.sig The signature to include in the digest
    * @returns {Hex} The encoded digest to be prepended to the userOp signature
    */
   const buildDeferredActionDigest = ({
-    typedData,
+    fullPreSignatureDeferredActionDigest,
     sig,
   }: BuildDeferredActionDigestParams): Hex => {
+    const sigLength = size(sig);
+
+    const encodedData = concatHex([
+      fullPreSignatureDeferredActionDigest,
+      toHex(sigLength, { size: 4 }),
+      sig,
+    ]);
+    return encodedData;
+  };
+
+  const buildPreSignatureDeferredActionDigest = ({
+    typedData,
+  }: BuildPreSignatureDeferredActionDigestParams): Hex => {
     const signerEntity = client.account.signerEntity;
     const validationLocator =
       (BigInt(signerEntity.entityId) << 8n) |
       (signerEntity.isGlobalValidation ? 1n : 0n);
 
-    let encodedData = encodePacked(
+    const encodedCallData = encodePacked(
       ["uint168", "uint48", "bytes"],
       [validationLocator, typedData.message.deadline, typedData.message.call]
     );
 
-    const encodedDataLength = size(encodedData);
-    const sigLength = size(sig);
-
-    encodedData = concatHex([
+    const encodedDataLength = size(encodedCallData);
+    const encodedData = concatHex([
       toHex(encodedDataLength, { size: 4 }),
-      encodedData,
-      toHex(sigLength, { size: 4 }),
-      sig,
+      encodedCallData,
     ]);
-
     return encodedData;
   };
 
@@ -239,9 +224,10 @@ export const deferralActions: (
   };
 
   const getEntityIdAndNonce = async ({
-    entityId,
-    nonceKey,
+    entityId = 1,
+    nonceKey = 0n,
     isGlobalValidation,
+    isDeferredAction = true,
   }: EntityIdAndNonceParams) => {
     if (!client.account) {
       throw new AccountNotFoundError();
@@ -266,7 +252,7 @@ export const deferralActions: (
           nonceKey,
           entityId,
           isGlobalValidation,
-          isDeferredAction: true,
+          isDeferredAction,
         }),
       ],
     });
@@ -285,6 +271,7 @@ export const deferralActions: (
   return {
     createDeferredActionTypedDataObject,
     buildDeferredActionDigest,
+    buildPreSignatureDeferredActionDigest,
     buildUserOperationWithDeferredAction,
     getEntityIdAndNonce,
   };

package/src/ma-v2/index.ts

@@ -20,6 +20,10 @@ export {
 } from "./actions/common/utils.js";
 export type * from "./actions/install-validation/installValidation.js";
 export { installValidationActions } from "./actions/install-validation/installValidation.js";
+export type * from "./actions/deferralActions.js";
+export { deferralActions } from "./actions/deferralActions.js";
+export type * from "./permissionBuilder.js";
+export { PermissionBuilder, PermissionType } from "./permissionBuilder.js";
 
 export {
   getDefaultAllowlistModuleAddress,

package/src/ma-v2/modules/single-signer-validation/signer.ts

@@ -39,32 +39,38 @@ import { packUOSignature, pack1271Signature } from "../../utils.js";
  * @param {Chain} chain Chain object for the signer
  * @param {Address} accountAddress address of the smart account using this signer
  * @param {number} entityId the entity id of the signing validation
+ * @param {Hex} deferredActionData optional deferred action data to prepend to the uo signatures
  * @returns {object} an object with methods for signing operations and managing signatures
  */
 export const singleSignerMessageSigner = (
   signer: SmartAccountSigner,
   chain: Chain,
   accountAddress: Address,
-  entityId: number
+  entityId: number,
+  deferredActionData?: Hex
 ) => {
   return {
     getDummySignature: (): Hex => {
-      const dummyEcdsaSignature =
-        "0xfffffffffffffffffffffffffffffff0000000000000000000000000000000007aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa1c";
-
-      return packUOSignature({
+      const sig = packUOSignature({
         // orderedHookData: [],
-        validationSignature: dummyEcdsaSignature,
+        validationSignature:
+          "0xfffffffffffffffffffffffffffffff0000000000000000000000000000000007aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa1c",
       });
+
+      return deferredActionData ? concatHex([deferredActionData, sig]) : sig;
     },
 
-    signUserOperationHash: (uoHash: Hex): Promise<Hex> => {
-      return signer.signMessage({ raw: uoHash }).then((signature: Hex) =>
-        packUOSignature({
-          // orderedHookData: [],
-          validationSignature: signature,
-        })
-      );
+    signUserOperationHash: async (uoHash: Hex): Promise<Hex> => {
+      const sig = await signer
+        .signMessage({ raw: uoHash })
+        .then((signature: Hex) =>
+          packUOSignature({
+            // orderedHookData: [],
+            validationSignature: signature,
+          })
+        );
+
+      return deferredActionData ? concatHex([deferredActionData, sig]) : sig;
     },
 
     // we apply the expected 1271 packing here since the account contract will expect it