@ledgerhq/wallet-api-simulator 0.12.4 → 1.0.0

package/lib/core/src/JSONRPC/RpcNode.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcNode = void 0;
+const uuid_1 = require("uuid");
+const zod_1 = require("zod");
+const errors_1 = require("@ledgerhq/errors");
+const errors_2 = require("../errors");
+const helpers_1 = require("./helpers");
+const RPCError_1 = require("./RPCError");
+const types_1 = require("./types");
+class RpcNode {
+    transport;
+    requestHandlers;
+    ongoingRequests = {};
+    constructor(transport, requestHandlers) {
+        this.transport = transport;
+        this.requestHandlers = requestHandlers;
+        this.transport.onMessage = (message) => {
+            void this.handleMessage(message);
+        };
+    }
+    _request(request) {
+        return new Promise((resolve, reject) => {
+            if (!request.id) {
+                reject(new Error("requests need to have an id"));
+                return;
+            }
+            const resolver = (response) => {
+                if ("error" in response) {
+                    if (response.error.code === types_1.RpcErrorCode.SERVER_ERROR) {
+                        const serverErrorData = errors_2.schemaServerErrorData.parse(response.error.data);
+                        if (serverErrorData.code === "UNKNOWN_ERROR") {
+                            reject((0, errors_1.deserializeError)(serverErrorData.data));
+                            return;
+                        }
+                        reject(new errors_2.ServerError(serverErrorData));
+                        return;
+                    }
+                    reject(new RPCError_1.RpcError(response.error));
+                    return;
+                }
+                resolve(response.result);
+            };
+            this.ongoingRequests[request.id] = resolver;
+            this.transport.send(JSON.stringify(request));
+        });
+    }
+    _notify(request) {
+        this.transport.send(JSON.stringify(request));
+    }
+    request(method, params) {
+        const requestId = (0, uuid_1.v4)();
+        return this._request({
+            id: requestId,
+            jsonrpc: "2.0",
+            method,
+            params,
+        });
+    }
+    notify(method, params) {
+        return this._notify({
+            jsonrpc: "2.0",
+            method,
+            params,
+        });
+    }
+    async handleRpcRequest(request) {
+        try {
+            const result = await this.onRequest(request);
+            if (request.id) {
+                const response = (0, helpers_1.createRpcResponse)({
+                    id: request.id,
+                    result,
+                });
+                this.transport.send(JSON.stringify(response));
+            }
+        }
+        catch (error) {
+            if (error instanceof zod_1.z.ZodError) {
+                throw new RPCError_1.RpcError({
+                    code: types_1.RpcErrorCode.INVALID_PARAMS,
+                    message: error.message,
+                    data: error.flatten(),
+                });
+            }
+            if (error instanceof errors_2.ServerError) {
+                throw new RPCError_1.RpcError({
+                    code: types_1.RpcErrorCode.SERVER_ERROR,
+                    message: "unexpected server error",
+                    data: error.getData(),
+                });
+            }
+            if (error instanceof RPCError_1.RpcError) {
+                throw error;
+            }
+            throw new RPCError_1.RpcError({
+                code: types_1.RpcErrorCode.SERVER_ERROR,
+                message: "unexpected server error",
+                // @ts-expect-error: Bad typings on serialize error !!
+                data: (0, errors_2.createUnknownError)((0, errors_1.serializeError)(error)),
+            });
+        }
+    }
+    async handleMessage(message) {
+        let isResponse = false;
+        let callId;
+        try {
+            const rpcCall = (0, helpers_1.parseRPCCall)(message);
+            callId = rpcCall.id;
+            if ("method" in rpcCall) {
+                // message is a request
+                await this.handleRpcRequest(rpcCall);
+            }
+            else {
+                // message is a response
+                isResponse = true;
+                this.handleRpcResponse(rpcCall);
+            }
+        }
+        catch (error) {
+            if (isResponse) {
+                throw error;
+            }
+            if (error instanceof RPCError_1.RpcError) {
+                const errorResponse = (0, helpers_1.createRpcResponse)({
+                    id: callId || null,
+                    error: {
+                        code: error.getCode(),
+                        message: error.message,
+                        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+                        data: error.getData(),
+                    },
+                });
+                this.transport.send(JSON.stringify(errorResponse));
+                return;
+            }
+            // TODO handle no RpcError (that should not happen btw)
+            throw error;
+        }
+    }
+    handleRpcResponse(response) {
+        if (!response.id) {
+            return;
+        }
+        const resolver = this.ongoingRequests[response.id];
+        if (!resolver) {
+            throw new Error(`no ongoingRequest ${response.id}`);
+        }
+        resolver(response);
+    }
+}
+exports.RpcNode = RpcNode;
+//# sourceMappingURL=RpcNode.js.map

