@aa-sdk/core 4.0.0-alpha.0

package/dist/esm/utils/stateOverride.d.ts

@@ -0,0 +1,4 @@
+import { type RpcStateOverride, type StateOverride } from "viem";
+type SerializeStateOverrideParameters = StateOverride | undefined;
+export declare function serializeStateOverride(parameters?: SerializeStateOverrideParameters): RpcStateOverride | undefined;
+export {};

package/dist/esm/utils/stateOverride.js

@@ -0,0 +1,48 @@
+import { AccountStateConflictError, InvalidAddressError, StateAssignmentConflictError, isAddress, numberToHex, } from "viem";
+function serializeStateMapping(stateMapping) {
+    if (!stateMapping || stateMapping.length === 0)
+        return undefined;
+    return stateMapping.reduce((acc, { slot, value }) => {
+        validateBytes32HexLength(slot);
+        validateBytes32HexLength(value);
+        acc[slot] = value;
+        return acc;
+    }, {});
+}
+function validateBytes32HexLength(value) {
+    if (value.length !== 66) {
+        throw new Error(`Hex is expected to be 66 hex long, but is ${value.length} hex long.`);
+    }
+}
+function serializeAccountStateOverride(parameters) {
+    const { balance, nonce, state, stateDiff, code } = parameters;
+    const rpcAccountStateOverride = {};
+    if (code !== undefined)
+        rpcAccountStateOverride.code = code;
+    if (balance !== undefined)
+        rpcAccountStateOverride.balance = numberToHex(balance);
+    if (nonce !== undefined)
+        rpcAccountStateOverride.nonce = numberToHex(nonce);
+    if (state !== undefined)
+        rpcAccountStateOverride.state = serializeStateMapping(state);
+    if (stateDiff !== undefined) {
+        if (rpcAccountStateOverride.state)
+            throw new StateAssignmentConflictError();
+        rpcAccountStateOverride.stateDiff = serializeStateMapping(stateDiff);
+    }
+    return rpcAccountStateOverride;
+}
+export function serializeStateOverride(parameters) {
+    if (!parameters)
+        return undefined;
+    const rpcStateOverride = {};
+    for (const { address, ...accountState } of parameters) {
+        if (!isAddress(address, { strict: false }))
+            throw new InvalidAddressError({ address });
+        if (rpcStateOverride[address])
+            throw new AccountStateConflictError({ address: address });
+        rpcStateOverride[address] = serializeAccountStateOverride(accountState);
+    }
+    return rpcStateOverride;
+}
+//# sourceMappingURL=stateOverride.js.map

