@metamask/snaps-utils 0.24.0

package/dist/mock.js

@@ -0,0 +1,107 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateMockEndowments = exports.isConstructor = exports.ALL_APIS = void 0;
+const events_1 = __importDefault(require("events"));
+const crypto_1 = __importDefault(require("crypto"));
+const default_endowments_1 = require("./default-endowments");
+const NETWORK_APIS = ['fetch', 'WebSocket'];
+exports.ALL_APIS = [...default_endowments_1.DEFAULT_ENDOWMENTS, ...NETWORK_APIS];
+/**
+ * Get a mock snap API, that always returns `true` for requests.
+ *
+ * @returns A mocked snap provider.
+ */
+function getMockSnapGlobal() {
+    return { request: async () => true };
+}
+/**
+ * Get a mock Ethereum provider, that always returns `true` for requests.
+ *
+ * @returns A mocked ethereum provider.
+ */
+function getMockEthereumProvider() {
+    const mockProvider = new events_1.default();
+    mockProvider.request = async () => true;
+    return mockProvider;
+}
+/**
+ * Check if a value is a constructor.
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a constructor, or `false` otherwise.
+ */
+const isConstructor = (value) => { var _a, _b; return Boolean(typeof ((_b = (_a = value === null || value === void 0 ? void 0 : value.prototype) === null || _a === void 0 ? void 0 : _a.constructor) === null || _b === void 0 ? void 0 : _b.name) === 'string'); };
+exports.isConstructor = isConstructor;
+/**
+ * A function that always returns `true`.
+ *
+ * @returns `true`.
+ */
+const mockFunction = () => true;
+class MockClass {
+}
+const handler = {
+    construct(Target, args) {
+        return new Proxy(new Target(...args), handler);
+    },
+    get(_target, _prop) {
+        return mockFunction;
+    },
+};
+/**
+ * Generate a mock class for a given value. The value is wrapped in a Proxy, and
+ * all methods are replaced with a mock function.
+ *
+ * @param value - The value to mock.
+ * @returns A mock class.
+ */
+const generateMockClass = (value) => {
+    return new Proxy(value, handler);
+};
+// Things not currently auto-mocked because of NodeJS, by adding them here we
+// have types for them and can use that to generate mocks if needed.
+const mockWindow = {
+    WebSocket: MockClass,
+    crypto: crypto_1.default,
+    SubtleCrypto: MockClass,
+};
+/**
+ * Generate a mock endowment for a certain class or function on the `globalThis`
+ * object.
+ *
+ * @param key - The key to generate the mock endowment for.
+ * @returns A mocked class or function. If the key is part of the default
+ * endowments, the original value is returned.
+ */
+const generateMockEndowment = (key) => {
+    const globalValue = globalThis[key];
+    // Default exposed APIs don't need to be mocked
+    if (globalValue && default_endowments_1.DEFAULT_ENDOWMENTS.includes(key)) {
+        return globalValue;
+    }
+    // Fall back to mockWindow for certain APIs not exposed in global in Node.JS
+    const globalOrMocked = globalValue !== null && globalValue !== void 0 ? globalValue : mockWindow[key];
+    const type = typeof globalOrMocked;
+    const isFunction = type === 'function';
+    if (isFunction && (0, exports.isConstructor)(globalOrMocked)) {
+        return generateMockClass(globalOrMocked);
+    }
+    else if (isFunction || !globalOrMocked) {
+        // Fall back to function mock for now
+        return mockFunction;
+    }
+    return globalOrMocked;
+};
+/**
+ * Generate mock endowments for all the APIs as defined in {@link ALL_APIS}.
+ *
+ * @returns A map of endowments.
+ */
+const generateMockEndowments = () => {
+    return exports.ALL_APIS.reduce((acc, cur) => (Object.assign(Object.assign({}, acc), { [cur]: generateMockEndowment(cur) })), { snap: getMockSnapGlobal(), ethereum: getMockEthereumProvider() });
+};
+exports.generateMockEndowments = generateMockEndowments;
+//# sourceMappingURL=mock.js.map

