Struct Client 

pub struct Client { /* private fields */ }

Jsonrpc client, Only to one chain

Implementations

impl Client

pub fn new() -> Self

Create a client for CITA

pub fn set_uri(self, url: &str) -> Self

Set url

When the url address is invalid, panic

pub fn uri(&self) -> &Uri

Get url

pub fn set_chain_id(&mut self, chain_id: U256) -> &mut Self

Set chain id

pub fn set_private_key(&mut self, private_key: &PrivateKey) -> &mut Self

Set private key

pub fn private_key(&self) -> Option<&PrivateKey>

Get private key

pub fn debug(&self) -> bool

Get debug

pub fn set_debug(self, mode: bool) -> Self

Set debug mode

pub fn send_requests<T: Iterator<Item = JsonRpcParams>>( &self, params: T, ) -> Vec<Result<JsonRpcResponse, ToolError>>

Send requests

pub fn send_request( &self, param: JsonRpcParams, ) -> Result<JsonRpcResponse, ToolError>

Send request

pub fn send_request_with_multiple_url<T: Iterator<Item = Uri>>( &self, url: T, params: JsonRpcParams, ) -> Vec<Result<JsonRpcResponse, ToolError>>

Send multiple params to one node

pub fn generate_transaction( &mut self, transaction_options: TransactionOptions<'_>, ) -> Result<Transaction, ToolError>

Constructing a Transaction

pub fn generate_sign_transaction( &self, tx: &Transaction, ) -> Result<String, ToolError>

Constructing a UnverifiedTransaction hex string

pub fn send_signed_transaction( &mut self, param: &str, ) -> Result<JsonRpcResponse, ToolError>

Send a signed transaction

pub fn send_transaction( &mut self, param: &str, ) -> Result<JsonRpcResponse, ToolError>

Send unsigned transactions

pub fn get_chain_id(&mut self) -> Result<u32, ToolError>

Get chain id

pub fn get_chain_id_v1(&mut self) -> Result<U256, ToolError>

Get chain id v1

pub fn get_current_height(&self) -> Result<u64, ToolError>

Get block height

pub fn get_version(&self) -> Result<u32, ToolError>

Get version

Trait Implementations

impl AmendExt<JsonRpcResponse, ToolError> for Client

fn amend_code( &mut self, address: &str, content: &str, quota: Option<u64>, ) -> Result<T, E>

Amend contract code

fn amend_abi( &mut self, address: &str, content: String, quota: Option<u64>, ) -> Result<T, E>

Amend contract ABI

fn amend_h256kv( &mut self, address: &str, h256_kv: &str, quota: Option<u64>, ) -> Result<T, E>

Amend H256KV

fn amend_balance( &mut self, address: &str, balance: U256, quota: Option<u64>, ) -> Result<T, E>

Amend account balance

impl ClientExt<JsonRpcResponse, ToolError> for Client

fn get_peer_count(&self) -> Result<JsonRpcResponse, ToolError>

peerCount: Get network peer count

fn get_peers_info(&self, extra: bool) -> Result<JsonRpcResponse, ToolError>

peersInfo: Get all peers information

fn get_license_info(&self) -> Result<JsonRpcResponse, ToolError>

licenseInfo: Get CITA license information

fn get_block_number(&self) -> Result<JsonRpcResponse, ToolError>

blockNumber: Get current height

fn send_raw_transaction( &mut self, transaction_option: TransactionOptions<'_>, ) -> Result<JsonRpcResponse, ToolError>

sendTransaction: Send a transaction and return transaction hash

fn get_block_by_hash( &self, hash: &str, transaction_info: bool, ) -> Result<JsonRpcResponse, ToolError>

getBlockByHash: Get block by hash

fn get_block_by_number( &self, height: &str, transaction_info: bool, ) -> Result<JsonRpcResponse, ToolError>

getBlockByNumber: Get block by number

fn get_transaction_receipt( &self, hash: &str, ) -> Result<JsonRpcResponse, ToolError>

getTransactionReceipt: Get transaction receipt

fn get_logs( &self, topic: Option<Vec<&str>>, address: Option<Vec<&str>>, from: Option<&str>, to: Option<&str>, ) -> Result<JsonRpcResponse, ToolError>

getLogs: Get logs

fn call( &self, from: Option<&str>, to: &str, data: Option<&str>, height: &str, extra: bool, ) -> Result<JsonRpcResponse, ToolError>

call: (readonly, will not save state change)

fn get_transaction( &self, hash: &str, in_pool: bool, ) -> Result<JsonRpcResponse, ToolError>

getTransaction: Get transaction by hash

fn get_transaction_count( &self, address: &str, height: &str, ) -> Result<JsonRpcResponse, ToolError>

getTransactionCount: Get transaction count of an account

fn get_code( &self, address: &str, height: &str, ) -> Result<JsonRpcResponse, ToolError>

getCode: Get the code of a contract

fn get_abi( &self, address: &str, height: &str, ) -> Result<JsonRpcResponse, ToolError>

getAbi: Get the ABI of a contract

fn get_balance( &self, address: &str, height: &str, ) -> Result<JsonRpcResponse, ToolError>

getBalance: Get the balance of a contract (TODO: return U256)

fn new_filter( &self, topic: Option<Vec<&str>>, address: Option<Vec<&str>>, from: Option<&str>, to: Option<&str>, ) -> Result<JsonRpcResponse, ToolError>

newFilter:

fn new_block_filter(&self) -> Result<JsonRpcResponse, ToolError>

newBlockFilter:

fn uninstall_filter( &self, filter_id: &str, ) -> Result<JsonRpcResponse, ToolError>

uninstallFilter: Uninstall a filter by its id

fn get_filter_changes( &self, filter_id: &str, ) -> Result<JsonRpcResponse, ToolError>

getFilterChanges: Get filter changes

fn get_filter_logs(&self, filter_id: &str) -> Result<JsonRpcResponse, ToolError>

getFilterLogs: Get filter logs

fn get_transaction_proof( &self, hash: &str, ) -> Result<JsonRpcResponse, ToolError>

getTransactionProof: Get proof of a transaction

fn get_metadata(&self, height: &str) -> Result<JsonRpcResponse, ToolError>

getMetaData: Get metadata

fn get_block_header(&self, height: &str) -> Result<JsonRpcResponse, ToolError>

getBlockHeader: Get block headers based on block height

fn get_state_proof( &self, address: &str, key: &str, height: &str, ) -> Result<JsonRpcResponse, ToolError>

getStateProof: Get the proof of the variable at the specified height

fn get_storage_at( &self, address: &str, key: &str, height: &str, ) -> Result<JsonRpcResponse, ToolError>

getStorageAt: Get the value of the key at the specified height

fn get_version(&self) -> Result<JsonRpcResponse, ToolError>

getVersion: Get release version info of all modules

fn estimate_quota( &self, from: Option<&str>, to: &str, data: Option<&str>, height: &str, ) -> Result<JsonRpcResponse, ToolError>

estimateQuota: Estimate a transaction’s quota used

fn get_pool_tx_num(&self) -> Result<JsonRpcResponse, ToolError>

get tx number in pool

fn operate_censored_address( &self, action: CensorAction, censor_addr: &str, ) -> Result<JsonRpcResponse, ToolError>

operate censorship address list

fn get_censored_addr(&self) -> Result<JsonRpcResponse, ToolError>

get censorship address list

impl Clone for Client

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for Client

fn default() -> Self

Returns the “default value” for a type.

impl StoreExt<JsonRpcResponse, ToolError> for Client

fn store_data(&mut self, content: &str, quota: Option<u64>) -> Result<T, E>

Store data to chain, data can be get back by getTransaction rpc call

fn store_abi( &mut self, address: &str, content: String, quota: Option<u64>, ) -> Result<T, E>

Store contract ABI to chain, ABI can be get back by getAbi rpc call

impl Transfer<JsonRpcResponse, ToolError> for Client

fn transfer( &mut self, value: U256, address: &str, quota: Option<u64>, ) -> Result<T, E>

Account transfer, only applies to charge mode