Module mempool

Source
Expand description

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.
pending_outputs ๐Ÿ”’
Pending transparent::Output tracker for AwaitOutput requests.
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 Aliasesยง

InboundTxDownloads ๐Ÿ”’
Outbound ๐Ÿ”’
State ๐Ÿ”’
TxVerifier ๐Ÿ”’