// Copyright 2019-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 collection of node-specific RPC methods. //! //! Since `substrate` core functionality makes no assumptions //! about the modules used inside the runtime, so do //! RPC methods defined in `sc-rpc` crate. //! It means that `client/rpc` can't have any methods that //! need some strong assumptions about the particular runtime. //! //! The RPCs available in this crate however can make some assumptions //! about how the runtime is constructed and what FRAME pallets //! are part of it. Therefore all node-runtime-specific RPCs can //! be placed here or imported from corresponding FRAME RPC definitions. #![warn(missing_docs)] use std::{sync::Arc, fmt}; use node_primitives::{Block, BlockNumber, AccountId, Index, Balance}; use node_runtime::UncheckedExtrinsic; use sp_api::ProvideRuntimeApi; use sp_transaction_pool::TransactionPool; use sp_blockchain::{Error as BlockChainError, HeaderMetadata, HeaderBackend}; use sp_consensus::SelectChain; use sc_keystore::KeyStorePtr; use sp_consensus_babe::BabeApi; use sc_consensus_epochs::SharedEpochChanges; use sc_consensus_babe::{Config, Epoch}; use sc_consensus_babe_rpc::BabeRPCHandler; /// 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: Config, /// BABE pending epoch changes. pub shared_epoch_changes: SharedEpochChanges, /// The keystore that manages the keys of the node. pub keystore: KeyStorePtr, } /// 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, /// BABE specific dependencies. pub babe: BabeDeps, } /// Instantiate all Full RPC extensions. pub fn create_full( deps: FullDeps, ) -> jsonrpc_core::IoHandler where C: ProvideRuntimeApi, C: HeaderBackend + HeaderMetadata + 'static, C: Send + Sync + 'static, C::Api: substrate_frame_rpc_system::AccountNonceApi, C::Api: pallet_contracts_rpc::ContractsRuntimeApi, C::Api: pallet_transaction_payment_rpc::TransactionPaymentRuntimeApi, C::Api: BabeApi, ::Error: fmt::Debug, P: TransactionPool + 'static, M: jsonrpc_core::Metadata + Default, SC: SelectChain +'static, { use substrate_frame_rpc_system::{FullSystem, SystemApi}; use pallet_contracts_rpc::{Contracts, ContractsApi}; use pallet_transaction_payment_rpc::{TransactionPayment, TransactionPaymentApi}; let mut io = jsonrpc_core::IoHandler::default(); let FullDeps { client, pool, select_chain, babe } = deps; let BabeDeps { keystore, babe_config, shared_epoch_changes, } = babe; io.extend_with( SystemApi::to_delegate(FullSystem::new(client.clone(), pool)) ); // Making synchronous calls in light client freezes the browser currently, // more context: https://github.com/paritytech/substrate/pull/3480 // These RPCs should use an asynchronous caller instead. io.extend_with( ContractsApi::to_delegate(Contracts::new(client.clone())) ); io.extend_with( TransactionPaymentApi::to_delegate(TransactionPayment::new(client.clone())) ); io.extend_with( sc_consensus_babe_rpc::BabeApi::to_delegate( BabeRPCHandler::new(client, shared_epoch_changes, keystore, babe_config, select_chain) ) ); io } /// Instantiate all Light RPC extensions. pub fn create_light( deps: LightDeps, ) -> jsonrpc_core::IoHandler where C: sc_client::blockchain::HeaderBackend, C: Send + Sync + 'static, F: sc_client::light::fetcher::Fetcher + 'static, P: TransactionPool + 'static, M: jsonrpc_core::Metadata + Default, { use substrate_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 }