package/dist/esm/utils/stateOverride.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateOverride.js","sourceRoot":"","sources":["../../../src/utils/stateOverride.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,4BAA4B,EAC5B,SAAS,EACT,WAAW,GAMZ,MAAM,MAAM,CAAC;AAOd,SAAS,qBAAqB,CAC5B,YAA6C;IAE7C,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACjE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;QAClD,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAC/B,wBAAwB,CAAC,KAAK,CAAC,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAClB,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAqB,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAExB,MAAM,IAAI,KAAK,CACb,6CAA6C,KAAK,CAAC,MAAM,YAAY,CACtE,CAAC;IACJ,CAAC;AACH,CAAC;AAOD,SAAS,6BAA6B,CACpC,UAAmD;IAEnD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC;IAC9D,MAAM,uBAAuB,GAA4B,EAAE,CAAC;IAC5D,IAAI,IAAI,KAAK,SAAS;QAAE,uBAAuB,CAAC,IAAI,GAAG,IAAI,CAAC;IAC5D,IAAI,OAAO,KAAK,SAAS;QACvB,uBAAuB,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IACzD,IAAI,KAAK,KAAK,SAAS;QAAE,uBAAuB,CAAC,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAC5E,IAAI,KAAK,KAAK,SAAS;QACrB,uBAAuB,CAAC,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC/D,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,uBAAuB,CAAC,KAAK;YAAE,MAAM,IAAI,4BAA4B,EAAE,CAAC;QAC5E,uBAAuB,CAAC,SAAS,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,uBAAuB,CAAC;AACjC,CAAC;AAKD,MAAM,UAAU,sBAAsB,CACpC,UAA6C;IAE7C,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,gBAAgB,GAAqB,EAAE,CAAC;IAC9C,KAAK,MAAM,EAAE,OAAO,EAAE,GAAG,YAAY,EAAE,IAAI,UAAU,EAAE,CAAC;QACtD,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;YACxC,MAAM,IAAI,mBAAmB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7C,IAAI,gBAAgB,CAAC,OAAO,CAAC;YAC3B,MAAM,IAAI,yBAAyB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5D,gBAAgB,CAAC,OAAO,CAAC,GAAG,6BAA6B,CAAC,YAAY,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC","sourcesContent":["import type { Address } from \"abitype\";\nimport {\n  AccountStateConflictError,\n  InvalidAddressError,\n  StateAssignmentConflictError,\n  isAddress,\n  numberToHex,\n  type RpcAccountStateOverride,\n  type RpcStateMapping,\n  type RpcStateOverride,\n  type StateMapping,\n  type StateOverride,\n} from \"viem\";\n\n// Copied from Viem's utils/stateOverride.ts, which does not expose these\n// functions.\n\ntype SerializeStateMappingParameters = StateMapping | undefined;\n\nfunction serializeStateMapping(\n  stateMapping: SerializeStateMappingParameters\n): RpcStateMapping | undefined {\n  if (!stateMapping || stateMapping.length === 0) return undefined;\n  return stateMapping.reduce((acc, { slot, value }) => {\n    validateBytes32HexLength(slot);\n    validateBytes32HexLength(value);\n    acc[slot] = value;\n    return acc;\n  }, {} as RpcStateMapping);\n}\n\nfunction validateBytes32HexLength(value: Address): void {\n  if (value.length !== 66) {\n    // This is the error message from Viem's non-exported InvalidBytesLengthError.\n    throw new Error(\n      `Hex is expected to be 66 hex long, but is ${value.length} hex long.`\n    );\n  }\n}\n\ntype SerializeAccountStateOverrideParameters = Omit<\n  StateOverride[number],\n  \"address\"\n>;\n\nfunction serializeAccountStateOverride(\n  parameters: SerializeAccountStateOverrideParameters\n): RpcAccountStateOverride {\n  const { balance, nonce, state, stateDiff, code } = parameters;\n  const rpcAccountStateOverride: RpcAccountStateOverride = {};\n  if (code !== undefined) rpcAccountStateOverride.code = code;\n  if (balance !== undefined)\n    rpcAccountStateOverride.balance = numberToHex(balance);\n  if (nonce !== undefined) rpcAccountStateOverride.nonce = numberToHex(nonce);\n  if (state !== undefined)\n    rpcAccountStateOverride.state = serializeStateMapping(state);\n  if (stateDiff !== undefined) {\n    if (rpcAccountStateOverride.state) throw new StateAssignmentConflictError();\n    rpcAccountStateOverride.stateDiff = serializeStateMapping(stateDiff);\n  }\n  return rpcAccountStateOverride;\n}\n\ntype SerializeStateOverrideParameters = StateOverride | undefined;\n\n// eslint-disable-next-line jsdoc/require-jsdoc\nexport function serializeStateOverride(\n  parameters?: SerializeStateOverrideParameters\n): RpcStateOverride | undefined {\n  if (!parameters) return undefined;\n  const rpcStateOverride: RpcStateOverride = {};\n  for (const { address, ...accountState } of parameters) {\n    if (!isAddress(address, { strict: false }))\n      throw new InvalidAddressError({ address });\n    if (rpcStateOverride[address])\n      throw new AccountStateConflictError({ address: address });\n    rpcStateOverride[address] = serializeAccountStateOverride(accountState);\n  }\n  return rpcStateOverride;\n}\n"]}

package/dist/esm/utils/testUtils.d.ts

@@ -0,0 +1,6 @@
+import { type Chain } from "viem";
+import { type SmartContractAccount } from "../account/smartContractAccount.js";
+import { type BundlerClient } from "../client/bundlerClient.js";
+import type { DefaultEntryPointVersion } from "../entrypoint/types.js";
+export declare const createDummySmartContractAccount: <C extends BundlerClient>(client: C) => Promise<SmartContractAccount<"dummy", DefaultEntryPointVersion>>;
+export declare const createTestClient: (chain: Chain) => BundlerClient<import("viem").CustomTransport>;

package/dist/esm/utils/testUtils.js

