@metamask/snaps-sdk 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -6,9 +6,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.1.0]
+### Added
+- Add Snap error wrappers of JSON-RPC errors ([#1924](https://github.com/MetaMask/snaps/pull/1924))
+
 ## [1.0.0]
 ### Added
 - Initial release of this package.
 
-[Unreleased]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-sdk@1.0.0...HEAD
+[Unreleased]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-sdk@1.1.0...HEAD
+[1.1.0]: https://github.com/MetaMask/snaps/compare/@metamask/snaps-sdk@1.0.0...@metamask/snaps-sdk@1.1.0
 [1.0.0]: https://github.com/MetaMask/snaps/releases/tag/@metamask/snaps-sdk@1.0.0

package/dist/cjs/error-wrappers.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    InternalError: function() {
+        return InternalError;
+    },
+    InvalidInputError: function() {
+        return InvalidInputError;
+    },
+    InvalidParamsError: function() {
+        return InvalidParamsError;
+    },
+    InvalidRequestError: function() {
+        return InvalidRequestError;
+    },
+    LimitExceededError: function() {
+        return LimitExceededError;
+    },
+    MethodNotFoundError: function() {
+        return MethodNotFoundError;
+    },
+    MethodNotSupportedError: function() {
+        return MethodNotSupportedError;
+    },
+    ParseError: function() {
+        return ParseError;
+    },
+    ResourceNotFoundError: function() {
+        return ResourceNotFoundError;
+    },
+    ResourceUnavailableError: function() {
+        return ResourceUnavailableError;
+    },
+    TransactionRejected: function() {
+        return TransactionRejected;
+    },
+    ChainDisconnectedError: function() {
+        return ChainDisconnectedError;
+    },
+    DisconnectedError: function() {
+        return DisconnectedError;
+    },
+    UnauthorizedError: function() {
+        return UnauthorizedError;
+    },
+    UnsupportedMethodError: function() {
+        return UnsupportedMethodError;
+    },
+    UserRejectedRequestError: function() {
+        return UserRejectedRequestError;
+    }
+});
+const _rpcerrors = require("@metamask/rpc-errors");
+const _internals = require("./internals");
+const InternalError = (0, _internals.createSnapError)(_rpcerrors.rpcErrors.internal);
+const InvalidInputError = (0, _internals.createSnapError)(_rpcerrors.rpcErrors.invalidInput);
+const InvalidParamsError = (0, _internals.createSnapError)(_rpcerrors.rpcErrors.invalidParams);
+const InvalidRequestError = (0, _internals.createSnapError)(_rpcerrors.rpcErrors.invalidRequest);
+const LimitExceededError = (0, _internals.createSnapError)(_rpcerrors.rpcErrors.limitExceeded);
+const MethodNotFoundError = (0, _internals.createSnapError)(_rpcerrors.rpcErrors.methodNotFound);
+const MethodNotSupportedError = (0, _internals.createSnapError)(_rpcerrors.rpcErrors.methodNotSupported);
+const ParseError = (0, _internals.createSnapError)(_rpcerrors.rpcErrors.parse);
+const ResourceNotFoundError = (0, _internals.createSnapError)(_rpcerrors.rpcErrors.resourceNotFound);
+const ResourceUnavailableError = (0, _internals.createSnapError)(_rpcerrors.rpcErrors.resourceUnavailable);
+const TransactionRejected = (0, _internals.createSnapError)(_rpcerrors.rpcErrors.transactionRejected);
+const ChainDisconnectedError = (0, _internals.createSnapError)(_rpcerrors.providerErrors.chainDisconnected);
+const DisconnectedError = (0, _internals.createSnapError)(_rpcerrors.providerErrors.disconnected);
+const UnauthorizedError = (0, _internals.createSnapError)(_rpcerrors.providerErrors.unauthorized);
+const UnsupportedMethodError = (0, _internals.createSnapError)(_rpcerrors.providerErrors.unsupportedMethod);
+const UserRejectedRequestError = (0, _internals.createSnapError)(_rpcerrors.providerErrors.userRejectedRequest);
+
+//# sourceMappingURL=error-wrappers.js.map

