// Copyright 2019-2020 Parity Technologies (UK) Ltd. // This file is part of Polkadot. // Polkadot 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. // Polkadot 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 Polkadot. If not, see . //! Polkadot-specific RPCs implementation. #![warn(missing_docs)] use std::sync::Arc; use polkadot_primitives::v0::{AccountId, Balance, Block, BlockNumber, Hash, Nonce}; use sc_client_api::{ light::{Fetcher, RemoteBlockchain}, AuxStore, }; use sc_consensus_babe::Epoch; use sc_finality_grandpa::FinalityProofProvider; pub use sc_rpc::{DenyUnsafe, SubscriptionTaskExecutor}; use sc_sync_state_rpc::{SyncStateRpcApi, SyncStateRpcHandler}; use sp_api::ProvideRuntimeApi; use sp_block_builder::BlockBuilder; use sp_blockchain::{Error as BlockChainError, HeaderBackend, HeaderMetadata}; use sp_consensus::SelectChain; use sp_consensus_babe::BabeApi; use sp_keystore::SyncCryptoStorePtr; use txpool_api::TransactionPool; /// A type representing all RPC extensions. pub type RpcExtension = jsonrpc_core::IoHandler; /// Light client extra dependencies. pub struct LightDeps { /// The client instance to use. pub client: Arc, /// Transaction pool instance. pub pool: Arc

, /// Remote access to the blockchain (async). pub remote_blockchain: Arc>, /// Fetcher instance. pub fetcher: Arc, } /// Extra dependencies for BABE. pub struct BabeDeps { /// BABE protocol config. pub babe_config: sc_consensus_babe::Config, /// BABE pending epoch changes. pub shared_epoch_changes: sc_consensus_epochs::SharedEpochChanges, /// The keystore that manages the keys of the node. pub keystore: SyncCryptoStorePtr, } /// Dependencies for GRANDPA pub struct GrandpaDeps { /// Voting round info. pub shared_voter_state: sc_finality_grandpa::SharedVoterState, /// Authority set info. pub shared_authority_set: sc_finality_grandpa::SharedAuthoritySet, /// Receives notifications about justification events from Grandpa. pub justification_stream: sc_finality_grandpa::GrandpaJustificationStream, /// Executor to drive the subscription manager in the Grandpa RPC handler. pub subscription_executor: sc_rpc::SubscriptionTaskExecutor, /// Finality proof provider. pub finality_provider: Arc>, } /// Dependencies for BEEFY pub struct BeefyDeps { /// Receives notifications about signed commitment events from BEEFY. pub beefy_commitment_stream: beefy_gadget::notification::BeefySignedCommitmentStream, /// Executor to drive the subscription manager in the BEEFY RPC handler. pub subscription_executor: sc_rpc::SubscriptionTaskExecutor, } /// Full client dependencies pub struct FullDeps { /// The client instance to use. pub client: Arc, /// Transaction pool instance. pub pool: Arc

, /// The [`SelectChain`] Strategy pub select_chain: SC, /// A copy of the chain spec. pub chain_spec: Box, /// Whether to deny unsafe calls pub deny_unsafe: DenyUnsafe, /// BABE specific dependencies. pub babe: BabeDeps, /// GRANDPA specific dependencies. pub grandpa: GrandpaDeps, /// BEEFY specific dependencies. pub beefy: BeefyDeps, } /// Instantiate all RPC extensions. pub fn create_full( deps: FullDeps, ) -> Result> where C: ProvideRuntimeApi + HeaderBackend + AuxStore + HeaderMetadata + Send + Sync + 'static, C::Api: frame_rpc_system::AccountNonceApi, C::Api: pallet_mmr_rpc::MmrRuntimeApi::Hash>, C::Api: pallet_transaction_payment_rpc::TransactionPaymentRuntimeApi, C::Api: BabeApi, C::Api: BlockBuilder, P: TransactionPool + Sync + Send + 'static, SC: SelectChain + 'static, B: sc_client_api::Backend + Send + Sync + 'static, B::State: sc_client_api::StateBackend>, { use frame_rpc_system::{FullSystem, SystemApi}; use pallet_mmr_rpc::{Mmr, MmrApi}; use pallet_transaction_payment_rpc::{TransactionPayment, TransactionPaymentApi}; use sc_consensus_babe_rpc::BabeRpcHandler; use sc_finality_grandpa_rpc::{GrandpaApi, GrandpaRpcHandler}; let mut io = jsonrpc_core::IoHandler::default(); let FullDeps { client, pool, select_chain, chain_spec, deny_unsafe, babe, grandpa, beefy } = deps; let BabeDeps { keystore, babe_config, shared_epoch_changes } = babe; let GrandpaDeps { shared_voter_state, shared_authority_set, justification_stream, subscription_executor, finality_provider, } = grandpa; io.extend_with(SystemApi::to_delegate(FullSystem::new(client.clone(), pool, deny_unsafe))); io.extend_with(TransactionPaymentApi::to_delegate(TransactionPayment::new(client.clone()))); io.extend_with(MmrApi::to_delegate(Mmr::new(client.clone()))); io.extend_with(sc_consensus_babe_rpc::BabeApi::to_delegate(BabeRpcHandler::new( client.clone(), shared_epoch_changes.clone(), keystore, babe_config, select_chain, deny_unsafe, ))); io.extend_with(GrandpaApi::to_delegate(GrandpaRpcHandler::new( shared_authority_set.clone(), shared_voter_state, justification_stream, subscription_executor, finality_provider, ))); io.extend_with(SyncStateRpcApi::to_delegate(SyncStateRpcHandler::new( chain_spec, client, shared_authority_set, shared_epoch_changes, deny_unsafe, )?)); io.extend_with(beefy_gadget_rpc::BeefyApi::to_delegate( beefy_gadget_rpc::BeefyRpcHandler::new( beefy.beefy_commitment_stream, beefy.subscription_executor, ), )); Ok(io) } /// Instantiate all RPC extensions for light node. pub fn create_light(deps: LightDeps) -> RpcExtension where C: ProvideRuntimeApi, C: HeaderBackend, C: Send + Sync + 'static, C::Api: frame_rpc_system::AccountNonceApi, C::Api: pallet_transaction_payment_rpc::TransactionPaymentRuntimeApi, P: TransactionPool + Sync + Send + 'static, F: Fetcher + 'static, { use frame_rpc_system::{LightSystem, SystemApi}; let LightDeps { client, pool, remote_blockchain, fetcher } = deps; let mut io = jsonrpc_core::IoHandler::default(); io.extend_with(SystemApi::::to_delegate(LightSystem::new( client, remote_blockchain, fetcher, pool, ))); io }