// 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)
}
}