package/dist/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"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","sourcesContent":["import EventEmitter from 'events';\nimport crypto from 'crypto';\nimport { DEFAULT_ENDOWMENTS } from './default-endowments';\n\nconst NETWORK_APIS = ['fetch', 'WebSocket'];\n\nexport const ALL_APIS: string[] = [...DEFAULT_ENDOWMENTS, ...NETWORK_APIS];\n\ntype MockSnapGlobal = {\n  request: () => Promise<any>;\n};\n\ntype MockEthereumProvider = EventEmitter & {\n  request: () => Promise<any>;\n};\n\n/**\n * Get a mock snap API, that always returns `true` for requests.\n *\n * @returns A mocked snap provider.\n */\nfunction getMockSnapGlobal(): MockSnapGlobal {\n  return { request: async () => true };\n}\n\n/**\n * Get a mock Ethereum provider, that always returns `true` for requests.\n *\n * @returns A mocked ethereum provider.\n */\nfunction getMockEthereumProvider(): MockEthereumProvider {\n  const mockProvider = new EventEmitter() as Partial<MockEthereumProvider>;\n  mockProvider.request = async () => true;\n  return mockProvider as MockEthereumProvider;\n}\n\n/**\n * Check if a value is a constructor.\n *\n * @param value - The value to check.\n * @returns `true` if the value is a constructor, or `false` otherwise.\n */\nexport const isConstructor = (value: any) =>\n  Boolean(typeof value?.prototype?.constructor?.name === 'string');\n\n/**\n * A function that always returns `true`.\n *\n * @returns `true`.\n */\nconst mockFunction = () => true;\nclass MockClass {}\n\nconst handler = {\n  construct(Target: any, args: any[]): any {\n    return new Proxy(new Target(...args), handler);\n  },\n  get(_target: any, _prop: any) {\n    return mockFunction;\n  },\n};\n\n/**\n * Generate a mock class for a given value. The value is wrapped in a Proxy, and\n * all methods are replaced with a mock function.\n *\n * @param value - The value to mock.\n * @returns A mock class.\n */\nconst generateMockClass = (value: any) => {\n  return new Proxy(value, handler);\n};\n\n// Things not currently auto-mocked because of NodeJS, by adding them here we\n// have types for them and can use that to generate mocks if needed.\nconst mockWindow: Record<string, unknown> = {\n  WebSocket: MockClass,\n  crypto,\n  SubtleCrypto: MockClass,\n};\n\n/**\n * Generate a mock endowment for a certain class or function on the `globalThis`\n * object.\n *\n * @param key - The key to generate the mock endowment for.\n * @returns A mocked class or function. If the key is part of the default\n * endowments, the original value is returned.\n */\nconst generateMockEndowment = (key: string) => {\n  const globalValue = (globalThis as any)[key];\n\n  // Default exposed APIs don't need to be mocked\n  if (globalValue && DEFAULT_ENDOWMENTS.includes(key)) {\n    return globalValue;\n  }\n\n  // Fall back to mockWindow for certain APIs not exposed in global in Node.JS\n  const globalOrMocked = globalValue ?? mockWindow[key];\n\n  const type = typeof globalOrMocked;\n  const isFunction = type === 'function';\n  if (isFunction && isConstructor(globalOrMocked)) {\n    return generateMockClass(globalOrMocked);\n  } else if (isFunction || !globalOrMocked) {\n    // Fall back to function mock for now\n    return mockFunction;\n  }\n  return globalOrMocked;\n};\n\n/**\n * Generate mock endowments for all the APIs as defined in {@link ALL_APIS}.\n *\n * @returns A map of endowments.\n */\nexport const generateMockEndowments = () => {\n  return ALL_APIS.reduce<Record<string, any>>(\n    (acc, cur) => ({ ...acc, [cur]: generateMockEndowment(cur) }),\n    { snap: getMockSnapGlobal(), ethereum: getMockEthereumProvider() },\n  );\n};\n"]}

package/dist/namespace.d.ts

