// 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::{Block, BlockNumber, AccountId, Nonce, Balance, Hash}; use sp_api::ProvideRuntimeApi; use txpool_api::TransactionPool; use sp_block_builder::BlockBuilder; use sp_blockchain::{HeaderBackend, HeaderMetadata, Error as BlockChainError}; use sp_consensus::SelectChain; use sp_consensus_babe::BabeApi; use sp_keystore::SyncCryptoStorePtr; use sc_client_api::AuxStore; use sc_client_api::light::{Fetcher, RemoteBlockchain}; use sc_consensus_babe::Epoch; use sc_finality_grandpa::FinalityProofProvider; use sc_sync_state_rpc::{SyncStateRpcApi, SyncStateRpcHandler}; pub use sc_rpc::{DenyUnsafe, SubscriptionTaskExecutor}; /// 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>, } /// 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, } /// Instantiate all RPC extensions. pub fn create_full(deps: FullDeps) -> RpcExtension where C: ProvideRuntimeApi + HeaderBackend + AuxStore + HeaderMetadata + Send + Sync + 'static, C::Api: frame_rpc_system::AccountNonceApi, 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_transaction_payment_rpc::{TransactionPayment, TransactionPaymentApi}; use sc_finality_grandpa_rpc::{GrandpaApi, GrandpaRpcHandler}; use sc_consensus_babe_rpc::BabeRpcHandler; let mut io = jsonrpc_core::IoHandler::default(); let FullDeps { client, pool, select_chain, chain_spec, deny_unsafe, babe, grandpa, } = 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( 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 } /// 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 }