smoldot 2.0.28 → 2.0.30

package/dist/cjs/internals/client.js

@@ -327,25 +327,37 @@ function start(options, wasmModule, platformBindings) {
                         default: throw new Error("Internal error: unknown json_rpc_send error code: " + retVal);
                     }
                 },
+                jsonRpcResponses: {
+                    next: () => __awaiter(this, void 0, void 0, function* () {
+                        while (true) {
+                            if (!state.chains.has(chainId))
+                                return { done: true, value: undefined };
+                            if (options.disableJsonRpc)
+                                throw new public_types_js_1.JsonRpcDisabledError();
+                            if (state.instance.status === "destroyed")
+                                throw state.instance.error;
+                            if (state.instance.status !== "ready")
+                                throw new Error(); // Internal error. Never supposed to happen.
+                            // Try to pop a message from the queue.
+                            const message = state.instance.instance.peekJsonRpcResponse(chainId);
+                            if (message)
+                                return { done: false, value: message };
+                            // If no message is available, wait for one to be.
+                            yield new Promise((resolve) => {
+                                state.chains.get(chainId).jsonRpcResponsesPromises.push(resolve);
+                            });
+                        }
+                    }),
+                    [Symbol.asyncIterator]() {
+                        return this;
+                    }
+                },
                 nextJsonRpcResponse: () => __awaiter(this, void 0, void 0, function* () {
-                    while (true) {
-                        if (!state.chains.has(chainId))
-                            throw new public_types_js_1.AlreadyDestroyedError();
-                        if (options.disableJsonRpc)
-                            return Promise.reject(new public_types_js_1.JsonRpcDisabledError());
-                        if (state.instance.status === "destroyed")
-                            throw state.instance.error;
-                        if (state.instance.status !== "ready")
-                            throw new Error(); // Internal error. Never supposed to happen.
-                        // Try to pop a message from the queue.
-                        const message = state.instance.instance.peekJsonRpcResponse(chainId);
-                        if (message)
-                            return message;
-                        // If no message is available, wait for one to be.
-                        yield new Promise((resolve) => {
-                            state.chains.get(chainId).jsonRpcResponsesPromises.push(resolve);
-                        });
+                    const result = yield newChain.jsonRpcResponses.next();
+                    if (result.done) {
+                        throw new public_types_js_1.AlreadyDestroyedError();
                     }
+                    return result.value;
                 }),
                 remove: () => {
                     if (state.instance.status === "destroyed")

package/dist/cjs/public-types.d.ts

@@ -137,6 +137,19 @@ export interface Chain {
      * @throws {@link CrashError} If the background client has crashed.
      */
     nextJsonRpcResponse(): Promise<string>;
+    /**
+     * JSON-RPC responses or notifications async iterable.
+     *
+     * Each chain contains a buffer of the responses waiting to be sent out. Iterating over this
+     * pulls one element from the buffer. If the iteration happen at a slower rate than
+     * responses are generated, then the buffer will eventually become full, at which point calling
+     * {@link Chain.sendJsonRpc} will throw an exception. The size of this buffer can be configured
+     * through {@link AddChainOptions.jsonRpcMaxPendingRequests}.
+     *
+     * @throws {@link JsonRpcDisabledError} If the JSON-RPC system was disabled in the options of the chain.
+     * @throws {@link CrashError} If the background client has crashed.
+     */
+    readonly jsonRpcResponses: AsyncIterableIterator<string>;
     /**
      * Disconnects from the blockchain.
      *