@@ -0,0 +1,275 @@
+import { Infer } from 'superstruct';
+import { AssertionErrorConstructor } from '@metamask/utils';
+export declare const CHAIN_ID_REGEX: RegExp;
+export declare const ACCOUNT_ID_REGEX: RegExp;
+/**
+ * Parse a chain ID string to an object containing the namespace and reference.
+ * This validates the chain ID before parsing it.
+ *
+ * @param chainId - The chain ID to validate and parse.
+ * @returns The parsed chain ID.
+ */
+export declare function parseChainId(chainId: ChainId): {
+    namespace: NamespaceId;
+    reference: string;
+};
+/**
+ * Parse an account ID to an object containing the chain, chain ID and address.
+ * This validates the account ID before parsing it.
+ *
+ * @param accountId - The account ID to validate and parse.
+ * @returns The parsed account ID.
+ */
+export declare function parseAccountId(accountId: AccountId): {
+    chain: {
+        namespace: NamespaceId;
+        reference: string;
+    };
+    chainId: ChainId;
+    address: string;
+};
+/**
+ * A helper struct for a string with a minimum length of 1 and a maximum length
+ * of 40.
+ */
+export declare const LimitedString: import("superstruct").Struct<string, null>;
+/**
+ * A CAIP-2 chain ID, i.e., a human-readable namespace and reference.
+ */
+export declare const ChainIdStruct: import("superstruct").Struct<string, null>;
+export declare type ChainId = `${string}:${string}`;
+export declare const AccountIdStruct: import("superstruct").Struct<string, null>;
+export declare type AccountId = `${ChainId}:${string}`;
+export declare const AccountIdArrayStruct: import("superstruct").Struct<string[], import("superstruct").Struct<string, null>>;
+/**
+ * A chain descriptor.
+ */
+export declare const ChainStruct: import("superstruct").Struct<{
+    name: string;
+    id: string;
+}, {
+    id: import("superstruct").Struct<string, null>;
+    name: import("superstruct").Struct<string, null>;
+}>;
+export declare type Chain = Infer<typeof ChainStruct>;
+export declare const NamespaceStruct: import("superstruct").Struct<{
+    chains: {
+        name: string;
+        id: string;
+    }[];
+    methods?: string[] | undefined;
+    events?: string[] | undefined;
+}, {
+    /**
+     * A list of supported chains in the namespace.
+     */
+    chains: import("superstruct").Struct<{
+        name: string;
+        id: string;
+    }[], import("superstruct").Struct<{
+        name: string;
+        id: string;
+    }, {
+        id: import("superstruct").Struct<string, null>;
+        name: import("superstruct").Struct<string, null>;
+    }>>;
+    /**
+     * A list of supported RPC methods on the namespace, that a DApp can call.
+     */
+    methods: import("superstruct").Struct<string[] | undefined, import("superstruct").Struct<string, null>>;
+    /**
+     * A list of supported RPC events on the namespace, that a DApp can listen to.
+     */
+    events: import("superstruct").Struct<string[] | undefined, import("superstruct").Struct<string, null>>;
+}>;
+export declare type Namespace = Infer<typeof NamespaceStruct>;
+export declare const RequestNamespaceStruct: import("superstruct").Struct<{
+    chains: string[];
+    methods?: string[] | undefined;
+    events?: string[] | undefined;
+}, {
+    chains: import("superstruct").Struct<string[], import("superstruct").Struct<string, null>>;
+    methods: import("superstruct").Struct<string[] | undefined, import("superstruct").Struct<string, null>>;
+    events: import("superstruct").Struct<string[] | undefined, import("superstruct").Struct<string, null>>;
+}>;
+export declare type RequestNamespace = Infer<typeof RequestNamespaceStruct>;
+export declare const SessionNamespaceStruct: import("superstruct").Struct<{
+    accounts: string[];
+    chains: string[];
+    methods?: string[] | undefined;
+    events?: string[] | undefined;
+}, {
+    accounts: import("superstruct").Struct<string[], import("superstruct").Struct<string, null>>;
+    chains: import("superstruct").Struct<string[], import("superstruct").Struct<string, null>>;
+    methods: import("superstruct").Struct<string[] | undefined, import("superstruct").Struct<string, null>>;
+    events: import("superstruct").Struct<string[] | undefined, import("superstruct").Struct<string, null>>;
+}>;
+export declare type SessionNamespace = Infer<typeof SessionNamespaceStruct>;
+/**
+ * A CAIP-2 namespace, i.e., the first part of a chain ID.
+ */
+export declare const NamespaceIdStruct: import("superstruct").Struct<string, null>;
+export declare type NamespaceId = Infer<typeof NamespaceIdStruct>;
+/**
+ * An object mapping CAIP-2 namespaces to their values.
+ */
+export declare const NamespacesStruct: import("superstruct").Struct<Record<string, {
+    chains: {
+        name: string;
+        id: string;
+    }[];
+    methods?: string[] | undefined;
+    events?: string[] | undefined;
+}>, null>;
+export declare type Namespaces = Infer<typeof NamespacesStruct>;
+export declare const SessionStruct: import("superstruct").Struct<{
+    namespaces: Record<string, {
+        accounts: string[];
+        chains: string[];
+        methods?: string[] | undefined;
+        events?: string[] | undefined;
+    }>;
+}, {
+    namespaces: import("superstruct").Struct<Record<string, {
+        accounts: string[];
+        chains: string[];
+        methods?: string[] | undefined;
+        events?: string[] | undefined;
+    }>, null>;
+}>;
+export declare type Session = Infer<typeof SessionStruct>;
+/**
+ * Asserts that the given value is a valid {@link Session}.
+ *
+ * @param value - The value to assert.
+ * @throws If the value is not a valid {@link Session}.
+ */
+export declare function assertIsSession(value: unknown): asserts value is Session;
+export declare const ConnectArgumentsStruct: import("superstruct").Struct<{
+    requiredNamespaces: Record<string, {
+        chains: string[];
+        methods?: string[] | undefined;
+        events?: string[] | undefined;
+    }>;
+}, {
+    requiredNamespaces: import("superstruct").Struct<Record<string, {
+        chains: string[];
+        methods?: string[] | undefined;
+        events?: string[] | undefined;
+    }>, null>;
+}>;
+export declare type ConnectArguments = Infer<typeof ConnectArgumentsStruct>;
+export declare const RequestArgumentsStruct: import("superstruct").Struct<{
+    method: string;
+    params?: Record<string, import("@metamask/utils").Json> | import("@metamask/utils").Json[] | undefined;
+    id?: string | number | null | undefined;
+    jsonrpc?: "2.0" | undefined;
+}, {
+    params: import("superstruct").Struct<Record<string, import("@metamask/utils").Json> | import("@metamask/utils").Json[] | undefined, null>;
+    method: import("superstruct").Struct<string, null>;
+    id: import("superstruct").Struct<string | number | null | undefined, unknown>;
+    jsonrpc: import("superstruct").Struct<"2.0" | undefined, unknown>;
+}>;
+export declare type RequestArguments = Infer<typeof RequestArgumentsStruct>;
+export declare const MultiChainRequestStruct: import("superstruct").Struct<{
+    request: {
+        method: string;
+        params?: Record<string, import("@metamask/utils").Json> | import("@metamask/utils").Json[] | undefined;
+        id?: string | number | null | undefined;
+        jsonrpc?: "2.0" | undefined;
+    };
+    chainId: string;
+}, {
+    chainId: import("superstruct").Struct<string, null>;
+    request: import("superstruct").Struct<{
+        method: string;
+        params?: Record<string, import("@metamask/utils").Json> | import("@metamask/utils").Json[] | undefined;
+        id?: string | number | null | undefined;
+        jsonrpc?: "2.0" | undefined;
+    }, {
+        params: import("superstruct").Struct<Record<string, import("@metamask/utils").Json> | import("@metamask/utils").Json[] | undefined, null>;
+        method: import("superstruct").Struct<string, null>;
+        id: import("superstruct").Struct<string | number | null | undefined, unknown>;
+        jsonrpc: import("superstruct").Struct<"2.0" | undefined, unknown>;
+    }>;
+}>;
+export declare type MultiChainRequest = Infer<typeof MultiChainRequestStruct>;
+/**
+ * Check if the given value is a CAIP-2 namespace ID.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a CAIP-2 namespace ID.
+ */
+export declare function isNamespaceId(value: unknown): value is NamespaceId;
+/**
+ * Check if the given value is a CAIP-2 chain ID.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a CAIP-2 chain ID.
+ */
+export declare function isChainId(value: unknown): value is ChainId;
+/**
+ * Check if the given value is a CAIP-10 account ID.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a CAIP-10 account ID.
+ */
+export declare function isAccountId(value: unknown): value is AccountId;
+/**
+ * Check if the given value is an array of CAIP-10 account IDs.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is an array of CAIP-10 account IDs.
+ */
+export declare function isAccountIdArray(value: unknown): value is AccountId[];
+/**
+ * Check if the given value is a {@link ConnectArguments} object.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a valid {@link ConnectArguments} object.
+ */
+export declare function isConnectArguments(value: unknown): value is ConnectArguments;
+/**
+ * Assert that the given value is a {@link ConnectArguments} object.
+ *
+ * @param value - The value to check.
+ * @throws If the value is not a valid {@link ConnectArguments} object.
+ */
+export declare function assertIsConnectArguments(value: unknown): asserts value is ConnectArguments;
+/**
+ * Check if the given value is a {@link MultiChainRequest} object.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a valid {@link MultiChainRequest} object.
+ */
+export declare function isMultiChainRequest(value: unknown): value is MultiChainRequest;
+/**
+ * Assert that the given value is a {@link MultiChainRequest} object.
+ *
+ * @param value - The value to check.
+ * @throws If the value is not a valid {@link MultiChainRequest} object.
+ */
+export declare function assertIsMultiChainRequest(value: unknown): asserts value is MultiChainRequest;
+/**
+ * Check if a value is a {@link Namespace}.
+ *
+ * @param value - The value to validate.
+ * @returns True if the value is a valid {@link Namespace}.
+ */
+export declare function isNamespace(value: unknown): value is Namespace;
+/**
+ * Check if a value is an object containing {@link Namespace}s.
+ *
+ * @param value - The value to validate.
+ * @returns True if the value is a valid object containing namespaces.
+ */
+export declare function isNamespacesObject(value: unknown): value is Namespaces;
+/**
+ * Assert that the given value is a {@link Namespaces} object.
+ *
+ * @param value - The value to check.
+ * @param ErrorWrapper - The error wrapper to use. Defaults to
+ * {@link AssertionError}.
+ * @throws If the value is not a valid {@link Namespaces} object.
+ */
+export declare function assertIsNamespacesObject(value: unknown, ErrorWrapper?: AssertionErrorConstructor): asserts value is Namespaces;