package/dist/cjs/error-wrappers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/error-wrappers.ts"],"sourcesContent":["import { providerErrors, rpcErrors } from '@metamask/rpc-errors';\n\nimport { createSnapError } from './internals';\n\n/**\n * A JSON-RPC 2.0 Internal (-32603) error.\n *\n * This can be thrown by a Snap to indicate that an internal error occurred,\n * without crashing the Snap.\n *\n * @see https://www.jsonrpc.org/specification#error_object\n */\nexport const InternalError = createSnapError(rpcErrors.internal);\n\n/**\n * An Ethereum JSON-RPC Invalid Input (-32000) error.\n *\n * This can be thrown by a Snap to indicate that the input to a method is\n * invalid, without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes\n */\nexport const InvalidInputError = createSnapError(rpcErrors.invalidInput);\n\n/**\n * A JSON-RPC 2.0 Invalid Params (-32602) error.\n *\n * This can be thrown by a Snap to indicate that the parameters to a method are\n * invalid, without crashing the Snap.\n *\n * @see https://www.jsonrpc.org/specification#error_object\n */\nexport const InvalidParamsError = createSnapError(rpcErrors.invalidParams);\n\n/**\n * A JSON-RPC 2.0 Invalid Request (-32600) error.\n *\n * This can be thrown by a Snap to indicate that the request is invalid, without\n * crashing the Snap.\n *\n * @see https://www.jsonrpc.org/specification#error_object\n */\nexport const InvalidRequestError = createSnapError(rpcErrors.invalidRequest);\n\n/**\n * An Ethereum JSON-RPC Limit Exceeded (-32005) error.\n *\n * This can be thrown by a Snap to indicate that a limit has been exceeded,\n * without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes\n */\nexport const LimitExceededError = createSnapError(rpcErrors.limitExceeded);\n\n/**\n * An Ethereum JSON-RPC Method Not Found (-32601) error.\n *\n * This can be thrown by a Snap to indicate that a method does not exist,\n * without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes\n */\nexport const MethodNotFoundError = createSnapError(rpcErrors.methodNotFound);\n\n/**\n * An Ethereum JSON-RPC Method Not Supported (-32004) error.\n *\n * This can be thrown by a Snap to indicate that a method is not supported,\n * without crashing the Snap.\n */\nexport const MethodNotSupportedError = createSnapError(\n  rpcErrors.methodNotSupported,\n);\n\n/**\n * A JSON-RPC 2.0 Parse (-32700) error.\n *\n * This can be thrown by a Snap to indicate that a request is not valid JSON,\n * without crashing the Snap.\n *\n * @see https://www.jsonrpc.org/specification#error_object\n */\nexport const ParseError = createSnapError(rpcErrors.parse);\n\n/**\n * An Ethereum JSON-RPC Resource Not Found (-32001) error.\n *\n * This can be thrown by a Snap to indicate that a resource does not exist,\n * without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes\n */\nexport const ResourceNotFoundError = createSnapError(\n  rpcErrors.resourceNotFound,\n);\n\n/**\n * An Ethereum JSON-RPC Resource Unavailable (-32002) error.\n *\n * This can be thrown by a Snap to indicate that a resource is unavailable,\n * without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes\n */\nexport const ResourceUnavailableError = createSnapError(\n  rpcErrors.resourceUnavailable,\n);\n\n/**\n * An Ethereum JSON-RPC Transaction Rejected (-32003) error.\n *\n * This can be thrown by a Snap to indicate that a transaction was rejected,\n * without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes\n */\nexport const TransactionRejected = createSnapError(\n  rpcErrors.transactionRejected,\n);\n\n/**\n * An Ethereum Provider Chain Disconnected (4901) error.\n *\n * This can be thrown by a Snap to indicate that the provider is disconnected\n * from the requested chain, without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors\n */\nexport const ChainDisconnectedError = createSnapError(\n  providerErrors.chainDisconnected,\n);\n\n/**\n * An Ethereum Provider Disconnected (4900) error.\n *\n * This can be thrown by a Snap to indicate that the provider is disconnected,\n * without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors\n */\nexport const DisconnectedError = createSnapError(providerErrors.disconnected);\n\n/**\n * An Ethereum Provider Unauthorized (4100) error.\n *\n * This can be thrown by a Snap to indicate that the requested method / account\n * is not authorized by the user, without crashing the Snap.\n */\nexport const UnauthorizedError = createSnapError(providerErrors.unauthorized);\n\n/**\n * An Ethereum Provider Unsupported Method (4200) error.\n *\n * This can be thrown by a Snap to indicate that the requested method is not\n * supported by the provider, without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors\n */\nexport const UnsupportedMethodError = createSnapError(\n  providerErrors.unsupportedMethod,\n);\n\n/**\n * An Ethereum Provider User Rejected Request (4001) error.\n *\n * This can be thrown by a Snap to indicate that the user rejected the request,\n * without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors\n */\nexport const UserRejectedRequestError = createSnapError(\n  providerErrors.userRejectedRequest,\n);\n"],"names":["InternalError","InvalidInputError","InvalidParamsError","InvalidRequestError","LimitExceededError","MethodNotFoundError","MethodNotSupportedError","ParseError","ResourceNotFoundError","ResourceUnavailableError","TransactionRejected","ChainDisconnectedError","DisconnectedError","UnauthorizedError","UnsupportedMethodError","UserRejectedRequestError","createSnapError","rpcErrors","internal","invalidInput","invalidParams","invalidRequest","limitExceeded","methodNotFound","methodNotSupported","parse","resourceNotFound","resourceUnavailable","transactionRejected","providerErrors","chainDisconnected","disconnected","unauthorized","unsupportedMethod","userRejectedRequest"],"mappings":";;;;;;;;;;;IAYaA,aAAa;eAAbA;;IAUAC,iBAAiB;eAAjBA;;IAUAC,kBAAkB;eAAlBA;;IAUAC,mBAAmB;eAAnBA;;IAUAC,kBAAkB;eAAlBA;;IAUAC,mBAAmB;eAAnBA;;IAQAC,uBAAuB;eAAvBA;;IAYAC,UAAU;eAAVA;;IAUAC,qBAAqB;eAArBA;;IAYAC,wBAAwB;eAAxBA;;IAYAC,mBAAmB;eAAnBA;;IAYAC,sBAAsB;eAAtBA;;IAYAC,iBAAiB;eAAjBA;;IAQAC,iBAAiB;eAAjBA;;IAUAC,sBAAsB;eAAtBA;;IAYAC,wBAAwB;eAAxBA;;;2BA1K6B;2BAEV;AAUzB,MAAMf,gBAAgBgB,IAAAA,0BAAe,EAACC,oBAAS,CAACC,QAAQ;AAUxD,MAAMjB,oBAAoBe,IAAAA,0BAAe,EAACC,oBAAS,CAACE,YAAY;AAUhE,MAAMjB,qBAAqBc,IAAAA,0BAAe,EAACC,oBAAS,CAACG,aAAa;AAUlE,MAAMjB,sBAAsBa,IAAAA,0BAAe,EAACC,oBAAS,CAACI,cAAc;AAUpE,MAAMjB,qBAAqBY,IAAAA,0BAAe,EAACC,oBAAS,CAACK,aAAa;AAUlE,MAAMjB,sBAAsBW,IAAAA,0BAAe,EAACC,oBAAS,CAACM,cAAc;AAQpE,MAAMjB,0BAA0BU,IAAAA,0BAAe,EACpDC,oBAAS,CAACO,kBAAkB;AAWvB,MAAMjB,aAAaS,IAAAA,0BAAe,EAACC,oBAAS,CAACQ,KAAK;AAUlD,MAAMjB,wBAAwBQ,IAAAA,0BAAe,EAClDC,oBAAS,CAACS,gBAAgB;AAWrB,MAAMjB,2BAA2BO,IAAAA,0BAAe,EACrDC,oBAAS,CAACU,mBAAmB;AAWxB,MAAMjB,sBAAsBM,IAAAA,0BAAe,EAChDC,oBAAS,CAACW,mBAAmB;AAWxB,MAAMjB,yBAAyBK,IAAAA,0BAAe,EACnDa,yBAAc,CAACC,iBAAiB;AAW3B,MAAMlB,oBAAoBI,IAAAA,0BAAe,EAACa,yBAAc,CAACE,YAAY;AAQrE,MAAMlB,oBAAoBG,IAAAA,0BAAe,EAACa,yBAAc,CAACG,YAAY;AAUrE,MAAMlB,yBAAyBE,IAAAA,0BAAe,EACnDa,yBAAc,CAACI,iBAAiB;AAW3B,MAAMlB,2BAA2BC,IAAAA,0BAAe,EACrDa,yBAAc,CAACK,mBAAmB"}

