BREAKING: Remove duplicate CAIP types (#3071)

This removes duplicate CAIP types that were moved to `@metamask/utils`.
We were already using the `@metamask/utils` types in most places.

Closes #3043.

## Breaking changes

- The following functions, values, types, and structs were removed from
`@metamask/snaps-utils`:
   - `CHAIN_ID_REGEX`
   - `ACCOUNT_ID_REGEX`
   - `ACCOUNT_ADDRESS_REGEX`
   - `parseChainId`
   - `parseAccountId`
   - `LimitedString`
   - `ChainIdStringStruct`
   - `ChainIdStruct`
   - `AccountIdStruct`
   - `AccountIdArrayStruct`
   - `AccountAddressStruct`
   - `AccountAddress`
   - `ChainStruct`
   - `Chain`
   - `NamespaceStruct`
   - `Namespace`
   - `NamespaceIdStruct`
   - `NamespaceId`
   - `isNamespaceId`
   - `isChainId`
   - `isAccountId`
   - `isAccountIdArray`
   - `isNamespace`

Author: Mrtenz

packages/snaps-execution-environments/src/common/validation.ts

@@ -3,7 +3,7 @@ import {
   InterfaceContextStruct,
   UserInputEventStruct,
 } from '@metamask/snaps-sdk';
-import { ChainIdStruct, HandlerType } from '@metamask/snaps-utils';
+import { HandlerType } from '@metamask/snaps-utils';
 import type { Infer, Struct } from '@metamask/superstruct';
 import {
   any,
@@ -127,7 +127,7 @@ export type RequestArguments =
 export const OnTransactionRequestArgumentsStruct = object({
   // TODO: Improve `transaction` type.
   transaction: record(string(), JsonStruct),
-  chainId: ChainIdStruct,
+  chainId: CaipChainIdStruct,
   transactionOrigin: nullable(string()),
 });
 
@@ -182,7 +182,7 @@ export function assertIsOnSignatureRequestArguments(
   );
 }
 
-const baseNameLookupArgs = { chainId: ChainIdStruct };
+const baseNameLookupArgs = { chainId: CaipChainIdStruct };
 const domainRequestStruct = object({
   ...baseNameLookupArgs,
   address: string(),

packages/snaps-rpc-methods/src/endowments/name-lookup.test.ts

@@ -243,7 +243,7 @@ describe('nameLookupCaveatSpecifications', () => {
           value: ['eip155'],
         }),
       ).toThrow(
-        'Assertion failed: At path: 0 -- Expected a Chain ID matching `/^(?<namespace>[-a-z0-9]{3,8}):(?<reference>[-a-zA-Z0-9]{1,32})$/` but received "eip155".',
+        'Assertion failed: At path: 0 -- Expected a value of type `CaipChainId`, but received: `"eip155"`.',
       );
 
       expect(() =>

packages/snaps-sdk/src/types/caip.test.ts

@@ -1,13 +1,24 @@
+import type { CaipAccountId, CaipChainId } from '@metamask/utils';
+
+export type {
+  CaipAccountId,
+  CaipAssetType,
+  CaipChainId,
+  CaipNamespace,
+} from '@metamask/utils';
+
 /**
  * A CAIP-2 chain ID, i.e., a human-readable namespace and reference.
  *
  * @see https://chainagnostic.org/CAIPs/caip-2
+ * @deprecated Use {@link CaipChainId} instead.
  */
-export type ChainId = `${string}:${string}`;
+export type ChainId = CaipChainId;
 
 /**
  * A CAIP-10 account ID, i.e., a chain ID and an account address.
  *
  * @see https://chainagnostic.org/CAIPs/caip-10
+ * @deprecated Use {@link CaipAccountId} instead.
  */
-export type AccountId = `${ChainId}:${string}`;
+export type AccountId = CaipAccountId;

packages/snaps-sdk/src/types/caip.ts

@@ -1,9 +1,7 @@
-import type { NonEmptyArray } from '@metamask/utils';
-
-import type { ChainId } from '../caip';
+import type { CaipChainId, NonEmptyArray } from '@metamask/utils';
 
 type BaseOnNameLookupArgs = {
-  chainId: ChainId;
+  chainId: CaipChainId;
 };
 
 /**
@@ -76,7 +74,7 @@ export type AddressLookupResult = {
  * Note that using this handler requires the `endowment:name-lookup` permission.
  *
  * @param args - The request arguments.
- * @param args.chainId - The CAIP-2 {@link ChainId} of the network the
+ * @param args.chainId - The CAIP-2 {@link CaipChainId} of the network the
  * transaction is being submitted to.
  * @param args.domain - The human-readable address that is to be resolved. This
  * is mutually exclusive with `args.address`.

packages/snaps-sdk/src/types/handlers/name-lookup.ts

@@ -1,6 +1,7 @@
+import type { CaipChainId } from '@metamask/utils';
+
 import type { ComponentOrElement } from '..';
 import type { EnumToUnion } from '../../internals';
-import type { ChainId } from '../caip';
 
 /**
  * The severity level of content being returned from a transaction insight.
@@ -87,7 +88,7 @@ export type Transaction = EIP1559Transaction | LegacyTransaction;
  * @param args - The request arguments.
  * @param args.transaction - The transaction object, containing the address,
  * value, data, and other properties of the transaction.
- * @param args.chainId - The CAIP-2 {@link ChainId} of the network the
+ * @param args.chainId - The CAIP-2 {@link CaipChainId} of the network the
  * transaction is being submitted to.
  * @param args.transactionOrigin - The origin of the transaction. This is the
  * URL of the website that submitted the transaction. This is only available if
@@ -99,7 +100,7 @@ export type Transaction = EIP1559Transaction | LegacyTransaction;
  */
 export type OnTransactionHandler = (args: {
   transaction: Transaction;
-  chainId: ChainId;
+  chainId: CaipChainId;
   transactionOrigin?: string;
 }) => Promise<OnTransactionResponse | null>;
 

packages/snaps-sdk/src/types/handlers/transaction.ts

@@ -1,7 +1,5 @@
 import type { SupportedCurve } from '@metamask/key-tree';
-import type { JsonRpcRequest } from '@metamask/utils';
-
-import type { ChainId } from './caip';
+import type { CaipChainId, JsonRpcRequest } from '@metamask/utils';
 
 export type EmptyObject = Record<string, never>;
 
@@ -49,7 +47,7 @@ export type InitialPermissions = Partial<{
     maxRequestTime?: number;
   };
   'endowment:name-lookup': {
-    chains?: ChainId[];
+    chains?: CaipChainId[];
     matchers?: NameLookupMatchers;
     maxRequestTime?: number;
   };

packages/snaps-sdk/src/types/permissions.ts

@@ -1,6 +1,6 @@
 {
   "branches": 99.74,
-  "functions": 98.95,
-  "lines": 99.47,
-  "statements": 96.27
+  "functions": 98.92,
+  "lines": 99.61,
+  "statements": 96.91
 }

packages/snaps-utils/coverage.json

@@ -4,5 +4,4 @@ export * from './handlers';
 export * from './handler-types';
 export * from './iframe';
 export * from './logging';
-export * from './namespace';
 export * from './types';

packages/snaps-utils/src/index.executionenv.ts

@@ -20,7 +20,6 @@ export * from './json-rpc';
 export * from './localization';
 export * from './logging';
 export * from './manifest';
-export * from './namespace';
 export * from './path';
 export * from './platform-version';
 export * from './snaps';