@@ -0,0 +1,28 @@
+import { createPublicClient, custom } from "viem";
+import { toSmartContractAccount, } from "../account/smartContractAccount.js";
+import { createBundlerClientFromExisting, } from "../client/bundlerClient.js";
+import { getEntryPoint } from "../entrypoint/index.js";
+export const createDummySmartContractAccount = async (client) => {
+    return toSmartContractAccount({
+        source: "dummy",
+        accountAddress: "0x1234567890123456789012345678901234567890",
+        entryPoint: getEntryPoint(client.chain),
+        chain: client.chain,
+        transport: custom(client),
+        signMessage: async () => "0xdeadbeef",
+        signTypedData: async () => "0xdeadbeef",
+        getAccountInitCode: async () => "0x1234567890123456789012345678901234567890deadbeef",
+        encodeBatchExecute: async () => "0x",
+        encodeExecute: async () => "0x",
+        getDummySignature: () => "0xfffffffffffffffffffffffffffffff0000000000000000000000000000000007aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa1c",
+    });
+};
+export const createTestClient = (chain) => {
+    return createBundlerClientFromExisting(createPublicClient({
+        chain,
+        transport: custom({
+            request: async () => { },
+        }),
+    }));
+};
+//# sourceMappingURL=testUtils.js.map

package/dist/esm/utils/testUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.js","sourceRoot":"","sources":["../../../src/utils/testUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAwB,MAAM,MAAM,CAAC;AACxE,OAAO,EACL,sBAAsB,GAEvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,+BAA+B,GAEhC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,EAClD,MAAS,EACyD,EAAE;IACpE,OAAO,sBAAsB,CAAC;QAC5B,MAAM,EAAE,OAAO;QACf,cAAc,EAAE,4CAA4C;QAC5D,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;QACvC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;QACzB,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,YAAY;QACrC,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,YAAY;QACvC,kBAAkB,EAAE,KAAK,IAAI,EAAE,CAC7B,oDAAoD;QACtD,kBAAkB,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;QACpC,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI;QAC/B,iBAAiB,EAAE,GAAQ,EAAE,CAC3B,sIAAsI;KACzI,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAY,EAAE,EAAE;IAC/C,OAAO,+BAA+B,CACpC,kBAAkB,CAAC;QACjB,KAAK;QACL,SAAS,EAAE,MAAM,CAAC;YAChB,OAAO,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;SACxB,CAAC;KACH,CAAC,CACH,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import { createPublicClient, custom, type Chain, type Hex } from \"viem\";\nimport {\n  toSmartContractAccount,\n  type SmartContractAccount,\n} from \"../account/smartContractAccount.js\";\nimport {\n  createBundlerClientFromExisting,\n  type BundlerClient,\n} from \"../client/bundlerClient.js\";\nimport { getEntryPoint } from \"../entrypoint/index.js\";\nimport type { DefaultEntryPointVersion } from \"../entrypoint/types.js\";\n\nexport const createDummySmartContractAccount = async <C extends BundlerClient>(\n  client: C\n): Promise<SmartContractAccount<\"dummy\", DefaultEntryPointVersion>> => {\n  return toSmartContractAccount({\n    source: \"dummy\",\n    accountAddress: \"0x1234567890123456789012345678901234567890\",\n    entryPoint: getEntryPoint(client.chain),\n    chain: client.chain,\n    transport: custom(client),\n    signMessage: async () => \"0xdeadbeef\",\n    signTypedData: async () => \"0xdeadbeef\",\n    getAccountInitCode: async () =>\n      \"0x1234567890123456789012345678901234567890deadbeef\",\n    encodeBatchExecute: async () => \"0x\",\n    encodeExecute: async () => \"0x\",\n    getDummySignature: (): Hex =>\n      \"0xfffffffffffffffffffffffffffffff0000000000000000000000000000000007aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa1c\",\n  });\n};\n\nexport const createTestClient = (chain: Chain) => {\n  return createBundlerClientFromExisting(\n    createPublicClient({\n      chain,\n      transport: custom({\n        request: async () => {},\n      }),\n    })\n  );\n};\n"]}

package/dist/esm/utils/types.d.ts

