Local Boba
Learn how to set up a local OMGX system.

Overall Setup

Clone the repository, open it, and install nodejs packages with yarn:
1
git clone [email protected]:omgnetwork/optimism.git
2
cd optimism
3
yarn clean
4
yarn install
5
yarn build
Copied!
Build and run the entire stack:
1
$ cd ops
2
$ BUILD=1 DAEMON=0 ./up_local.sh
Copied!
If you need a L1 that advances blocks even without transactions, then you can use an upstream Geth with a 5s blocktime
1
$ cd ops
2
$ BUILD=1 DAEMON=0 ./up_local_g5.sh
Copied!
That one takes a while to spin up all the right services, and you can help it along in Docker, by restarting needed services that time out.
Helpful commands:
    Running out of space on your Docker, or having other having hard to debug issues? Try running docker system prune -a --volumes and then rebuild the images.
    To (re)build individual base services: docker-compose build -- l2geth
    To (re)build individual Boba services: docker-compose -f "docker-compose.yml" build -- omgx_message-relayer-fast Note: First you will have to comment out various dependencies in docker-compose.yml.

Running unit tests

To run unit tests for a specific package:
1
cd packages/package-to-test
2
yarn test
Copied!

Running integration tests

1
cd integration-tests
2
yarn build:integration
3
yarn test:integration
Copied!
More information can be found on our Github
Last modified 23d ago
Copy link