Getting Started
Learn about the recommended paths of testing and debugging your projects on Validium.
Validium provides two distinct testing environments for your local development needs:
Dockerized local setup
In-Memory Node.
Each solution boasts unique characteristics tailored to diverse use cases. This section aims to unpack the intricacies of these tools, aiding you in selecting the setup best suited for your development workflow.
In-Memory node vs Dockerized local setup
The local testing process revolves around two principal options:
Dockerized local setup: An extensive Validium network simulation that comprises a Postgres database, a local Geth node functioning as Layer 1, and the Validium node. Opt for this setup for comprehensive simulations and testing that require interaction with both L1 and L2.
In-Memory node: A lightweight, speedy alternative, the in-memory node, supports forking the state from various networks, including the mainnet and testnet. This choice is ideal for swift testing, prototyping, and bootloader and system contract testing.
When to use each
Use the Dockerized local setup for in-depth simulations and tests that necessitate L1 and L2 interaction. This detailed setup mirrors how your contracts will function within the mainnet Validium network.
Opt for the In-Memory node for swift testing, prototyping, or testing new changes via the local bootloader and system contracts. This setup facilitates forking the state from the mainnet or testnet, suitable for replaying transactions or observing the impact of modifications on existing contracts.
Feature comparison
The following table highlights the key characteristics of each testing environment for a quick comparison:
Quick startup
Yes
No
Supports forking state
Yes
No
Console.log debugging
Yes
No
Detailed call traces
Yes
No
Pre-configured 'rich' accounts
Yes
Yes
Replay existing transactions
Yes
No
Fast for integration testing
Yes
No
Communication between Layer 1 & Layer 2
No
Yes
Multiple transactions per batch
No
Yes
Complete set of APIs
No (Basic set only)
Yes
Websocket support
No
Yes
Whether you're testing new contracts, debugging transactions, or prototyping, Validium provides robust options for local testing. Both the Dockerized local setup and the In-Memory Node offer feature-rich and quick setup options, each with their distinct strengths and limitations. Choose the most appropriate setup based on your specific needs, and happy testing!
Use ZKsync CLI for easy setup
The ZKsync CLI makes it simple for developers to work with both the Dockerized local setup and In-Memory Node. Use zksync-cli dev start to get your local development environment running along with additional modules like Block Explorer, Wallet and Bridge.
Last updated