How pimlicolabs/alto works
Main Components
a) Core Bundler Components:
• Mempool System (/src/mempool)
• Executor System (/src/executor)
• RPC Handler (/src/rpc)
• CLI Interface (/src/cli)
b) Supporting Systems:
• Validation Layer (/src/rpc/validation)
• Gas Estimation System (/src/rpc/estimation)
• Contract Interfaces (/src/types/contracts)
• Event Handlers (/src/handlers)
Component Relationships
External Layer:
• ERC-4337 Client Requests
• Ethereum Node Connection
• Smart Contracts (EntryPoint)
API Layer:
• RPC Server
• Custom Endpoints
• Request Validation
Core Processing Layer:
• Mempool Management
• Operation Execution
• Gas Estimation
• Transaction Validation
Infrastructure Layer:
• Monitoring & Metrics
• Configuration Management
• Utility Wallet Management
Specific Implementation Details
Key elements:
a) RPC Endpoints:
• eth_sendUserOperation
• eth_estimateUserOperationGas
• eth_getUserOperationByHash
• eth_getUserOperationReceipt
• Custom Pimlico endpoints
b) Processing Pipeline:
• Flow from request reception to transaction inclusion
• Validation steps
• Gas estimation process
• Mempool management
Critical Subsystems
Important subsystems:
a) Validation System:
• Safe Validator
• Unsafe Validator
• Tracer Components
b) Execution System:
• Executor Manager
• Sender Manager
• Utility Wallet Monitor
Integration Points
Connections with:
• Ethereum Network
• EntryPoint Contracts
• Client Applications
• Monitoring Systems