Skip to content

scroll-tech/scroll

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

42d85af · Dec 17, 2024
Oct 15, 2024
Dec 12, 2024
Oct 15, 2024
Dec 12, 2024
Dec 17, 2024
Oct 22, 2024
Dec 17, 2024
Dec 12, 2024
Jul 31, 2024
Oct 23, 2024
Jun 13, 2024
Jul 2, 2024
Nov 10, 2022
Dec 22, 2023
Dec 13, 2023
Jan 24, 2024
Aug 23, 2024
Aug 2, 2024
Dec 13, 2023
Jun 12, 2024
Oct 23, 2024

Repository files navigation

Scroll Monorepo

rollup bridge-history coordinator prover integration codecov

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.

Directory Structure

├── 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
├── prover: Prover client that runs proof generation for zkEVM circuit and aggregation circuit
├── rollup: Rollup-related services
├── scroll-contracts: solidity code for Scroll L1 bridge and rollup contracts and L2 bridge and pre-deployed contracts.
└── tests: Integration tests

Contributing

We welcome community contributions to this repository. Before you submit any issues or PRs, please read the Code of Conduct and the Contribution Guideline.

Prerequisites

  • 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

Unit Tests

Run the tests using the following commands:

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/...

License

Scroll Monorepo is licensed under the MIT license.