Enum BlockchainResponse 

pub enum BlockchainResponse {
    BlockCompleteEntries {
        blocks: Vec<BlockCompleteEntry>,
        missing_hashes: Vec<[u8; 32]>,
        blockchain_height: usize,
    },
    BlockCompleteEntriesByHeight(Vec<BlockCompleteEntry>),
    BlockCompleteEntriesAboveSplitPoint {
        blocks: Vec<BlockCompleteEntry>,
        output_indices: Vec<Vec<Vec<u64>>>,
        blockchain_height: usize,
        start_height: usize,
        top_hash: [u8; 32],
    },
    BlockExtendedHeader(ExtendedBlockHeader),
    BlockHash([u8; 32]),
    BlockHashInRange(Vec<[u8; 32]>),
    FindBlock(Option<(Chain, usize)>),
    FilterUnknownHashes(HashSet<[u8; 32]>),
    BlockExtendedHeaderInRange(Vec<ExtendedBlockHeader>),
    ChainHeight(usize, [u8; 32]),
    GeneratedCoins(u64),
    CumulativeRctOutsInRange(Vec<u64>),
    Outputs(OutputCache),
    OutputsVec(Vec<(u64, Vec<(u64, OutputOnChain)>)>),
    NumberOutputsWithAmount(HashMap<u64, usize>),
    KeyImagesSpent(bool),
    KeyImagesSpentVec(Vec<bool>),
    CompactChainHistory {
        block_ids: Vec<[u8; 32]>,
        cumulative_difficulty: u128,
    },
    NextChainEntry {
        start_height: Option<usize>,
        chain_height: usize,
        block_ids: Vec<[u8; 32]>,
        block_weights: Vec<usize>,
        cumulative_difficulty: u128,
        first_block_blob: Option<Vec<u8>>,
    },
    FindFirstUnknown(Option<(usize, usize)>),
    TxsInBlock(Option<TxsInBlock>),
    AltBlocksInChain(Vec<AltBlockInformation>),
    Block(Block),
    TotalTxCount(usize),
    DatabaseSize {
        database_size: u64,
        free_space: u64,
    },
    PreRctOutputDistribution(Vec<OutputDistributionData>),
    OutputHistogram(Vec<OutputHistogramEntry>),
    CoinbaseTxSum(CoinbaseTxSum),
    AltChains(Vec<ChainInfo>),
    AltChainCount(usize),
    Transactions {
        txs: Vec<TxInBlockchain>,
        missed_txs: Vec<[u8; 32]>,
    },
    TotalRctOutputs(u64),
    TxOutputIndexes(Vec<u64>),
    Ok,
    PopBlocks(ChainId),
}

A response from the database.

These are the data types returned when using sending a Request.

This pairs with BlockchainReadRequest and BlockchainWriteRequest, see those two for more info.

Variants

BlockCompleteEntries

Response to BlockchainReadRequest::BlockCompleteEntries.

Fields

blocks: Vec<BlockCompleteEntry>

The BlockCompleteEntrys that we had.

missing_hashes: Vec<[u8; 32]>

The hashes of blocks that were requested, but we don’t have.

blockchain_height: usize

Our blockchain height.

BlockCompleteEntriesByHeight(Vec<BlockCompleteEntry>)

Response to BlockchainReadRequest::BlockCompleteEntriesByHeight.

BlockCompleteEntriesAboveSplitPoint

Response to BlockchainReadRequest::BlockCompleteEntriesAboveSplitPoint.

Fields

blocks: Vec<BlockCompleteEntry>

The BlockCompleteEntrys that we had.

output_indices: Vec<Vec<Vec<u64>>>

The output indices of all transaction outputs across all blocks.

output_indices[block][tx][output], including the miner tx (miner tx will be empty if not requested).

blockchain_height: usize

Our blockchain height.

start_height: usize

The height the returned blocks start from.

