tari-project / tari / 15280118615

Committed 27 May 2025 04:01PM UTC coverage: 73.59% (+0.4%) from 73.233%

Build # 15280118615

Build Type

push

github

Committed by

Commit Message

feat: add base node HTTP wallet service (#7061)

Description
---
Added a new HTTP server for base node that exposes some wallet related
query functionality.

Current new endpoints (examples on **esmeralda** network):
- http://127.0.0.1:9005/get_tip_info
- http://127.0.0.1:9005/get_header_by_height?height=6994
- http://127.0.0.1:9005/get_height_at_time?time=1747739959

Default ports for http service (by network):
```
MainNet: 9000,
StageNet: 9001,
NextNet: 9002,
LocalNet: 9003,
Igor: 9004,
Esmeralda: 9005,
```

New configuration needs to be set in base node:
```toml
[base_node.http_wallet_query_service]
port = 9000
external_address = "http://127.0.0.1:9000" # this is optional, but if not set, when someone requests for the external address, just returns a None, so wallets can't contact base node
```

Motivation and Context
---

How Has This Been Tested?
---
### Manually

#### Basic test
1. Build new base node
2. Set base node configuration by adding the following:
```toml
[base_node.http_wallet_query_service]
port = 9000
external_address = "http://127.0.0.1:9000"
```
This way we set the port and external address (which is sent to wallet
client when requesting, so in real world it must be public)
3. Set logging level of base node logs to DEBUG
4. Start base node
5. Build and start console wallet
6. See that it is still able to synchronize
7. Check logs of base node (with `tail -f ...` command for instance) and
see that the HTTP endpoints are used

#### Use RPC fallback test
1. Build new base node
2. Set base node configuration by adding the following:
```toml
[base_node.http_wallet_query_service]
port = 9000
external_address = "http://127.0.0.1:9001"
```
This way we set the port and external address (which is sent to wallet
client when requesting, so in real world it must be public)
3. Set logging level of base node logs to DEBUG
4. Start base node
5. Build and start console wallet
6. See that it is still able to synchronize
7. Check logs of base nod... (continued)

Run Details

9 of 114 new or added lines in 4 files covered. (7.89%)

1592 existing lines in 62 files now uncovered.

82227 of 111736 relevant lines covered (73.59%)

272070.7 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

0.0

/base_layer/core/src/base_node/rpc/models/get_tip_info.rs

1	// Copyright 2025 The Tari Project
2	// SPDX-License-Identifier: BSD-3-Clause
3
4	use serde::{Deserialize, Serialize};
5
NEW 6	#[derive(Serialize, Deserialize)]	×
7	pub struct TipInfoResponse {
8	pub metadata: Option<tari_common_types::chain_metadata::ChainMetadata>,
9	pub is_synced: bool,
10	}
11
12	impl TryFrom<crate::proto::base_node::TipInfoResponse> for TipInfoResponse {
13	type Error = String;
14
NEW 15	fn try_from(proto_value: crate::proto::base_node::TipInfoResponse) -> Result<Self, Self::Error> {	×
NEW 16	let chain_metadata = match proto_value.metadata.map(\|m\| {	×
NEW 17	let result: Result<tari_common_types::chain_metadata::ChainMetadata, String> = m.try_into();	×
NEW 18	result	×
NEW 19	}) {	×
NEW 20	Some(result) => Some(result?),	×
NEW 21	None => None,	×
22	};
NEW 23	Ok(Self {	×
NEW 24	metadata: chain_metadata,	×
NEW 25	is_synced: proto_value.is_synced,	×
NEW 26	})	×
NEW 27	}	×
28	}