// 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 client::blockchain::HeaderBackend; use codec::Codec; use jsonrpc_core::{Error, ErrorCode, Result}; use jsonrpc_derive::rpc; use primitives::{H256, Bytes}; use rpc_primitives::number; use serde::{Deserialize, Serialize}; use sr_primitives::{ generic::BlockId, traits::{Block as BlockT, ProvideRuntimeApi}, }; pub use self::gen_client::Client as ContractsClient; pub use pallet_contracts_rpc_runtime_api::{ self as runtime_api, ContractExecResult, ContractsApi as ContractsRuntimeApi, GetStorageResult, }; const RUNTIME_ERROR: i64 = 1; const CONTRACT_DOESNT_EXIST: i64 = 2; const CONTRACT_IS_A_TOMBSTONE: i64 = 3; // A private newtype for converting `GetStorageError` into an RPC error. struct GetStorageError(runtime_api::GetStorageError); impl From for Error { fn from(e: GetStorageError) -> Error { use runtime_api::GetStorageError::*; match e.0 { ContractDoesntExist => Error { code: ErrorCode::ServerError(CONTRACT_DOESNT_EXIST), message: "The specified contract doesn't exist.".into(), data: None, }, IsTombstone => Error { code: ErrorCode::ServerError(CONTRACT_IS_A_TOMBSTONE), message: "The contract is a tombstone and doesn't have any storage.".into(), data: None, } } } } /// 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: Bytes, } /// 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; /// Returns the value under a specified storage `key` in a contract given by `address` param, /// or `None` if it is not set. #[rpc(name = "contracts_getStorage")] fn get_storage( &self, address: AccountId, key: H256, at: Option, ) -> Result>; } /// An implementation of contract specific RPC methods. pub struct Contracts { client: Arc, _marker: std::marker::PhantomData, } impl Contracts { /// Create new `Contracts` with the given reference to the client. pub fn new(client: Arc) -> Self { Contracts { client, _marker: Default::default(), } } } impl ContractsApi<::Hash, AccountId, Balance> for Contracts where Block: BlockT, C: Send + Sync + 'static, C: ProvideRuntimeApi, C: HeaderBackend, C::Api: ContractsRuntimeApi, AccountId: Codec, Balance: Codec, { 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.to_vec()) .map_err(|e| Error { code: ErrorCode::ServerError(RUNTIME_ERROR), message: "Runtime trapped while executing a contract.".into(), data: Some(format!("{:?}", e).into()), })?; Ok(exec_result) } fn get_storage( &self, address: AccountId, key: H256, 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 get_storage_result = api .get_storage(&at, address, key.into()) .map_err(|e| // Handle general API calling errors. Error { code: ErrorCode::ServerError(RUNTIME_ERROR), message: "Runtime trapped while querying storage.".into(), data: Some(format!("{:?}", e).into()), })? .map_err(GetStorageError)? .map(Bytes); Ok(get_storage_result) } }