package/dist/cjs/internals/error-wrappers.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "createSnapError", {
+    enumerable: true,
+    get: function() {
+        return createSnapError;
+    }
+});
+const _errors = require("../errors");
+function createSnapError(fn) {
+    return class SnapJsonRpcError extends _errors.SnapError {
+        constructor(message, data){
+            const error = fn(message);
+            super({
+                code: error.code,
+                message: error.message,
+                data
+            });
+        }
+    };
+}
+
+//# sourceMappingURL=error-wrappers.js.map

package/dist/cjs/internals/error-wrappers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/internals/error-wrappers.ts"],"sourcesContent":["import type { rpcErrors } from '@metamask/rpc-errors';\nimport type { Json } from '@metamask/utils';\n\nimport { SnapError } from '../errors';\n\nexport type JsonRpcErrorFunction = typeof rpcErrors.parse;\n\n/**\n * Create a `SnapError` class from an error function from\n * `@metamask/rpc-errors`. This is useful for creating custom error classes\n * which can be thrown by a Snap.\n *\n * The created class will inherit the message, code, and data properties from\n * the error function.\n *\n * @param fn - The error function to create the class from.\n * @returns The created `SnapError` class.\n */\nexport function createSnapError(fn: JsonRpcErrorFunction) {\n  return class SnapJsonRpcError extends SnapError {\n    constructor(message?: string, data?: Record<string, Json>) {\n      const error = fn(message);\n\n      super({\n        code: error.code,\n        message: error.message,\n        data,\n      });\n    }\n  };\n}\n"],"names":["createSnapError","fn","SnapJsonRpcError","SnapError","constructor","message","data","error","code"],"mappings":";;;;+BAkBgBA;;;eAAAA;;;wBAfU;AAenB,SAASA,gBAAgBC,EAAwB;IACtD,OAAO,MAAMC,yBAAyBC,iBAAS;QAC7CC,YAAYC,OAAgB,EAAEC,IAA2B,CAAE;YACzD,MAAMC,QAAQN,GAAGI;YAEjB,KAAK,CAAC;gBACJG,MAAMD,MAAMC,IAAI;gBAChBH,SAASE,MAAMF,OAAO;gBACtBC;YACF;QACF;IACF;AACF"}

