feat: adds paymaster guard module

.vitest/src/instances.ts

@@ -23,7 +23,7 @@ export const local060Instance = defineInstance({
 
 export const local070Instance = defineInstance({
   chain: localhost,
-  forkBlockNumber: 6381303,
+  forkBlockNumber: 7299096,
   forkUrl:
     process.env.VITEST_SEPOLIA_FORK_URL ??
     "https://ethereum-sepolia-rpc.publicnode.com",

aa-sdk/core/src/errors/client.ts

@@ -53,3 +53,51 @@ export class ChainNotFoundError extends BaseError {
     super("No chain supplied to the client");
   }
 }
+
+/**
+ * Error class denoting that the provided entity id is invalid because it's too large.
+ */
+export class InvalidEntityIdError extends BaseError {
+  override name = "InvalidEntityIdError";
+
+  /**
+   * Initializes a new instance of the error message with a default message indicating that the entity id is invalid because it's too large.
+   *
+   * @param {number} entityId the invalid entityId used
+   */
+  constructor(entityId: number) {
+    super(`Entity ID used is ${entityId}, but must be less than uint32.max`);
+  }
+}
+
+/**
+ * Error class denoting that the nonce key is invalid because its too large.
+ */
+export class InvalidNonceKeyError extends BaseError {
+  override name = "InvalidNonceKeyError";
+
+  /**
+   * Initializes a new instance of the error message with a default message indicating that the nonce key is invalid.
+   *
+   * @param {bigint} nonceKey the invalid nonceKey used
+   */
+  constructor(nonceKey: bigint) {
+    super(`Nonce key is ${nonceKey} but has to be less than 2**152`);
+  }
+}
+
+/**
+ * Error class denoting that the provided entity id is invalid because it's overriding the native entity id.
+ */
+export class EntityIdOverrideError extends BaseError {
+  override name = "InvalidNonceKeyError";
+
+  /**
+   * Initializes a new instance of the error message with a default message indicating that the nonce key is invalid.
+   */
+  constructor() {
+    super(
+      `Installing entityId of 0 overrides the owner's entity id in the account`
+    );
+  }
+}

aa-sdk/core/src/index.ts

@@ -73,6 +73,9 @@ export {
   ChainNotFoundError,
   IncompatibleClientError,
   InvalidRpcUrlError,
+  InvalidEntityIdError,
+  InvalidNonceKeyError,
+  EntityIdOverrideError,
 } from "./errors/client.js";
 export {
   EntryPointNotFoundError,