Skip to content

Running a local development environment

Install and start the entire opbnb system locally, including L1 (BNB Smart Chain) and L2 development nodes. Running a local development environment is a great way to test the behavior of your code and contracts.

How to do it

  1. Make sure the following software is installed: golang, nodejs 16+, make, pnpm, python3, docker, foundry, poetry, jq Tips:

Install Foundry by following the instructions located here.
Please make sure your Foundry version matches the one described in opbnb/versions.json. If they do not match, please use a command such as foundryup -C xxxxxx to modify it.

  1. Clone opbnb monorepo:
    git clone
    cd opbnb
  1. Running pnpm install and then running pnpm build.
  2. Running make devnet-up and wait for the docker container to start.(The first run will be relatively slow because it needs to download the image and deploy the contract, and then it will be fast)
  3. Through the docker ps command, you can see that 5 containers have been started: ops-bedrock_l1_1, ops-bedrock_l2_1, ops-bedrock_op-node_1, ops-bedrock_op-batcher_1, ops-bedrock_op-proposer_1

Now L1 is accessible at http://localhost:8545, and L2 is accessible at http://localhost:9545

Stop or clean

To stop, run (in the root directory of the monorepo) make devnet-down.
To clean everything, run (in the root directory of the monorepo) make devnet-clean. To view logs, run make devnet-logs


  1. When executing for the first time, please be patient if you see the message “Waiting for RPC server at…”, as the BSC network takes time to initialize.
  2. If you encounter an error during the “Deploying contracts” step, please try again as it usually recovers.

Additional Information

L1 chain ID is 714.
L2 chain ID is 901.

L1 test account:

  • address: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
  • Private key: ac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80

L2 test account:

  • Address: 0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266
  • Private key: ac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80