// Copyright 2020 Parity Technologies (UK) Ltd.
// This file is part of Substrate.
// Substrate is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
// Substrate is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
// You should have received a copy of the GNU General Public License
// along with Substrate. If not, see .
//! A RPC handler to create sync states for light clients.
//! Currently only usable with BABE + GRANDPA.
use sp_runtime::traits::{Block as BlockT, NumberFor};
use sp_blockchain::HeaderBackend;
use std::sync::Arc;
use sp_runtime::generic::BlockId;
use jsonrpc_derive::rpc;
type SharedAuthoritySet =
sc_finality_grandpa::SharedAuthoritySet<::Hash, NumberFor>;
type SharedEpochChanges = sc_consensus_epochs::SharedEpochChanges;
struct Error(sp_blockchain::Error);
impl From for jsonrpc_core::Error {
fn from(error: Error) -> Self {
jsonrpc_core::Error {
message: error.0.to_string(),
code: jsonrpc_core::ErrorCode::ServerError(1),
data: None,
}
}
}
/// An api for sync state RPC calls.
#[rpc]
pub trait SyncStateRpcApi {
/// Returns the json-serialized chainspec running the node, with a sync state.
#[rpc(name = "sync_state_genSyncSpec", returns = "jsonrpc_core::Value")]
fn system_gen_sync_spec(&self, raw: bool)
-> jsonrpc_core::Result;
}
/// The handler for sync state RPC calls.
pub struct SyncStateRpcHandler {
chain_spec: Box,
client: Arc,
shared_authority_set: SharedAuthoritySet,
shared_epoch_changes: SharedEpochChanges,
deny_unsafe: sc_rpc_api::DenyUnsafe,
}
impl SyncStateRpcHandler
where
TBl: BlockT,
TCl: HeaderBackend + sc_client_api::AuxStore + 'static,
{
/// Create a new handler.
pub fn new(
chain_spec: Box,
client: Arc,
shared_authority_set: SharedAuthoritySet,
shared_epoch_changes: SharedEpochChanges,
deny_unsafe: sc_rpc_api::DenyUnsafe,
) -> Self {
Self {
chain_spec, client, shared_authority_set, shared_epoch_changes, deny_unsafe,
}
}
fn build_sync_state(&self) -> Result, sp_blockchain::Error> {
let finalized_hash = self.client.info().finalized_hash;
let finalized_header = self.client.header(BlockId::Hash(finalized_hash))?
.ok_or_else(|| sp_blockchain::Error::Msg(
format!("Failed to get the header for block {:?}", finalized_hash)
))?;
let finalized_block_weight = sc_consensus_babe::aux_schema::load_block_weight(
&*self.client,
finalized_hash,
)?
.ok_or_else(|| sp_blockchain::Error::Msg(
format!("Failed to load the block weight for block {:?}", finalized_hash)
))?;
Ok(sc_chain_spec::LightSyncState {
finalized_block_header: finalized_header,
babe_epoch_changes: self.shared_epoch_changes.lock().clone(),
babe_finalized_block_weight: finalized_block_weight,
grandpa_authority_set: self.shared_authority_set.clone_inner(),
})
}
}
impl SyncStateRpcApi for SyncStateRpcHandler
where
TBl: BlockT,
TCl: HeaderBackend + sc_client_api::AuxStore + 'static,
{
fn system_gen_sync_spec(&self, raw: bool)
-> jsonrpc_core::Result
{
if let Err(err) = self.deny_unsafe.check_if_safe() {
return Err(err.into());
}
let mut chain_spec = self.chain_spec.cloned_box();
let sync_state = self.build_sync_state().map_err(Error)?;
chain_spec.set_light_sync_state(sync_state.to_serializable());
let string = chain_spec.as_json(raw).map_err(map_error)?;
serde_json::from_str(&string).map_err(|err| map_error(err.to_string()))
}
}
fn map_error(error: String) -> jsonrpc_core::Error {
Error(sp_blockchain::Error::Msg(error)).into()
}