@@ -0,0 +1,16 @@
+export type NoUndefined<T> = T extends undefined ? never : T;
+export type IsUndefined<T> = [undefined] extends [T] ? true : false;
+export type RequiredBy<TType, TKeys extends keyof TType> = Required<Pick<TType, TKeys>> & Omit<TType, TKeys>;
+export type Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+export type WithRequired<T, K extends keyof T> = Required<Pick<T, K>>;
+export type WithOptional<T, K extends keyof T> = Pick<Partial<T>, K>;
+export type EQ<A, B> = [A] extends [B] ? [B] extends [A] ? true : false : false;
+export type EqualsOneOfTheComponents<T, Union> = Union extends infer Component ? EQ<T, Component> : never;
+export type IsMemberOrSubtypeOfAComponent<T, Union, ConjunctionOfExplicitComponentChecks extends boolean> = [T] extends [Union] ? true extends ConjunctionOfExplicitComponentChecks ? true : false : false;
+export type IsOneOf<T, Union> = IsMemberOrSubtypeOfAComponent<T, Union, EqualsOneOfTheComponents<T, Union>>;
+export type OneOf<T1, T2> = IsOneOf<T1, T2> extends true ? T1 : never;
+export type RecordableKeys<T> = {
+    [K in keyof T]: T[K] extends string | number | symbol ? K : never;
+}[keyof T];

package/dist/esm/utils/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/utils/types.ts"],"names":[],"mappings":"","sourcesContent":["// borrowed from viem\n\n/**\n * @description Constructs a type by excluding `undefined` from `T`.\n *\n * @example\n * NoUndefined<string | undefined>\n * => string\n */\nexport type NoUndefined<T> = T extends undefined ? never : T;\n// borrowed from viem\n/**\n * @description Checks if {@link T} is `undefined`\n * @param T - Type to check\n * @example\n * type Result = IsUndefined<undefined>\n * //   ^? type Result = true\n */\n\nexport type IsUndefined<T> = [undefined] extends [T] ? true : false;\n\nexport type RequiredBy<TType, TKeys extends keyof TType> = Required<\n  Pick<TType, TKeys>\n> &\n  Omit<TType, TKeys>;\n\n/**\n * @description Combines members of an intersection into a readable type.\n *\n * @see {@link https://twitter.com/mattpocockuk/status/1622730173446557697?s=20&t=NdpAcmEFXY01xkqU3KO0Mg}\n * @example\n * Prettify<{ a: string } & { b: string } & { c: number, d: bigint }>\n * => { a: string, b: string, c: number, d: bigint }\n */\nexport type Prettify<T> = {\n  [K in keyof T]: T[K];\n} & {};\n\nexport type WithRequired<T, K extends keyof T> = Required<Pick<T, K>>;\nexport type WithOptional<T, K extends keyof T> = Pick<Partial<T>, K>;\n\n// Checks for type equivalence, evaluates always to either `true` or `false`.\n// Semantics: (EQ<A, B> = true) <==> (A <==> B)\nexport type EQ<A, B> = [A] extends [B]\n  ? [B] extends [A]\n    ? true\n    : false\n  : false;\n\n// Auxiliary type for `IsMemberOrSubtypeOfAComponent`\n// Evaluates to `true` or `boolean` if one of the explicit components (according to the TypeScript distribution\n// mechanism for union types) of the union type equals the other given type.\n// Examples:\n//    EqualsOneOfTheComponents<string, string | boolean> ⟶ boolean\n//    EqualsOneOfTheComponents<string, string> ⟶ true\n//    EqualsOneOfTheComponents<number, string | boolean> ⟶ false\nexport type EqualsOneOfTheComponents<T, Union> = Union extends infer Component // enforce distribution\n  ? EQ<T, Component>\n  : never;\n\n// Auxiliary type for `IsOneOf`\nexport type IsMemberOrSubtypeOfAComponent<\n  T,\n  Union,\n  ConjunctionOfExplicitComponentChecks extends boolean\n> = [T] extends [Union]\n  ? true extends ConjunctionOfExplicitComponentChecks\n    ? true\n    : false\n  : false;\n\n// Checks whether the given type equals one of the explicit components of the union type. Note that in this respect we\n// consider the members of the infinite types number and string as implicit since the inbuilt distribution mechanism of\n// TypeScript does not (cannot) distribute over the infinite number of strings or numbers. However, `boolean` is treated\n// by TypeScript (and accordingly here) as the explicit union `true | false`.\n//\n// In particular, the evaluation result is `false` if the type is a proper union of components of the union type. It also\n// evaluates to false if the given type is a proper subtype of one of its explicit components.\n// It always evaluates to either `true` or `false`.\n// Examples:\n//    IsOneOf<number, string | number | boolean> ⟶ true\n//    IsOneOf<2 | 4, 0 | 1 | 2 | 3 | 4 | 5 | 6> ⟶ false\n//    IsOneOf<'text', string> ⟶ false  // only implicit but not explicit component\nexport type IsOneOf<T, Union> = IsMemberOrSubtypeOfAComponent<\n  T,\n  Union,\n  EqualsOneOfTheComponents<T, Union>\n>;\n\nexport type OneOf<T1, T2> = IsOneOf<T1, T2> extends true ? T1 : never;\n\nexport type RecordableKeys<T> = {\n  [K in keyof T]: T[K] extends string | number | symbol ? K : never;\n}[keyof T];\n"]}

