Enum cuprate_types::blockchain::BlockchainResponse

pub enum BlockchainResponse {
    BlockExtendedHeader(ExtendedBlockHeader),
    BlockHash([u8; 32]),
    FindBlock(Option<(Chain, usize)>),
    FilterUnknownHashes(HashSet<[u8; 32]>),
    BlockExtendedHeaderInRange(Vec<ExtendedBlockHeader>),
    ChainHeight(usize, [u8; 32]),
    GeneratedCoins(u64),
    Outputs(HashMap<u64, HashMap<u64, OutputOnChain>>),
    NumberOutputsWithAmount(HashMap<u64, usize>),
    KeyImagesSpent(bool),
    CompactChainHistory {
        block_ids: Vec<[u8; 32]>,
        cumulative_difficulty: u128,
    },
    FindFirstUnknown(Option<(usize, usize)>),
    AltBlocksInChain(Vec<AltBlockInformation>),
    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

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.

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.

Outputs(HashMap<u64, HashMap<u64, OutputOnChain>>)

Response to BlockchainReadRequest::Outputs.

Inner value is all the outputs requested, associated with their amount and amount index.

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.

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.

FindFirstUnknown(Option<(usize, usize)>)

The response for BlockchainReadRequest::FindFirstUnknown.

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

This will be None if all blocks were known.

AltBlocksInChain(Vec<AltBlockInformation>)

The response for BlockchainReadRequest::AltBlocksInChain.

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

Ok

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

currently the response for:

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

PopBlocks(ChainId)

The response for 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 copy 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 PartialEq for BlockchainResponse

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for BlockchainResponse

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: 64 bytes

Size for each variant:

• BlockExtendedHeader: 63 bytes
• BlockHash: 32 bytes
• FindBlock: 31 bytes
• FilterUnknownHashes: 55 bytes
• BlockExtendedHeaderInRange: 31 bytes
• ChainHeight: 47 bytes
• GeneratedCoins: 15 bytes
• Outputs: 55 bytes
• NumberOutputsWithAmount: 55 bytes
• KeyImagesSpent: 1 byte
• CompactChainHistory: 47 bytes
• FindFirstUnknown: 31 bytes
• AltBlocksInChain: 31 bytes
• Ok: 0 bytes
• PopBlocks: 15 bytes