@alchemy/smart-accounts 0.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Alchemy Insights, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/esm/errors/EntityIdOverrideError.d.ts

@@ -0,0 +1,11 @@
+import { BaseError } from "@alchemy/common";
+/**
+ * Error class denoting that the provided entity id is invalid because it's overriding the native entity id.
+ */
+export declare class EntityIdOverrideError extends BaseError {
+    name: string;
+    /**
+     * Initializes a new instance of the error message with a default message indicating that the nonce key is invalid.
+     */
+    constructor();
+}

package/dist/esm/errors/EntityIdOverrideError.js

@@ -0,0 +1,19 @@
+import { BaseError } from "@alchemy/common";
+/**
+ * Error class denoting that the provided entity id is invalid because it's overriding the native entity id.
+ */
+export class EntityIdOverrideError extends BaseError {
+    /**
+     * Initializes a new instance of the error message with a default message indicating that the nonce key is invalid.
+     */
+    constructor() {
+        super(`EntityId of 0 is reserved for the owner and cannot be used`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "EntityIdOverrideError"
+        });
+    }
+}
+//# sourceMappingURL=EntityIdOverrideError.js.map

package/dist/esm/errors/EntityIdOverrideError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityIdOverrideError.js","sourceRoot":"","sources":["../../../src/errors/EntityIdOverrideError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,SAAS;IAGlD;;OAEG;IACH;QACE,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAN7D;;;;mBAAO,uBAAuB;WAAC;IAOxC,CAAC;CACF","sourcesContent":["import { BaseError } from \"@alchemy/common\";\n\n/**\n * Error class denoting that the provided entity id is invalid because it's overriding the native entity id.\n */\nexport class EntityIdOverrideError extends BaseError {\n  override name = \"EntityIdOverrideError\";\n\n  /**\n   * Initializes a new instance of the error message with a default message indicating that the nonce key is invalid.\n   */\n  constructor() {\n    super(`EntityId of 0 is reserved for the owner and cannot be used`);\n  }\n}\n"]}

package/dist/esm/errors/InvalidDeferredActionNonceError.d.ts

@@ -0,0 +1,11 @@
+import { BaseError } from "@alchemy/common";
+/**
+ * Error class denoting that the deferred action nonce used is invalid.
+ */
+export declare class InvalidDeferredActionNonceError extends BaseError {
+    name: string;
+    /**
+     * Initializes a new instance of the error message with a default message indicating that the provided deferred action nonce is invalid.
+     */
+    constructor();
+}

package/dist/esm/errors/InvalidDeferredActionNonceError.js

@@ -0,0 +1,19 @@
+import { BaseError } from "@alchemy/common";
+/**
+ * Error class denoting that the deferred action nonce used is invalid.
+ */
+export class InvalidDeferredActionNonceError extends BaseError {
+    /**
+     * Initializes a new instance of the error message with a default message indicating that the provided deferred action nonce is invalid.
+     */
+    constructor() {
+        super(`The provided deferred action nonce is invalid`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "InvalidDeferredActionNonce"
+        });
+    }
+}
+//# sourceMappingURL=InvalidDeferredActionNonceError.js.map

package/dist/esm/errors/InvalidDeferredActionNonceError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidDeferredActionNonceError.js","sourceRoot":"","sources":["../../../src/errors/InvalidDeferredActionNonceError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAO,+BAAgC,SAAQ,SAAS;IAG5D;;OAEG;IACH;QACE,KAAK,CAAC,+CAA+C,CAAC,CAAC;QANhD;;;;mBAAO,4BAA4B;WAAC;IAO7C,CAAC;CACF","sourcesContent":["import { BaseError } from \"@alchemy/common\";\n\n/**\n * Error class denoting that the deferred action nonce used is invalid.\n */\nexport class InvalidDeferredActionNonceError extends BaseError {\n  override name = \"InvalidDeferredActionNonce\";\n\n  /**\n   * Initializes a new instance of the error message with a default message indicating that the provided deferred action nonce is invalid.\n   */\n  constructor() {\n    super(`The provided deferred action nonce is invalid`);\n  }\n}\n"]}