package/lib/core/src/JSONRPC/RpcNode.js.map

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

package/lib/core/src/JSONRPC/helpers.d.ts

@@ -0,0 +1,18 @@
+import { RpcRequest, RpcResponse, RpcResponseError } from "./types";
+export declare function parseRPCCall(data: string): RpcRequest | RpcResponse;
+type CreateRpcRequestParams<T> = {
+    id?: string | number | null;
+    method: string;
+    params?: T;
+};
+export declare function createRpcRequest<T>(params: CreateRpcRequestParams<T>): RpcRequest<string, T>;
+type CreateRpcResponseParams<T, E> = {
+    id: string | number | null;
+    result: T;
+} | {
+    id: string | number | null;
+    error: RpcResponseError<E>;
+};
+export declare function createRpcResponse<T, E>(params: CreateRpcResponseParams<T, E>): RpcResponse<T, E>;
+export {};
+//# sourceMappingURL=helpers.d.ts.map

package/lib/core/src/JSONRPC/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../../../core/src/JSONRPC/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,UAAU,EACV,WAAW,EACX,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAGjB,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAqBnE;AAED,KAAK,sBAAsB,CAAC,CAAC,IAAI;IAC/B,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,CAAC,CAAC;CACZ,CAAC;AACF,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAChC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAKvB;AAED,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAC7B;IACE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,CAAC,CAAC;CACX,GACD;IACE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC5B,CAAC;AACN,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,CAAC,EACpC,MAAM,EAAE,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,GACpC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAKnB"}

package/lib/core/src/JSONRPC/helpers.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRpcResponse = exports.createRpcRequest = exports.parseRPCCall = void 0;
+const zod_1 = require("zod");
+const RPCError_1 = require("./RPCError");
+const types_1 = require("./types");
+const validation_1 = require("./validation");
+function parseRPCCall(data) {
+    try {
+        const parsedData = JSON.parse(data);
+        const rpcCall = validation_1.schemaRPCCall.parse(parsedData);
+        return rpcCall;
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new RPCError_1.RpcError({
+                code: types_1.RpcErrorCode.PARSE_ERROR,
+                message: "parse error",
+            });
+        }
+        if (error instanceof zod_1.z.ZodError) {
+            throw new RPCError_1.RpcError({
+                code: types_1.RpcErrorCode.INVALID_REQUEST,
+                message: "invalid request",
+            });
+        }
+        throw error;
+    }
+}
+exports.parseRPCCall = parseRPCCall;
+function createRpcRequest(params) {
+    return {
+        jsonrpc: "2.0",
+        ...params,
+    };
+}
+exports.createRpcRequest = createRpcRequest;
+function createRpcResponse(params) {
+    return {
+        jsonrpc: "2.0",
+        ...params,
+    };
+}
+exports.createRpcResponse = createRpcResponse;
+//# sourceMappingURL=helpers.js.map

