// Copyright 2019 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 . //! Node-specific RPC methods for interaction with contracts. use std::sync::Arc; use serde::{Serialize, Deserialize}; use client::blockchain::HeaderBackend; use jsonrpc_core::{Error, ErrorCode, Result}; use jsonrpc_derive::rpc; use node_primitives::{ AccountId, Balance, Block, BlockId, ContractExecResult, ContractsApi as ContractsRuntimeApi, }; use sr_primitives::traits::{ self, Block as BlockT, }; use rpc_primitives::number; /// A struct that encodes RPC parameters required for a call to a smart-contract. #[derive(Serialize, Deserialize)] #[serde(rename_all="camelCase")] #[serde(deny_unknown_fields)] pub struct CallRequest { origin: AccountId, dest: AccountId, value: Balance, gas_limit: number::NumberOrHex, input_data: Vec, } /// Contracts RPC methods. #[rpc] pub trait ContractsApi { /// Executes a call to a contract. /// /// This call is performed locally without submitting any transactions. Thus executing this /// won't change any state. Nonetheless, the calling state-changing contracts is still possible. /// /// This method is useful for calling getter-like methods on contracts. #[rpc(name = "contracts_call")] fn call( &self, call_request: CallRequest, at: Option, ) -> Result; } /// An implementation of contract specific RPC methods. pub struct Contracts { client: Arc, } impl Contracts { /// Create new `Contracts` with the given reference to the client. pub fn new(client: Arc) -> Self { Contracts { client } } } impl ContractsApi<::Hash> for Contracts where C: Send + Sync + 'static, C: traits::ProvideRuntimeApi, C: HeaderBackend, C::Api: ContractsRuntimeApi, { fn call( &self, call_request: CallRequest, at: Option<::Hash>, ) -> Result { let api = self.client.runtime_api(); let at = BlockId::hash(at.unwrap_or_else(|| // If the block hash is not supplied assume the best block. self.client.info().best_hash )); let CallRequest { origin, dest, value, gas_limit, input_data } = call_request; let gas_limit = gas_limit.to_number().map_err(|e| Error { code: ErrorCode::InvalidParams, message: e, data: None, })?; let exec_result = api .call(&at, origin, dest, value, gas_limit, input_data) .map_err(|e| Error { code: ErrorCode::ServerError(crate::constants::RUNTIME_ERROR), message: "Runtime trapped while executing a contract.".into(), data: Some(format!("{:?}", e).into()), })?; Ok(exec_result) } }