package/dist/esm/errors/InvalidEntityIdError.d.ts

@@ -0,0 +1,13 @@
+import { BaseError } from "@alchemy/common";
+/**
+ * Error class denoting that the provided entity id is invalid because it's too large.
+ */
+export declare class InvalidEntityIdError extends BaseError {
+    name: string;
+    /**
+     * 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);
+}

package/dist/esm/errors/InvalidEntityIdError.js

@@ -0,0 +1,21 @@
+import { BaseError } from "@alchemy/common";
+/**
+ * Error class denoting that the provided entity id is invalid because it's too large.
+ */
+export class InvalidEntityIdError extends BaseError {
+    /**
+     * 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) {
+        super(`Entity ID used is ${entityId}, but must be less than or equal to uint32.max`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "InvalidEntityIdError"
+        });
+    }
+}
+//# sourceMappingURL=InvalidEntityIdError.js.map

package/dist/esm/errors/InvalidEntityIdError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidEntityIdError.js","sourceRoot":"","sources":["../../../src/errors/InvalidEntityIdError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IAGjD;;;;OAIG;IACH,YAAY,QAAgB;QAC1B,KAAK,CACH,qBAAqB,QAAQ,gDAAgD,CAC9E,CAAC;QAVK;;;;mBAAO,sBAAsB;WAAC;IAWvC,CAAC;CACF","sourcesContent":["import { BaseError } from \"@alchemy/common\";\n\n/**\n * Error class denoting that the provided entity id is invalid because it's too large.\n */\nexport class InvalidEntityIdError extends BaseError {\n  override name = \"InvalidEntityIdError\";\n\n  /**\n   * Initializes a new instance of the error message with a default message indicating that the entity id is invalid because it's too large.\n   *\n   * @param {number} entityId the invalid entityId used\n   */\n  constructor(entityId: number) {\n    super(\n      `Entity ID used is ${entityId}, but must be less than or equal to uint32.max`,\n    );\n  }\n}\n"]}

package/dist/esm/errors/InvalidNonceKeyError.d.ts

@@ -0,0 +1,13 @@
+import { BaseError } from "@alchemy/common";
+/**
+ * Error class denoting that the nonce key is invalid because its too large.
+ */
+export declare class InvalidNonceKeyError extends BaseError {
+    name: string;
+    /**
+     * 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);
+}

package/dist/esm/errors/InvalidNonceKeyError.js

@@ -0,0 +1,21 @@
+import { BaseError } from "@alchemy/common";
+/**
+ * Error class denoting that the nonce key is invalid because its too large.
+ */
+export class InvalidNonceKeyError extends BaseError {
+    /**
+     * 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) {
+        super(`Nonce key is ${nonceKey} but has to be less than or equal to 2**152`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "InvalidNonceKeyError"
+        });
+    }
+}
+//# sourceMappingURL=InvalidNonceKeyError.js.map

package/dist/esm/errors/InvalidNonceKeyError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidNonceKeyError.js","sourceRoot":"","sources":["../../../src/errors/InvalidNonceKeyError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,SAAS;IAGjD;;;;OAIG;IACH,YAAY,QAAgB;QAC1B,KAAK,CACH,gBAAgB,QAAQ,6CAA6C,CACtE,CAAC;QAVK;;;;mBAAO,sBAAsB;WAAC;IAWvC,CAAC;CACF","sourcesContent":["import { BaseError } from \"@alchemy/common\";\n\n/**\n * Error class denoting that the nonce key is invalid because its too large.\n */\nexport class InvalidNonceKeyError extends BaseError {\n  override name = \"InvalidNonceKeyError\";\n\n  /**\n   * Initializes a new instance of the error message with a default message indicating that the nonce key is invalid.\n   *\n   * @param {bigint} nonceKey the invalid nonceKey used\n   */\n  constructor(nonceKey: bigint) {\n    super(\n      `Nonce key is ${nonceKey} but has to be less than or equal to 2**152`,\n    );\n  }\n}\n"]}

package/dist/esm/errors/InvalidOwnerError.d.ts

@@ -0,0 +1,13 @@
+import { BaseError } from "@alchemy/common";
+/**
+ * Error class denoting that the owner for an account is invalid
+ */
+export declare class InvalidOwnerError extends BaseError {
+    name: string;
+    /**
+     * Initializes a new instance of the error message with a default message indicating that the owner is invalid
+     *
+     * @param {string} reason the reason the owner is invalid
+     */
+    constructor(reason: string);
+}

package/dist/esm/errors/InvalidOwnerError.js

@@ -0,0 +1,21 @@
+import { BaseError } from "@alchemy/common";
+/**
+ * Error class denoting that the owner for an account is invalid
+ */
+export class InvalidOwnerError extends BaseError {
+    /**
+     * Initializes a new instance of the error message with a default message indicating that the owner is invalid
+     *
+     * @param {string} reason the reason the owner is invalid
+     */
+    constructor(reason) {
+        super(`Owner is invalid (${reason}).`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "InvalidOwnerError"
+        });
+    }
+}
+//# sourceMappingURL=InvalidOwnerError.js.map

package/dist/esm/errors/InvalidOwnerError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvalidOwnerError.js","sourceRoot":"","sources":["../../../src/errors/InvalidOwnerError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;IAG9C;;;;OAIG;IACH,YAAY,MAAc;QACxB,KAAK,CAAC,qBAAqB,MAAM,IAAI,CAAC,CAAC;QARhC;;;;mBAAO,mBAAmB;WAAC;IASpC,CAAC;CACF","sourcesContent":["import { BaseError } from \"@alchemy/common\";\n\n/**\n * Error class denoting that the owner for an account is invalid\n */\nexport class InvalidOwnerError extends BaseError {\n  override name = \"InvalidOwnerError\";\n\n  /**\n   * Initializes a new instance of the error message with a default message indicating that the owner is invalid\n   *\n   * @param {string} reason the reason the owner is invalid\n   */\n  constructor(reason: string) {\n    super(`Owner is invalid (${reason}).`);\n  }\n}\n"]}