package/lib/core/src/JSONRPC/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../../../core/src/JSONRPC/helpers.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,yCAAsC;AACtC,mCAKiB;AACjB,6CAA6C;AAE7C,SAAgB,YAAY,CAAC,IAAY;IACvC,IAAI;QACF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;QAE/C,MAAM,OAAO,GAAG,0BAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAChD,OAAO,OAAO,CAAC;KAChB;IAAC,OAAO,KAAK,EAAE;QACd,IAAI,KAAK,YAAY,WAAW,EAAE;YAChC,MAAM,IAAI,mBAAQ,CAAC;gBACjB,IAAI,EAAE,oBAAY,CAAC,WAAW;gBAC9B,OAAO,EAAE,aAAa;aACvB,CAAC,CAAC;SACJ;QACD,IAAI,KAAK,YAAY,OAAC,CAAC,QAAQ,EAAE;YAC/B,MAAM,IAAI,mBAAQ,CAAC;gBACjB,IAAI,EAAE,oBAAY,CAAC,eAAe;gBAClC,OAAO,EAAE,iBAAiB;aAC3B,CAAC,CAAC;SACJ;QACD,MAAM,KAAK,CAAC;KACb;AACH,CAAC;AArBD,oCAqBC;AAOD,SAAgB,gBAAgB,CAC9B,MAAiC;IAEjC,OAAO;QACL,OAAO,EAAE,KAAK;QACd,GAAG,MAAM;KACV,CAAC;AACJ,CAAC;AAPD,4CAOC;AAWD,SAAgB,iBAAiB,CAC/B,MAAqC;IAErC,OAAO;QACL,OAAO,EAAE,KAAK;QACd,GAAG,MAAM;KACV,CAAC;AACJ,CAAC;AAPD,8CAOC"}

package/lib/core/src/JSONRPC/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./RPCError";
+export * from "./types";
+export * from "./validation";
+export * from "./helpers";
+export * from "./RpcNode";
+//# sourceMappingURL=index.d.ts.map

package/lib/core/src/JSONRPC/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../core/src/JSONRPC/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/lib/core/src/JSONRPC/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./RPCError"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./validation"), exports);
+__exportStar(require("./helpers"), exports);
+__exportStar(require("./RpcNode"), exports);
+//# sourceMappingURL=index.js.map

package/lib/core/src/JSONRPC/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../core/src/JSONRPC/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,0CAAwB;AACxB,+CAA6B;AAC7B,4CAA0B;AAC1B,4CAA0B"}

