Trait ethcore::client::BlockChainClient [] [src]

pub trait BlockChainClient: Sync + Send {
    fn block_header(&self, id: BlockId) -> Option<Header>;
    fn block_number(&self, id: BlockId) -> Option<BlockNumber>;
    fn block_body(&self, id: BlockId) -> Option<Body>;
    fn block(&self, id: BlockId) -> Option<Block>;
    fn block_status(&self, id: BlockId) -> BlockStatus;
    fn block_total_difficulty(&self, id: BlockId) -> Option<U256>;
    fn nonce(&self, address: &Address, id: BlockId) -> Option<U256>;
    fn storage_root(&self, address: &Address, id: BlockId) -> Option<H256>;
    fn block_hash(&self, id: BlockId) -> Option<H256>;
    fn code(&self, address: &Address, id: BlockId) -> Option<Option<Bytes>>;
    fn balance(&self, address: &Address, id: BlockId) -> Option<U256>;
    fn storage_at(&self,
              address: &Address,
              position: &H256,
              id: BlockId)
              -> Option<H256>; fn list_accounts(&self,
                 id: BlockId,
                 after: Option<&Address>,
                 count: u64)
                 -> Option<Vec<Address>>; fn list_storage(&self,
                id: BlockId,
                account: &Address,
                after: Option<&H256>,
                count: u64)
                -> Option<Vec<H256>>; fn transaction(&self, id: TransactionId) -> Option<LocalizedTransaction>; fn transaction_block(&self, id: TransactionId) -> Option<H256>; fn uncle(&self, id: UncleId) -> Option<Header>; fn transaction_receipt(&self, id: TransactionId) -> Option<LocalizedReceipt>; fn tree_route(&self, from: &H256, to: &H256) -> Option<TreeRoute>; fn find_uncles(&self, hash: &H256) -> Option<Vec<H256>>; fn state_data(&self, hash: &H256) -> Option<Bytes>; fn block_receipts(&self, hash: &H256) -> Option<Bytes>; fn import_block(&self, bytes: Bytes) -> Result<H256, BlockImportError>; fn import_block_with_receipts(&self,
                              block_bytes: Bytes,
                              receipts_bytes: Bytes)
                              -> Result<H256, BlockImportError>; fn queue_info(&self) -> BlockQueueInfo; fn clear_queue(&self); fn chain_info(&self) -> BlockChainInfo; fn additional_params(&self) -> BTreeMap<String, String>; fn best_block_header(&self) -> Header; fn blocks_with_bloom(&self,
                     bloom: &H2048,
                     from_block: BlockId,
                     to_block: BlockId)
                     -> Option<Vec<BlockNumber>>; fn logs(&self, filter: Filter) -> Vec<LocalizedLogEntry>; fn call(&self,
        t: &SignedTransaction,
        block: BlockId,
        analytics: CallAnalytics)
        -> Result<Executed, CallError>; fn estimate_gas(&self,
                t: &SignedTransaction,
                block: BlockId)
                -> Result<U256, CallError>; fn replay(&self,
          t: TransactionId,
          analytics: CallAnalytics)
          -> Result<Executed, CallError>; fn filter_traces(&self, filter: TraceFilter) -> Option<Vec<LocalizedTrace>>; fn trace(&self, trace: TraceId) -> Option<LocalizedTrace>; fn transaction_traces(&self,
                      trace: TransactionId)
                      -> Option<Vec<LocalizedTrace>>; fn block_traces(&self, trace: BlockId) -> Option<Vec<LocalizedTrace>>; fn last_hashes(&self) -> LastHashes; fn queue_transactions(&self, transactions: Vec<Bytes>, peer_id: usize); fn queue_consensus_message(&self, message: Bytes); fn ready_transactions(&self) -> Vec<PendingTransaction>; fn signing_network_id(&self) -> Option<u64>; fn mode(&self) -> Mode; fn set_mode(&self, mode: Mode); fn disable(&self); fn block_extra_info(&self, id: BlockId) -> Option<BTreeMap<String, String>>; fn uncle_extra_info(&self, id: UncleId) -> Option<BTreeMap<String, String>>; fn pruning_info(&self) -> PruningInfo; fn call_contract(&self, address: Address, data: Bytes) -> Result<Bytes, String>; fn transact_contract(&self,
                     address: Address,
                     data: Bytes)
                     -> Result<TransactionImportResult, EthcoreError>; fn registrar_address(&self) -> Option<Address>; fn registry_address(&self, name: String) -> Option<Address>; fn keep_alive(&self) { ... } fn latest_nonce(&self, address: &Address) -> U256 { ... } fn latest_code(&self, address: &Address) -> Option<Bytes> { ... } fn latest_balance(&self, address: &Address) -> U256 { ... } fn latest_storage_at(&self, address: &Address, position: &H256) -> H256 { ... } fn gas_price_corpus(&self, sample_size: usize) -> Vec<U256> { ... } fn gas_price_median(&self, sample_size: usize) -> Option<U256> { ... } fn gas_price_histogram(&self,
                       sample_size: usize,
                       bucket_number: usize)
                       -> Option<Histogram> { ... } }