package/dist/esm/errors/permissionBuilderErrors.d.ts

@@ -0,0 +1,150 @@
+import { BaseError } from "@alchemy/common";
+import type { Permission } from "../ma-v2/permissionBuilder.js";
+import type { Address } from "viem";
+/**
+ * Abstract class representing a Permission Builder Error, subclassed by all permission builder errors.
+ */
+export declare abstract class PermissionBuilderError extends BaseError {
+}
+/**
+ * Error class for when a root permission is added to a permission builder.
+ */
+export declare class RootPermissionOnlyError extends PermissionBuilderError {
+    name: string;
+    /**
+     * Constructor for initializing an error message indicating that the root permission cannot be combined with other permissions.
+     *
+     * @param {Permission} permission The permission trying to be added atop the root permission
+     */
+    constructor(permission: Permission);
+}
+/**
+ * Error class for when an account address is used as target.
+ */
+export declare class AccountAddressAsTargetError extends PermissionBuilderError {
+    name: string;
+    /**
+     * Constructor for initializing an error message indicating that account address is used as target.
+     *
+     * @param {Permission} permission The permission with account address as target
+     */
+    constructor(permission: Permission);
+}
+/**
+ * Error class for when a duplicate target address is added to a permission builder.
+ */
+export declare class DuplicateTargetAddressError extends PermissionBuilderError {
+    name: string;
+    /**
+     * Constructor for initializing an error message indicating duplicate target address in permissions.
+     *
+     * @param {Permission} permission The permission with duplicate target address
+     * @param {Address} targetAddress The duplicate target address
+     */
+    constructor(permission: Permission, targetAddress: Address);
+}
+/**
+ * Error class for when no functions are provided to a permission builder.
+ */
+export declare class NoFunctionsProvidedError extends PermissionBuilderError {
+    name: string;
+    /**
+     * Constructor for initializing an error message indicating no functions were provided.
+     *
+     * @param {Permission} permission The permission missing functions
+     */
+    constructor(permission: Permission);
+}
+/**
+ * Error class for when a deadline is expired.
+ */
+export declare class ExpiredDeadlineError extends PermissionBuilderError {
+    name: string;
+    /**
+     * Constructor for initializing an error message indicating the deadline has expired.
+     *
+     * @param {number} deadline The expired deadline timestamp
+     * @param {number} currentTime The current timestamp
+     */
+    constructor(deadline: number, currentTime: number);
+}
+/**
+ * Error class for when a deadline is over the limit.
+ */
+export declare class DeadlineOverLimitError extends PermissionBuilderError {
+    name: string;
+    /**
+     * Constructor for initializing an error message indicating the deadline has expired.
+     *
+     * @param {number} deadline The expired deadline timestamp
+     */
+    constructor(deadline: number);
+}
+/**
+ * Error class for when a validation config is unset.
+ */
+export declare class ValidationConfigUnsetError extends PermissionBuilderError {
+    name: string;
+    /**
+     * Constructor for initializing an error message indicating the validation config is unset.
+     */
+    constructor();
+}
+/**
+ * Error class for when a multiple native token transfer permission is added to a permission builder.
+ */
+export declare class MultipleNativeTokenTransferError extends PermissionBuilderError {
+    name: string;
+    /**
+     * Constructor for initializing an error message indicating multiple native token transfer permissions.
+     *
+     * @param {Permission} permission The duplicate native token transfer permission
+     */
+    constructor(permission: Permission);
+}
+/**
+ * Error class for when a zero address is provided to a permission builder.
+ */
+export declare class ZeroAddressError extends PermissionBuilderError {
+    name: string;
+    /**
+     * Constructor for initializing an error message indicating zero address was provided.
+     *
+     * @param {Permission} permission The permission with zero address
+     */
+    constructor(permission: Permission);
+}
+/**
+ * Error class for when a multiple gas limit permission is added to a permission builder.
+ */
+export declare class MultipleGasLimitError extends PermissionBuilderError {
+    name: string;
+    /**
+     * Constructor for initializing an error message indicating multiple gas limit permissions.
+     *
+     * @param {Permission} permission The duplicate gas limit permission
+     */
+    constructor(permission: Permission);
+}
+/**
+ * Error class for when an unsupported permission type is added to a permission builder.
+ */
+export declare class UnsupportedPermissionTypeError extends PermissionBuilderError {
+    name: string;
+    /**
+     * Constructor for initializing an error message indicating an unsupported permission type.
+     */
+    constructor();
+}
+/**
+ * Error class for when a selector is not allowed.
+ */
+export declare class SelectorNotAllowed extends PermissionBuilderError {
+    name: string;
+    /**
+     * Constructor for initializing an error message indicating that the selector being added is not allowed.
+     *
+     * @param {string} functionName The function name of the selector that is being added.
+     */
+    constructor(functionName: string);
+}

