feat: single entrypoint json-rpc based host-call

[zees-dev]

Description

This pull request introduces significant updates to the Blockless runtime to support JSON-RPC functionality and HTTP request handling.
Key changes include the addition of a new BlocklessRpcErrorKind enum, integration of a JSON-RPC interface, and a comprehensive HTTP request handler.
These updates enhance the runtime's ability to process RPC calls and execute HTTP requests directly within the WASM environment.

JSON-RPC Integration:

• Added BlocklessRpcErrorKind enum to define error types for RPC operations, along with implementations for std::error::Error and std::fmt::Display. (crates/blockless-drivers/src/error.rs, crates/blockless-drivers/src/error.rsR220-R242)
• Introduced JSON-RPC structures (JsonRpcRequest, JsonRpcResponse, JsonRpcError) and implemented the rpc_call method to handle RPC calls in WASM memory. (crates/blockless-drivers/src/wasi/rpc.rs, crates/blockless-drivers/src/wasi/rpc.rsR1-R153)
• Defined a new WITX module $bless with an rpc_call interface for JSON-RPC operations. (crates/blockless-drivers/witx/blockless_rpc.witx, crates/blockless-drivers/witx/blockless_rpc.witxR1-R30)

HTTP Request Handling:

• Added HttpRpcRequest, HttpOptions, HttpBody, and related structures to support HTTP requests, including multipart handling. (crates/blockless-drivers/src/handlers/http.rs, crates/blockless-drivers/src/handlers/http.rsR1-R239)
• Implemented handle_http_request and execute_http_request methods to process HTTP requests asynchronously using reqwest. (crates/blockless-drivers/src/handlers/http.rs, crates/blockless-drivers/src/handlers/http.rsR1-R239)

Runtime Enhancements:

• Integrated the new RPC functionality into the Blockless runtime by adding add_bless_to_linker. (blockless/src/lib.rs, [1]; crates/blockless-env/src/lib.rs, [2]
• Updated Cargo.toml to include the multipart feature for reqwest. (crates/blockless-drivers/Cargo.toml, crates/blockless-drivers/Cargo.tomlL29-R29)

These changes collectively enhance the runtime's extensibility and enable advanced communication and request handling capabilities.

[Copilot]

Pull Request Overview

This PR adds a unified JSON-RPC entrypoint for host calls and integrates HTTP request handling into the Blockless runtime.

• Introduces a new BlocklessRpcErrorKind enum and WITX interface for rpc_call
• Implements JSON-RPC request/response types and the rpc_call handler in WASI
• Adds async HTTP request execution via reqwest and links the RPC interface into the runtime

Reviewed Changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
crates/blockless-env/src/lib.rs	Registers the new add_bless_to_linker integration
crates/blockless-drivers/witx/blockless_rpc.witx	Defines the $bless WITX module and rpc_call function
crates/blockless-drivers/src/wasi/rpc.rs	Implements JSON-RPC types and the async rpc_call logic
crates/blockless-drivers/src/wasi/mod.rs	Exposes the rpc submodule
crates/blockless-drivers/src/lib.rs	Adds the handlers module to the driver crate
crates/blockless-drivers/src/handlers/http.rs	Implements handle_http_request and HTTP execution logic
crates/blockless-drivers/src/error.rs	Defines the BlocklessRpcErrorKind enum and Display
crates/blockless-drivers/Cargo.toml	Enables the multipart feature for reqwest
blockless/src/lib.rs	Links the new RPC entrypoint into the Blockless runtime

Comments suppressed due to low confidence (2)

crates/blockless-drivers/src/handlers/http.rs:1

• Public structs and functions in this file lack documentation comments. Adding docstrings for HttpRpcRequest, handle_http_request, and execute_http_request will improve clarity for consumers of the API.

use reqwest::{Client, Method};

crates/blockless-drivers/src/wasi/rpc.rs:110

• The new handle_rpc_request async handler lacks unit tests to verify each RPC method (e.g., ping, echo, version, http.request). Consider adding tests to cover these code paths.

async fn handle_rpc_request(request: JsonRpcRequest) -> JsonRpcResponse {

[github-actions]

Pull Request Test Coverage Report for Build 16256800493

Details

• 1 of 214 (0.47%) changed or added relevant lines in 5 files are covered.
• No unchanged relevant lines lost coverage.
• Overall coverage decreased (-0.02%) to 7.781%

---

Changes Missing Coverage	Covered Lines	Changed/Added Lines	%
crates/blockless-env/src/lib.rs	0	1	0.0%
crates/blockless-drivers/src/error.rs	0	8	0.0%
crates/blockless-drivers/src/wasi/rpc.rs	0	78	0.0%
crates/blockless-drivers/src/handlers/http.rs	0	126	0.0%

Totals
Change from base Build 15269465304:	-0.02%
Covered Lines:	5715
Relevant Lines:	73447

---

💛 - Coveralls