Struct OrphanPool 

pub struct OrphanPool { /* private fields */ }

The orphan transaction pool.

Implementations

impl OrphanPool

pub fn new() -> Self

Create a new orphan pool with default settings.

pub fn with_config(max_orphans: usize, expire_time: u64) -> Self

Create with custom limits (useful for testing).

pub fn add_orphan( &mut self, tx: Transaction, from_peer: u64, now: u64, ) -> AddOrphanResult

Add a transaction to the orphan pool.

Returns the result of the add operation.

pub fn remove_orphan(&mut self, txid: &Txid) -> Option<OrphanEntry>

Remove an orphan by txid. Returns the entry if it was present.

pub fn get_orphans_by_prev(&self, outpoint: &OutPoint) -> Vec<Txid>

Get all orphan txids that depend on a given outpoint.

Call this when a new transaction is accepted to find orphans that can now be re-evaluated.

pub fn get_children_of( &self, parent_txid: &Txid, output_count: u32, ) -> Vec<Txid>

Get all orphan txids that depend on any output of a given transaction.

This is the common pattern: when tx parent_txid is accepted, find all orphans that spent one of its outputs.

pub fn expire_old_orphans(&mut self, now: u64) -> usize

Remove all orphans that are older than the expiry time.

Returns the number of orphans removed.

pub fn remove_for_peer(&mut self, peer_id: u64) -> usize

Remove all orphans from a specific peer.

Useful when a peer is banned or disconnected.

pub fn get(&self, txid: &Txid) -> Option<&OrphanEntry>

Get an orphan entry by txid.

pub fn contains(&self, txid: &Txid) -> bool

Check if we have an orphan with the given txid.

pub fn len(&self) -> usize

Get the number of orphan transactions in the pool.

pub fn is_empty(&self) -> bool

Check if the pool is empty.

pub fn clear(&mut self)

Clear all orphans.

Trait Implementations

impl Default for OrphanPool

fn default() -> Self

Returns the “default value” for a type.