Module zebrad::components::mempool

Zebra mempool.

A zebrad application component that manages the active collection, reception, gossip, verification, in-memory storage, eviction, and rejection of unmined Zcash transactions (those that have not been confirmed in a mined block on the blockchain).

Major parts of the mempool include:

• Mempool Service
  • activates when the syncer is near the chain tip
  • spawns download and verify tasks for each crawled or gossiped transaction
  • handles in-memory storage of unmined transactions
• Crawler
  • runs in the background to periodically poll peers for fresh unmined transactions
• Queue Checker
  • runs in the background, polling the mempool to store newly verified transactions
• Transaction Gossip Task
  • runs in the background and gossips newly added mempool transactions to peers

Re-exports

• pub use crate::BoxError;
• pub use config::Config;
• pub use gossip::gossip_mempool_transaction_id;

Modules

• config
  User-configurable mempool parameters.
• crawler 🔒
  Zebra Mempool crawler.
• downloads
  Transaction downloader and verifier.
• error 🔒
  Errors that can occur when interacting with the mempool.
• gossip
  A task that gossips any zebra_chain::transaction::UnminedTxId that enters the mempool to peers.
• queue_checker 🔒
  Zebra Mempool queue checker.
• storage 🔒
  Mempool transaction storage.

Structs

• Crawler
  The mempool transaction crawler.
• Mempool
  Mempool async management and query service.
• QueueChecker
  The mempool queue checker.
• Storage
  Hold mempool verified and rejected mempool transactions.

Enums

• ActiveState 🔒
  The state of the mempool.
• ExactTipRejectionError
  Transactions rejected based on transaction authorizing data (scripts, proofs, signatures), or lock times. These rejections are only valid for the current tip.
• MempoolError
  Mempool errors.
• SameEffectsChainRejectionError
  Transactions rejected based only on their effects (spends, outputs, transaction header). These rejections are valid while the current chain continues to grow.
• SameEffectsTipRejectionError
  Transactions rejected based only on their effects (spends, outputs, transaction header). These rejections are only valid for the current tip.

Type Definitions

• InboundTxDownloads 🔒
• Outbound 🔒
• State 🔒
• TxVerifier 🔒