Blockchain database client. Owns and manages a blockchain and a block queue.

Required Methods

Get raw block header data by block id.

Look up the block number for the given block ID.

Get raw block body data by block id. Block body is an RLP list of two items: uncles and transactions.

Get raw block data by block header hash.

Get block status by block header hash.

Get block total difficulty.

Attempt to get address nonce at given block. May not fail on BlockId::Latest.

Attempt to get address storage root at given block. May not fail on BlockId::Latest.

Get block hash.

Get address code at given block's state.

Get address balance at the given block's state.

May not return None if given BlockId::Latest. Returns None if and only if the block's root hash has been pruned from the DB.

Get value of the storage at given position at the given block's state.

May not return None if given BlockId::Latest. Returns None if and only if the block's root hash has been pruned from the DB.

Get a list of all accounts in the block id, if fat DB is in operation, otherwise None. If after is set the list starts with the following item.

Get a list of all storage keys in the block id, if fat DB is in operation, otherwise None. If after is set the list starts with the following item.

Get transaction with given hash.

Get the hash of block that contains the transaction, if any.

Get uncle with given id.

Get transaction receipt with given hash.

Get a tree route between from and to. See BlockChain::tree_route.

Get all possible uncle hashes for a block.

Get latest state node

Get raw block receipts data by block header hash.

Import a block into the blockchain.

Import a block with transaction receipts. Does no sealing and transaction validation.

Get block queue information.

Clear block queue and abort all import activity.

Get blockchain information.

Get the registrar address, if it exists.

Get the best block header.

Returns numbers of blocks containing given bloom.

Returns logs matching given filter.

Makes a non-persistent transaction call.

Estimates how much gas will be necessary for a call.

Replays a given transaction for inspection.

Returns traces matching given filter.

Returns trace with given id.

Returns traces created by transaction.

Returns traces created by transaction from block.

Get last hashes starting from best block.

Queue transactions for importing.

Queue conensus engine message.

List all transactions that are allowed into the next block.

Get the preferred network ID to sign on

Get the mode.

Set the mode.

Disable the client from importing blocks. This cannot be undone in this session and indicates that a subsystem has reason to believe this executable incapable of syncing the chain.

Returns engine-related extra info for BlockId.

Returns engine-related extra info for UncleId.

Returns information about pruning/data availability.

Like call, but with various defaults. Designed to be used for calling contracts.

Import a transaction: used for misbehaviour reporting.

Get the address of the registry itself.

Get the address of a particular blockchain service, if available.

Provided Methods

Should be called by any external-facing interface when actively using the client. To minimise chatter, there's no need to call more than once every 30s.

Get address nonce at the latest block's state.

Get address code at the latest block's state.

Get address balance at the latest block's state.

Get value of the storage at given position at the latest block's state.

Sorted list of transaction gas prices from at least last sample_size blocks.

Calculate median gas price from recent blocks if they have any transactions.

Get the gas price distribution based on recent blocks if they have any transactions.

Trait Implementations

impl IpcConfig for BlockChainClient
[src]

Current service api version Should be increased if any of the methods changes signature Read more

Current ipc protocol version Should be increased only if signature of system methods changes Read more

Default handshake requires exact versions match

Implementors