Struct reth_provider::providers::DatabaseProviderRW
source · pub struct DatabaseProviderRW<DB: Database>(pub DatabaseProvider<<DB as Database>::TXMut>);
Expand description
A DatabaseProvider
that holds a read-write database transaction.
Ideally this would be an alias type. However, there’s some weird compiler error (https://github.com/rust-lang/rust/issues/102211), that forces us to wrap this in a struct instead. Once that issue is solved, we can probably revert back to being an alias type.
Tuple Fields§
§0: DatabaseProvider<<DB as Database>::TXMut>
Implementations§
source§impl<DB: Database> DatabaseProviderRW<DB>
impl<DB: Database> DatabaseProviderRW<DB>
source§impl<DB: Database> DatabaseProviderRW<DB>
impl<DB: Database> DatabaseProviderRW<DB>
sourcepub fn insert_historical_block(
&self,
block: SealedBlockWithSenders,
) -> ProviderResult<StoredBlockBodyIndices>
pub fn insert_historical_block( &self, block: SealedBlockWithSenders, ) -> ProviderResult<StoredBlockBodyIndices>
Inserts an historical block. Used for setting up test environments
Methods from Deref<Target = DatabaseProvider<<DB as Database>::TXMut>>§
sourcepub fn static_file_provider(&self) -> &StaticFileProvider
pub fn static_file_provider(&self) -> &StaticFileProvider
Returns a static file provider
sourcepub fn prune_modes_ref(&self) -> &PruneModes
pub fn prune_modes_ref(&self) -> &PruneModes
Returns reference to prune modes.
sourcepub fn chain_spec(&self) -> &ChainSpec
pub fn chain_spec(&self) -> &ChainSpec
Returns a reference to the [ChainSpec
].
sourcepub fn table<T: Table>(&self) -> Result<Vec<KeyValue<T>>, DatabaseError>
pub fn table<T: Table>(&self) -> Result<Vec<KeyValue<T>>, DatabaseError>
Return full table as Vec
sourcepub fn get<T: Table>(
&self,
range: impl RangeBounds<T::Key>,
) -> Result<Vec<KeyValue<T>>, DatabaseError>
pub fn get<T: Table>( &self, range: impl RangeBounds<T::Key>, ) -> Result<Vec<KeyValue<T>>, DatabaseError>
Return a list of entries from the table, based on the given range.
sourcepub fn get_block_range(
&self,
range: impl RangeBounds<BlockNumber> + Clone,
) -> ProviderResult<Vec<SealedBlockWithSenders>>
pub fn get_block_range( &self, range: impl RangeBounds<BlockNumber> + Clone, ) -> ProviderResult<Vec<SealedBlockWithSenders>>
Get the given range of blocks.
sourcepub fn get_state(
&self,
range: RangeInclusive<BlockNumber>,
) -> ProviderResult<Option<ExecutionOutcome>>
pub fn get_state( &self, range: RangeInclusive<BlockNumber>, ) -> ProviderResult<Option<ExecutionOutcome>>
Return the last N blocks of state, recreating the ExecutionOutcome
.
- Iterate over the
BlockBodyIndices
table to get all the transaction ids. - Iterate over the
StorageChangeSets
table and theAccountChangeSets
tables in reverse order to reconstruct the changesets.- In order to have both the old and new values in the changesets, we also access the plain state tables.
- While iterating over the changeset tables, if we encounter a new account or storage slot,
we:
- Take the old value from the changeset
- Take the new value from the plain state
- Save the old value to the local state
- While iterating over the changeset tables, if we encounter an account/storage slot we
have seen before we:
- Take the old value from the changeset
- Take the new value from the local state
- Set the local state to the value in the changeset
If the range is empty, or there are no blocks for the given range, then this returns None
.
sourcepub fn remove_state(
&self,
range: RangeInclusive<BlockNumber>,
) -> ProviderResult<()>
pub fn remove_state( &self, range: RangeInclusive<BlockNumber>, ) -> ProviderResult<()>
Remove the last N blocks of state.
The latest state will be unwound
- Iterate over the
BlockBodyIndices
table to get all the transaction ids. - Iterate over the
StorageChangeSets
table and theAccountChangeSets
tables in reverse order to reconstruct the changesets.- In order to have both the old and new values in the changesets, we also access the plain state tables.
- While iterating over the changeset tables, if we encounter a new account or storage slot,
we:
- Take the old value from the changeset
- Take the new value from the plain state
- Save the old value to the local state
- While iterating over the changeset tables, if we encounter an account/storage slot we
have seen before we:
- Take the old value from the changeset
- Take the new value from the local state
- Set the local state to the value in the changeset
sourcepub fn take_state(
&self,
range: RangeInclusive<BlockNumber>,
) -> ProviderResult<ExecutionOutcome>
pub fn take_state( &self, range: RangeInclusive<BlockNumber>, ) -> ProviderResult<ExecutionOutcome>
Take the last N blocks of state, recreating the ExecutionOutcome
.
The latest state will be unwound and returned back with all the blocks
- Iterate over the
BlockBodyIndices
table to get all the transaction ids. - Iterate over the
StorageChangeSets
table and theAccountChangeSets
tables in reverse order to reconstruct the changesets.- In order to have both the old and new values in the changesets, we also access the plain state tables.
- While iterating over the changeset tables, if we encounter a new account or storage slot,
we:
- Take the old value from the changeset
- Take the new value from the plain state
- Save the old value to the local state
- While iterating over the changeset tables, if we encounter an account/storage slot we
have seen before we:
- Take the old value from the changeset
- Take the new value from the local state
- Set the local state to the value in the changeset
sourcepub fn remove<T: Table>(
&self,
range: impl RangeBounds<T::Key>,
) -> Result<usize, DatabaseError>
pub fn remove<T: Table>( &self, range: impl RangeBounds<T::Key>, ) -> Result<usize, DatabaseError>
Remove list of entries from the table. Returns the number of entries removed.
sourcepub fn take<T: Table>(
&self,
range: impl RangeBounds<T::Key>,
) -> Result<Vec<KeyValue<T>>, DatabaseError>
pub fn take<T: Table>( &self, range: impl RangeBounds<T::Key>, ) -> Result<Vec<KeyValue<T>>, DatabaseError>
Return a list of entries from the table, and remove them, based on the given range.
sourcepub fn remove_block_transaction_range(
&self,
range: impl RangeBounds<BlockNumber> + Clone,
) -> ProviderResult<()>
pub fn remove_block_transaction_range( &self, range: impl RangeBounds<BlockNumber> + Clone, ) -> ProviderResult<()>
Remove requested block transactions, without returning them.
This will remove block data for the given range from the following tables:
sourcepub fn take_block_transaction_range(
&self,
range: impl RangeBounds<BlockNumber> + Clone,
) -> ProviderResult<Vec<(BlockNumber, Vec<TransactionSignedEcRecovered>)>>
pub fn take_block_transaction_range( &self, range: impl RangeBounds<BlockNumber> + Clone, ) -> ProviderResult<Vec<(BlockNumber, Vec<TransactionSignedEcRecovered>)>>
Get requested blocks transaction with senders, also removing them from the database
This will remove block data for the given range from the following tables:
sourcepub fn remove_block_range(
&self,
range: impl RangeBounds<BlockNumber> + Clone,
) -> ProviderResult<()>
pub fn remove_block_range( &self, range: impl RangeBounds<BlockNumber> + Clone, ) -> ProviderResult<()>
Remove the given range of blocks, without returning any of the blocks.
This will remove block data for the given range from the following tables:
HeaderNumbers
CanonicalHeaders
BlockOmmers
BlockWithdrawals
BlockRequests
HeaderTerminalDifficulties
This will also remove transaction data according to
remove_block_transaction_range
.
sourcepub fn take_block_range(
&self,
range: impl RangeBounds<BlockNumber> + Clone,
) -> ProviderResult<Vec<SealedBlockWithSenders>>
pub fn take_block_range( &self, range: impl RangeBounds<BlockNumber> + Clone, ) -> ProviderResult<Vec<SealedBlockWithSenders>>
Remove the given range of blocks, and return them.
This will remove block data for the given range from the following tables:
HeaderNumbers
CanonicalHeaders
BlockOmmers
BlockWithdrawals
BlockRequests
HeaderTerminalDifficulties
This will also remove transaction data according to
take_block_transaction_range
.
sourcepub fn unwind_table_by_num<T>(&self, num: u64) -> Result<usize, DatabaseError>where
T: Table<Key = u64>,
pub fn unwind_table_by_num<T>(&self, num: u64) -> Result<usize, DatabaseError>where
T: Table<Key = u64>,
Unwind table by some number key. Returns number of rows unwound.
Note: Key is not inclusive and specified key would stay in db.
sourcepub fn unwind_table_by_walker<T1, T2>(
&self,
range: impl RangeBounds<T1::Key>,
) -> Result<(), DatabaseError>where
T1: Table,
T2: Table<Key = T1::Value>,
pub fn unwind_table_by_walker<T1, T2>(
&self,
range: impl RangeBounds<T1::Key>,
) -> Result<(), DatabaseError>where
T1: Table,
T2: Table<Key = T1::Value>,
Unwind a table forward by a [Walker
][reth_db_api::cursor::Walker] on another table.
Note: Range is inclusive and first key in the range is removed.
Trait Implementations§
source§impl<DB: Database> AsRef<DatabaseProvider<<DB as Database>::TXMut>> for DatabaseProviderRW<DB>
impl<DB: Database> AsRef<DatabaseProvider<<DB as Database>::TXMut>> for DatabaseProviderRW<DB>
source§fn as_ref(&self) -> &DatabaseProvider<<DB as Database>::TXMut>
fn as_ref(&self) -> &DatabaseProvider<<DB as Database>::TXMut>
source§impl<DB: Debug + Database> Debug for DatabaseProviderRW<DB>
impl<DB: Debug + Database> Debug for DatabaseProviderRW<DB>
source§impl<DB: Database> Deref for DatabaseProviderRW<DB>
impl<DB: Database> Deref for DatabaseProviderRW<DB>
source§impl<DB: Database> DerefMut for DatabaseProviderRW<DB>
impl<DB: Database> DerefMut for DatabaseProviderRW<DB>
source§impl<DB: Database> From<DatabaseProviderRW<DB>> for DatabaseProvider<<DB as Database>::TXMut>
impl<DB: Database> From<DatabaseProviderRW<DB>> for DatabaseProvider<<DB as Database>::TXMut>
source§fn from(provider: DatabaseProviderRW<DB>) -> Self
fn from(provider: DatabaseProviderRW<DB>) -> Self
Auto Trait Implementations§
impl<DB> Freeze for DatabaseProviderRW<DB>where
<DB as Database>::TXMut: Freeze,
impl<DB> !RefUnwindSafe for DatabaseProviderRW<DB>
impl<DB> Send for DatabaseProviderRW<DB>
impl<DB> Sync for DatabaseProviderRW<DB>
impl<DB> Unpin for DatabaseProviderRW<DB>where
<DB as Database>::TXMut: Unpin,
impl<DB> !UnwindSafe for DatabaseProviderRW<DB>
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
§impl<T> Conv for T
impl<T> Conv for T
§impl<T> FmtForward for T
impl<T> FmtForward for T
§fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
fn fmt_binary(self) -> FmtBinary<Self>where
Self: Binary,
self
to use its Binary
implementation when Debug
-formatted.§fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
fn fmt_display(self) -> FmtDisplay<Self>where
Self: Display,
self
to use its Display
implementation when
Debug
-formatted.§fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
fn fmt_lower_exp(self) -> FmtLowerExp<Self>where
Self: LowerExp,
self
to use its LowerExp
implementation when
Debug
-formatted.§fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
fn fmt_lower_hex(self) -> FmtLowerHex<Self>where
Self: LowerHex,
self
to use its LowerHex
implementation when
Debug
-formatted.§fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
fn fmt_octal(self) -> FmtOctal<Self>where
Self: Octal,
self
to use its Octal
implementation when Debug
-formatted.§fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
fn fmt_pointer(self) -> FmtPointer<Self>where
Self: Pointer,
self
to use its Pointer
implementation when
Debug
-formatted.§fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
fn fmt_upper_exp(self) -> FmtUpperExp<Self>where
Self: UpperExp,
self
to use its UpperExp
implementation when
Debug
-formatted.§fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
fn fmt_upper_hex(self) -> FmtUpperHex<Self>where
Self: UpperHex,
self
to use its UpperHex
implementation when
Debug
-formatted.§fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
fn fmt_list(self) -> FmtList<Self>where
&'a Self: for<'a> IntoIterator,
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> Instrument for T
impl<T> Instrument for T
source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
source§impl<T> IntoEither for T
impl<T> IntoEither for T
source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
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 moresource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
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§impl<T> Pipe for Twhere
T: ?Sized,
impl<T> Pipe for Twhere
T: ?Sized,
§fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> Rwhere
Self: Sized,
§fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
fn pipe_ref_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> Rwhere
R: 'a,
self
and passes that borrow into the pipe function. Read more§fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
fn pipe_borrow<'a, B, R>(&'a self, func: impl FnOnce(&'a B) -> R) -> R
§fn pipe_borrow_mut<'a, B, R>(
&'a mut self,
func: impl FnOnce(&'a mut B) -> R,
) -> R
fn pipe_borrow_mut<'a, B, R>( &'a mut self, func: impl FnOnce(&'a mut B) -> R, ) -> R
§fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
fn pipe_as_ref<'a, U, R>(&'a self, func: impl FnOnce(&'a U) -> R) -> R
self
, then passes self.as_ref()
into the pipe function.§fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
fn pipe_as_mut<'a, U, R>(&'a mut self, func: impl FnOnce(&'a mut U) -> R) -> R
self
, then passes self.as_mut()
into the pipe
function.§fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
fn pipe_deref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R
self
, then passes self.deref()
into the pipe function.§impl<T> Pointable for T
impl<T> Pointable for T
§impl<T> Tap for T
impl<T> Tap for T
§fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow<B>(self, func: impl FnOnce(&B)) -> Self
Borrow<B>
of a value. Read more§fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut<B>(self, func: impl FnOnce(&mut B)) -> Self
BorrowMut<B>
of a value. Read more§fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref<R>(self, func: impl FnOnce(&R)) -> Self
AsRef<R>
view of a value. Read more§fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut<R>(self, func: impl FnOnce(&mut R)) -> Self
AsMut<R>
view of a value. Read more§fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref<T>(self, func: impl FnOnce(&T)) -> Self
Deref::Target
of a value. Read more§fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
fn tap_deref_mut<T>(self, func: impl FnOnce(&mut T)) -> Self
Deref::Target
of a value. Read more§fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
fn tap_dbg(self, func: impl FnOnce(&Self)) -> Self
.tap()
only in debug builds, and is erased in release builds.§fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
fn tap_mut_dbg(self, func: impl FnOnce(&mut Self)) -> Self
.tap_mut()
only in debug builds, and is erased in release
builds.§fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
fn tap_borrow_dbg<B>(self, func: impl FnOnce(&B)) -> Self
.tap_borrow()
only in debug builds, and is erased in release
builds.§fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
fn tap_borrow_mut_dbg<B>(self, func: impl FnOnce(&mut B)) -> Self
.tap_borrow_mut()
only in debug builds, and is erased in release
builds.§fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
fn tap_ref_dbg<R>(self, func: impl FnOnce(&R)) -> Self
.tap_ref()
only in debug builds, and is erased in release
builds.§fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
fn tap_ref_mut_dbg<R>(self, func: impl FnOnce(&mut R)) -> Self
.tap_ref_mut()
only in debug builds, and is erased in release
builds.§fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
fn tap_deref_dbg<T>(self, func: impl FnOnce(&T)) -> Self
.tap_deref()
only in debug builds, and is erased in release
builds.§impl<T> TryConv for T
impl<T> TryConv for T
§impl<T> WithSubscriber for T
impl<T> WithSubscriber for T
§fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
§fn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
source§impl<T> WithSubscriber for T
impl<T> WithSubscriber for T
source§fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>where
S: Into<Dispatch>,
source§fn with_current_subscriber(self) -> WithDispatch<Self>
fn with_current_subscriber(self) -> WithDispatch<Self>
impl<T> MaybeDebug for Twhere
T: Debug,
Layout§
Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.