package/lib/core/src/JSONRPC/types.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Error code that may occur during WalletAPI server communication
+ * @enum
+ */
+export declare enum RpcErrorCode {
+    /**
+     * Invalid JSON was received by the server.
+     * or An error occurred on the server while parsing the JSON text.
+     */
+    PARSE_ERROR = -32700,
+    /**
+     * The JSON sent is not a valid Request object.
+     */
+    INVALID_REQUEST = -32600,
+    /**
+     * The method does not exist / is not available.
+     */
+    METHOD_NOT_FOUND = -32601,
+    /**
+     * Invalid method parameter(s).
+     */
+    INVALID_PARAMS = -32602,
+    /**
+     * Internal JSON-RPC error.
+     */
+    INTERNAL_ERROR = -32603,
+    /**
+     * Reserved for implementation-defined server-errors.
+     */
+    SERVER_ERROR = -32000
+}
+/**
+ * A rpc call is represented by sending a Request object to a Server.
+ */
+export interface RpcRequest<MParam = string, TParam = unknown> {
+    /**
+     * A String specifying the version of the JSON-RPC protocol. **MUST** be exactly "2.0".
+     */
+    jsonrpc: "2.0";
+    /**
+     * A String containing the name of the method to be invoked.
+     */
+    method: MParam;
+    /**
+     * A Structured value that holds the parameter values
+     * to be used during the invocation of the method.
+     */
+    params?: TParam;
+    /**
+     * An identifier established by the Client that **MUST** contain a `String`, `Number`,
+     * or `NULL` value if included.
+     * If it is not included it is assumed to be a notification.
+     * The value **SHOULD** normally not be Null and Numbers **SHOULD NOT** contain fractional parts
+     */
+    id?: string | number | null;
+}
+/**
+ * When a rpc call encounters an error,
+ * the Response Object MUST contain the error member with a value that is that object
+ */
+export interface RpcResponseError<TErrorData = unknown> {
+    /**
+     * A Number that indicates the error type that occurred.
+     */
+    code: number | RpcErrorCode;
+    /**
+     * A String providing a short description of the error.
+     */
+    message: string;
+    /**
+     * A Primitive or Structured value that contains additional information about the error.
+     * The value of this member is defined by the Server
+     * (e.g. detailed error information, nested errors etc.).
+     */
+    data?: TErrorData;
+}
+export interface RpcResponseCommon {
+    /**
+     * A String specifying the version of the JSON-RPC protocol.
+     * **MUST** be exactly "2.0".
+     */
+    jsonrpc: "2.0";
+    /**
+     * An identifier established by the Client that **MUST** contain a `String`, `Number`,
+     * or `NULL` value if included.
+     * It **MUST** be the same as the value of the id member in the Request Object.
+     * If there was an error
+     * in detecting the `id` in the Request object (e.g. `Parse error`/`Invalid Request`)
+     * it **MUST** be `Null`.
+     */
+    id: string | number | null;
+}
+/**
+ * When a rpc call is made, the Server **MUST** reply with a Response
+ * except for in the case of Notifications.
+ * The Response is expressed as a single JSON Object
+ */
+export type RpcResponse<TResult = unknown, TErrorData = unknown> = RpcResponseSuccess<TResult> | RpcResponseFailed<TErrorData>;
+export interface RpcResponseSuccess<TResult = unknown> extends RpcResponseCommon {
+    /**
+     * This member is **REQUIRED** on success.
+     * This member **MUST NOT** exist if there was an error invoking the method.
+     * The value of this member is determined by the method invoked on the Server.
+     */
+    result: TResult;
+}
+export interface RpcResponseFailed<TErrorData = unknown> extends RpcResponseCommon {
+    /**
+     * This member is REQUIRED on error.
+     * This member MUST NOT exist if there was no error triggered during invocation.
+     * The value for this member MUST be an Object of Type `RpcResponseError`.
+     */
+    error: RpcResponseError<TErrorData>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/core/src/JSONRPC/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../core/src/JSONRPC/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,YAAY;IACtB;;;OAGG;IACH,WAAW,SAAS;IACpB;;OAEG;IACH,eAAe,SAAS;IACxB;;OAEG;IACH,gBAAgB,SAAS;IACzB;;OAEG;IACH,cAAc,SAAS;IACvB;;OAEG;IACH,cAAc,SAAS;IACvB;;OAEG;IACH,YAAY,SAAS;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,GAAG,OAAO;IAC3D;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,UAAU,GAAG,OAAO;IACpD;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,EAAE,KAAK,CAAC;IAEf;;;;;;;OAOG;IACH,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,GAAG,OAAO,EAAE,UAAU,GAAG,OAAO,IAC3D,kBAAkB,CAAC,OAAO,CAAC,GAC3B,iBAAiB,CAAC,UAAU,CAAC,CAAC;AAElC,MAAM,WAAW,kBAAkB,CAAC,OAAO,GAAG,OAAO,CACnD,SAAQ,iBAAiB;IACzB;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB,CAAC,UAAU,GAAG,OAAO,CACrD,SAAQ,iBAAiB;IACzB;;;;OAIG;IACH,KAAK,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;CACrC"}

package/lib/core/src/JSONRPC/types.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcErrorCode = void 0;
+/**
+ * Error code that may occur during WalletAPI server communication
+ * @enum
+ */
+var RpcErrorCode;
+(function (RpcErrorCode) {
+    /**
+     * Invalid JSON was received by the server.
+     * or An error occurred on the server while parsing the JSON text.
+     */
+    RpcErrorCode[RpcErrorCode["PARSE_ERROR"] = -32700] = "PARSE_ERROR";
+    /**
+     * The JSON sent is not a valid Request object.
+     */
+    RpcErrorCode[RpcErrorCode["INVALID_REQUEST"] = -32600] = "INVALID_REQUEST";
+    /**
+     * The method does not exist / is not available.
+     */
+    RpcErrorCode[RpcErrorCode["METHOD_NOT_FOUND"] = -32601] = "METHOD_NOT_FOUND";
+    /**
+     * Invalid method parameter(s).
+     */
+    RpcErrorCode[RpcErrorCode["INVALID_PARAMS"] = -32602] = "INVALID_PARAMS";
+    /**
+     * Internal JSON-RPC error.
+     */
+    RpcErrorCode[RpcErrorCode["INTERNAL_ERROR"] = -32603] = "INTERNAL_ERROR";
+    /**
+     * Reserved for implementation-defined server-errors.
+     */
+    RpcErrorCode[RpcErrorCode["SERVER_ERROR"] = -32000] = "SERVER_ERROR";
+})(RpcErrorCode = exports.RpcErrorCode || (exports.RpcErrorCode = {}));
+//# sourceMappingURL=types.js.map

package/lib/core/src/JSONRPC/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../core/src/JSONRPC/types.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,IAAY,YA0BX;AA1BD,WAAY,YAAY;IACtB;;;OAGG;IACH,kEAAoB,CAAA;IACpB;;OAEG;IACH,0EAAwB,CAAA;IACxB;;OAEG;IACH,4EAAyB,CAAA;IACzB;;OAEG;IACH,wEAAuB,CAAA;IACvB;;OAEG;IACH,wEAAuB,CAAA;IACvB;;OAEG;IACH,oEAAqB,CAAA;AACvB,CAAC,EA1BW,YAAY,GAAZ,oBAAY,KAAZ,oBAAY,QA0BvB"}

package/lib/core/src/JSONRPC/validation.d.ts

@@ -0,0 +1,194 @@
+import { z } from "zod";
+export declare const schemaRPCRequest: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    method: z.ZodString;
+    params: z.ZodAny;
+    id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodNull]>>;
+}, "strict", z.ZodTypeAny, {
+    method: string;
+    jsonrpc: "2.0";
+    params?: any;
+    id?: string | number | null | undefined;
+}, {
+    method: string;
+    jsonrpc: "2.0";
+    params?: any;
+    id?: string | number | null | undefined;
+}>;
+export declare const schemaRPCResponseErrorData: z.ZodObject<{
+    code: z.ZodNumber;
+    message: z.ZodString;
+    data: z.ZodOptional<z.ZodAny>;
+}, "strict", z.ZodTypeAny, {
+    code: number;
+    message: string;
+    data?: any;
+}, {
+    code: number;
+    message: string;
+    data?: any;
+}>;
+export declare const schemaRPCResponseSuccess: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodNull]>;
+    result: z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>;
+}, "strict", z.ZodTypeAny, {
+    id: string | number | null;
+    jsonrpc: "2.0";
+    result: {} & {
+        [k: string]: unknown;
+    };
+}, {
+    id: string | number | null;
+    jsonrpc: "2.0";
+    result: {} & {
+        [k: string]: unknown;
+    };
+}>;
+export declare const schemaRPCResponseError: z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodNull]>;
+    error: z.ZodObject<{
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodAny>;
+    }, "strict", z.ZodTypeAny, {
+        code: number;
+        message: string;
+        data?: any;
+    }, {
+        code: number;
+        message: string;
+        data?: any;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    error: {
+        code: number;
+        message: string;
+        data?: any;
+    };
+    id: string | number | null;
+    jsonrpc: "2.0";
+}, {
+    error: {
+        code: number;
+        message: string;
+        data?: any;
+    };
+    id: string | number | null;
+    jsonrpc: "2.0";
+}>;
+export declare const schemaRPCResponse: z.ZodUnion<[z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodNull]>;
+    error: z.ZodObject<{
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodAny>;
+    }, "strict", z.ZodTypeAny, {
+        code: number;
+        message: string;
+        data?: any;
+    }, {
+        code: number;
+        message: string;
+        data?: any;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    error: {
+        code: number;
+        message: string;
+        data?: any;
+    };
+    id: string | number | null;
+    jsonrpc: "2.0";
+}, {
+    error: {
+        code: number;
+        message: string;
+        data?: any;
+    };
+    id: string | number | null;
+    jsonrpc: "2.0";
+}>, z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodNull]>;
+    result: z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>;
+}, "strict", z.ZodTypeAny, {
+    id: string | number | null;
+    jsonrpc: "2.0";
+    result: {} & {
+        [k: string]: unknown;
+    };
+}, {
+    id: string | number | null;
+    jsonrpc: "2.0";
+    result: {} & {
+        [k: string]: unknown;
+    };
+}>]>;
+export declare const schemaRPCCall: z.ZodUnion<[z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    method: z.ZodString;
+    params: z.ZodAny;
+    id: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodNull]>>;
+}, "strict", z.ZodTypeAny, {
+    method: string;
+    jsonrpc: "2.0";
+    params?: any;
+    id?: string | number | null | undefined;
+}, {
+    method: string;
+    jsonrpc: "2.0";
+    params?: any;
+    id?: string | number | null | undefined;
+}>, z.ZodUnion<[z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodNull]>;
+    error: z.ZodObject<{
+        code: z.ZodNumber;
+        message: z.ZodString;
+        data: z.ZodOptional<z.ZodAny>;
+    }, "strict", z.ZodTypeAny, {
+        code: number;
+        message: string;
+        data?: any;
+    }, {
+        code: number;
+        message: string;
+        data?: any;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    error: {
+        code: number;
+        message: string;
+        data?: any;
+    };
+    id: string | number | null;
+    jsonrpc: "2.0";
+}, {
+    error: {
+        code: number;
+        message: string;
+        data?: any;
+    };
+    id: string | number | null;
+    jsonrpc: "2.0";
+}>, z.ZodObject<{
+    jsonrpc: z.ZodLiteral<"2.0">;
+    id: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodNull]>;
+    result: z.ZodObject<{}, "passthrough", z.ZodTypeAny, z.objectOutputType<{}, z.ZodTypeAny, "passthrough">, z.objectInputType<{}, z.ZodTypeAny, "passthrough">>;
+}, "strict", z.ZodTypeAny, {
+    id: string | number | null;
+    jsonrpc: "2.0";
+    result: {} & {
+        [k: string]: unknown;
+    };
+}, {
+    id: string | number | null;
+    jsonrpc: "2.0";
+    result: {} & {
+        [k: string]: unknown;
+    };
+}>]>]>;
+//# sourceMappingURL=validation.d.ts.map

