feat: implement CAIP25 MultiChain API and NextJS playground integration

package.json

@@ -10,6 +10,7 @@
     "packages/sdk-socket-server-next",
     "packages/sdk-install-modal-web",
     "packages/sdk-communication-layer",
+    "packages/multichainapi",
     "packages/sdk",
     "packages/sdk-react",
     "packages/sdk-react-native",
@@ -34,7 +35,7 @@
     "postinstall": "patch-package",
     "link-packages": "./scripts/link-packages.sh",
     "prepare": "husky install",
-    "dev:core": "turbo run dev --parallel --filter=@metamask/sdk-communication-layer --filter=@metamask/sdk --filter=@metamask/sdk-react",
+    "dev:core": "turbo run dev --parallel --filter=@metamask/sdk-communication-layer --filter=@metamask/multichainapi --filter=@metamask/sdk --filter=@metamask/sdk-react",
     "lint": "yarn workspaces foreach --no-private run lint",
     "lint:changelogs": "yarn workspaces foreach --no-private run lint:changelog",
     "lint:eslint": "yarn workspaces foreach --no-private run lint:eslint",

packages/multichainapi/.eslintrc.js

@@ -0,0 +1,45 @@
+const path = require('path');
+
+/**
+ * @type {import('eslint').Linter.Config}
+ */
+module.exports = {
+  extends: ['@metamask/eslint-config-typescript', '../../.eslintrc.js'],
+  root: true,
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    project: [path.resolve(__dirname, 'tsconfig.eslint.json')],
+  },
+
+  ignorePatterns: [
+    '.prettierrc.js',
+    '**/.eslintrc.js',
+    'jest.config.ts',
+    '**/dist*/',
+    'rollup.config.js',
+    '**/coverage/**',
+  ],
+
+  overrides: [
+    {
+      files: ['**/*.ts'],
+      rules: {
+        '@typescript-eslint/consistent-type-definitions': [
+          'error',
+          'interface',
+        ],
+        '@typescript-eslint/no-floating-promises': 'error',
+        'no-async-promise-executor': 'error',
+        'import/no-named-as-default': 0,
+        'no-shadow': 'off',
+        '@typescript-eslint/no-shadow': ['error'],
+      },
+    },
+    {
+      files: ['**/*.d.ts'],
+      rules: {
+        'import/unambiguous': 'off',
+      },
+    },
+  ],
+};

packages/multichainapi/jest.config.js

@@ -0,0 +1,7 @@
+/** @type {import('jest').Config} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testMatch: ['**/*.test.ts'],
+  collectCoverageFrom: ['src/**/*.ts', '!src/**/*.d.ts'],
+};

packages/multichainapi/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@metamask/multichainapi",
+  "version": "0.1.0",
+  "description": "CAIP-based multichain API for MetaMask",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MetaMask/metamask-sdk",
+    "directory": "packages/multichainapi"
+  },
+  "main": "dist/node/cjs/index.js",
+  "module": "dist/browser/es/index.js",
+  "browser": "dist/browser/es/index.js",
+  "types": "dist/types/src/index.d.ts",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build:types": "tsc --project tsconfig.build.json --emitDeclarationOnly --outDir dist/types",
+    "build": "yarn build:types && rollup -c --bundleConfigAsCjs",
+    "build:clean": "yarn clean && yarn build",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf ./dist",
+    "lint": "yarn lint:eslint && yarn lint:misc --check",
+    "lint:changelog": "../../scripts/validate-changelog.sh @metamask/multichainapi",
+    "lint:eslint": "eslint . --cache --ext js,ts",
+    "lint:fix": "yarn lint:eslint --fix && yarn lint:misc --write",
+    "lint:misc": "prettier '**/*.json' '**/*.md' '!CHANGELOG.md' --ignore-path ../../.gitignore",
+    "test": "jest",
+    "test:watch": "jest --watch"
+  },
+  "dependencies": {
+    "@babel/runtime": "^7.26.0",
+    "@metamask/api-specs": "^0.10.13",
+    "@metamask/utils": "^11.0.1",
+    "@open-rpc/meta-schema": "^1.14.9",
+    "@types/chrome": "^0.0.296",
+    "debug": "^4.3.4",
+    "eventemitter2": "^6.4.9",
+    "tslib": "^2.6.2"
+  },
+  "devDependencies": {
+    "@jest/globals": "^29.3.1",
+    "@lavamoat/allow-scripts": "^3.3.1",
+    "@metamask/auto-changelog": "3.1.0",
+    "@metamask/eslint-config": "^6.0.0",
+    "@metamask/eslint-config-typescript": "^6.0.0",
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-json": "^6.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.2",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@types/debug": "^4.1.12",
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.1.3",
+    "@typescript-eslint/eslint-plugin": "^4.26.0",
+    "@typescript-eslint/parser": "^4.26.0",
+    "eslint": "^7.30.0",
+    "jest": "^29.3.1",
+    "prettier": "^2.3.0",
+    "rimraf": "^4.4.0",
+    "rollup": "^4.9.4",
+    "ts-jest": "^29.0.3",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

packages/multichainapi/rollup.config.js

@@ -0,0 +1,73 @@
+import typescript from '@rollup/plugin-typescript';
+import { nodeResolve } from '@rollup/plugin-node-resolve';
+import commonjs from '@rollup/plugin-commonjs';
+import json from '@rollup/plugin-json';
+import terser from '@rollup/plugin-terser';
+
+const packageJson = require('./package.json');
+
+// Dependencies that should be external
+const external = [
+  ...Object.keys(packageJson.dependencies || {}),
+  ...Object.keys(packageJson.peerDependencies || {}),
+  ...Object.keys(packageJson.optionalDependencies || {}),
+];
+
+/**
+ * @type {import('rollup').RollupOptions[]}
+ */
+const configs = [
+  // Node.js build
+  {
+    input: 'src/index.ts',
+    output: [
+      {
+        file: packageJson.main,
+        format: 'cjs',
+        sourcemap: true,
+        exports: 'named',
+      },
+    ],
+    external,
+    plugins: [
+      typescript({
+        tsconfig: './tsconfig.build.json',
+      }),
+      nodeResolve({
+        preferBuiltins: true,
+        exportConditions: ['node'],
+      }),
+      commonjs(),
+      json(),
+      terser(),
+    ],
+  },
+  // Browser build
+  {
+    input: 'src/index.ts',
+    output: [
+      {
+        file: packageJson.module,
+        format: 'es',
+        sourcemap: true,
+        exports: 'named',
+      },
+    ],
+    external,
+    plugins: [
+      typescript({
+        tsconfig: './tsconfig.build.json',
+      }),
+      nodeResolve({
+        browser: true,
+        preferBuiltins: false,
+        exportConditions: ['browser'],
+      }),
+      commonjs(),
+      json(),
+      terser(),
+    ],
+  },
+];
+
+export default configs;