package/dist/esm/errors/permissionBuilderErrors.js

@@ -0,0 +1,233 @@
+import { BaseError } from "@alchemy/common";
+/**
+ * Abstract class representing a Permission Builder Error, subclassed by all permission builder errors.
+ */
+export class PermissionBuilderError extends BaseError {
+}
+/**
+ * Error class for when a root permission is added to a permission builder.
+ */
+export class RootPermissionOnlyError extends PermissionBuilderError {
+    /**
+     * Constructor for initializing an error message indicating that the root permission cannot be combined with other permissions.
+     *
+     * @param {Permission} permission The permission trying to be added atop the root permission
+     */
+    constructor(permission) {
+        super(`Adding ${permission.type}: Cannot add permissions with ROOT permission`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "PermissionBuilder: RootPermissionOnlyError"
+        });
+    }
+}
+/**
+ * Error class for when an account address is used as target.
+ */
+export class AccountAddressAsTargetError extends PermissionBuilderError {
+    /**
+     * Constructor for initializing an error message indicating that account address is used as target.
+     *
+     * @param {Permission} permission The permission with account address as target
+     */
+    constructor(permission) {
+        super(`${permission.type}: Account address as target, use ACCOUNT_FUNCTIONS for account address`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "PermissionBuilder: AccountAddressAsTargetError"
+        });
+    }
+}
+/**
+ * Error class for when a duplicate target address is added to a permission builder.
+ */
+export class DuplicateTargetAddressError extends PermissionBuilderError {
+    /**
+     * Constructor for initializing an error message indicating duplicate target address in permissions.
+     *
+     * @param {Permission} permission The permission with duplicate target address
+     * @param {Address} targetAddress The duplicate target address
+     */
+    constructor(permission, targetAddress) {
+        super(`${permission.type}: Address ${targetAddress} already has a permission. Cannot add multiple CONTRACT_ACCESS or FUNCTIONS_ON_CONTRACT permissions for the same target address.`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "PermissionBuilder: DuplicateTargetAddressError"
+        });
+    }
+}
+/**
+ * Error class for when no functions are provided to a permission builder.
+ */
+export class NoFunctionsProvidedError extends PermissionBuilderError {
+    /**
+     * Constructor for initializing an error message indicating no functions were provided.
+     *
+     * @param {Permission} permission The permission missing functions
+     */
+    constructor(permission) {
+        super(`${permission.type}: No functions provided`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "PermissionBuilder: NoFunctionsProvidedError"
+        });
+    }
+}
+/**
+ * Error class for when a deadline is expired.
+ */
+export class ExpiredDeadlineError extends PermissionBuilderError {
+    /**
+     * Constructor for initializing an error message indicating the deadline has expired.
+     *
+     * @param {number} deadline The expired deadline timestamp
+     * @param {number} currentTime The current timestamp
+     */
+    constructor(deadline, currentTime) {
+        super(`compileDeferred(): deadline ${deadline} cannot be before now (${currentTime})`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "PermissionBuilder: ExpiredDeadlineError"
+        });
+    }
+}
+/**
+ * Error class for when a deadline is over the limit.
+ */
+export class DeadlineOverLimitError extends PermissionBuilderError {
+    /**
+     * Constructor for initializing an error message indicating the deadline has expired.
+     *
+     * @param {number} deadline The expired deadline timestamp
+     */
+    constructor(deadline) {
+        super(`compileDeferred(): deadline ${deadline} cannot be > max uint48 (2^48 - 1)`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "PermissionBuilder: DeadlineOverLimitError"
+        });
+    }
+}
+/**
+ * Error class for when a validation config is unset.
+ */
+export class ValidationConfigUnsetError extends PermissionBuilderError {
+    /**
+     * Constructor for initializing an error message indicating the validation config is unset.
+     */
+    constructor() {
+        super("Missing permission among: functions on contract, functions on all contracts, account functions, contract access, or erc20 token transfer");
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "PermissionBuilder: ValidationConfigUnsetError"
+        });
+    }
+}
+/**
+ * Error class for when a multiple native token transfer permission is added to a permission builder.
+ */
+export class MultipleNativeTokenTransferError extends PermissionBuilderError {
+    /**
+     * Constructor for initializing an error message indicating multiple native token transfer permissions.
+     *
+     * @param {Permission} permission The duplicate native token transfer permission
+     */
+    constructor(permission) {
+        super(`${permission.type}: Must have at most ONE native token transfer permission`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "PermissionBuilder: MultipleNativeTokenTransferError"
+        });
+    }
+}
+/**
+ * Error class for when a zero address is provided to a permission builder.
+ */
+export class ZeroAddressError extends PermissionBuilderError {
+    /**
+     * Constructor for initializing an error message indicating zero address was provided.
+     *
+     * @param {Permission} permission The permission with zero address
+     */
+    constructor(permission) {
+        super(`${permission.type}: Zero address provided`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "PermissionBuilder: ZeroAddressError"
+        });
+    }
+}
+/**
+ * Error class for when a multiple gas limit permission is added to a permission builder.
+ */
+export class MultipleGasLimitError extends PermissionBuilderError {
+    /**
+     * Constructor for initializing an error message indicating multiple gas limit permissions.
+     *
+     * @param {Permission} permission The duplicate gas limit permission
+     */
+    constructor(permission) {
+        super(`${permission.type}: Must have at most ONE gas limit permission`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "PermissionBuilder: MultipleGasLimitError"
+        });
+    }
+}
+/**
+ * Error class for when an unsupported permission type is added to a permission builder.
+ */
+export class UnsupportedPermissionTypeError extends PermissionBuilderError {
+    /**
+     * Constructor for initializing an error message indicating an unsupported permission type.
+     */
+    constructor() {
+        super(`Unsupported permission type`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "PermissionBuilder: UnsupportedPermissionTypeError"
+        });
+    }
+}
+/**
+ * Error class for when a selector is not allowed.
+ */
+export class SelectorNotAllowed extends PermissionBuilderError {
+    /**
+     * Constructor for initializing an error message indicating that the selector being added is not allowed.
+     *
+     * @param {string} functionName The function name of the selector that is being added.
+     */
+    constructor(functionName) {
+        super(`Cannot add ${functionName} on the account`);
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: "SelectorNotAllowed"
+        });
+    }
+}
+//# sourceMappingURL=permissionBuilderErrors.js.map