package/lib/core/src/JSONRPC/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../../../core/src/JSONRPC/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAOlB,CAAC;AAEZ,eAAO,MAAM,0BAA0B;;;;;;;;;;;;EAM5B,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;EAM1B,CAAC;AAEZ,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMxB,CAAC;AAEZ,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAG5B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAiD,CAAC"}

package/lib/core/src/JSONRPC/validation.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.schemaRPCCall = exports.schemaRPCResponse = exports.schemaRPCResponseError = exports.schemaRPCResponseSuccess = exports.schemaRPCResponseErrorData = exports.schemaRPCRequest = void 0;
+const zod_1 = require("zod");
+const schemaRPCId = zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.null()]);
+exports.schemaRPCRequest = zod_1.z
+    .object({
+    jsonrpc: zod_1.z.literal("2.0"),
+    method: zod_1.z.string(),
+    params: zod_1.z.any(),
+    id: schemaRPCId.optional(),
+})
+    .strict();
+exports.schemaRPCResponseErrorData = zod_1.z
+    .object({
+    code: zod_1.z.number(),
+    message: zod_1.z.string(),
+    data: zod_1.z.any().optional(),
+})
+    .strict();
+exports.schemaRPCResponseSuccess = zod_1.z
+    .object({
+    jsonrpc: zod_1.z.literal("2.0"),
+    id: schemaRPCId,
+    result: zod_1.z.object({}).passthrough(),
+})
+    .strict();
+exports.schemaRPCResponseError = zod_1.z
+    .object({
+    jsonrpc: zod_1.z.literal("2.0"),
+    id: schemaRPCId,
+    error: exports.schemaRPCResponseErrorData,
+})
+    .strict();
+exports.schemaRPCResponse = zod_1.z.union([
+    exports.schemaRPCResponseError,
+    exports.schemaRPCResponseSuccess,
+]);
+exports.schemaRPCCall = zod_1.z.union([exports.schemaRPCRequest, exports.schemaRPCResponse]);
+//# sourceMappingURL=validation.js.map