Struct MemPoolArena

pub struct MemPoolArena { /* private fields */ }

Arena holding all mempool entries with multi-index support.

Provides O(1) lookups by txid/wtxid and sorted iteration by various criteria.

Implementations

impl MemPoolArena

pub fn new() -> Self

Create a new empty arena.

pub fn insert(&mut self, entry: TxMemPoolEntry) -> EntryId

Insert a new entry into the arena.

Returns the handle to the inserted entry.

pub fn update_ancestor_state( &mut self, id: EntryId, size_delta: i64, fee_delta: SignedAmount, count_delta: i64, sigops_delta: i64, )

Update ancestor state and reindex.

CRITICAL: Uses cached keys to remove old entries before mutation.

pub fn update_descendant_state( &mut self, id: EntryId, size_delta: i64, fee_delta: SignedAmount, count_delta: i64, )

Update descendant state and reindex.

pub fn update_modified_fee(&mut self, id: EntryId, new_modified_fee: Amount)

Update modified fee (priority adjustment) and reindex.

pub fn get(&self, id: EntryId) -> Option<&TxMemPoolEntry>

Get entry by ID (immutable).

pub fn get_mut(&mut self, id: EntryId) -> Option<&mut TxMemPoolEntry>

Get entry by ID (mutable).

pub fn get_by_txid(&self, txid: &Txid) -> Option<EntryId>

Lookup entry ID by txid.

pub fn get_by_wtxid(&self, wtxid: &Wtxid) -> Option<EntryId>

Lookup entry ID by wtxid.

pub fn remove(&mut self, id: EntryId) -> Option<TxMemPoolEntry>

Remove entry from arena.

Returns the removed entry if it existed.

pub fn iter_by_ancestor_score( &self, ) -> impl Iterator<Item = (EntryId, &TxMemPoolEntry)>

Iterate entries sorted by ancestor score (highest fee first).

This is the mining order.

pub fn iter_by_descendant_score( &self, ) -> impl Iterator<Item = (EntryId, &TxMemPoolEntry)>

Iterate entries sorted by descendant score (lowest fee first).

This is the eviction order.

pub fn iter_by_entry_time( &self, ) -> impl Iterator<Item = (EntryId, &TxMemPoolEntry)>

Iterate entries sorted by entry time (oldest first).

pub fn len(&self) -> usize

Get total number of entries.

pub fn is_empty(&self) -> bool

Check if arena is empty.

Trait Implementations

impl Default for MemPoolArena

fn default() -> Self

Returns the “default value” for a type.