pezkuwi-subxt-lightclient 0.44.0

Light Client for chain interaction
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

// Copyright 2019-2025 Parity Technologies (UK) Ltd.
// This file is dual-licensed as Apache-2.0 or GPL-3.0.
// see LICENSE for license details.

use serde_json::Value;
use std::borrow::Cow;

/// Something went wrong building chain config.
#[non_exhaustive]
#[derive(thiserror::Error, Debug)]
pub enum ChainConfigError {
	/// The provided chain spec is the wrong shape.
	#[error("Invalid chain spec format")]
	InvalidSpecFormat,
}

/// Configuration to connect to a chain.
pub struct ChainConfig<'a> {
	// The chain spec to use.
	chain_spec: Cow<'a, str>,
}

impl<'a> From<&'a str> for ChainConfig<'a> {
	fn from(chain_spec: &'a str) -> Self {
		ChainConfig::chain_spec(chain_spec)
	}
}

impl From<String> for ChainConfig<'_> {
	fn from(chain_spec: String) -> Self {
		ChainConfig::chain_spec(chain_spec)
	}
}

impl<'a> ChainConfig<'a> {
	/// Construct a chain config from a chain spec.
	pub fn chain_spec(chain_spec: impl Into<Cow<'a, str>>) -> Self {
		ChainConfig { chain_spec: chain_spec.into() }
	}

	/// Set the bootnodes to the given ones.
	pub fn set_bootnodes<S: AsRef<str>>(
		self,
		bootnodes: impl IntoIterator<Item = S>,
	) -> Result<Self, ChainConfigError> {
		let mut chain_spec_json: Value = serde_json::from_str(&self.chain_spec)
			.map_err(|_e| ChainConfigError::InvalidSpecFormat)?;

		if let Value::Object(map) = &mut chain_spec_json {
			let bootnodes =
				bootnodes.into_iter().map(|s| Value::String(s.as_ref().to_owned())).collect();

			map.insert("bootNodes".to_string(), Value::Array(bootnodes));
		} else {
			return Err(ChainConfigError::InvalidSpecFormat);
		}

		Ok(ChainConfig { chain_spec: Cow::Owned(chain_spec_json.to_string()) })
	}

	// Used internally to fetch the chain spec back out.
	pub(crate) fn as_chain_spec(&self) -> &str {
		&self.chain_spec
	}
}