package/dist/esm/utils/userop.d.ts

@@ -0,0 +1,49 @@
+import { type Hex } from "viem";
+import type { EntryPointVersion } from "../entrypoint/types";
+import type { BigNumberish, Multiplier, UserOperationFeeOptionsField, UserOperationOverrides, UserOperationRequest, UserOperationStruct } from "../types";
+export declare function isValidRequest<TEntryPointVersion extends EntryPointVersion = EntryPointVersion>(request: UserOperationStruct<TEntryPointVersion>): request is UserOperationRequest<TEntryPointVersion>;
+export declare function isValidPaymasterAndData<TEntryPointVersion extends EntryPointVersion = EntryPointVersion>(request: UserOperationStruct<TEntryPointVersion>): boolean;
+export declare function isValidFactoryAndData<TEntryPointVersion extends EntryPointVersion = EntryPointVersion>(request: UserOperationStruct<TEntryPointVersion>): boolean;
+export declare function applyUserOpOverride<TValue extends BigNumberish | undefined>(value: TValue, override?: BigNumberish | Multiplier): TValue | BigNumberish;
+export declare function applyUserOpFeeOption<TValue extends BigNumberish | undefined>(value: TValue, feeOption?: UserOperationFeeOptionsField): TValue | BigNumberish;
+export declare function applyUserOpOverrideOrFeeOption<TValue extends BigNumberish | undefined>(value: TValue, override?: BigNumberish | Multiplier, feeOption?: UserOperationFeeOptionsField): TValue | BigNumberish;
+export declare const bypassPaymasterAndData: <TEntryPointVersion extends keyof import("../entrypoint/types").EntryPointRegistryBase<unknown> = keyof import("../entrypoint/types").EntryPointRegistryBase<unknown>>(overrides: Partial<{
+    callGasLimit: {
+        multiplier: number;
+    } | UserOperationStruct<TEntryPointVersion>["callGasLimit"];
+    maxFeePerGas: {
+        multiplier: number;
+    } | UserOperationStruct<TEntryPointVersion>["maxFeePerGas"];
+    maxPriorityFeePerGas: {
+        multiplier: number;
+    } | UserOperationStruct<TEntryPointVersion>["maxPriorityFeePerGas"];
+    preVerificationGas: {
+        multiplier: number;
+    } | UserOperationStruct<TEntryPointVersion>["preVerificationGas"];
+    verificationGasLimit: {
+        multiplier: number;
+    } | UserOperationStruct<TEntryPointVersion>["verificationGasLimit"];
+    nonceKey: bigint;
+    stateOverride: import("viem").StateOverride;
+} & import("../types").UserOperationPaymasterOverrides<TEntryPointVersion>> | undefined) => boolean;
+export declare const bypassPaymasterAndDataEmptyHex: <TEntryPointVersion extends keyof import("../entrypoint/types").EntryPointRegistryBase<unknown> = keyof import("../entrypoint/types").EntryPointRegistryBase<unknown>>(overrides: Partial<{
+    callGasLimit: {
+        multiplier: number;
+    } | UserOperationStruct<TEntryPointVersion>["callGasLimit"];
+    maxFeePerGas: {
+        multiplier: number;
+    } | UserOperationStruct<TEntryPointVersion>["maxFeePerGas"];
+    maxPriorityFeePerGas: {
+        multiplier: number;
+    } | UserOperationStruct<TEntryPointVersion>["maxPriorityFeePerGas"];
+    preVerificationGas: {
+        multiplier: number;
+    } | UserOperationStruct<TEntryPointVersion>["preVerificationGas"];
+    verificationGasLimit: {
+        multiplier: number;
+    } | UserOperationStruct<TEntryPointVersion>["verificationGasLimit"];
+    nonceKey: bigint;
+    stateOverride: import("viem").StateOverride;
+} & import("../types").UserOperationPaymasterOverrides<TEntryPointVersion>> | undefined) => boolean;
+export declare const parsePaymasterAndData: (paymasterAndData: Hex) => Pick<UserOperationRequest<"0.7.0">, "paymaster" | "paymasterData">;
+export declare const concatPaymasterAndData: ({ paymaster, paymasterData, }: Pick<UserOperationRequest<"0.7.0">, "paymaster" | "paymasterData">) => Hex;

