@metamask-previews/utils 11.12.1-preview-9962b7e

package/dist/caip-types.d.ts

@@ -0,0 +1,294 @@
+import type { Infer } from '@metamask/superstruct';
+export declare const CAIP_CHAIN_ID_REGEX: RegExp;
+export declare const CAIP_NAMESPACE_REGEX: RegExp;
+export declare const CAIP_REFERENCE_REGEX: RegExp;
+export declare const CAIP_ACCOUNT_ID_REGEX: RegExp;
+export declare const CAIP_ACCOUNT_ADDRESS_REGEX: RegExp;
+export declare const CAIP_ASSET_NAMESPACE_REGEX: RegExp;
+export declare const CAIP_ASSET_REFERENCE_REGEX: RegExp;
+export declare const CAIP_TOKEN_ID_REGEX: RegExp;
+export declare const CAIP_ASSET_TYPE_REGEX: RegExp;
+export declare const CAIP_ASSET_ID_REGEX: RegExp;
+/**
+ * A CAIP-2 chain ID, i.e., a human-readable namespace and reference.
+ */
+export declare const CaipChainIdStruct: import("@metamask/superstruct").Struct<`${string}:${string}`, null>;
+export type CaipChainId = Infer<typeof CaipChainIdStruct>;
+/**
+ * A CAIP-2 namespace, i.e., the first part of a CAIP chain ID.
+ */
+export declare const CaipNamespaceStruct: import("@metamask/superstruct").Struct<string, null>;
+export type CaipNamespace = Infer<typeof CaipNamespaceStruct>;
+/**
+ * A CAIP-2 reference, i.e., the second part of a CAIP chain ID.
+ */
+export declare const CaipReferenceStruct: import("@metamask/superstruct").Struct<string, null>;
+export type CaipReference = Infer<typeof CaipReferenceStruct>;
+/**
+ * A CAIP-10 account ID, i.e., a human-readable namespace, reference, and account address.
+ */
+export declare const CaipAccountIdStruct: import("@metamask/superstruct").Struct<`${string}:${string}:${string}`, null>;
+export type CaipAccountId = Infer<typeof CaipAccountIdStruct>;
+/**
+ * A CAIP-10 account address, i.e., the third part of the CAIP account ID.
+ */
+export declare const CaipAccountAddressStruct: import("@metamask/superstruct").Struct<string, null>;
+export type CaipAccountAddress = Infer<typeof CaipAccountAddressStruct>;
+/**
+ * A CAIP-19 asset namespace, i.e., a namespace domain of an asset.
+ */
+export declare const CaipAssetNamespaceStruct: import("@metamask/superstruct").Struct<string, null>;
+export type CaipAssetNamespace = Infer<typeof CaipAssetNamespaceStruct>;
+/**
+ * A CAIP-19 asset reference, i.e., an identifier for an asset within a given namespace.
+ */
+export declare const CaipAssetReferenceStruct: import("@metamask/superstruct").Struct<string, null>;
+export type CaipAssetReference = Infer<typeof CaipAssetReferenceStruct>;
+/**
+ * A CAIP-19 asset token ID, i.e., a unique identifier for an addressable asset of a given type
+ */
+export declare const CaipTokenIdStruct: import("@metamask/superstruct").Struct<string, null>;
+export type CaipTokenId = Infer<typeof CaipTokenIdStruct>;
+/**
+ * A CAIP-19 asset type identifier, i.e., a human-readable type of asset identifier.
+ */
+export declare const CaipAssetTypeStruct: import("@metamask/superstruct").Struct<`${string}:${string}/${string}:${string}`, null>;
+export type CaipAssetType = Infer<typeof CaipAssetTypeStruct>;
+/**
+ * A CAIP-19 asset ID identifier, i.e., a human-readable type of asset ID.
+ */
+export declare const CaipAssetIdStruct: import("@metamask/superstruct").Struct<`${string}:${string}/${string}:${string}/${string}`, null>;
+export type CaipAssetId = Infer<typeof CaipAssetIdStruct>;
+/**
+ * A CAIP-19 asset type or asset ID identifier, i.e., a human-readable type of asset identifier.
+ */
+export declare const CaipAssetTypeOrIdStruct: import("@metamask/superstruct").Struct<`${string}:${string}/${string}:${string}` | `${string}:${string}/${string}:${string}/${string}`, null>;
+export type CaipAssetTypeOrId = Infer<typeof CaipAssetTypeOrIdStruct>;
+/** Known CAIP namespaces. */
+export declare enum KnownCaipNamespace {
+    /** BIP-122 (Bitcoin) compatible chains. */
+    Bip122 = "bip122",
+    /** Solana compatible chains */
+    Solana = "solana",
+    /** Stellar compatible chains */
+    Stellar = "stellar",
+    /** Tron compatible chains */
+    Tron = "tron",
+    /** EIP-155 compatible chains. */
+    Eip155 = "eip155",
+    Wallet = "wallet"
+}
+/**
+ * A CAIP-2 chain ID that is guaranteed to have a known CAIP namespace
+ * (@see {@link KnownCaipNamespace}).
+ *
+ * This is a narrower, more type-safe alternative to {@link CaipChainId} for use cases
+ * where the chain namespace must be one of the known standards.
+ *
+ * @template Namespace - The namespace of the CAIP-2 chain ID. Must be a known namespace specified in {@link KnownCaipNamespace}.
+ */
+export type KnownCaipNamespacedChainId<Namespace extends `${KnownCaipNamespace}` = `${KnownCaipNamespace}`> = `${Namespace}:${string}`;
+/**
+ * Check if the given value is a {@link CaipChainId}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipChainId}.
+ */
+export declare function isCaipChainId(value: unknown): value is CaipChainId;
+/**
+ * Check if the given value is a {@link CaipNamespace}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipNamespace}.
+ */
+export declare function isCaipNamespace(value: unknown): value is CaipNamespace;
+/**
+ * Check if the given value is a {@link CaipReference}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipReference}.
+ */
+export declare function isCaipReference(value: unknown): value is CaipReference;
+/**
+ * Check if the given value is a {@link CaipAccountId}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipAccountId}.
+ */
+export declare function isCaipAccountId(value: unknown): value is CaipAccountId;
+/**
+ * Check if a value is a {@link CaipAccountAddress}.
+ *
+ * @param value - The value to validate.
+ * @returns True if the value is a valid {@link CaipAccountAddress}.
+ */
+export declare function isCaipAccountAddress(value: unknown): value is CaipAccountAddress;
+/**
+ * Check if the given value is a {@link CaipAssetNamespace}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipAssetNamespace}.
+ */
+export declare function isCaipAssetNamespace(value: unknown): value is CaipAssetNamespace;
+/**
+ * Check if the given value is a {@link CaipAssetReference}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipAssetReference}.
+ */
+export declare function isCaipAssetReference(value: unknown): value is CaipAssetReference;
+/**
+ * Check if the given value is a {@link CaipTokenId}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipTokenId}.
+ */
+export declare function isCaipTokenId(value: unknown): value is CaipTokenId;
+/**
+ * Check if the given value is a {@link CaipAssetType}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipAssetType}.
+ */
+export declare function isCaipAssetType(value: unknown): value is CaipAssetType;
+/**
+ * Check if the given value is a {@link CaipAssetId}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipAssetId}.
+ */
+export declare function isCaipAssetId(value: unknown): value is CaipAssetId;
+/**
+ * Parse a CAIP-2 chain ID to an object containing the namespace and reference.
+ * This validates the CAIP-2 chain ID before parsing it.
+ *
+ * @param caipChainId - The CAIP-2 chain ID to validate and parse.
+ * @returns The parsed CAIP-2 chain ID.
+ */
+export declare function parseCaipChainId(caipChainId: CaipChainId): {
+    namespace: CaipNamespace;
+    reference: CaipReference;
+};
+/**
+ * Parse an CAIP-10 account ID to an object containing the chain ID, parsed chain ID, and account address.
+ * This validates the CAIP-10 account ID before parsing it.
+ *
+ * @param caipAccountId - The CAIP-10 account ID to validate and parse.
+ * @returns The parsed CAIP-10 account ID.
+ */
+export declare function parseCaipAccountId(caipAccountId: CaipAccountId): {
+    address: CaipAccountAddress;
+    chainId: CaipChainId;
+    chain: {
+        namespace: CaipNamespace;
+        reference: CaipReference;
+    };
+};
+/**
+ * Parse a CAIP-19 asset type to an object containing the chain ID, parsed chain ID,
+ * asset namespace, and asset reference
+ *
+ * This validates the CAIP-19 asset type before parsing it.
+ *
+ * @param caipAssetType - The CAIP-19 asset type to validate and parse.
+ * @returns The parsed CAIP-19 asset type.
+ */
+export declare function parseCaipAssetType(caipAssetType: CaipAssetType): {
+    assetNamespace: CaipAssetNamespace;
+    assetReference: CaipAssetReference;
+    chainId: CaipChainId;
+    chain: {
+        namespace: CaipNamespace;
+        reference: CaipReference;
+    };
+};
+/**
+ * Parse a CAIP-19 asset ID to an object containing the chain ID, parsed chain ID,
+ * asset namespace, asset reference, and token ID.
+ *
+ * This validates the CAIP-19 asset ID before parsing it.
+ *
+ * @param caipAssetId - The CAIP-19 asset ID to validate and parse.
+ * @returns The parsed CAIP-19 asset ID.
+ */
+export declare function parseCaipAssetId(caipAssetId: CaipAssetId): {
+    assetNamespace: CaipAssetNamespace;
+    assetReference: CaipAssetReference;
+    tokenId: CaipTokenId;
+    chainId: CaipChainId;
+    chain: {
+        namespace: CaipNamespace;
+        reference: CaipReference;
+    };
+};
+/**
+ * Chain ID as defined per the CAIP-2
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-2.md}.
+ *
+ * It defines a way to uniquely identify any blockchain in a human-readable
+ * way.
+ *
+ * @param namespace - The standard (ecosystem) of similar blockchains.
+ * @param reference - Identify of a blockchain within a given namespace.
+ * @throws {@link Error}
+ * This exception is thrown if the inputs does not comply with the CAIP-2
+ * syntax specification
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-2.md#syntax}.
+ * @returns A CAIP chain ID.
+ */
+export declare function toCaipChainId(namespace: CaipNamespace, reference: CaipReference): CaipChainId;
+/**
+ * Account ID as defined per the CAIP-10
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-10.md}.
+ *
+ * It defines a way to uniquely identify any blockchain account in a human-readable
+ * way.
+ *
+ * @param namespace - The standard (ecosystem) of similar blockchains.
+ * @param reference - Identity of a blockchain within a given namespace.
+ * @param accountAddress - The address of the blockchain account.
+ * @throws {@link Error}
+ * This exception is thrown if the inputs do not comply with the CAIP-10
+ * syntax specification
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-10.md#syntax}.
+ * @returns A CAIP account ID.
+ */
+export declare function toCaipAccountId(namespace: CaipNamespace, reference: CaipReference, accountAddress: CaipAccountAddress): CaipAccountId;
+/**
+ * Asset Type as defined per the CAIP-19
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-19.md}.
+ *
+ * It defines a way to uniquely identify any blockchain asset in a human-readable
+ * way.
+ *
+ * @param namespace - The standard (ecosystem) of similar blockchains.
+ * @param reference - Identity of a blockchain within a given namespace.
+ * @param assetNamespace - The namespace domain of an asset.
+ * @param assetReference - The identity of an asset within a given namespace.
+ * @throws {@link Error}
+ * This exception is thrown if the inputs do not comply with the CAIP-19
+ * syntax specification
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-19.md#syntax}.
+ * @returns A CAIP asset type.
+ */
+export declare function toCaipAssetType(namespace: CaipNamespace, reference: CaipReference, assetNamespace: CaipAssetNamespace, assetReference: CaipAssetReference): CaipAssetType;
+/**
+ * Asset ID as defined per the CAIP-19
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-19.md}.
+ *
+ * It defines a way to uniquely identify any blockchain asset in a human-readable
+ * way.
+ *
+ * @param namespace - The standard (ecosystem) of similar blockchains.
+ * @param reference - Identity of a blockchain within a given namespace.
+ * @param assetNamespace - The namespace domain of an asset.
+ * @param assetReference - The identity of an asset within a given namespace.
+ * @param tokenId - The unique identifier for an addressable asset of a given type.
+ * @throws {@link Error}
+ * This exception is thrown if the inputs do not comply with the CAIP-19
+ * syntax specification
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-19.md#syntax}.
+ * @returns A CAIP asset ID.
+ */
+export declare function toCaipAssetId(namespace: CaipNamespace, reference: CaipReference, assetNamespace: CaipAssetNamespace, assetReference: CaipAssetReference, tokenId: CaipTokenId): CaipAssetId;
+//# sourceMappingURL=caip-types.d.ts.map