top_hash: [u8; 32]

Hash of the current top block.

BlockExtendedHeader(ExtendedBlockHeader)

Response to BlockchainReadRequest::BlockExtendedHeader.

Inner value is the extended headed of the requested block.

BlockHash([u8; 32])

Response to BlockchainReadRequest::BlockHash.

Inner value is the hash of the requested block.

BlockHashInRange(Vec<[u8; 32]>)

Response to BlockchainReadRequest::BlockHashInRange.

Inner value is the hashes of the requested blocks, in order.

FindBlock(Option<(Chain, usize)>)

Response to BlockchainReadRequest::FindBlock.

Inner value is the chain and height of the block if found.

FilterUnknownHashes(HashSet<[u8; 32]>)

Response to BlockchainReadRequest::FilterUnknownHashes.

Inner value is the list of hashes that were in the main chain.

BlockExtendedHeaderInRange(Vec<ExtendedBlockHeader>)

Response to BlockchainReadRequest::BlockExtendedHeaderInRange.

Inner value is the list of extended header(s) of the requested block(s).

ChainHeight(usize, [u8; 32])

Response to BlockchainReadRequest::ChainHeight.

Inner value is the chain height, and the top block’s hash.

GeneratedCoins(u64)

Response to BlockchainReadRequest::GeneratedCoins.

Inner value is the total amount of generated coins up to and including the chosen height, in atomic units.

CumulativeRctOutsInRange(Vec<u64>)

Response to BlockchainReadRequest::CumulativeRctOutsInRange.

Inner value is cumulative_rct_outs for each block in the requested range.

Outputs(OutputCache)

Response to BlockchainReadRequest::Outputs.

Inner value is an OutputCache, missing outputs won’t trigger an error, they just will not be in the cache until the cache is updated with the block containing those outputs.

OutputsVec(Vec<(u64, Vec<(u64, OutputOnChain)>)>)

Response to BlockchainReadRequest::OutputsVec.

NumberOutputsWithAmount(HashMap<u64, usize>)

Response to BlockchainReadRequest::NumberOutputsWithAmount.

Inner value is a HashMap of all the outputs requested where:

• Key = output amount
• Value = count of outputs with the same amount

KeyImagesSpent(bool)

Response to BlockchainReadRequest::KeyImagesSpent.

The inner value is true if any of the key images were spent (existed in the database already).

The inner value is false if none of the key images were spent.

KeyImagesSpentVec(Vec<bool>)

Response to BlockchainReadRequest::KeyImagesSpentVec.

Inner value is a Vec the same length as the input.

The index of each entry corresponds with the request. true means that the key image was spent.

CompactChainHistory

Response to BlockchainReadRequest::CompactChainHistory.

Fields

block_ids: Vec<[u8; 32]>

A list of blocks IDs in our chain, starting with the most recent block, all the way to the genesis block.

These blocks should be in reverse chronological order, not every block is needed.

cumulative_difficulty: u128

The current cumulative difficulty of the chain.

NextChainEntry

Response to BlockchainReadRequest::NextChainEntry.

If all blocks were unknown start_height will be None, the other fields will be meaningless.

Fields

start_height: Option<usize>

The start height of this entry, None if we could not find the split point.

chain_height: usize

The current chain height.

block_ids: Vec<[u8; 32]>

The next block hashes in the entry.

block_weights: Vec<usize>

The block weights of the next blocks.

cumulative_difficulty: u128

The current cumulative difficulty of our chain.

first_block_blob: Option<Vec<u8>>

The block blob of the 2nd block in block_ids, if there is one.

FindFirstUnknown(Option<(usize, usize)>)

Response to BlockchainReadRequest::FindFirstUnknown.

Contains the index of the first unknown block and its expected height.

This will be None if all blocks were known.

TxsInBlock(Option<TxsInBlock>)

The response for BlockchainReadRequest::TxsInBlock.