package/dist/esm/utils/userop.js

@@ -0,0 +1,62 @@
+import { concat } from "viem";
+import { bigIntClamp, bigIntMultiply } from "./bigint.js";
+import { allEqual, isBigNumberish } from "./index.js";
+export function isValidRequest(request) {
+    return (BigInt(request.callGasLimit || 0n) > 0n &&
+        BigInt(request.maxFeePerGas || 0n) > 0n &&
+        BigInt(request.preVerificationGas || 0n) > 0n &&
+        BigInt(request.verificationGasLimit || 0n) > 0n &&
+        request.maxPriorityFeePerGas != null &&
+        isValidPaymasterAndData(request) &&
+        isValidFactoryAndData(request));
+}
+export function isValidPaymasterAndData(request) {
+    if ("paymasterAndData" in request) {
+        return request.paymasterAndData != null;
+    }
+    return allEqual(request.paymaster == null, request.paymasterData == null, request.paymasterPostOpGasLimit == null, request.paymasterVerificationGasLimit == null);
+}
+export function isValidFactoryAndData(request) {
+    if ("initCode" in request) {
+        const { initCode } = request;
+        return initCode != null;
+    }
+    return allEqual(request.factory == null, request.factoryData == null);
+}
+export function applyUserOpOverride(value, override) {
+    if (override == null) {
+        return value;
+    }
+    if (isBigNumberish(override)) {
+        return override;
+    }
+    else {
+        return value != null ? bigIntMultiply(value, override.multiplier) : value;
+    }
+}
+export function applyUserOpFeeOption(value, feeOption) {
+    if (feeOption == null) {
+        return value;
+    }
+    return value != null
+        ? bigIntClamp(feeOption.multiplier
+            ? bigIntMultiply(value, feeOption.multiplier)
+            : value, feeOption.min, feeOption.max)
+        : feeOption.min ?? 0n;
+}
+export function applyUserOpOverrideOrFeeOption(value, override, feeOption) {
+    return value != null && override != null
+        ? applyUserOpOverride(value, override)
+        : applyUserOpFeeOption(value, feeOption);
+}
+export const bypassPaymasterAndData = (overrides) => !!overrides &&
+    ("paymasterAndData" in overrides || "paymasterData" in overrides);
+export const bypassPaymasterAndDataEmptyHex = (overrides) => overrides !== undefined &&
+    (("paymasterAndData" in overrides && overrides.paymasterAndData === "0x") ||
+        ("paymasterData" in overrides && overrides.paymasterData === "0x"));
+export const parsePaymasterAndData = (paymasterAndData) => ({
+    paymaster: paymasterAndData.substring(0, 42),
+    paymasterData: `0x${paymasterAndData.substring(42)}`,
+});
+export const concatPaymasterAndData = ({ paymaster = "0x", paymasterData = "0x", }) => concat([paymaster, paymasterData]);
+//# sourceMappingURL=userop.js.map

