Component/batch executor

[0xSero]

Add Executor Component for Transaction Management

Overview

This PR introduces a new Executor component that manages the execution of profitable bump transactions. It provides a robust, configurable system for handling wallet operations, transaction queueing, and tip collection.

Key Features

• Transaction queue management with FIFO processing
• Wallet balance monitoring and automatic tip collection
• Concurrent transaction execution with configurable limits
• Gas price optimization with boost percentage
• Comprehensive error handling and retry mechanism
• Detailed transaction status tracking and statistics

Technical Details

• Implements a modular architecture with strategy pattern
• Uses TypeScript for type safety
• Includes comprehensive test suite
• Configurable via environment variables and runtime options
• Follows existing logging patterns

Configuration Options

• Queue size and concurrency limits
• Gas price boost percentage
• Minimum wallet balance
• Transaction confirmation requirements
• Tip transfer thresholds

Testing

Added test-executor.ts that verifies:

• Queue management functionality
• Transaction execution flow
• Status monitoring
• Error handling scenarios
• Tip transfer mechanism

Usage Example

const executor = new ExecutorWrapper(stakerContract, provider, {
wallet: {
privateKey: process.env.PRIVATE_KEY,
minBalance: ethers.parseEther('0.1'),
},
gasBoostPercentage: 10,
concurrentTransactions: 3,
});
await executor.start();
const tx = await executor.queueTransaction(depositId, profitabilityCheck);

Related

• Integrates with existing profitability engine
• Uses shared logging system
• Follows project architecture patterns

Notes

• Requires TEST_PRIVATE_KEY in .env for testing
• Gas boost percentage is configurable per environment
• Includes detailed README with usage examples

closes: #6