Struct diem_key_manager::diem_interface::JsonRpcDiemInterface

pub struct JsonRpcDiemInterface { /* fields omitted */ }

This implements the DiemInterface by talking directly to the JSON RPC API.

DISCLAIMER: this implementation assumes that the json rpc client explicitly trusts the json rpc server that is responding to its requests (e.g., the client assumes the server has already been authenticated, provides encrypted and freshness protected messages, etc.). As such, the security of the server will need to be verified in production before this interface should be used. Pointing the client to an untrusted (and potentially malicious) json rpc server, can result in denial-of-service attacks (e.g., against the key manager).

TODO(joshlind): add proof checks to the JsonRpcClient to verify the state returned by the json rpc server we’re talking to. Although we won’t be able to guarantee freshness, it’s better than simply trusting the response for correctness..

Implementations

impl JsonRpcDiemInterface

pub fn new(json_rpc_endpoint: String) -> Self

Trait Implementations

impl Clone for JsonRpcDiemInterface

fn clone(&self) -> JsonRpcDiemInterface

Returns a copy of the value.

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

Performs copy-assignment from source.

impl DiemInterface for JsonRpcDiemInterface

fn diem_timestamp(&self) -> Result<u64, Error>

Retrieves the current time from the blockchain, this is returned as microseconds.

fn last_reconfiguration(&self) -> Result<u64, Error>

Retrieves the last reconfiguration time from the blockchain, this is returned as microseconds.

fn retrieve_sequence_number(
    &self,
    account: AccountAddress
) -> Result<u64, Error>

Retrieve current sequence number for the provided account.

fn submit_transaction(&self, transaction: Transaction) -> Result<(), Error>

Submits a transaction to the block chain and returns successfully if the transaction was successfully submitted. It does not necessarily mean the transaction successfully executed.

fn retrieve_validator_config(
    &self,
    account: AccountAddress
) -> Result<ValidatorConfig, Error>

Retrieves the ValidatorConfig at the specified AccountAddress if one exists.

fn retrieve_validator_info(
    &self,
    account: AccountAddress
) -> Result<ValidatorInfo, Error>

Retrieves the ValidatorInfo for the specified account from the current ValidatorSet if one exists.

fn retrieve_account_state(
    &self,
    account: AccountAddress
) -> Result<AccountState, Error>

Fetches the AccountState associated with a specific account. This is currently only used by test code, but it’s not completely inconceivable that non-test code will want access to this in the future.