Add Rpc interface

bitcoin/bitcoin#32297 introduced the RPC interface for `bitcoin-cli`, allowing
it to execute RPC commands over IPC. This commit adds the corresponding Cap'n Proto
schema and includes a test that queries `getblockcount`.

Author: xyzconstant

build.rs

@@ -6,6 +6,7 @@ fn main() {
         .file("capnp/echo.capnp")
         .file("capnp/init.capnp")
         .file("capnp/mining.capnp")
+        .file("capnp/rpc.capnp")
         .file("capnp/proxy.capnp")
         .run()
         .unwrap();

capnp/init.capnp

@@ -10,10 +10,12 @@ $Cxx.namespace("ipc::capnp::messages");
 using Proxy = import "proxy.capnp";
 using Echo = import "echo.capnp";
 using Mining = import "mining.capnp";
+using Rpc = import "rpc.capnp";
 
 interface Init $Proxy.wrap("interfaces::Init") {
     construct @0 (threadMap: Proxy.ThreadMap) -> (threadMap :Proxy.ThreadMap);
     makeEcho @1 (context :Proxy.Context) -> (result :Echo.Echo);
     makeMiningOld2 @2 () -> ();
     makeMining @3 (context :Proxy.Context) -> (result :Mining.Mining);
+    makeRpc @4 (context :Proxy.Context) -> (result :Rpc.Rpc);
 }

capnp/rpc.capnp

@@ -0,0 +1,15 @@
+# Copyright (c) 2025 The Bitcoin Core developers
+# Distributed under the MIT software license, see the accompanying
+# file COPYING or http://www.opensource.org/licenses/mit-license.php.
+
+@0x9c3505dc45e146ac;
+
+using Cxx = import "/capnp/c++.capnp";
+$Cxx.namespace("ipc::capnp::messages");
+
+using Common = import "common.capnp";
+using Proxy = import "proxy.capnp";
+
+interface Rpc $Proxy.wrap("interfaces::Rpc") {
+    executeRpc @0 (context :Proxy.Context, request :Text, uri :Text, user :Text) -> (result :Text);
+}

src/lib.rs

@@ -3,6 +3,7 @@ capnp::generated_code!(pub mod common_capnp);
 capnp::generated_code!(pub mod echo_capnp);
 capnp::generated_code!(pub mod proxy_capnp);
 capnp::generated_code!(pub mod mining_capnp);
+capnp::generated_code!(pub mod rpc_capnp);
 
 pub extern crate capnp;
 pub extern crate capnp_rpc;

tests/test.rs

@@ -7,10 +7,12 @@ mod bitcoin_core_wallet_util;
 
 use bitcoin_core_util::{
     destroy_template, make_block_template, mempool_tx_count, with_init_client, with_mining_client,
+    with_rpc_client,
 };
 use bitcoin_core_wallet_util::{
     bitcoin_test_wallet, create_mempool_self_transfer, ensure_wallet_loaded_and_funded,
 };
+use serde_json::{Value, json};
 
 #[tokio::test]
 #[serial_test::parallel]
@@ -40,6 +42,41 @@ async fn integration() {
     .await;
 }
 
+/// Test the RPC interface by calling `getblockcount`
+#[tokio::test]
+#[serial_test::parallel]
+async fn rpc_query_getblockcount() {
+    with_rpc_client(|_client, thread, rpc| async move {
+        let mut execute_rpc_request = rpc.execute_rpc_request();
+        execute_rpc_request
+            .get()
+            .get_context()
+            .unwrap()
+            .set_thread(thread.clone());
+        let j: Value = json!({
+            "method": "getblockcount",
+            "params": [],
+            "id": "test",
+            "jsonrpc": "2.0"
+        });
+        execute_rpc_request.get().set_request(j.to_string());
+        let exec_rpc_response = execute_rpc_request.send().promise.await.unwrap();
+        let result = exec_rpc_response
+            .get()
+            .unwrap()
+            .get_result()
+            .unwrap()
+            .to_string()
+            .unwrap();
+        let v: Value = serde_json::from_str(&result)
+            .map_err(|e| format!("failed to parse rpc response as JSON: {e}"))
+            .unwrap();
+        // Tests are boostrapped with 101 blocks. See `ensure_bootstrap_chain_ready()`
+        assert_eq!(101, v["result"]);
+    })
+    .await;
+}
+
 /// Calling the deprecated makeMiningOld2 (@2) should return an error from the
 /// server. Cap'n Proto requires sequential ordinals so this placeholder cannot
 /// be removed, but the server intentionally rejects it.

tests/util/bitcoin_core.rs

@@ -11,6 +11,7 @@ use bitcoin_capnp_types::{
     init_capnp::init,
     mining_capnp::{block_template, mining},
     proxy_capnp::{thread, thread_map},
+    rpc_capnp::rpc,
 };
 use capnp_rpc::{RpcSystem, rpc_twoparty_capnp::Side, twoparty::VatNetwork};
 use futures::io::BufReader;
@@ -88,6 +89,18 @@ where
     .await;
 }
 
+pub async fn with_rpc_client<F, Fut>(f: F)
+where
+    F: FnOnce(init::Client, thread::Client, rpc::Client) -> Fut,
+    Fut: Future<Output = ()>,
+{
+    with_init_client(|client, thread| async move {
+        let rpc = make_rpc(&client, &thread).await;
+        f(client, thread, rpc).await;
+    })
+    .await;
+}
+
 pub async fn connect_unix_stream(
     path: impl AsRef<Path>,
 ) -> VatNetwork<BufReader<Compat<OwnedReadHalf>>> {
@@ -151,6 +164,14 @@ pub async fn make_mining(init: &init::Client, thread: &thread::Client) -> mining
     resp.get().unwrap().get_result().unwrap()
 }
 
+/// Obtain a Rpc client from an Init client.
+pub async fn make_rpc(init: &init::Client, thread: &thread::Client) -> rpc::Client {
+    let mut req = init.make_rpc_request();
+    req.get().get_context().unwrap().set_thread(thread.clone());
+    let resp = req.send().promise.await.unwrap();
+    resp.get().unwrap().get_result().unwrap()
+}
+
 /// Create a new block template with default options and no cooldown.
 ///
 /// The node must have height > 16. At height <= 16 the BIP34 height push