package/dist/namespace.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertIsNamespacesObject = exports.isNamespacesObject = exports.isNamespace = exports.assertIsMultiChainRequest = exports.isMultiChainRequest = exports.assertIsConnectArguments = exports.isConnectArguments = exports.isAccountIdArray = exports.isAccountId = exports.isChainId = exports.isNamespaceId = exports.MultiChainRequestStruct = exports.RequestArgumentsStruct = exports.ConnectArgumentsStruct = exports.assertIsSession = exports.SessionStruct = exports.NamespacesStruct = exports.NamespaceIdStruct = exports.SessionNamespaceStruct = exports.RequestNamespaceStruct = exports.NamespaceStruct = exports.ChainStruct = exports.AccountIdArrayStruct = exports.AccountIdStruct = exports.ChainIdStruct = exports.LimitedString = exports.parseAccountId = exports.parseChainId = exports.ACCOUNT_ID_REGEX = exports.CHAIN_ID_REGEX = void 0;
+const superstruct_1 = require("superstruct");
+const utils_1 = require("@metamask/utils");
+exports.CHAIN_ID_REGEX = /^(?<namespace>[-a-z0-9]{3,8}):(?<reference>[-a-zA-Z0-9]{1,32})$/u;
+exports.ACCOUNT_ID_REGEX = /^(?<chainId>(?<namespace>[-a-z0-9]{3,8}):(?<reference>[-a-zA-Z0-9]{1,32})):(?<accountAddress>[a-zA-Z0-9]{1,64})$/u;
+/**
+ * Parse a chain ID string to an object containing the namespace and reference.
+ * This validates the chain ID before parsing it.
+ *
+ * @param chainId - The chain ID to validate and parse.
+ * @returns The parsed chain ID.
+ */
+function parseChainId(chainId) {
+    const match = exports.CHAIN_ID_REGEX.exec(chainId);
+    if (!(match === null || match === void 0 ? void 0 : match.groups)) {
+        throw new Error('Invalid chain ID.');
+    }
+    return {
+        namespace: match.groups.namespace,
+        reference: match.groups.reference,
+    };
+}
+exports.parseChainId = parseChainId;
+/**
+ * Parse an account ID to an object containing the chain, chain ID and address.
+ * This validates the account ID before parsing it.
+ *
+ * @param accountId - The account ID to validate and parse.
+ * @returns The parsed account ID.
+ */
+function parseAccountId(accountId) {
+    const match = exports.ACCOUNT_ID_REGEX.exec(accountId);
+    if (!(match === null || match === void 0 ? void 0 : match.groups)) {
+        throw new Error('Invalid account ID.');
+    }
+    return {
+        address: match.groups.accountAddress,
+        chainId: match.groups.chainId,
+        chain: {
+            namespace: match.groups.namespace,
+            reference: match.groups.reference,
+        },
+    };
+}
+exports.parseAccountId = parseAccountId;
+/**
+ * A helper struct for a string with a minimum length of 1 and a maximum length
+ * of 40.
+ */
+exports.LimitedString = (0, superstruct_1.size)((0, superstruct_1.string)(), 1, 40);
+/**
+ * A CAIP-2 chain ID, i.e., a human-readable namespace and reference.
+ */
+exports.ChainIdStruct = (0, superstruct_1.pattern)((0, superstruct_1.string)(), exports.CHAIN_ID_REGEX);
+exports.AccountIdStruct = (0, superstruct_1.pattern)((0, superstruct_1.string)(), exports.ACCOUNT_ID_REGEX);
+exports.AccountIdArrayStruct = (0, superstruct_1.array)(exports.AccountIdStruct);
+/**
+ * A chain descriptor.
+ */
+exports.ChainStruct = (0, superstruct_1.object)({
+    id: exports.ChainIdStruct,
+    name: exports.LimitedString,
+});
+exports.NamespaceStruct = (0, superstruct_1.object)({
+    /**
+     * A list of supported chains in the namespace.
+     */
+    chains: (0, superstruct_1.array)(exports.ChainStruct),
+    /**
+     * A list of supported RPC methods on the namespace, that a DApp can call.
+     */
+    methods: (0, superstruct_1.optional)((0, superstruct_1.array)(exports.LimitedString)),
+    /**
+     * A list of supported RPC events on the namespace, that a DApp can listen to.
+     */
+    events: (0, superstruct_1.optional)((0, superstruct_1.array)(exports.LimitedString)),
+});
+exports.RequestNamespaceStruct = (0, superstruct_1.assign)((0, superstruct_1.omit)(exports.NamespaceStruct, ['chains']), (0, superstruct_1.object)({ chains: (0, superstruct_1.array)(exports.ChainIdStruct) }));
+exports.SessionNamespaceStruct = (0, superstruct_1.assign)(exports.RequestNamespaceStruct, (0, superstruct_1.object)({ accounts: (0, superstruct_1.array)(exports.AccountIdStruct) }));
+/**
+ * A CAIP-2 namespace, i.e., the first part of a chain ID.
+ */
+exports.NamespaceIdStruct = (0, superstruct_1.pattern)((0, superstruct_1.string)(), /^[-a-z0-9]{3,8}$/u);
+/**
+ * An object mapping CAIP-2 namespaces to their values.
+ */
+exports.NamespacesStruct = (0, superstruct_1.record)(exports.NamespaceIdStruct, exports.NamespaceStruct);
+exports.SessionStruct = (0, superstruct_1.object)({
+    namespaces: (0, superstruct_1.record)(exports.NamespaceIdStruct, exports.SessionNamespaceStruct),
+});
+/**
+ * Asserts that the given value is a valid {@link Session}.
+ *
+ * @param value - The value to assert.
+ * @throws If the value is not a valid {@link Session}.
+ */
+function assertIsSession(value) {
+    (0, utils_1.assertStruct)(value, exports.SessionStruct, 'Invalid session');
+}
+exports.assertIsSession = assertIsSession;
+exports.ConnectArgumentsStruct = (0, superstruct_1.object)({
+    requiredNamespaces: (0, superstruct_1.record)(exports.NamespaceIdStruct, exports.RequestNamespaceStruct),
+});
+exports.RequestArgumentsStruct = (0, superstruct_1.assign)((0, superstruct_1.partial)((0, superstruct_1.pick)(utils_1.JsonRpcRequestStruct, ['id', 'jsonrpc'])), (0, superstruct_1.omit)(utils_1.JsonRpcRequestStruct, ['id', 'jsonrpc']));
+exports.MultiChainRequestStruct = (0, superstruct_1.object)({
+    chainId: exports.ChainIdStruct,
+    request: exports.RequestArgumentsStruct,
+});
+/**
+ * Check if the given value is a CAIP-2 namespace ID.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a CAIP-2 namespace ID.
+ */
+function isNamespaceId(value) {
+    return (0, superstruct_1.is)(value, exports.NamespaceIdStruct);
+}
+exports.isNamespaceId = isNamespaceId;
+/**
+ * Check if the given value is a CAIP-2 chain ID.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a CAIP-2 chain ID.
+ */
+function isChainId(value) {
+    return (0, superstruct_1.is)(value, exports.ChainIdStruct);
+}
+exports.isChainId = isChainId;
+/**
+ * Check if the given value is a CAIP-10 account ID.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a CAIP-10 account ID.
+ */
+function isAccountId(value) {
+    return (0, superstruct_1.is)(value, exports.AccountIdStruct);
+}
+exports.isAccountId = isAccountId;
+/**
+ * Check if the given value is an array of CAIP-10 account IDs.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is an array of CAIP-10 account IDs.
+ */
+function isAccountIdArray(value) {
+    return (0, superstruct_1.is)(value, exports.AccountIdArrayStruct);
+}
+exports.isAccountIdArray = isAccountIdArray;
+/**
+ * Check if the given value is a {@link ConnectArguments} object.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a valid {@link ConnectArguments} object.
+ */
+function isConnectArguments(value) {
+    return (0, superstruct_1.is)(value, exports.ConnectArgumentsStruct);
+}
+exports.isConnectArguments = isConnectArguments;
+/**
+ * Assert that the given value is a {@link ConnectArguments} object.
+ *
+ * @param value - The value to check.
+ * @throws If the value is not a valid {@link ConnectArguments} object.
+ */
+function assertIsConnectArguments(value) {
+    (0, utils_1.assertStruct)(value, exports.ConnectArgumentsStruct, 'Invalid connect arguments');
+}
+exports.assertIsConnectArguments = assertIsConnectArguments;
+/**
+ * Check if the given value is a {@link MultiChainRequest} object.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a valid {@link MultiChainRequest} object.
+ */
+function isMultiChainRequest(value) {
+    return (0, superstruct_1.is)(value, exports.MultiChainRequestStruct);
+}
+exports.isMultiChainRequest = isMultiChainRequest;
+/**
+ * Assert that the given value is a {@link MultiChainRequest} object.
+ *
+ * @param value - The value to check.
+ * @throws If the value is not a valid {@link MultiChainRequest} object.
+ */
+function assertIsMultiChainRequest(value) {
+    (0, utils_1.assertStruct)(value, exports.MultiChainRequestStruct, 'Invalid request arguments');
+}
+exports.assertIsMultiChainRequest = assertIsMultiChainRequest;
+/**
+ * Check if a value is a {@link Namespace}.
+ *
+ * @param value - The value to validate.
+ * @returns True if the value is a valid {@link Namespace}.
+ */
+function isNamespace(value) {
+    return (0, superstruct_1.is)(value, exports.NamespaceStruct);
+}
+exports.isNamespace = isNamespace;
+/**
+ * Check if a value is an object containing {@link Namespace}s.
+ *
+ * @param value - The value to validate.
+ * @returns True if the value is a valid object containing namespaces.
+ */
+function isNamespacesObject(value) {
+    return (0, superstruct_1.is)(value, exports.NamespacesStruct);
+}
+exports.isNamespacesObject = isNamespacesObject;
+/**
+ * Assert that the given value is a {@link Namespaces} object.
+ *
+ * @param value - The value to check.
+ * @param ErrorWrapper - The error wrapper to use. Defaults to
+ * {@link AssertionError}.
+ * @throws If the value is not a valid {@link Namespaces} object.
+ */
+function assertIsNamespacesObject(value, ErrorWrapper) {
+    (0, utils_1.assertStruct)(value, exports.NamespacesStruct, 'Invalid namespaces object', ErrorWrapper);
+}
+exports.assertIsNamespacesObject = assertIsNamespacesObject;
+//# sourceMappingURL=namespace.js.map