Will return None if the request contained an index out of range.

AltBlocksInChain(Vec<AltBlockInformation>)

The response for BlockchainReadRequest::AltBlocksInChain.

Contains all the alt blocks in the alt-chain in chronological order.

Block(Block)

Response to:

• BlockchainReadRequest::Block.
• BlockchainReadRequest::BlockByHash.

TotalTxCount(usize)

Response to BlockchainReadRequest::TotalTxCount.

DatabaseSize

Response to BlockchainReadRequest::DatabaseSize.

Fields

database_size: u64

The size of the database file in bytes.

free_space: u64

The amount of free bytes there are the disk where the database is located.

PreRctOutputDistribution(Vec<OutputDistributionData>)

Response to BlockchainReadRequest::PreRctOutputDistribution.

OutputHistogram(Vec<OutputHistogramEntry>)

Response to BlockchainReadRequest::OutputHistogram.

CoinbaseTxSum(CoinbaseTxSum)

Response to BlockchainReadRequest::CoinbaseTxSum.

AltChains(Vec<ChainInfo>)

Response to BlockchainReadRequest::AltChains.

AltChainCount(usize)

Response to BlockchainReadRequest::AltChainCount.

Transactions

Response to BlockchainReadRequest::Transactions.

Fields

txs: Vec<TxInBlockchain>

The transaction blobs found.

missed_txs: Vec<[u8; 32]>

The hashes of any transactions that could not be found.

TotalRctOutputs(u64)

Response to BlockchainReadRequest::TotalRctOutputs.

TxOutputIndexes(Vec<u64>)

Response to BlockchainReadRequest::TxOutputIndexes.

Ok

A generic Ok response to indicate a request was successfully handled.

currently the response for:

• BlockchainWriteRequest::WriteBlock
• BlockchainWriteRequest::WriteAltBlock
• BlockchainWriteRequest::FlushAltBlocks

PopBlocks(ChainId)

Response to BlockchainWriteRequest::PopBlocks.

The inner value is the alt-chain ID for the old main chain blocks.

Trait Implementations

impl Clone for BlockchainResponse

fn clone(&self) -> BlockchainResponse

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BlockchainResponse

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for BlockchainResponse

impl PartialEq for BlockchainResponse

fn eq(&self, other: &BlockchainResponse) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for BlockchainResponse

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 640 bytes

Size for each variant:

• BlockCompleteEntries: 64 bytes
• BlockCompleteEntriesByHeight: 32 bytes
• BlockCompleteEntriesAboveSplitPoint: 104 bytes
• BlockExtendedHeader: 64 bytes
• BlockHash: 40 bytes
• BlockHashInRange: 32 bytes
• FindBlock: 32 bytes
• FilterUnknownHashes: 56 bytes
• BlockExtendedHeaderInRange: 32 bytes
• ChainHeight: 48 bytes
• GeneratedCoins: 16 bytes
• CumulativeRctOutsInRange: 32 bytes
• Outputs: 224 bytes
• OutputsVec: 32 bytes
• NumberOutputsWithAmount: 56 bytes
• KeyImagesSpent: 9 bytes
• KeyImagesSpentVec: 32 bytes
• CompactChainHistory: 64 bytes
• NextChainEntry: 128 bytes
• FindFirstUnknown: 32 bytes
• TxsInBlock: 56 bytes
• AltBlocksInChain: 32 bytes
• Block: 632 bytes
• TotalTxCount: 16 bytes
• DatabaseSize: 24 bytes
• PreRctOutputDistribution: 32 bytes
• OutputHistogram: 32 bytes
• CoinbaseTxSum: 40 bytes
• AltChains: 32 bytes
• AltChainCount: 16 bytes
• Transactions: 56 bytes
• TotalRctOutputs: 16 bytes
• TxOutputIndexes: 32 bytes
• Ok: 0 bytes
• PopBlocks: 16 bytes