package/dist/esm/errors/permissionBuilderErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissionBuilderErrors.js","sourceRoot":"","sources":["../../../src/errors/permissionBuilderErrors.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseError } from \"@alchemy/common\";\nimport type { Permission } from \"../ma-v2/permissionBuilder.js\";\nimport type { Address } from \"viem\";\n\n/**\n * Abstract class representing a Permission Builder Error, subclassed by all permission builder errors.\n */\nexport abstract class PermissionBuilderError extends BaseError {}\n\n/**\n * Error class for when a root permission is added to a permission builder.\n */\nexport class RootPermissionOnlyError extends PermissionBuilderError {\n  override name = \"PermissionBuilder: RootPermissionOnlyError\";\n\n  /**\n   * Constructor for initializing an error message indicating that the root permission cannot be combined with other permissions.\n   *\n   * @param {Permission} permission The permission trying to be added atop the root permission\n   */\n  constructor(permission: Permission) {\n    super(\n      `Adding ${permission.type}: Cannot add permissions with ROOT permission`,\n    );\n  }\n}\n\n/**\n * Error class for when an account address is used as target.\n */\nexport class AccountAddressAsTargetError extends PermissionBuilderError {\n  override name = \"PermissionBuilder: AccountAddressAsTargetError\";\n\n  /**\n   * Constructor for initializing an error message indicating that account address is used as target.\n   *\n   * @param {Permission} permission The permission with account address as target\n   */\n  constructor(permission: Permission) {\n    super(\n      `${permission.type}: Account address as target, use ACCOUNT_FUNCTIONS for account address`,\n    );\n  }\n}\n\n/**\n * Error class for when a duplicate target address is added to a permission builder.\n */\nexport class DuplicateTargetAddressError extends PermissionBuilderError {\n  override name = \"PermissionBuilder: DuplicateTargetAddressError\";\n\n  /**\n   * Constructor for initializing an error message indicating duplicate target address in permissions.\n   *\n   * @param {Permission} permission The permission with duplicate target address\n   * @param {Address} targetAddress The duplicate target address\n   */\n  constructor(permission: Permission, targetAddress: Address) {\n    super(\n      `${permission.type}: Address ${targetAddress} already has a permission. Cannot add multiple CONTRACT_ACCESS or FUNCTIONS_ON_CONTRACT permissions for the same target address.`,\n    );\n  }\n}\n\n/**\n * Error class for when no functions are provided to a permission builder.\n */\nexport class NoFunctionsProvidedError extends PermissionBuilderError {\n  override name = \"PermissionBuilder: NoFunctionsProvidedError\";\n\n  /**\n   * Constructor for initializing an error message indicating no functions were provided.\n   *\n   * @param {Permission} permission The permission missing functions\n   */\n  constructor(permission: Permission) {\n    super(`${permission.type}: No functions provided`);\n  }\n}\n\n/**\n * Error class for when a deadline is expired.\n */\nexport class ExpiredDeadlineError extends PermissionBuilderError {\n  override name = \"PermissionBuilder: ExpiredDeadlineError\";\n\n  /**\n   * Constructor for initializing an error message indicating the deadline has expired.\n   *\n   * @param {number} deadline The expired deadline timestamp\n   * @param {number} currentTime The current timestamp\n   */\n  constructor(deadline: number, currentTime: number) {\n    super(\n      `compileDeferred(): deadline ${deadline} cannot be before now (${currentTime})`,\n    );\n  }\n}\n\n/**\n * Error class for when a deadline is over the limit.\n */\nexport class DeadlineOverLimitError extends PermissionBuilderError {\n  override name = \"PermissionBuilder: DeadlineOverLimitError\";\n\n  /**\n   * Constructor for initializing an error message indicating the deadline has expired.\n   *\n   * @param {number} deadline The expired deadline timestamp\n   */\n  constructor(deadline: number) {\n    super(\n      `compileDeferred(): deadline ${deadline} cannot be > max uint48 (2^48 - 1)`,\n    );\n  }\n}\n\n/**\n * Error class for when a validation config is unset.\n */\nexport class ValidationConfigUnsetError extends PermissionBuilderError {\n  override name = \"PermissionBuilder: ValidationConfigUnsetError\";\n\n  /**\n   * Constructor for initializing an error message indicating the validation config is unset.\n   */\n  constructor() {\n    super(\n      \"Missing permission among: functions on contract, functions on all contracts, account functions, contract access, or erc20 token transfer\",\n    );\n  }\n}\n\n/**\n * Error class for when a multiple native token transfer permission is added to a permission builder.\n */\nexport class MultipleNativeTokenTransferError extends PermissionBuilderError {\n  override name = \"PermissionBuilder: MultipleNativeTokenTransferError\";\n\n  /**\n   * Constructor for initializing an error message indicating multiple native token transfer permissions.\n   *\n   * @param {Permission} permission The duplicate native token transfer permission\n   */\n  constructor(permission: Permission) {\n    super(\n      `${permission.type}: Must have at most ONE native token transfer permission`,\n    );\n  }\n}\n\n/**\n * Error class for when a zero address is provided to a permission builder.\n */\nexport class ZeroAddressError extends PermissionBuilderError {\n  override name = \"PermissionBuilder: ZeroAddressError\";\n\n  /**\n   * Constructor for initializing an error message indicating zero address was provided.\n   *\n   * @param {Permission} permission The permission with zero address\n   */\n  constructor(permission: Permission) {\n    super(`${permission.type}: Zero address provided`);\n  }\n}\n\n/**\n * Error class for when a multiple gas limit permission is added to a permission builder.\n */\nexport class MultipleGasLimitError extends PermissionBuilderError {\n  override name = \"PermissionBuilder: MultipleGasLimitError\";\n\n  /**\n   * Constructor for initializing an error message indicating multiple gas limit permissions.\n   *\n   * @param {Permission} permission The duplicate gas limit permission\n   */\n  constructor(permission: Permission) {\n    super(`${permission.type}: Must have at most ONE gas limit permission`);\n  }\n}\n\n/**\n * Error class for when an unsupported permission type is added to a permission builder.\n */\nexport class UnsupportedPermissionTypeError extends PermissionBuilderError {\n  override name = \"PermissionBuilder: UnsupportedPermissionTypeError\";\n\n  /**\n   * Constructor for initializing an error message indicating an unsupported permission type.\n   */\n  constructor() {\n    super(`Unsupported permission type`);\n  }\n}\n\n/**\n * Error class for when a selector is not allowed.\n */\nexport class SelectorNotAllowed extends PermissionBuilderError {\n  override name = \"SelectorNotAllowed\";\n\n  /**\n   * Constructor for initializing an error message indicating that the selector being added is not allowed.\n   *\n   * @param {string} functionName The function name of the selector that is being added.\n   */\n  constructor(functionName: string) {\n    super(`Cannot add ${functionName} on the account`);\n  }\n}\n"]}