[−][src]Struct grin_chain::txhashset::TxHashSet
An easy to manipulate structure holding the 3 MMRs necessary to validate blocks and capturing the output set, associated rangeproofs and the kernels. Also handles the index of Commitments to positions in the output and rangeproof MMRs.
Note that the index is never authoritative, only the trees are guaranteed to indicate whether an output is spent or not. The index may have commitments that have already been spent, even with pruning enabled.
Implementations
impl TxHashSet
[src]
pub fn open(
root_dir: String,
commit_index: Arc<ChainStore>,
header: Option<&BlockHeader>
) -> Result<TxHashSet, Error>
[src]
root_dir: String,
commit_index: Arc<ChainStore>,
header: Option<&BlockHeader>
) -> Result<TxHashSet, Error>
Open an existing or new set of backends for the TxHashSet
pub fn release_backend_files(&mut self)
[src]
Close all backend file handles
pub fn get_unspent(
&self,
commit: Commitment
) -> Result<Option<(OutputIdentifier, CommitPos)>, Error>
[src]
&self,
commit: Commitment
) -> Result<Option<(OutputIdentifier, CommitPos)>, Error>
Check if an output is unspent. We look in the index to find the output MMR pos. Then we check the entry in the output MMR and confirm the hash matches.
pub fn last_n_output(&self, distance: u64) -> Vec<(Hash, OutputIdentifier)>
[src]
returns the last N nodes inserted into the tree (i.e. the 'bottom' nodes at level 0 TODO: These need to return the actual data from the flat-files instead of hashes now
pub fn last_n_rangeproof(&self, distance: u64) -> Vec<(Hash, RangeProof)>
[src]
as above, for range proofs
pub fn last_n_kernel(&self, distance: u64) -> Vec<(Hash, TxKernel)>
[src]
as above, for kernels
pub fn kernel_pmmr_at(
&self,
header: &BlockHeader
) -> ReadonlyPMMR<'_, TxKernel, PMMRBackend<TxKernel>>
[src]
&self,
header: &BlockHeader
) -> ReadonlyPMMR<'_, TxKernel, PMMRBackend<TxKernel>>
Efficient view into the kernel PMMR based on size in header.
pub fn output_pmmr_at(
&self,
header: &BlockHeader
) -> ReadonlyPMMR<'_, OutputIdentifier, PMMRBackend<OutputIdentifier>>
[src]
&self,
header: &BlockHeader
) -> ReadonlyPMMR<'_, OutputIdentifier, PMMRBackend<OutputIdentifier>>
Efficient view into the output PMMR based on size in header.
pub fn rangeproof_pmmr_at(
&self,
header: &BlockHeader
) -> ReadonlyPMMR<'_, RangeProof, PMMRBackend<RangeProof>>
[src]
&self,
header: &BlockHeader
) -> ReadonlyPMMR<'_, RangeProof, PMMRBackend<RangeProof>>
Efficient view into the rangeproof PMMR based on size in header.
pub fn get_block_header(&self, hash: &Hash) -> Result<BlockHeader, Error>
[src]
Convenience function to query the db for a header by its hash.
pub fn outputs_by_pmmr_index(
&self,
start_index: u64,
max_count: u64,
max_index: Option<u64>
) -> (u64, Vec<OutputIdentifier>)
[src]
&self,
start_index: u64,
max_count: u64,
max_index: Option<u64>
) -> (u64, Vec<OutputIdentifier>)
returns outputs from the given pmmr index up to the specified limit. Also returns the last index actually populated max index is the last PMMR index to consider, not leaf index
pub fn highest_output_insertion_index(&self) -> u64
[src]
highest output insertion index available
pub fn rangeproofs_by_pmmr_index(
&self,
start_index: u64,
max_count: u64,
max_index: Option<u64>
) -> (u64, Vec<RangeProof>)
[src]
&self,
start_index: u64,
max_count: u64,
max_index: Option<u64>
) -> (u64, Vec<RangeProof>)
As above, for rangeproofs
pub fn find_kernel(
&self,
excess: &Commitment,
min_index: Option<u64>,
max_index: Option<u64>
) -> Option<(TxKernel, u64)>
[src]
&self,
excess: &Commitment,
min_index: Option<u64>,
max_index: Option<u64>
) -> Option<(TxKernel, u64)>
Find a kernel with a given excess. Work backwards from max_index
to min_index
pub fn roots(&self) -> TxHashSetRoots
[src]
Get MMR roots.
pub fn get_output_pos(&self, commit: &Commitment) -> Result<u64, Error>
[src]
Return Commit's MMR position
pub fn merkle_proof(&mut self, commit: Commitment) -> Result<MerkleProof, Error>
[src]
build a new merkle proof for the given position.
pub fn compact(
&mut self,
horizon_header: &BlockHeader,
batch: &Batch<'_>
) -> Result<(), Error>
[src]
&mut self,
horizon_header: &BlockHeader,
batch: &Batch<'_>
) -> Result<(), Error>
Compact the MMR data files and flush the rm logs
pub fn init_recent_kernel_pos_index(
&self,
header_pmmr: &PMMRHandle<BlockHeader>,
batch: &Batch<'_>
) -> Result<(), Error>
[src]
&self,
header_pmmr: &PMMRHandle<BlockHeader>,
batch: &Batch<'_>
) -> Result<(), Error>
(Re)build the NRD kernel_pos index based on 2 weeks of recent kernel history.
pub fn verify_kernel_pos_index(
&self,
from_header: &BlockHeader,
header_pmmr: &PMMRHandle<BlockHeader>,
batch: &Batch<'_>
) -> Result<(), Error>
[src]
&self,
from_header: &BlockHeader,
header_pmmr: &PMMRHandle<BlockHeader>,
batch: &Batch<'_>
) -> Result<(), Error>
Verify and (re)build the NRD kernel_pos index from the provided header onwards.
pub fn init_output_pos_index(
&self,
header_pmmr: &PMMRHandle<BlockHeader>,
batch: &Batch<'_>
) -> Result<(), Error>
[src]
&self,
header_pmmr: &PMMRHandle<BlockHeader>,
batch: &Batch<'_>
) -> Result<(), Error>
(Re)build the output_pos index to be consistent with the current UTXO set. Remove any "stale" index entries that do not correspond to outputs in the UTXO set. Add any missing index entries based on UTXO set.
Auto Trait Implementations
impl !RefUnwindSafe for TxHashSet
[src]
impl Send for TxHashSet
[src]
impl Sync for TxHashSet
[src]
impl Unpin for TxHashSet
[src]
impl !UnwindSafe for TxHashSet
[src]
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> SafeBorrow<T> for T where
T: ?Sized,
T: ?Sized,
pub fn borrow_replacement(ptr: &T) -> &T
impl<T> Same<T> for T
type Output = T
Should always be Self
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> UnsafeAny for T where
T: Any,
T: Any,
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
V: MultiLane<T>,