AggSandbox
Complete local testing environment for building and testing cross-chain applications with Agglayer
Overview
AggSandbox is your comprehensive development environment for Agglayer cross-chain applications. It provides a complete local blockchain ecosystem with pre-configured networks, deployed contracts, and bridge services - eliminating the complexity of setting up infrastructure so you can focus on building and testing your applications.
Key Benefits:
- Instant Setup: Get a complete multi-chain environment running in minutes
- Production Parity: Test with the same contracts and logic used in production
- Rich Debugging: Comprehensive logging and monitoring for all bridge operations
- Flexible Configuration: Customize networks, tokens, and bridge settings for your needs
What You Can Test
With AggSandbox, you can test the full spectrum of cross-chain operations:
- Asset Transfers: Bridge ERC20 tokens and ETH between L1, L2, and L2↔L2 networks
- Cross-Chain Messages: Execute smart contract calls across different chains
- Atomic Operations: Test complex bridge-and-call operations that combine asset transfers with contract execution
- Multi-Chain Workflows: Build applications that coordinate operations across multiple networks
Getting Started
Ready to start building with AggSandbox?
Quickstart
Get your first cross-chain bridge operation running in under 10 minutes with step-by-step guidance.
Start Building →
Installation
Complete setup guide with system requirements, installation steps, and configuration options.
Learn more →
Core Concepts
Understand the fundamentals before diving into development:
Architecture
Learn how AggSandbox components work together to provide a complete testing environment.
Learn more →
Bridge Basics
Understand fundamental bridge concepts, token mechanics, and security considerations.
Learn more →
Bridge Operations
Master all types of cross-chain operations with comprehensive guides:
Asset Bridging
Complete guide to transferring ERC20 tokens and ETH across networks with practical examples.
Learn more →
Message Bridging
Execute smart contract calls across chains with message bridging and contract integration examples.
Learn more →
Bridge-and-Call
Advanced atomic operations that combine asset transfers with contract execution in single transactions.
Learn more →
Reference
CLI Commands
Complete reference for all AggSandbox commands with examples, options, and use cases.
Learn more →
Why AggSandbox?
Development Speed
- No External Dependencies: Everything runs locally - no need for testnets or external services
- Instant Feedback: Test bridge operations with immediate results and comprehensive logging
- Rich Debugging: Detailed transaction traces and event monitoring for troubleshooting
Production Parity
- Same Contracts: Uses identical bridge contracts and logic as production Agglayer
- Realistic Timing: Configurable sync times that mirror production network behavior
- Complete Ecosystem: Full L1/L2 environment with proper state synchronization
Flexible Testing
- Multiple Networks: Test L1↔L2 and L2↔L2 operations in the same environment
- Custom Scenarios: Configure tokens, accounts, and network parameters for your use cases
- Automated Testing: Build comprehensive test suites with scriptable CLI commands
Last updated on