// This file is part of Substrate. // Copyright (C) 2021 Parity Technologies (UK) Ltd. // SPDX-License-Identifier: Apache-2.0 // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. //! WS RPC API for one off RPC calls to a substrate node. // TODO: Consolidate one off RPC calls https://github.com/paritytech/substrate/issues/8988 use jsonrpsee::{ rpc_params, types::traits::Client, ws_client::{WsClient, WsClientBuilder}, }; use sp_runtime::{ generic::SignedBlock, traits::{Block as BlockT, Header as HeaderT}, }; /// Get the header of the block identified by `at` pub async fn get_header(from: S, at: Block::Hash) -> Result where Block: BlockT, Block::Header: serde::de::DeserializeOwned, S: AsRef, { let client = build_client(from).await?; client .request::("chain_getHeader", rpc_params!(at)) .await .map_err(|e| format!("chain_getHeader request failed: {:?}", e)) } /// Get the finalized head pub async fn get_finalized_head(from: S) -> Result where Block: BlockT, S: AsRef, { let client = build_client(from).await?; client .request::("chain_getFinalizedHead", None) .await .map_err(|e| format!("chain_getFinalizedHead request failed: {:?}", e)) } /// Get the signed block identified by `at`. pub async fn get_block(from: S, at: Block::Hash) -> Result where S: AsRef, Block: BlockT + serde::de::DeserializeOwned, Block::Header: HeaderT, { let client = build_client(from).await?; let signed_block = client .request::>("chain_getBlock", rpc_params!(at)) .await .map_err(|e| format!("chain_getBlock request failed: {:?}", e))?; Ok(signed_block.block) } /// Build a website client that connects to `from`. async fn build_client>(from: S) -> Result { WsClientBuilder::default() .max_request_body_size(u32::MAX) .build(from.as_ref()) .await .map_err(|e| format!("`WsClientBuilder` failed to build: {:?}", e)) } /// Get the runtime version of a given chain. pub async fn get_runtime_version( from: S, at: Option, ) -> Result where S: AsRef, Block: BlockT + serde::de::DeserializeOwned, Block::Header: HeaderT, { let client = build_client(from).await?; client .request::("state_getRuntimeVersion", rpc_params!(at)) .await .map_err(|e| format!("state_getRuntimeVersion request failed: {:?}", e)) }