package/dist/esm/utils/userop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userop.js","sourceRoot":"","sources":["../../../src/utils/userop.ts"],"names":[],"mappings":"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","sourcesContent":["import { concat, type Address, type Hex } from \"viem\";\nimport type { EntryPointVersion } from \"../entrypoint/types\";\nimport type {\n  BigNumberish,\n  Multiplier,\n  UserOperationFeeOptionsField,\n  UserOperationOverrides,\n  UserOperationRequest,\n  UserOperationStruct,\n  UserOperationStruct_v6,\n  UserOperationStruct_v7,\n} from \"../types\";\nimport { bigIntClamp, bigIntMultiply } from \"./bigint.js\";\nimport { allEqual, isBigNumberish } from \"./index.js\";\n\n/**\n * Utility method for asserting a {@link UserOperationStruct} has valid fields for the given entry point version\n *\n * @param request a {@link UserOperationStruct} to validate\n * @returns a type guard that asserts the {@link UserOperationRequest} is valid\n */\nexport function isValidRequest<\n  TEntryPointVersion extends EntryPointVersion = EntryPointVersion\n>(\n  request: UserOperationStruct<TEntryPointVersion>\n): request is UserOperationRequest<TEntryPointVersion> {\n  // These are the only ones marked as optional in the interface above\n  return (\n    BigInt(request.callGasLimit || 0n) > 0n &&\n    BigInt(request.maxFeePerGas || 0n) > 0n &&\n    BigInt(request.preVerificationGas || 0n) > 0n &&\n    BigInt(request.verificationGasLimit || 0n) > 0n &&\n    request.maxPriorityFeePerGas != null &&\n    isValidPaymasterAndData(request) &&\n    isValidFactoryAndData(request)\n  );\n}\n\n/**\n * Utility method for asserting a {@link UserOperationRequest} has valid fields for the paymaster data\n *\n * @param request a {@link UserOperationRequest} to validate\n * @returns a type guard that asserts the {@link UserOperationRequest} is a {@link UserOperationRequest}\n */\nexport function isValidPaymasterAndData<\n  TEntryPointVersion extends EntryPointVersion = EntryPointVersion\n>(request: UserOperationStruct<TEntryPointVersion>): boolean {\n  if (\"paymasterAndData\" in request) {\n    return (request as UserOperationStruct_v6).paymasterAndData != null;\n  }\n\n  // either all exist, or none.\n  return allEqual(\n    (request as UserOperationStruct_v7).paymaster == null,\n    (request as UserOperationStruct_v7).paymasterData == null,\n    (request as UserOperationStruct_v7).paymasterPostOpGasLimit == null,\n    (request as UserOperationStruct_v7).paymasterVerificationGasLimit == null\n  );\n}\n\n/**\n * Utility method for asserting a {@link UserOperationStruct} has valid fields for the paymaster data\n *\n * @param request a {@link UserOperationRequest} to validate\n * @returns a type guard that asserts the {@link UserOperationStruct} is a {@link UserOperationRequest}\n */\nexport function isValidFactoryAndData<\n  TEntryPointVersion extends EntryPointVersion = EntryPointVersion\n>(request: UserOperationStruct<TEntryPointVersion>): boolean {\n  if (\"initCode\" in request) {\n    const { initCode } = request as UserOperationStruct_v6;\n    return initCode != null;\n  }\n\n  // either all exist, or none.\n  return allEqual(\n    (request as UserOperationStruct_v7).factory == null,\n    (request as UserOperationStruct_v7).factoryData == null\n  );\n}\n\n/**\n * Utility method for applying a {@link UserOperationOverrides} field value\n * over the current value set for the field\n *\n * @param value the current value of the field\n * @param override the override value to apply\n * @returns the new value of the field after applying the override\n */\nexport function applyUserOpOverride<TValue extends BigNumberish | undefined>(\n  value: TValue,\n  override?: BigNumberish | Multiplier\n): TValue | BigNumberish {\n  if (override == null) {\n    return value;\n  }\n\n  if (isBigNumberish(override)) {\n    return override;\n  }\n\n  // multiplier override\n  else {\n    return value != null ? bigIntMultiply(value, override.multiplier) : value;\n  }\n}\n\n/**\n * Utility method for applying a {@link UserOperationFeeOptionsField} value\n * over the current value set for the field\n *\n * @param value the current value of the field\n * @param feeOption the fee option field value to apply\n * @returns the new value of the field after applying the fee option\n */\nexport function applyUserOpFeeOption<TValue extends BigNumberish | undefined>(\n  value: TValue,\n  feeOption?: UserOperationFeeOptionsField\n): TValue | BigNumberish {\n  if (feeOption == null) {\n    return value;\n  }\n\n  return value != null\n    ? bigIntClamp(\n        feeOption.multiplier\n          ? bigIntMultiply(value, feeOption.multiplier)\n          : value,\n        feeOption.min,\n        feeOption.max\n      )\n    : feeOption.min ?? 0n;\n}\n\n/**\n * Utility method for applying a {@link UserOperationOverrides} field value and\n * a {@link UserOperationFeeOptionsField} value over the current value set for the field,\n * with the override taking precedence over the fee option\n *\n * @param value the current value of the field\n * @param [override] the override value to apply\n * @param [feeOption] the fee option field value to apply\n * @returns the new value of the field after applying the override or fee option\n */\nexport function applyUserOpOverrideOrFeeOption<\n  TValue extends BigNumberish | undefined\n>(\n  value: TValue,\n  override?: BigNumberish | Multiplier,\n  feeOption?: UserOperationFeeOptionsField\n): TValue | BigNumberish {\n  return value != null && override != null\n    ? applyUserOpOverride(value, override)!\n    : applyUserOpFeeOption(value, feeOption);\n}\n\n/**\n * Utility method for checking whether the middleware pipeline should\n * bypass the paymaster middleware for the user operation with the given overrides,\n * either because the UserOp is paying for its own gas, or passing a specific paymaster\n *\n * @template EntryPointVersion TEntryPointVersion\n * @param overrides the user operation overrides to check\n * @returns whether the paymaster middleware should be bypassed\n */\nexport const bypassPaymasterAndData = <\n  TEntryPointVersion extends EntryPointVersion = EntryPointVersion\n>(\n  overrides: UserOperationOverrides<TEntryPointVersion> | undefined\n): boolean =>\n  !!overrides &&\n  (\"paymasterAndData\" in overrides || \"paymasterData\" in overrides);\n\n/**\n * An alternative to `bypassPaymasterAndData` which only returns true if the data parameter\n * is \"0x,\" this is useful for cases when middleware should be bypassed ONLY IF the UserOp will\n * pay for its own gas\n *\n * @template EntryPointVersion TEntryPointVersion\n * @param overrides the user operation overrides to check\n * @returns whether the paymaster middleware should be bypassed\n */\nexport const bypassPaymasterAndDataEmptyHex = <\n  TEntryPointVersion extends EntryPointVersion = EntryPointVersion\n>(\n  overrides: UserOperationOverrides<TEntryPointVersion> | undefined\n): boolean =>\n  overrides !== undefined &&\n  ((\"paymasterAndData\" in overrides && overrides.paymasterAndData === \"0x\") ||\n    (\"paymasterData\" in overrides && overrides.paymasterData === \"0x\"));\n\n/**\n * Utility method for parsing the paymaster address and paymasterData from the paymasterAndData hex string\n *\n * @param paymasterAndData the paymaster and data hex string to parse.\n *                         The hex string refers to the paymasterAndData field of entrypoint v0.6 user operation request\n * @returns the parsed paymaster and paymasterData fields of entrypoint v0.7 user operation request paymaster and paymasterData field\n */\nexport const parsePaymasterAndData = (\n  paymasterAndData: Hex\n): Pick<UserOperationRequest<\"0.7.0\">, \"paymaster\" | \"paymasterData\"> => ({\n  paymaster: paymasterAndData.substring(0, 42) as Address,\n  paymasterData: `0x${paymasterAndData.substring(42)}` as Hex,\n});\n\n/**\n * Utility method for converting the object containing the paymaster address and paymaster data\n * to the paymaster and data concatenated hex string\n *\n * @param paymasterAndData the object containing the picked paymaster and paymasterData fields of\n *                         entrypoint v0.7 user operation request\n * @param paymasterAndData.paymaster the paymaster address\n * @param paymasterAndData.paymasterData the paymaster data\n * @returns the paymasterAndData hex value of entrypoint v0.6 user operation request paymasterAndData field\n */\nexport const concatPaymasterAndData = ({\n  paymaster = \"0x\",\n  paymasterData = \"0x\",\n}: Pick<UserOperationRequest<\"0.7.0\">, \"paymaster\" | \"paymasterData\">): Hex =>\n  concat([paymaster, paymasterData]);\n"]}

package/dist/esm/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "4.0.0-alpha.0";

package/dist/esm/version.js

@@ -0,0 +1,2 @@
+export const VERSION = "4.0.0-alpha.0";
+//# sourceMappingURL=version.js.map

package/dist/esm/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC","sourcesContent":["// This file is autogenerated by inject-version.ts. Any changes will be\n// overwritten on commit!\nexport const VERSION = \"4.0.0-alpha.0\";\n"]}