⛰️ Alto ⛰️

Alto is a Typescript implementation of the ERC-4337 bundler specification developed by Pimlico, focused on transaction inclusion reliability.

Getting started

For a full explanation of Alto, please visit our docs page

Run an instance of Alto with the following commands:

pnpm install
pnpm build
./alto --entrypoints "0x5ff1...2789,0x0000...a032" --executor-private-keys "..." --utility-private-key "..." --min-balance "0" --rpc-url "http://localhost:8545" --network-name "local"

To find a list of all options, run:

./alto help

A helper script for running Alto locally with an Anvil node can be found at scripts/run-local-instance.sh.

A comprehensive guide for self-hosting Alto can be found here.

Run the test suite with the following commands:

pnpm build
pnpm test # note: foundry must be installed on the machine for this to work

Prerequisites

• ⚙️ NodeJS (LTS)
• 🧰 Pnpm

How to test bundler specs

• Run Geth node or any other node that support debug_traceCall
• Clone bundler-spec-tests repo.
• build & run bundler with --environment development --bundleMode manual --safeMode true

SBC Modifications

This fork includes several enhancements and configurations specific to SBC's deployment needs:

Network Support

• Radius Testnet Configuration: Added pre-configured templates for deploying on Radius Testnet

  • Configuration template: config.radiusTestnet.json.template
  • Docker deployment: Dockerfile.radius-testnet
  • EntryPoint: 0x9b443e4bd122444852B52331f851a000164Cc83F

• Base Network Support: Added configurations for Base mainnet and Base Sepolia

  • Configuration templates: config.base.json.template and config.baseSepolia.json.template
  • Docker deployments: Dockerfile.base and Dockerfile.base-sepolia

Key Enhancements

• CORS Support: Enabled cross-origin resource sharing for browser-based applications
• IPv6 Compatibility: Added dual-stack IPv4/IPv6 support for improved network accessibility
• Block Range Limits: Configured max-block-range: 490 to comply with RPC provider limits (e.g., Alchemy's 500 block limit)
• Gas Fee Optimization: Tuned gas fee scaling for better transaction inclusion during network congestion
• Railway Deployment: Production-ready Docker configurations with environment variable management

Configuration

All network configurations use environment variables for secure deployment:

• ALTO_RPC_URL: Network RPC endpoint
• ALTO_EXECUTOR_PRIVATE_KEYS: Private keys for executor accounts
• ALTO_UTILITY_PRIVATE_KEY: Private key for utility operations
• SENTRY_DSN: (Optional) Sentry error tracking

License

Distributed under the GPL-3.0 License. See LICENSE for more information.

Contact

Feel free to ask any questions in our Telegram group

Acknowledgements

• Eth-Infinitism bundler
• Lodestar