BlockchainResponse

cuprate_types::blockchain

Enum BlockchainResponse 

Source 
pub enum BlockchainResponse {

Show 33 variants    BlockCompleteEntries {
        blocks: Vec<BlockCompleteEntry>,
        missing_hashes: Vec<[u8; 32]>,
        blockchain_height: usize,
    },
    BlockCompleteEntriesByHeight(Vec<BlockCompleteEntry>),
    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),
    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,
    },
    OutputDistribution(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),

}
Expand description

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.

§

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.

§

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:

§

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.

§

OutputDistribution(Vec<OutputDistributionData>)

Response to BlockchainReadRequest::OutputDistribution.

§

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:

§

PopBlocks(ChainId)

Response to BlockchainWriteRequest::PopBlocks.

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

Trait Implementations§

Source§

impl Clone for BlockchainResponse

Source§

fn clone(&self) -> BlockchainResponse

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for BlockchainResponse

Source§

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

Formats the value using the given formatter. Read more
Source§

impl PartialEq for BlockchainResponse

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

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

impl Eq for BlockchainResponse

Source§

impl StructuralPartialEq for BlockchainResponse

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> Conv for T

Source§

fn conv<T>(self) -> T
where Self: Into<T>,

Converts self into T using Into<T>. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> FmtForward for T

Source§

fn fmt_binary(self) -> FmtBinary<Self>
where Self: Binary,

Causes self to use its Binary implementation when Debug-formatted.
Source§

fn fmt_display(self) -> FmtDisplay<Self>
where Self: Display,

Causes self to use its Display implementation when Debug-formatted.
Source§

fn fmt_lower_exp(self) -> FmtLowerExp<Self>
where Self: LowerExp,

Causes self to use its LowerExp implementation when Debug-formatted.
Source§

fn fmt_lower_hex(self) -> FmtLowerHex<Self>
where Self: LowerHex,

Causes self to use its LowerHex implementation when Debug-formatted.
Source§

fn fmt_octal(self) -> FmtOctal<Self>
where Self: Octal,

Causes self to use its Octal implementation when Debug-formatted.
Source§

fn fmt_pointer(self) -> FmtPointer<Self>
where Self: Pointer,

Causes self to use its Pointer implementation when Debug-formatted.
Source§

fn fmt_upper_exp(self) -> FmtUpperExp<Self>
where Self: UpperExp,

Causes self to use its UpperExp implementation when Debug-formatted.
Source§

fn fmt_upper_hex(self) -> FmtUpperHex<Self>
where Self: UpperHex,

Causes self to use its UpperHex implementation when Debug-formatted.
Source§

fn fmt_list(self) -> FmtList<Self>
where &'a Self: for<'a> IntoIterator,

Formats each item in a sequence. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pipe for T
where T: ?Sized,

Source§

fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> R
where Self: Sized,

Pipes by value. This is generally the method you want to use. Read more
Source§

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R
where R: 'a,

Borrows self and passes that borrow into the pipe function. Read more
Source§

fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R
where R: 'a,

Mutably borrows self and passes that borrow into the pipe function. Read more
Source§

fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
where Self: Borrow<B>, B: 'a + ?Sized, R: 'a,

Borrows self, then passes self.borrow() into the pipe function. Read more
Source§

fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
where Self: BorrowMut<B>, B: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.borrow_mut() into the pipe function. Read more
Source§

fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
where Self: AsRef<U>, U: 'a + ?Sized, R: 'a,

Borrows self, then passes self.as_ref() into the pipe function.
Source§

fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
where Self: AsMut<U>, U: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.as_mut() into the pipe function.
Source§

fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
where Self: Deref<Target = T>, T: 'a + ?Sized, R: 'a,

Borrows self, then passes self.deref() into the pipe function.
Source§

fn pipe_deref_mut<'a, T, R>( &'a mut self, func: impl FnOnce(&'a mut T) -> R, ) -> R
where Self: DerefMut<Target = T> + Deref, T: 'a + ?Sized, R: 'a,

Mutably borrows self, then passes self.deref_mut() into the pipe function.
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> Tap for T

Source§

fn tap(self, func: impl FnOnce(&Self)) -> Self

Immutable access to a value. Read more
Source§

fn tap_mut(self, func: impl FnOnce(&mut Self)) -> Self

Mutable access to a value. Read more
Source§

fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Immutable access to the Borrow<B> of a value. Read more
Source§

fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Mutable access to the BorrowMut<B> of a value. Read more
Source§

fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Immutable access to the AsRef<R> view of a value. Read more
Source§

fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Mutable access to the AsMut<R> view of a value. Read more
Source§

fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Immutable access to the Deref::Target of a value. Read more
Source§

fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Mutable access to the Deref::Target of a value. Read more
Source§

fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self

Calls .tap() only in debug builds, and is erased in release builds.
Source§

fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self

Calls .tap_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
where Self: Borrow<B>, B: ?Sized,

Calls .tap_borrow() only in debug builds, and is erased in release builds.
Source§

fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
where Self: BorrowMut<B>, B: ?Sized,

Calls .tap_borrow_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
where Self: AsRef<R>, R: ?Sized,

Calls .tap_ref() only in debug builds, and is erased in release builds.
Source§

fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
where Self: AsMut<R>, R: ?Sized,

Calls .tap_ref_mut() only in debug builds, and is erased in release builds.
Source§

fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
where Self: Deref<Target = T>, T: ?Sized,

Calls .tap_deref() only in debug builds, and is erased in release builds.
Source§

fn tap_deref_mut_dbg<T>(self, func: impl FnOnce(&mut T)) -> Self
where Self: DerefMut<Target = T> + Deref, T: ?Sized,

Calls .tap_deref_mut() only in debug builds, and is erased in release builds.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> TryConv for T

Source§

fn try_conv<T>(self) -> Result<T, Self::Error>
where Self: TryInto<T>,

Attempts to convert self into T using TryInto<T>. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

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
  • BlockExtendedHeader: 64 bytes
  • BlockHash: 40 bytes
  • BlockHashInRange: 32 bytes
  • FindBlock: 32 bytes
  • FilterUnknownHashes: 56 bytes
  • BlockExtendedHeaderInRange: 32 bytes
  • ChainHeight: 48 bytes
  • GeneratedCoins: 16 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
  • OutputDistribution: 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