fix: initial multichain core (#1317)

* fix: add initial implementation of the multichain building-block

* fix: useUnknownInCatchVariables in tsconfig to allow err in catch to be any not unknown

* fix: add error handling and rpcClient coverage

* fix: add test coverage

* fix: improve tests for multichain init

* fix: improve testing coverage

* fix: remove empty lines

* fix: remove biome lint err

* fix: add missing jsdom pkg

* fix: code + test improvements

* fix: session upgrade test

* fix: using provider before its defined in sdk constructor

* fix: testing against wrong expect

Author: elribonazo

packages/sdk-multichain/README.md

@@ -19,4 +19,6 @@ src/
 │   ├── events/       # Event-driven communication
 │   ├── platform/     # Platform detection utilities
 │   └── store/        # Storage abstractions
+├── multichain/       # Concrete implementations
+└── store/           # Storage implementations
 ```

packages/sdk-multichain/package.json

@@ -34,6 +34,7 @@
     "@react-native-async-storage/async-storage": "^1.19.6",
     "@vitest/coverage-v8": "^3.2.4",
     "esbuild-plugin-umd-wrapper": "^3.0.0",
+    "jsdom": "^26.1.0",
     "nock": "^14.0.4",
     "prettier": "^3.3.3",
     "tsup": "^8.5.0",

packages/sdk-multichain/src/domain/errors/base.ts

@@ -0,0 +1,10 @@
+import type { ErrorCodes } from "./types";
+
+export abstract class BaseErr<C extends string, T extends ErrorCodes> extends Error {
+  constructor(
+    public readonly message: `${C}Err${T}: ${string}`,
+    public readonly code: T,
+  ) {
+    super(message);
+  }
+}

packages/sdk-multichain/src/domain/errors/index.ts

@@ -0,0 +1,2 @@
+export * from './rpc'
+export * from './types';

packages/sdk-multichain/src/domain/errors/rpc.ts

@@ -0,0 +1,53 @@
+
+import { BaseErr } from "./base";
+import type { RPCErrorCodes } from "./types";
+
+export class RPCHttpErr extends BaseErr<'RPC', RPCErrorCodes> {
+  static readonly code = 50;
+  constructor(
+     readonly rpcEndpoint: string,
+     readonly method: string,
+     readonly httpStatus: number,
+  ) {
+    super(
+      `RPCErr${RPCHttpErr.code}: ${httpStatus} on ${rpcEndpoint} for method ${method}`,
+      RPCHttpErr.code
+    );
+  }
+}
+
+export class RPCReadonlyResponseErr extends BaseErr<'RPC', RPCErrorCodes> {
+  static readonly code = 51;
+  constructor(
+    public readonly reason: string,
+  ) {
+    super(
+      `RPCErr${RPCReadonlyResponseErr.code}: RPC Client response reason ${reason}`,
+      RPCReadonlyResponseErr.code
+    );
+  }
+}
+
+export class RPCReadonlyRequestErr extends BaseErr<'RPC', RPCErrorCodes> {
+  static readonly code = 52;
+  constructor(
+    public readonly reason: string,
+  ) {
+    super(
+      `RPCErr${RPCReadonlyRequestErr.code}: RPC Client fetch reason ${reason}`,
+      RPCReadonlyRequestErr.code
+    );
+  }
+}
+
+export class RPCInvokeMethodErr extends BaseErr<'RPC', RPCErrorCodes> {
+  static readonly code = 53;
+  constructor(
+    public readonly reason: string,
+  ) {
+    super(
+      `RPCErr${RPCInvokeMethodErr.code}: RPC Client invoke method reason ${reason}`,
+      RPCInvokeMethodErr.code
+    );
+  }
+}

packages/sdk-multichain/src/domain/errors/storage.ts

@@ -0,0 +1,45 @@
+
+import { BaseErr } from "./base";
+import type {  StorageErrorCodes } from "./types";
+
+export class StorageGetErr extends BaseErr<'Storage', StorageErrorCodes> {
+  static readonly code = 60;
+  constructor(
+    public readonly platform: 'web' | 'rn' | 'node',
+    public readonly key: string,
+    public readonly reason: string,
+  ) {
+    super(
+      `StorageErr${StorageGetErr.code}: ${platform} storage get error in key: ${key} - ${reason}`,
+      StorageGetErr.code
+    );
+  }
+}
+
+export class StorageSetErr extends BaseErr<'Storage', StorageErrorCodes> {
+  static readonly code = 61;
+  constructor(
+    public readonly platform: 'web' | 'rn' | 'node',
+    public readonly key: string,
+    public readonly reason: string,
+  ) {
+    super(
+      `StorageErr${StorageSetErr.code}: ${platform} storage set error in key: ${key} - ${reason}`,
+      StorageSetErr.code
+    );
+  }
+}
+
+export class StorageDeleteErr extends BaseErr<'Storage', StorageErrorCodes> {
+  static readonly code = 62;
+  constructor(
+    public readonly platform: 'web' | 'rn' | 'node',
+    public readonly key: string,
+    public readonly reason: string,
+  ) {
+    super(
+      `StorageErr${StorageDeleteErr.code}: ${platform} storage delete error in key: ${key} - ${reason}`,
+      StorageDeleteErr.code
+    );
+  }
+}

packages/sdk-multichain/src/domain/errors/types.ts

@@ -0,0 +1,14 @@
+export type Enumerate<N extends number, Acc extends number[] = []> = Acc['length'] extends N
+? Acc[number]
+: Enumerate<N, [...Acc, Acc['length']]>;
+
+export type ErrorCodeRange<F extends number, T extends number> = Exclude<Enumerate<T>, Enumerate<F>>;
+
+export type DomainErrorCodes = ErrorCodeRange<1, 50>;
+export type RPCErrorCodes = ErrorCodeRange<50, 60>;
+export type StorageErrorCodes = ErrorCodeRange<60, 70>;
+
+export type ErrorCodes =
+  | DomainErrorCodes
+  | RPCErrorCodes
+  | StorageErrorCodes;

packages/sdk-multichain/src/domain/index.test.ts

@@ -3,9 +3,7 @@
 import * as t from 'vitest'
 import Bowser from 'bowser';
 
-import { EventEmitter,ExtensionEvents, SDKEvents, getPlatformType, PlatformType, createLogger, enableDebug, isEnabled } from './';
-
-
+import { EventEmitter,type ExtensionEvents, type SDKEvents, getPlatformType, PlatformType, createLogger, enableDebug, isEnabled } from './';
 
 
 const parseMock = t.vi.fn();

packages/sdk-multichain/src/domain/index.ts

@@ -1,3 +1,4 @@
+export * from './errors';
 export * from './platform';
 export * from './multichain';
 export * from './events';

packages/sdk-multichain/src/domain/multichain/api/constants.ts

@@ -1,5 +1,5 @@
 /* c8 ignore start */
-import { RPC_URLS_MAP } from "./types";
+import type { RPC_URLS_MAP } from "./types";
 
 export const infuraRpcUrls: RPC_URLS_MAP = {
   // ###### Ethereum ######