Scroll is a zkRollup Layer 2 dedicated to enhance Ethereum scalability through a bytecode-equivalent zkEVM circuit. This monorepo encompasses essential infrastructure components of the Scroll protocol. It contains the L1 and L2 contracts, the rollup node, the prover client, and the prover coordinator.
├── bridge-history-api: Bridge history service that collects deposit and withdraw events from both L1 and L2 chains and generates withdrawal proofs ├── common: Common libraries and types ├── coordinator: Prover coordinator service that dispatches proving tasks to provers ├── database: Database client and schema definition ├── l2geth: Scroll execution node ├── prover: Prover client that runs proof generation for zkEVM circuit and aggregation circuit ├── rollup: Rollup-related services ├── rpc-gateway: RPC gateway external repo └── tests: Integration tests
We welcome community contributions to this repository. Before you submit any issues or PRs, please read the Code of Conduct and the Contribution Guideline.
- Go 1.21
- Rust (for version, see rust-toolchain)
- Hardhat / Foundry
- Docker
To run the tests, it is essential to first pull or build the required Docker images. Execute the following commands in the root directory of the repository to do this:
docker pull postgres
make dev_docker
Run the tests using the following commands:
export LIBSCROLL_ZSTD_VERSION=v0.1.0-rc0-ubuntu20.04
export SCROLL_LIB_PATH=/scroll/lib
sudo mkdir -p $SCROLL_LIB_PATH
sudo wget -O $SCROLL_LIB_PATH/libscroll_zstd.so https://github.com/scroll-tech/da-codec/releases/download/$LIBSCROLL_ZSTD_VERSION/libscroll_zstd.so
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$SCROLL_LIB_PATH
export CGO_LDFLAGS="-L$SCROLL_LIB_PATH -Wl,-rpath,$SCROLL_LIB_PATH"
go test -v -race -covermode=atomic scroll-tech/rollup/...
go test -tags="mock_verifier" -v -race -covermode=atomic scroll-tech/coordinator/...
go test -v -race -covermode=atomic scroll-tech/database/...
go test -v -race -covermode=atomic scroll-tech/common/...
You can find the unit tests in contracts/src/test/
, and integration tests in contracts/integration-test/
.
See contracts
for more details on the contracts.
Scroll Monorepo is licensed under the MIT license.