pub trait BlockChainClient: Sync + Send + AccountData + BlockChain + CallContract + RegistryInfo + ImportBlock + IoClient + BadBlocks {
Show 51 methods
fn block_number(&self, id: BlockId) -> Option<BlockNumber>;
fn block_body(&self, id: BlockId) -> Option<Body>;
fn block_status(&self, id: BlockId) -> BlockStatus;
fn block_total_difficulty(&self, 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,
state: StateOrBlock
) -> Option<Option<Bytes>>;
fn is_canon(&self, hash: &H256) -> bool;
fn storage_at(
&self,
address: &Address,
position: &H256,
state: StateOrBlock
) -> 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 block_transaction(
&self,
id: TransactionId
) -> Option<LocalizedTransaction>;
fn queued_transaction(&self, hash: H256) -> Option<Arc<VerifiedTransaction>>;
fn uncle(&self, id: UncleId) -> Option<Header>;
fn transaction_receipt(&self, id: TransactionId) -> Option<LocalizedReceipt>;
fn localized_block_receipts(
&self,
id: BlockId
) -> Option<Vec<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<BlockReceipts>;
fn queue_info(&self) -> BlockQueueInfo;
fn clear_queue(&self);
fn additional_params(&self) -> BTreeMap<String, String>;
fn logs(&self, filter: Filter) -> Result<Vec<LocalizedLogEntry>, BlockId>;
fn replay(
&self,
t: TransactionId,
analytics: CallAnalytics
) -> Result<Executed, CallError>;
fn replay_block_transactions(
&self,
block: BlockId,
analytics: CallAnalytics
) -> Result<Box<dyn Iterator<Item = (H256, 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 transactions_to_propagate(&self) -> Vec<Arc<VerifiedTransaction>>ⓘNotable traits for Vec<u8, A>impl<A> Write for Vec<u8, A> where
A: Allocator,
;
fn transaction(&self, tx_hash: &H256) -> Option<Arc<VerifiedTransaction>>;
fn signing_chain_id(&self) -> Option<u64>;
fn mode(&self) -> Mode;
fn set_mode(&self, mode: Mode);
fn spec_name(&self) -> String;
fn set_spec_name(&self, spec_name: String) -> Result<(), ()>;
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 create_transaction(
&self,
tx_request: TransactionRequest
) -> Result<SignedTransaction, Error>;
fn transact(&self, tx_request: TransactionRequest) -> Result<(), Error>;
fn registrar_address(&self) -> Option<Address>;
fn is_processing_fork(&self) -> bool;
fn latest_code(&self, address: &Address) -> Option<Bytes> { ... }
fn latest_storage_at(&self, address: &Address, position: &H256) -> H256 { ... }
fn is_queue_empty(&self) -> bool { ... }
fn gas_price_corpus(&self, sample_size: usize) -> Corpus<U256> { ... }
fn priority_gas_price_corpus(
&self,
sample_size: usize,
eip1559_transition: BlockNumber
) -> Corpus<U256> { ... }
}
Expand description
Blockchain database client. Owns and manages a blockchain and a block queue.
Required methods
fn block_number(&self, id: BlockId) -> Option<BlockNumber>
fn block_number(&self, id: BlockId) -> Option<BlockNumber>
Look up the block number for the given block ID.
fn block_body(&self, id: BlockId) -> Option<Body>
fn block_body(&self, id: BlockId) -> Option<Body>
Get raw block body data by block id. Block body is an RLP list of two items: uncles and transactions.
fn block_status(&self, id: BlockId) -> BlockStatus
fn block_status(&self, id: BlockId) -> BlockStatus
Get block status by block header hash.
fn block_total_difficulty(&self, id: BlockId) -> Option<U256>
fn block_total_difficulty(&self, id: BlockId) -> Option<U256>
Get block total difficulty.
Attempt to get address storage root at given block. May not fail on BlockId::Latest.
fn block_hash(&self, id: BlockId) -> Option<H256>
fn block_hash(&self, id: BlockId) -> Option<H256>
Get block hash.
Get address code at given block’s state.
Returns true if the given block is known and in the canon chain.
fn storage_at(
&self,
address: &Address,
position: &H256,
state: StateOrBlock
) -> Option<H256>
fn storage_at(
&self,
address: &Address,
position: &H256,
state: StateOrBlock
) -> Option<H256>
Get address code hash at given block’s state. 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.
fn block_transaction(&self, id: TransactionId) -> Option<LocalizedTransaction>
fn block_transaction(&self, id: TransactionId) -> Option<LocalizedTransaction>
Get transaction with given hash.
fn queued_transaction(&self, hash: H256) -> Option<Arc<VerifiedTransaction>>
fn queued_transaction(&self, hash: H256) -> Option<Arc<VerifiedTransaction>>
Get pool transaction with a given hash.
fn transaction_receipt(&self, id: TransactionId) -> Option<LocalizedReceipt>
fn transaction_receipt(&self, id: TransactionId) -> Option<LocalizedReceipt>
Get transaction receipt with given hash.
fn localized_block_receipts(&self, id: BlockId) -> Option<Vec<LocalizedReceipt>>
fn localized_block_receipts(&self, id: BlockId) -> Option<Vec<LocalizedReceipt>>
Get localized receipts for all transaction in given block.
Get a tree route between from
and to
.
See BlockChain::tree_route
.
Get all possible uncle hashes for a block.
fn state_data(&self, hash: &H256) -> Option<Bytes>
fn state_data(&self, hash: &H256) -> Option<Bytes>
Get latest state node
fn block_receipts(&self, hash: &H256) -> Option<BlockReceipts>
fn block_receipts(&self, hash: &H256) -> Option<BlockReceipts>
Get block receipts data by block header hash.
fn queue_info(&self) -> BlockQueueInfo
fn queue_info(&self) -> BlockQueueInfo
Get block queue information.
fn clear_queue(&self)
fn clear_queue(&self)
Clear block queue and abort all import activity.
fn additional_params(&self) -> BTreeMap<String, String>
fn additional_params(&self) -> BTreeMap<String, String>
Get the registrar address, if it exists.
Returns logs matching given filter. If one of the filtering block cannot be found, returns the block id that caused the error.
fn replay(
&self,
t: TransactionId,
analytics: CallAnalytics
) -> Result<Executed, CallError>
fn replay(
&self,
t: TransactionId,
analytics: CallAnalytics
) -> Result<Executed, CallError>
Replays a given transaction for inspection.
Replays all the transactions in a given block for inspection.
fn filter_traces(&self, filter: TraceFilter) -> Option<Vec<LocalizedTrace>>
fn filter_traces(&self, filter: TraceFilter) -> Option<Vec<LocalizedTrace>>
Returns traces matching given filter.
fn trace(&self, trace: TraceId) -> Option<LocalizedTrace>
fn trace(&self, trace: TraceId) -> Option<LocalizedTrace>
Returns trace with given id.
fn transaction_traces(
&self,
trace: TransactionId
) -> Option<Vec<LocalizedTrace>>
fn transaction_traces(
&self,
trace: TransactionId
) -> Option<Vec<LocalizedTrace>>
Returns traces created by transaction.
fn block_traces(&self, trace: BlockId) -> Option<Vec<LocalizedTrace>>
fn block_traces(&self, trace: BlockId) -> Option<Vec<LocalizedTrace>>
Returns traces created by transaction from block.
fn last_hashes(&self) -> LastHashes
fn last_hashes(&self) -> LastHashes
Get last hashes starting from best block.
List all ready transactions that should be propagated to other peers.
fn transaction(&self, tx_hash: &H256) -> Option<Arc<VerifiedTransaction>>
fn transaction(&self, tx_hash: &H256) -> Option<Arc<VerifiedTransaction>>
Get verified transaction with specified transaction hash.
fn signing_chain_id(&self) -> Option<u64>
fn signing_chain_id(&self) -> Option<u64>
Get the preferred chain ID to sign on
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
.
fn pruning_info(&self) -> PruningInfo
fn pruning_info(&self) -> PruningInfo
Returns information about pruning/data availability.
fn create_transaction(
&self,
tx_request: TransactionRequest
) -> Result<SignedTransaction, Error>
fn create_transaction(
&self,
tx_request: TransactionRequest
) -> Result<SignedTransaction, Error>
Returns a transaction signed with the key configured in the engine signer.
Schedule state-altering transaction to be executed on the next pending block with the given gas and nonce parameters.
fn registrar_address(&self) -> Option<Address>
fn registrar_address(&self) -> Option<Address>
Get the address of the registry itself.
fn is_processing_fork(&self) -> bool
fn is_processing_fork(&self) -> bool
Returns true, if underlying import queue is processing possible fork at the moment
Provided methods
fn latest_code(&self, address: &Address) -> Option<Bytes>
fn latest_code(&self, address: &Address) -> Option<Bytes>
Get address code at the latest block’s state.
fn latest_storage_at(&self, address: &Address, position: &H256) -> H256
fn latest_storage_at(&self, address: &Address, position: &H256) -> H256
Get value of the storage at given position at the latest block’s state.
fn is_queue_empty(&self) -> bool
fn is_queue_empty(&self) -> bool
Returns true if block queue is empty.
fn gas_price_corpus(&self, sample_size: usize) -> Corpus<U256>
fn gas_price_corpus(&self, sample_size: usize) -> Corpus<U256>
Sorted list of transaction gas prices from at least last sample_size blocks.
fn priority_gas_price_corpus(
&self,
sample_size: usize,
eip1559_transition: BlockNumber
) -> Corpus<U256>
fn priority_gas_price_corpus(
&self,
sample_size: usize,
eip1559_transition: BlockNumber
) -> Corpus<U256>
Sorted list of transaction priority gas prices from at least last sample_size blocks.