package/dist/cjs/internals/index.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", {
     value: true
 });
+_export_star(require("./error-wrappers"), exports);
 _export_star(require("./errors"), exports);
 _export_star(require("./helpers"), exports);
 function _export_star(from, to) {

package/dist/cjs/internals/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/internals/index.ts"],"sourcesContent":["export * from './errors';\nexport * from './helpers';\n"],"names":[],"mappings":";;;;qBAAc;qBACA"}
+{"version":3,"sources":["../../../src/internals/index.ts"],"sourcesContent":["export * from './error-wrappers';\nexport * from './errors';\nexport * from './helpers';\n"],"names":[],"mappings":";;;;qBAAc;qBACA;qBACA"}

package/dist/esm/error-wrappers.js

@@ -0,0 +1,128 @@
+import { providerErrors, rpcErrors } from '@metamask/rpc-errors';
+import { createSnapError } from './internals';
+/**
+ * A JSON-RPC 2.0 Internal (-32603) error.
+ *
+ * This can be thrown by a Snap to indicate that an internal error occurred,
+ * without crashing the Snap.
+ *
+ * @see https://www.jsonrpc.org/specification#error_object
+ */ export const InternalError = createSnapError(rpcErrors.internal);
+/**
+ * An Ethereum JSON-RPC Invalid Input (-32000) error.
+ *
+ * This can be thrown by a Snap to indicate that the input to a method is
+ * invalid, without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes
+ */ export const InvalidInputError = createSnapError(rpcErrors.invalidInput);
+/**
+ * A JSON-RPC 2.0 Invalid Params (-32602) error.
+ *
+ * This can be thrown by a Snap to indicate that the parameters to a method are
+ * invalid, without crashing the Snap.
+ *
+ * @see https://www.jsonrpc.org/specification#error_object
+ */ export const InvalidParamsError = createSnapError(rpcErrors.invalidParams);
+/**
+ * A JSON-RPC 2.0 Invalid Request (-32600) error.
+ *
+ * This can be thrown by a Snap to indicate that the request is invalid, without
+ * crashing the Snap.
+ *
+ * @see https://www.jsonrpc.org/specification#error_object
+ */ export const InvalidRequestError = createSnapError(rpcErrors.invalidRequest);
+/**
+ * An Ethereum JSON-RPC Limit Exceeded (-32005) error.
+ *
+ * This can be thrown by a Snap to indicate that a limit has been exceeded,
+ * without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes
+ */ export const LimitExceededError = createSnapError(rpcErrors.limitExceeded);
+/**
+ * An Ethereum JSON-RPC Method Not Found (-32601) error.
+ *
+ * This can be thrown by a Snap to indicate that a method does not exist,
+ * without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes
+ */ export const MethodNotFoundError = createSnapError(rpcErrors.methodNotFound);
+/**
+ * An Ethereum JSON-RPC Method Not Supported (-32004) error.
+ *
+ * This can be thrown by a Snap to indicate that a method is not supported,
+ * without crashing the Snap.
+ */ export const MethodNotSupportedError = createSnapError(rpcErrors.methodNotSupported);
+/**
+ * A JSON-RPC 2.0 Parse (-32700) error.
+ *
+ * This can be thrown by a Snap to indicate that a request is not valid JSON,
+ * without crashing the Snap.
+ *
+ * @see https://www.jsonrpc.org/specification#error_object
+ */ export const ParseError = createSnapError(rpcErrors.parse);
+/**
+ * An Ethereum JSON-RPC Resource Not Found (-32001) error.
+ *
+ * This can be thrown by a Snap to indicate that a resource does not exist,
+ * without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes
+ */ export const ResourceNotFoundError = createSnapError(rpcErrors.resourceNotFound);
+/**
+ * An Ethereum JSON-RPC Resource Unavailable (-32002) error.
+ *
+ * This can be thrown by a Snap to indicate that a resource is unavailable,
+ * without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes
+ */ export const ResourceUnavailableError = createSnapError(rpcErrors.resourceUnavailable);
+/**
+ * An Ethereum JSON-RPC Transaction Rejected (-32003) error.
+ *
+ * This can be thrown by a Snap to indicate that a transaction was rejected,
+ * without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes
+ */ export const TransactionRejected = createSnapError(rpcErrors.transactionRejected);
+/**
+ * An Ethereum Provider Chain Disconnected (4901) error.
+ *
+ * This can be thrown by a Snap to indicate that the provider is disconnected
+ * from the requested chain, without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors
+ */ export const ChainDisconnectedError = createSnapError(providerErrors.chainDisconnected);
+/**
+ * An Ethereum Provider Disconnected (4900) error.
+ *
+ * This can be thrown by a Snap to indicate that the provider is disconnected,
+ * without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors
+ */ export const DisconnectedError = createSnapError(providerErrors.disconnected);
+/**
+ * An Ethereum Provider Unauthorized (4100) error.
+ *
+ * This can be thrown by a Snap to indicate that the requested method / account
+ * is not authorized by the user, without crashing the Snap.
+ */ export const UnauthorizedError = createSnapError(providerErrors.unauthorized);
+/**
+ * An Ethereum Provider Unsupported Method (4200) error.
+ *
+ * This can be thrown by a Snap to indicate that the requested method is not
+ * supported by the provider, without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors
+ */ export const UnsupportedMethodError = createSnapError(providerErrors.unsupportedMethod);
+/**
+ * An Ethereum Provider User Rejected Request (4001) error.
+ *
+ * This can be thrown by a Snap to indicate that the user rejected the request,
+ * without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors
+ */ export const UserRejectedRequestError = createSnapError(providerErrors.userRejectedRequest);
+
+//# sourceMappingURL=error-wrappers.js.map

package/dist/esm/error-wrappers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/error-wrappers.ts"],"sourcesContent":["import { providerErrors, rpcErrors } from '@metamask/rpc-errors';\n\nimport { createSnapError } from './internals';\n\n/**\n * A JSON-RPC 2.0 Internal (-32603) error.\n *\n * This can be thrown by a Snap to indicate that an internal error occurred,\n * without crashing the Snap.\n *\n * @see https://www.jsonrpc.org/specification#error_object\n */\nexport const InternalError = createSnapError(rpcErrors.internal);\n\n/**\n * An Ethereum JSON-RPC Invalid Input (-32000) error.\n *\n * This can be thrown by a Snap to indicate that the input to a method is\n * invalid, without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes\n */\nexport const InvalidInputError = createSnapError(rpcErrors.invalidInput);\n\n/**\n * A JSON-RPC 2.0 Invalid Params (-32602) error.\n *\n * This can be thrown by a Snap to indicate that the parameters to a method are\n * invalid, without crashing the Snap.\n *\n * @see https://www.jsonrpc.org/specification#error_object\n */\nexport const InvalidParamsError = createSnapError(rpcErrors.invalidParams);\n\n/**\n * A JSON-RPC 2.0 Invalid Request (-32600) error.\n *\n * This can be thrown by a Snap to indicate that the request is invalid, without\n * crashing the Snap.\n *\n * @see https://www.jsonrpc.org/specification#error_object\n */\nexport const InvalidRequestError = createSnapError(rpcErrors.invalidRequest);\n\n/**\n * An Ethereum JSON-RPC Limit Exceeded (-32005) error.\n *\n * This can be thrown by a Snap to indicate that a limit has been exceeded,\n * without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes\n */\nexport const LimitExceededError = createSnapError(rpcErrors.limitExceeded);\n\n/**\n * An Ethereum JSON-RPC Method Not Found (-32601) error.\n *\n * This can be thrown by a Snap to indicate that a method does not exist,\n * without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes\n */\nexport const MethodNotFoundError = createSnapError(rpcErrors.methodNotFound);\n\n/**\n * An Ethereum JSON-RPC Method Not Supported (-32004) error.\n *\n * This can be thrown by a Snap to indicate that a method is not supported,\n * without crashing the Snap.\n */\nexport const MethodNotSupportedError = createSnapError(\n  rpcErrors.methodNotSupported,\n);\n\n/**\n * A JSON-RPC 2.0 Parse (-32700) error.\n *\n * This can be thrown by a Snap to indicate that a request is not valid JSON,\n * without crashing the Snap.\n *\n * @see https://www.jsonrpc.org/specification#error_object\n */\nexport const ParseError = createSnapError(rpcErrors.parse);\n\n/**\n * An Ethereum JSON-RPC Resource Not Found (-32001) error.\n *\n * This can be thrown by a Snap to indicate that a resource does not exist,\n * without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes\n */\nexport const ResourceNotFoundError = createSnapError(\n  rpcErrors.resourceNotFound,\n);\n\n/**\n * An Ethereum JSON-RPC Resource Unavailable (-32002) error.\n *\n * This can be thrown by a Snap to indicate that a resource is unavailable,\n * without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes\n */\nexport const ResourceUnavailableError = createSnapError(\n  rpcErrors.resourceUnavailable,\n);\n\n/**\n * An Ethereum JSON-RPC Transaction Rejected (-32003) error.\n *\n * This can be thrown by a Snap to indicate that a transaction was rejected,\n * without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes\n */\nexport const TransactionRejected = createSnapError(\n  rpcErrors.transactionRejected,\n);\n\n/**\n * An Ethereum Provider Chain Disconnected (4901) error.\n *\n * This can be thrown by a Snap to indicate that the provider is disconnected\n * from the requested chain, without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors\n */\nexport const ChainDisconnectedError = createSnapError(\n  providerErrors.chainDisconnected,\n);\n\n/**\n * An Ethereum Provider Disconnected (4900) error.\n *\n * This can be thrown by a Snap to indicate that the provider is disconnected,\n * without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors\n */\nexport const DisconnectedError = createSnapError(providerErrors.disconnected);\n\n/**\n * An Ethereum Provider Unauthorized (4100) error.\n *\n * This can be thrown by a Snap to indicate that the requested method / account\n * is not authorized by the user, without crashing the Snap.\n */\nexport const UnauthorizedError = createSnapError(providerErrors.unauthorized);\n\n/**\n * An Ethereum Provider Unsupported Method (4200) error.\n *\n * This can be thrown by a Snap to indicate that the requested method is not\n * supported by the provider, without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors\n */\nexport const UnsupportedMethodError = createSnapError(\n  providerErrors.unsupportedMethod,\n);\n\n/**\n * An Ethereum Provider User Rejected Request (4001) error.\n *\n * This can be thrown by a Snap to indicate that the user rejected the request,\n * without crashing the Snap.\n *\n * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors\n */\nexport const UserRejectedRequestError = createSnapError(\n  providerErrors.userRejectedRequest,\n);\n"],"names":["providerErrors","rpcErrors","createSnapError","InternalError","internal","InvalidInputError","invalidInput","InvalidParamsError","invalidParams","InvalidRequestError","invalidRequest","LimitExceededError","limitExceeded","MethodNotFoundError","methodNotFound","MethodNotSupportedError","methodNotSupported","ParseError","parse","ResourceNotFoundError","resourceNotFound","ResourceUnavailableError","resourceUnavailable","TransactionRejected","transactionRejected","ChainDisconnectedError","chainDisconnected","DisconnectedError","disconnected","UnauthorizedError","unauthorized","UnsupportedMethodError","unsupportedMethod","UserRejectedRequestError","userRejectedRequest"],"mappings":"AAAA,SAASA,cAAc,EAAEC,SAAS,QAAQ,uBAAuB;AAEjE,SAASC,eAAe,QAAQ,cAAc;AAE9C;;;;;;;CAOC,GACD,OAAO,MAAMC,gBAAgBD,gBAAgBD,UAAUG,QAAQ,EAAE;AAEjE;;;;;;;CAOC,GACD,OAAO,MAAMC,oBAAoBH,gBAAgBD,UAAUK,YAAY,EAAE;AAEzE;;;;;;;CAOC,GACD,OAAO,MAAMC,qBAAqBL,gBAAgBD,UAAUO,aAAa,EAAE;AAE3E;;;;;;;CAOC,GACD,OAAO,MAAMC,sBAAsBP,gBAAgBD,UAAUS,cAAc,EAAE;AAE7E;;;;;;;CAOC,GACD,OAAO,MAAMC,qBAAqBT,gBAAgBD,UAAUW,aAAa,EAAE;AAE3E;;;;;;;CAOC,GACD,OAAO,MAAMC,sBAAsBX,gBAAgBD,UAAUa,cAAc,EAAE;AAE7E;;;;;CAKC,GACD,OAAO,MAAMC,0BAA0Bb,gBACrCD,UAAUe,kBAAkB,EAC5B;AAEF;;;;;;;CAOC,GACD,OAAO,MAAMC,aAAaf,gBAAgBD,UAAUiB,KAAK,EAAE;AAE3D;;;;;;;CAOC,GACD,OAAO,MAAMC,wBAAwBjB,gBACnCD,UAAUmB,gBAAgB,EAC1B;AAEF;;;;;;;CAOC,GACD,OAAO,MAAMC,2BAA2BnB,gBACtCD,UAAUqB,mBAAmB,EAC7B;AAEF;;;;;;;CAOC,GACD,OAAO,MAAMC,sBAAsBrB,gBACjCD,UAAUuB,mBAAmB,EAC7B;AAEF;;;;;;;CAOC,GACD,OAAO,MAAMC,yBAAyBvB,gBACpCF,eAAe0B,iBAAiB,EAChC;AAEF;;;;;;;CAOC,GACD,OAAO,MAAMC,oBAAoBzB,gBAAgBF,eAAe4B,YAAY,EAAE;AAE9E;;;;;CAKC,GACD,OAAO,MAAMC,oBAAoB3B,gBAAgBF,eAAe8B,YAAY,EAAE;AAE9E;;;;;;;CAOC,GACD,OAAO,MAAMC,yBAAyB7B,gBACpCF,eAAegC,iBAAiB,EAChC;AAEF;;;;;;;CAOC,GACD,OAAO,MAAMC,2BAA2B/B,gBACtCF,eAAekC,mBAAmB,EAClC"}

package/dist/esm/internals/error-wrappers.js

@@ -0,0 +1,25 @@
+import { SnapError } from '../errors';
+/**
+ * Create a `SnapError` class from an error function from
+ * `@metamask/rpc-errors`. This is useful for creating custom error classes
+ * which can be thrown by a Snap.
+ *
+ * The created class will inherit the message, code, and data properties from
+ * the error function.
+ *
+ * @param fn - The error function to create the class from.
+ * @returns The created `SnapError` class.
+ */ export function createSnapError(fn) {
+    return class SnapJsonRpcError extends SnapError {
+        constructor(message, data){
+            const error = fn(message);
+            super({
+                code: error.code,
+                message: error.message,
+                data
+            });
+        }
+    };
+}
+
+//# sourceMappingURL=error-wrappers.js.map

package/dist/esm/internals/error-wrappers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/internals/error-wrappers.ts"],"sourcesContent":["import type { rpcErrors } from '@metamask/rpc-errors';\nimport type { Json } from '@metamask/utils';\n\nimport { SnapError } from '../errors';\n\nexport type JsonRpcErrorFunction = typeof rpcErrors.parse;\n\n/**\n * Create a `SnapError` class from an error function from\n * `@metamask/rpc-errors`. This is useful for creating custom error classes\n * which can be thrown by a Snap.\n *\n * The created class will inherit the message, code, and data properties from\n * the error function.\n *\n * @param fn - The error function to create the class from.\n * @returns The created `SnapError` class.\n */\nexport function createSnapError(fn: JsonRpcErrorFunction) {\n  return class SnapJsonRpcError extends SnapError {\n    constructor(message?: string, data?: Record<string, Json>) {\n      const error = fn(message);\n\n      super({\n        code: error.code,\n        message: error.message,\n        data,\n      });\n    }\n  };\n}\n"],"names":["SnapError","createSnapError","fn","SnapJsonRpcError","constructor","message","data","error","code"],"mappings":"AAGA,SAASA,SAAS,QAAQ,YAAY;AAItC;;;;;;;;;;CAUC,GACD,OAAO,SAASC,gBAAgBC,EAAwB;IACtD,OAAO,MAAMC,yBAAyBH;QACpCI,YAAYC,OAAgB,EAAEC,IAA2B,CAAE;YACzD,MAAMC,QAAQL,GAAGG;YAEjB,KAAK,CAAC;gBACJG,MAAMD,MAAMC,IAAI;gBAChBH,SAASE,MAAMF,OAAO;gBACtBC;YACF;QACF;IACF;AACF"}

package/dist/esm/internals/index.js

@@ -1,3 +1,4 @@
+export * from './error-wrappers';
 export * from './errors';
 export * from './helpers';
 

package/dist/esm/internals/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/internals/index.ts"],"sourcesContent":["export * from './errors';\nexport * from './helpers';\n"],"names":[],"mappings":"AAAA,cAAc,WAAW;AACzB,cAAc,YAAY"}
+{"version":3,"sources":["../../../src/internals/index.ts"],"sourcesContent":["export * from './error-wrappers';\nexport * from './errors';\nexport * from './helpers';\n"],"names":[],"mappings":"AAAA,cAAc,mBAAmB;AACjC,cAAc,WAAW;AACzB,cAAc,YAAY"}

package/dist/types/error-wrappers.d.ts

@@ -0,0 +1,413 @@
+/// <reference types="node" />
+/**
+ * A JSON-RPC 2.0 Internal (-32603) error.
+ *
+ * This can be thrown by a Snap to indicate that an internal error occurred,
+ * without crashing the Snap.
+ *
+ * @see https://www.jsonrpc.org/specification#error_object
+ */
+export declare const InternalError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * An Ethereum JSON-RPC Invalid Input (-32000) error.
+ *
+ * This can be thrown by a Snap to indicate that the input to a method is
+ * invalid, without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes
+ */
+export declare const InvalidInputError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * A JSON-RPC 2.0 Invalid Params (-32602) error.
+ *
+ * This can be thrown by a Snap to indicate that the parameters to a method are
+ * invalid, without crashing the Snap.
+ *
+ * @see https://www.jsonrpc.org/specification#error_object
+ */
+export declare const InvalidParamsError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * A JSON-RPC 2.0 Invalid Request (-32600) error.
+ *
+ * This can be thrown by a Snap to indicate that the request is invalid, without
+ * crashing the Snap.
+ *
+ * @see https://www.jsonrpc.org/specification#error_object
+ */
+export declare const InvalidRequestError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * An Ethereum JSON-RPC Limit Exceeded (-32005) error.
+ *
+ * This can be thrown by a Snap to indicate that a limit has been exceeded,
+ * without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes
+ */
+export declare const LimitExceededError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * An Ethereum JSON-RPC Method Not Found (-32601) error.
+ *
+ * This can be thrown by a Snap to indicate that a method does not exist,
+ * without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes
+ */
+export declare const MethodNotFoundError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * An Ethereum JSON-RPC Method Not Supported (-32004) error.
+ *
+ * This can be thrown by a Snap to indicate that a method is not supported,
+ * without crashing the Snap.
+ */
+export declare const MethodNotSupportedError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * A JSON-RPC 2.0 Parse (-32700) error.
+ *
+ * This can be thrown by a Snap to indicate that a request is not valid JSON,
+ * without crashing the Snap.
+ *
+ * @see https://www.jsonrpc.org/specification#error_object
+ */
+export declare const ParseError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * An Ethereum JSON-RPC Resource Not Found (-32001) error.
+ *
+ * This can be thrown by a Snap to indicate that a resource does not exist,
+ * without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes
+ */
+export declare const ResourceNotFoundError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * An Ethereum JSON-RPC Resource Unavailable (-32002) error.
+ *
+ * This can be thrown by a Snap to indicate that a resource is unavailable,
+ * without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes
+ */
+export declare const ResourceUnavailableError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * An Ethereum JSON-RPC Transaction Rejected (-32003) error.
+ *
+ * This can be thrown by a Snap to indicate that a transaction was rejected,
+ * without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1474#error-codes
+ */
+export declare const TransactionRejected: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * An Ethereum Provider Chain Disconnected (4901) error.
+ *
+ * This can be thrown by a Snap to indicate that the provider is disconnected
+ * from the requested chain, without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors
+ */
+export declare const ChainDisconnectedError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * An Ethereum Provider Disconnected (4900) error.
+ *
+ * This can be thrown by a Snap to indicate that the provider is disconnected,
+ * without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors
+ */
+export declare const DisconnectedError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * An Ethereum Provider Unauthorized (4100) error.
+ *
+ * This can be thrown by a Snap to indicate that the requested method / account
+ * is not authorized by the user, without crashing the Snap.
+ */
+export declare const UnauthorizedError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * An Ethereum Provider Unsupported Method (4200) error.
+ *
+ * This can be thrown by a Snap to indicate that the requested method is not
+ * supported by the provider, without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors
+ */
+export declare const UnsupportedMethodError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};
+/**
+ * An Ethereum Provider User Rejected Request (4001) error.
+ *
+ * This can be thrown by a Snap to indicate that the user rejected the request,
+ * without crashing the Snap.
+ *
+ * @see https://eips.ethereum.org/EIPS/eip-1193#provider-errors
+ */
+export declare const UserRejectedRequestError: {
+    new (message?: string | undefined, data?: Record<string, import("@metamask/utils").Json> | undefined): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, import("@metamask/utils").Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, import("@metamask/utils").Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("./errors").SerializedSnapError;
+        serialize(): import("./errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};

package/dist/types/internals/error-wrappers.d.ts

@@ -0,0 +1,33 @@
+/// <reference types="node" />
+import type { rpcErrors } from '@metamask/rpc-errors';
+import type { Json } from '@metamask/utils';
+export declare type JsonRpcErrorFunction = typeof rpcErrors.parse;
+/**
+ * Create a `SnapError` class from an error function from
+ * `@metamask/rpc-errors`. This is useful for creating custom error classes
+ * which can be thrown by a Snap.
+ *
+ * The created class will inherit the message, code, and data properties from
+ * the error function.
+ *
+ * @param fn - The error function to create the class from.
+ * @returns The created `SnapError` class.
+ */
+export declare function createSnapError(fn: JsonRpcErrorFunction): {
+    new (message?: string, data?: Record<string, Json>): {
+        readonly "__#3@#code": number;
+        readonly "__#3@#message": string;
+        readonly "__#3@#data": Record<string, Json>;
+        readonly "__#3@#stack"?: string | undefined;
+        readonly name: string;
+        readonly code: number;
+        readonly message: string;
+        readonly data: Record<string, Json>;
+        readonly stack: string | undefined;
+        toJSON(): import("../errors").SerializedSnapError;
+        serialize(): import("../errors").SerializedSnapError;
+    };
+    captureStackTrace(targetObject: object, constructorOpt?: Function | undefined): void;
+    prepareStackTrace?: ((err: Error, stackTraces: NodeJS.CallSite[]) => any) | undefined;
+    stackTraceLimit: number;
+};

package/dist/types/internals/index.d.ts

@@ -1,2 +1,3 @@
+export * from './error-wrappers';
 export * from './errors';
 export * from './helpers';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask/snaps-sdk",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/MetaMask/snaps.git"
@@ -37,6 +37,7 @@
   "dependencies": {
     "@metamask/key-tree": "^9.0.0",
     "@metamask/providers": "^13.0.0",
+    "@metamask/rpc-errors": "^6.1.0",
     "@metamask/utils": "^8.1.0",
     "is-svg": "^4.4.0",
     "superstruct": "^1.0.3"
@@ -48,7 +49,6 @@
     "@metamask/eslint-config-jest": "^12.1.0",
     "@metamask/eslint-config-nodejs": "^12.1.0",
     "@metamask/eslint-config-typescript": "^12.1.0",
-    "@metamask/rpc-errors": "^6.1.0",
     "@swc/cli": "^0.1.62",
     "@swc/core": "1.3.78",
     "@swc/jest": "^0.2.26",