package/dist/caip-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"caip-types.d.ts","sourceRoot":"","sources":["../src/caip-types.ts"],"names":[],"mappings":"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"}

package/dist/caip-types.js

@@ -0,0 +1,369 @@
+import { definePattern } from './superstruct.js';
+export const CAIP_CHAIN_ID_REGEX = /^(?<namespace>[-a-z0-9]{3,8}):(?<reference>[-_a-zA-Z0-9]{1,32})$/u;
+export const CAIP_NAMESPACE_REGEX = /^[-a-z0-9]{3,8}$/u;
+export const CAIP_REFERENCE_REGEX = /^[-_a-zA-Z0-9]{1,32}$/u;
+export const CAIP_ACCOUNT_ID_REGEX = /^(?<chainId>(?<namespace>[-a-z0-9]{3,8}):(?<reference>[-_a-zA-Z0-9]{1,32})):(?<accountAddress>[-.%a-zA-Z0-9]{1,128})$/u;
+export const CAIP_ACCOUNT_ADDRESS_REGEX = /^[-.%a-zA-Z0-9]{1,128}$/u;
+export const CAIP_ASSET_NAMESPACE_REGEX = /^[-a-z0-9]{3,8}$/u;
+export const CAIP_ASSET_REFERENCE_REGEX = /^[-.%a-zA-Z0-9]{1,128}$/u;
+export const CAIP_TOKEN_ID_REGEX = /^[-.%a-zA-Z0-9]{1,78}$/u;
+export const CAIP_ASSET_TYPE_REGEX = /^(?<chainId>(?<namespace>[-a-z0-9]{3,8}):(?<reference>[-_a-zA-Z0-9]{1,32}))\/(?<assetNamespace>[-a-z0-9]{3,8}):(?<assetReference>[-.%a-zA-Z0-9]{1,128})$/u;
+export const CAIP_ASSET_ID_REGEX = /^(?<chainId>(?<namespace>[-a-z0-9]{3,8}):(?<reference>[-_a-zA-Z0-9]{1,32}))\/(?<assetNamespace>[-a-z0-9]{3,8}):(?<assetReference>[-.%a-zA-Z0-9]{1,128})\/(?<tokenId>[-.%a-zA-Z0-9]{1,78})$/u;
+const CAIP_ASSET_TYPE_OR_ID_REGEX = /^(?<chainId>(?<namespace>[-a-z0-9]{3,8}):(?<reference>[-_a-zA-Z0-9]{1,32}))\/(?<assetNamespace>[-a-z0-9]{3,8}):(?<assetReference>[-.%a-zA-Z0-9]{1,128})(\/(?<tokenId>[-.%a-zA-Z0-9]{1,78}))?$/u;
+/**
+ * A CAIP-2 chain ID, i.e., a human-readable namespace and reference.
+ */
+export const CaipChainIdStruct = definePattern('CaipChainId', CAIP_CHAIN_ID_REGEX);
+/**
+ * A CAIP-2 namespace, i.e., the first part of a CAIP chain ID.
+ */
+export const CaipNamespaceStruct = definePattern('CaipNamespace', CAIP_NAMESPACE_REGEX);
+/**
+ * A CAIP-2 reference, i.e., the second part of a CAIP chain ID.
+ */
+export const CaipReferenceStruct = definePattern('CaipReference', CAIP_REFERENCE_REGEX);
+/**
+ * A CAIP-10 account ID, i.e., a human-readable namespace, reference, and account address.
+ */
+export const CaipAccountIdStruct = definePattern('CaipAccountId', CAIP_ACCOUNT_ID_REGEX);
+/**
+ * A CAIP-10 account address, i.e., the third part of the CAIP account ID.
+ */
+export const CaipAccountAddressStruct = definePattern('CaipAccountAddress', CAIP_ACCOUNT_ADDRESS_REGEX);
+/**
+ * A CAIP-19 asset namespace, i.e., a namespace domain of an asset.
+ */
+export const CaipAssetNamespaceStruct = definePattern('CaipAssetNamespace', CAIP_ASSET_NAMESPACE_REGEX);
+/**
+ * A CAIP-19 asset reference, i.e., an identifier for an asset within a given namespace.
+ */
+export const CaipAssetReferenceStruct = definePattern('CaipAssetReference', CAIP_ASSET_REFERENCE_REGEX);
+/**
+ * A CAIP-19 asset token ID, i.e., a unique identifier for an addressable asset of a given type
+ */
+export const CaipTokenIdStruct = definePattern('CaipTokenId', CAIP_TOKEN_ID_REGEX);
+/**
+ * A CAIP-19 asset type identifier, i.e., a human-readable type of asset identifier.
+ */
+export const CaipAssetTypeStruct = definePattern('CaipAssetType', CAIP_ASSET_TYPE_REGEX);
+/**
+ * A CAIP-19 asset ID identifier, i.e., a human-readable type of asset ID.
+ */
+export const CaipAssetIdStruct = definePattern('CaipAssetId', CAIP_ASSET_ID_REGEX);
+/**
+ * A CAIP-19 asset type or asset ID identifier, i.e., a human-readable type of asset identifier.
+ */
+export const CaipAssetTypeOrIdStruct = definePattern('CaipAssetTypeOrId', CAIP_ASSET_TYPE_OR_ID_REGEX);
+/** Known CAIP namespaces. */
+export var KnownCaipNamespace;
+(function (KnownCaipNamespace) {
+    /** BIP-122 (Bitcoin) compatible chains. */
+    KnownCaipNamespace["Bip122"] = "bip122";
+    /** Solana compatible chains */
+    KnownCaipNamespace["Solana"] = "solana";
+    /** Stellar compatible chains */
+    KnownCaipNamespace["Stellar"] = "stellar";
+    /** Tron compatible chains */
+    KnownCaipNamespace["Tron"] = "tron";
+    /** EIP-155 compatible chains. */
+    KnownCaipNamespace["Eip155"] = "eip155";
+    KnownCaipNamespace["Wallet"] = "wallet";
+})(KnownCaipNamespace || (KnownCaipNamespace = {}));
+/**
+ * Check if the given value is a {@link CaipChainId}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipChainId}.
+ */
+export function isCaipChainId(value) {
+    return typeof value === 'string' && CAIP_CHAIN_ID_REGEX.test(value);
+}
+/**
+ * Check if the given value is a {@link CaipNamespace}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipNamespace}.
+ */
+export function isCaipNamespace(value) {
+    return typeof value === 'string' && CAIP_NAMESPACE_REGEX.test(value);
+}
+/**
+ * Check if the given value is a {@link CaipReference}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipReference}.
+ */
+export function isCaipReference(value) {
+    return typeof value === 'string' && CAIP_REFERENCE_REGEX.test(value);
+}
+/**
+ * Check if the given value is a {@link CaipAccountId}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipAccountId}.
+ */
+export function isCaipAccountId(value) {
+    return typeof value === 'string' && CAIP_ACCOUNT_ID_REGEX.test(value);
+}
+/**
+ * Check if a value is a {@link CaipAccountAddress}.
+ *
+ * @param value - The value to validate.
+ * @returns True if the value is a valid {@link CaipAccountAddress}.
+ */
+export function isCaipAccountAddress(value) {
+    return typeof value === 'string' && CAIP_ACCOUNT_ADDRESS_REGEX.test(value);
+}
+/**
+ * Check if the given value is a {@link CaipAssetNamespace}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipAssetNamespace}.
+ */
+export function isCaipAssetNamespace(value) {
+    return typeof value === 'string' && CAIP_ASSET_NAMESPACE_REGEX.test(value);
+}
+/**
+ * Check if the given value is a {@link CaipAssetReference}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipAssetReference}.
+ */
+export function isCaipAssetReference(value) {
+    return typeof value === 'string' && CAIP_ASSET_REFERENCE_REGEX.test(value);
+}
+/**
+ * Check if the given value is a {@link CaipTokenId}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipTokenId}.
+ */
+export function isCaipTokenId(value) {
+    return typeof value === 'string' && CAIP_TOKEN_ID_REGEX.test(value);
+}
+/**
+ * Check if the given value is a {@link CaipAssetType}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipAssetType}.
+ */
+export function isCaipAssetType(value) {
+    return typeof value === 'string' && CAIP_ASSET_TYPE_REGEX.test(value);
+}
+/**
+ * Check if the given value is a {@link CaipAssetId}.
+ *
+ * @param value - The value to check.
+ * @returns Whether the value is a {@link CaipAssetId}.
+ */
+export function isCaipAssetId(value) {
+    return typeof value === 'string' && CAIP_ASSET_ID_REGEX.test(value);
+}
+/**
+ * Parse a CAIP-2 chain ID to an object containing the namespace and reference.
+ * This validates the CAIP-2 chain ID before parsing it.
+ *
+ * @param caipChainId - The CAIP-2 chain ID to validate and parse.
+ * @returns The parsed CAIP-2 chain ID.
+ */
+export function parseCaipChainId(caipChainId) {
+    const match = CAIP_CHAIN_ID_REGEX.exec(caipChainId);
+    if (!match?.groups) {
+        throw new Error('Invalid CAIP chain ID.');
+    }
+    return {
+        namespace: match.groups.namespace,
+        reference: match.groups.reference,
+    };
+}
+/**
+ * Parse an CAIP-10 account ID to an object containing the chain ID, parsed chain ID, and account address.
+ * This validates the CAIP-10 account ID before parsing it.
+ *
+ * @param caipAccountId - The CAIP-10 account ID to validate and parse.
+ * @returns The parsed CAIP-10 account ID.
+ */
+export function parseCaipAccountId(caipAccountId) {
+    const match = CAIP_ACCOUNT_ID_REGEX.exec(caipAccountId);
+    if (!match?.groups) {
+        throw new Error('Invalid CAIP account ID.');
+    }
+    return {
+        address: match.groups.accountAddress,
+        chainId: match.groups.chainId,
+        chain: {
+            namespace: match.groups.namespace,
+            reference: match.groups.reference,
+        },
+    };
+}
+/**
+ * Parse a CAIP-19 asset type to an object containing the chain ID, parsed chain ID,
+ * asset namespace, and asset reference
+ *
+ * This validates the CAIP-19 asset type before parsing it.
+ *
+ * @param caipAssetType - The CAIP-19 asset type to validate and parse.
+ * @returns The parsed CAIP-19 asset type.
+ */
+export function parseCaipAssetType(caipAssetType) {
+    const match = CAIP_ASSET_TYPE_REGEX.exec(caipAssetType);
+    if (!match?.groups) {
+        throw new Error('Invalid CAIP asset type.');
+    }
+    return {
+        assetNamespace: match.groups.assetNamespace,
+        assetReference: match.groups.assetReference,
+        chainId: match.groups.chainId,
+        chain: {
+            namespace: match.groups.namespace,
+            reference: match.groups.reference,
+        },
+    };
+}
+/**
+ * Parse a CAIP-19 asset ID to an object containing the chain ID, parsed chain ID,
+ * asset namespace, asset reference, and token ID.
+ *
+ * This validates the CAIP-19 asset ID before parsing it.
+ *
+ * @param caipAssetId - The CAIP-19 asset ID to validate and parse.
+ * @returns The parsed CAIP-19 asset ID.
+ */
+export function parseCaipAssetId(caipAssetId) {
+    const match = CAIP_ASSET_ID_REGEX.exec(caipAssetId);
+    if (!match?.groups) {
+        throw new Error('Invalid CAIP asset ID.');
+    }
+    return {
+        assetNamespace: match.groups.assetNamespace,
+        assetReference: match.groups.assetReference,
+        tokenId: match.groups.tokenId,
+        chainId: match.groups.chainId,
+        chain: {
+            namespace: match.groups.namespace,
+            reference: match.groups.reference,
+        },
+    };
+}
+/**
+ * Chain ID as defined per the CAIP-2
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-2.md}.
+ *
+ * It defines a way to uniquely identify any blockchain in a human-readable
+ * way.
+ *
+ * @param namespace - The standard (ecosystem) of similar blockchains.
+ * @param reference - Identify of a blockchain within a given namespace.
+ * @throws {@link Error}
+ * This exception is thrown if the inputs does not comply with the CAIP-2
+ * syntax specification
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-2.md#syntax}.
+ * @returns A CAIP chain ID.
+ */
+export function toCaipChainId(namespace, reference) {
+    if (!isCaipNamespace(namespace)) {
+        throw new Error(`Invalid "namespace", must match: ${CAIP_NAMESPACE_REGEX.toString()}`);
+    }
+    if (!isCaipReference(reference)) {
+        throw new Error(`Invalid "reference", must match: ${CAIP_REFERENCE_REGEX.toString()}`);
+    }
+    return `${namespace}:${reference}`;
+}
+/**
+ * Account ID as defined per the CAIP-10
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-10.md}.
+ *
+ * It defines a way to uniquely identify any blockchain account in a human-readable
+ * way.
+ *
+ * @param namespace - The standard (ecosystem) of similar blockchains.
+ * @param reference - Identity of a blockchain within a given namespace.
+ * @param accountAddress - The address of the blockchain account.
+ * @throws {@link Error}
+ * This exception is thrown if the inputs do not comply with the CAIP-10
+ * syntax specification
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-10.md#syntax}.
+ * @returns A CAIP account ID.
+ */
+export function toCaipAccountId(namespace, reference, accountAddress) {
+    if (!isCaipNamespace(namespace)) {
+        throw new Error(`Invalid "namespace", must match: ${CAIP_NAMESPACE_REGEX.toString()}`);
+    }
+    if (!isCaipReference(reference)) {
+        throw new Error(`Invalid "reference", must match: ${CAIP_REFERENCE_REGEX.toString()}`);
+    }
+    if (!isCaipAccountAddress(accountAddress)) {
+        throw new Error(`Invalid "accountAddress", must match: ${CAIP_ACCOUNT_ADDRESS_REGEX.toString()}`);
+    }
+    return `${namespace}:${reference}:${accountAddress}`;
+}
+/**
+ * Asset Type as defined per the CAIP-19
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-19.md}.
+ *
+ * It defines a way to uniquely identify any blockchain asset in a human-readable
+ * way.
+ *
+ * @param namespace - The standard (ecosystem) of similar blockchains.
+ * @param reference - Identity of a blockchain within a given namespace.
+ * @param assetNamespace - The namespace domain of an asset.
+ * @param assetReference - The identity of an asset within a given namespace.
+ * @throws {@link Error}
+ * This exception is thrown if the inputs do not comply with the CAIP-19
+ * syntax specification
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-19.md#syntax}.
+ * @returns A CAIP asset type.
+ */
+export function toCaipAssetType(namespace, reference, assetNamespace, assetReference) {
+    if (!isCaipNamespace(namespace)) {
+        throw new Error(`Invalid "namespace", must match: ${CAIP_NAMESPACE_REGEX.toString()}`);
+    }
+    if (!isCaipReference(reference)) {
+        throw new Error(`Invalid "reference", must match: ${CAIP_REFERENCE_REGEX.toString()}`);
+    }
+    if (!isCaipAssetNamespace(assetNamespace)) {
+        throw new Error(`Invalid "assetNamespace", must match: ${CAIP_ASSET_NAMESPACE_REGEX.toString()}`);
+    }
+    if (!isCaipAssetReference(assetReference)) {
+        throw new Error(`Invalid "assetReference", must match: ${CAIP_ASSET_REFERENCE_REGEX.toString()}`);
+    }
+    return `${namespace}:${reference}/${assetNamespace}:${assetReference}`;
+}
+/**
+ * Asset ID as defined per the CAIP-19
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-19.md}.
+ *
+ * It defines a way to uniquely identify any blockchain asset in a human-readable
+ * way.
+ *
+ * @param namespace - The standard (ecosystem) of similar blockchains.
+ * @param reference - Identity of a blockchain within a given namespace.
+ * @param assetNamespace - The namespace domain of an asset.
+ * @param assetReference - The identity of an asset within a given namespace.
+ * @param tokenId - The unique identifier for an addressable asset of a given type.
+ * @throws {@link Error}
+ * This exception is thrown if the inputs do not comply with the CAIP-19
+ * syntax specification
+ * {@link https://github.com/ChainAgnostic/CAIPs/blob/main/CAIPs/caip-19.md#syntax}.
+ * @returns A CAIP asset ID.
+ */
+export function toCaipAssetId(namespace, reference, assetNamespace, assetReference, tokenId) {
+    if (!isCaipNamespace(namespace)) {
+        throw new Error(`Invalid "namespace", must match: ${CAIP_NAMESPACE_REGEX.toString()}`);
+    }
+    if (!isCaipReference(reference)) {
+        throw new Error(`Invalid "reference", must match: ${CAIP_REFERENCE_REGEX.toString()}`);
+    }
+    if (!isCaipAssetNamespace(assetNamespace)) {
+        throw new Error(`Invalid "assetNamespace", must match: ${CAIP_ASSET_NAMESPACE_REGEX.toString()}`);
+    }
+    if (!isCaipAssetReference(assetReference)) {
+        throw new Error(`Invalid "assetReference", must match: ${CAIP_ASSET_REFERENCE_REGEX.toString()}`);
+    }
+    if (!isCaipTokenId(tokenId)) {
+        throw new Error(`Invalid "tokenId", must match: ${CAIP_TOKEN_ID_REGEX.toString()}`);
+    }
+    return `${namespace}:${reference}/${assetNamespace}:${assetReference}/${tokenId}`;
+}
+//# sourceMappingURL=caip-types.js.map