package/dist/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../src/namespace.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  array,\n  Infer,\n  is,\n  object,\n  optional,\n  pattern,\n  record,\n  size,\n  string,\n  omit,\n  assign,\n  partial,\n  pick,\n} from 'superstruct';\nimport {\n  JsonRpcRequestStruct,\n  AssertionErrorConstructor,\n  assertStruct,\n} from '@metamask/utils';\n\nexport const CHAIN_ID_REGEX =\n  /^(?<namespace>[-a-z0-9]{3,8}):(?<reference>[-a-zA-Z0-9]{1,32})$/u;\n\nexport const ACCOUNT_ID_REGEX =\n  /^(?<chainId>(?<namespace>[-a-z0-9]{3,8}):(?<reference>[-a-zA-Z0-9]{1,32})):(?<accountAddress>[a-zA-Z0-9]{1,64})$/u;\n\n/**\n * Parse a chain ID string to an object containing the namespace and reference.\n * This validates the chain ID before parsing it.\n *\n * @param chainId - The chain ID to validate and parse.\n * @returns The parsed chain ID.\n */\nexport function parseChainId(chainId: ChainId): {\n  namespace: NamespaceId;\n  reference: string;\n} {\n  const match = CHAIN_ID_REGEX.exec(chainId);\n  if (!match?.groups) {\n    throw new Error('Invalid chain ID.');\n  }\n\n  return {\n    namespace: match.groups.namespace,\n    reference: match.groups.reference,\n  };\n}\n\n/**\n * Parse an account ID to an object containing the chain, chain ID and address.\n * This validates the account ID before parsing it.\n *\n * @param accountId - The account ID to validate and parse.\n * @returns The parsed account ID.\n */\nexport function parseAccountId(accountId: AccountId): {\n  chain: { namespace: NamespaceId; reference: string };\n  chainId: ChainId;\n  address: string;\n} {\n  const match = ACCOUNT_ID_REGEX.exec(accountId);\n  if (!match?.groups) {\n    throw new Error('Invalid account ID.');\n  }\n\n  return {\n    address: match.groups.accountAddress,\n    chainId: match.groups.chainId as ChainId,\n    chain: {\n      namespace: match.groups.namespace,\n      reference: match.groups.reference,\n    },\n  };\n}\n\n/**\n * A helper struct for a string with a minimum length of 1 and a maximum length\n * of 40.\n */\nexport const LimitedString = size(string(), 1, 40);\n\n/**\n * A CAIP-2 chain ID, i.e., a human-readable namespace and reference.\n */\nexport const ChainIdStruct = pattern(string(), CHAIN_ID_REGEX);\nexport type ChainId = `${string}:${string}`;\n\nexport const AccountIdStruct = pattern(string(), ACCOUNT_ID_REGEX);\nexport type AccountId = `${ChainId}:${string}`;\n\nexport const AccountIdArrayStruct = array(AccountIdStruct);\n\n/**\n * A chain descriptor.\n */\nexport const ChainStruct = object({\n  id: ChainIdStruct,\n  name: LimitedString,\n});\nexport type Chain = Infer<typeof ChainStruct>;\n\nexport const NamespaceStruct = object({\n  /**\n   * A list of supported chains in the namespace.\n   */\n  chains: array(ChainStruct),\n\n  /**\n   * A list of supported RPC methods on the namespace, that a DApp can call.\n   */\n  methods: optional(array(LimitedString)),\n\n  /**\n   * A list of supported RPC events on the namespace, that a DApp can listen to.\n   */\n  events: optional(array(LimitedString)),\n});\nexport type Namespace = Infer<typeof NamespaceStruct>;\n\nexport const RequestNamespaceStruct = assign(\n  omit(NamespaceStruct, ['chains']),\n  object({ chains: array(ChainIdStruct) }),\n);\nexport type RequestNamespace = Infer<typeof RequestNamespaceStruct>;\n\nexport const SessionNamespaceStruct = assign(\n  RequestNamespaceStruct,\n  object({ accounts: array(AccountIdStruct) }),\n);\nexport type SessionNamespace = Infer<typeof SessionNamespaceStruct>;\n\n/**\n * A CAIP-2 namespace, i.e., the first part of a chain ID.\n */\nexport const NamespaceIdStruct = pattern(string(), /^[-a-z0-9]{3,8}$/u);\nexport type NamespaceId = Infer<typeof NamespaceIdStruct>;\n\n/**\n * An object mapping CAIP-2 namespaces to their values.\n */\nexport const NamespacesStruct = record(NamespaceIdStruct, NamespaceStruct);\nexport type Namespaces = Infer<typeof NamespacesStruct>;\n\nexport const SessionStruct = object({\n  namespaces: record(NamespaceIdStruct, SessionNamespaceStruct),\n});\nexport type Session = Infer<typeof SessionStruct>;\n\n/**\n * Asserts that the given value is a valid {@link Session}.\n *\n * @param value - The value to assert.\n * @throws If the value is not a valid {@link Session}.\n */\nexport function assertIsSession(value: unknown): asserts value is Session {\n  assertStruct(value, SessionStruct, 'Invalid session');\n}\n\nexport const ConnectArgumentsStruct = object({\n  requiredNamespaces: record(NamespaceIdStruct, RequestNamespaceStruct),\n});\nexport type ConnectArguments = Infer<typeof ConnectArgumentsStruct>;\n\nexport const RequestArgumentsStruct = assign(\n  partial(pick(JsonRpcRequestStruct, ['id', 'jsonrpc'])),\n  omit(JsonRpcRequestStruct, ['id', 'jsonrpc']),\n);\nexport type RequestArguments = Infer<typeof RequestArgumentsStruct>;\n\nexport const MultiChainRequestStruct = object({\n  chainId: ChainIdStruct,\n  request: RequestArgumentsStruct,\n});\nexport type MultiChainRequest = Infer<typeof MultiChainRequestStruct>;\n\n/**\n * Check if the given value is a CAIP-2 namespace ID.\n *\n * @param value - The value to check.\n * @returns Whether the value is a CAIP-2 namespace ID.\n */\nexport function isNamespaceId(value: unknown): value is NamespaceId {\n  return is(value, NamespaceIdStruct);\n}\n\n/**\n * Check if the given value is a CAIP-2 chain ID.\n *\n * @param value - The value to check.\n * @returns Whether the value is a CAIP-2 chain ID.\n */\nexport function isChainId(value: unknown): value is ChainId {\n  return is(value, ChainIdStruct);\n}\n\n/**\n * Check if the given value is a CAIP-10 account ID.\n *\n * @param value - The value to check.\n * @returns Whether the value is a CAIP-10 account ID.\n */\nexport function isAccountId(value: unknown): value is AccountId {\n  return is(value, AccountIdStruct);\n}\n\n/**\n * Check if the given value is an array of CAIP-10 account IDs.\n *\n * @param value - The value to check.\n * @returns Whether the value is an array of CAIP-10 account IDs.\n */\nexport function isAccountIdArray(value: unknown): value is AccountId[] {\n  return is(value, AccountIdArrayStruct);\n}\n\n/**\n * Check if the given value is a {@link ConnectArguments} object.\n *\n * @param value - The value to check.\n * @returns Whether the value is a valid {@link ConnectArguments} object.\n */\nexport function isConnectArguments(value: unknown): value is ConnectArguments {\n  return is(value, ConnectArgumentsStruct);\n}\n\n/**\n * Assert that the given value is a {@link ConnectArguments} object.\n *\n * @param value - The value to check.\n * @throws If the value is not a valid {@link ConnectArguments} object.\n */\nexport function assertIsConnectArguments(\n  value: unknown,\n): asserts value is ConnectArguments {\n  assertStruct(value, ConnectArgumentsStruct, 'Invalid connect arguments');\n}\n\n/**\n * Check if the given value is a {@link MultiChainRequest} object.\n *\n * @param value - The value to check.\n * @returns Whether the value is a valid {@link MultiChainRequest} object.\n */\nexport function isMultiChainRequest(\n  value: unknown,\n): value is MultiChainRequest {\n  return is(value, MultiChainRequestStruct);\n}\n\n/**\n * Assert that the given value is a {@link MultiChainRequest} object.\n *\n * @param value - The value to check.\n * @throws If the value is not a valid {@link MultiChainRequest} object.\n */\nexport function assertIsMultiChainRequest(\n  value: unknown,\n): asserts value is MultiChainRequest {\n  assertStruct(value, MultiChainRequestStruct, 'Invalid request arguments');\n}\n\n/**\n * Check if a value is a {@link Namespace}.\n *\n * @param value - The value to validate.\n * @returns True if the value is a valid {@link Namespace}.\n */\nexport function isNamespace(value: unknown): value is Namespace {\n  return is(value, NamespaceStruct);\n}\n\n/**\n * Check if a value is an object containing {@link Namespace}s.\n *\n * @param value - The value to validate.\n * @returns True if the value is a valid object containing namespaces.\n */\nexport function isNamespacesObject(value: unknown): value is Namespaces {\n  return is(value, NamespacesStruct);\n}\n\n/**\n * Assert that the given value is a {@link Namespaces} object.\n *\n * @param value - The value to check.\n * @param ErrorWrapper - The error wrapper to use. Defaults to\n * {@link AssertionError}.\n * @throws If the value is not a valid {@link Namespaces} object.\n */\nexport function assertIsNamespacesObject(\n  value: unknown,\n  ErrorWrapper?: AssertionErrorConstructor,\n): asserts value is Namespaces {\n  assertStruct(\n    value,\n    NamespacesStruct,\n    'Invalid namespaces object',\n    ErrorWrapper,\n  );\n}\n"]}