Bulkmail

A parallel transaction sender with pluggable chain adapters (Ethereum today, Solana planned).

Docs

• Architecture
• Problem Answers
• Original Design Notes (superseded by ARCHITECTURE.md)

Features

• Handles sending transactions to a rapid EVM blockchain
• Sends multiple transactions concurrently
• Implements a priority system for transactions
• Includes a mechanism for replacing stuck transactions
• Manages nonces to ensure proper transaction ordering
• Late-binds nonces and gas prices to messages for flexible processing

Prerequisites

• Rust (latest stable version)

Getting Started

Building the Project

cargo build

Quick Start (Ethereum)

use bulkmail::{
    Chain, Eth, EthClient, EthFeeManager, EthReplayProtection, EthRetryStrategy, Message, Sender,
};
use alloy::primitives::Address;
use std::sync::Arc;

# async fn run(chain: Chain, signer: Address) -> Result<(), bulkmail::Error> {
let chain_arc: Arc<dyn bulkmail::LegacyChainClient> = Arc::new(chain.clone());
let client = Arc::new(EthClient::new(chain_arc.clone()));
let fees = Arc::new(EthFeeManager::new());
let replay = Arc::new(EthReplayProtection::new(chain_arc, signer).await?);
let retry = Arc::new(EthRetryStrategy::new());

let sender = Sender::<Eth>::new(client, fees, replay, retry);
sender.add_message(Message::default()).await;
sender.run().await
# }

Running the Oracle Simulation

Bulkmail includes an oracle program that simulates the system's behavior. To run it:

cargo run --example oracle_eth

Running Tests

cargo test

Project Structure

• src/: Contains the main library code
• examples/: Example programs (e.g., oracle_eth.rs)