Skip to content

Quickstart: Run a local devnet

  1. Install docker and docker compose.

  2. Clone @celestiaorg/nitro:

    git clone -b release --recurse-submodules https://github.com/celestiaorg/nitro.git
    git checkout v3.2.5 && cd /nitro/nitro-testnode
    git clone -b release --recurse-submodules https://github.com/celestiaorg/nitro.git
    git checkout v3.2.5 && cd /nitro/nitro-testnode
  3. ./celestia-start.sh

  4. Some useful optional commands to use with the start script:

    • --validate (heavy computation, validates all blocks in WASM)
    • --anytrsut (launches anytrust DAC locally, useful to test anytrust fallbacks)

Helper scripts

The repository includes a set of helper scripts for basic actions like funding accounts or bridging funds. You can see a list of the available scripts by running:

bash
./test-node.bash script --help
./test-node.bash script --help

If you want to see information of a particular script, you can add the name of the script to the help command.

bash
./test-node.bash script send-l1 --help
./test-node.bash script send-l1 --help

Here's an example of how to run the script that funds an address on L2. Replace0x11223344556677889900 with the address you want to fund.

./test-node.bash script send-l2 --to address_0x11223344556677889900 --ethamount 5

Default endpoints and addresses

Node RPC endpoints are available at:

NodeChain idRPC endpoint
L1 geth devnet1337http://localhost:8545
L2 nitro devnet412346http://localhost:8547 and ws://localhost:8548
L3 nitro (if enabled)333333http://localhost:3347
Celestia DA serverhttp://localhost:9875
Anytrusthttp://localhost:9876
Celestia Nodehttp://localhost:26658