Skip to content

Latest commit

 

History

History
177 lines (112 loc) · 5.04 KB

run-testnet.md

File metadata and controls

177 lines (112 loc) · 5.04 KB

TL; DR: I want to run it ASAP

Download our testnet docker-compose file:

curl https://raw.githubusercontent.com/chainwayxyz/citrea/nightly/docker-compose.yml --output docker-compose.yml

Then use docker-compose to both launch a Bitcoin testnet4 node and Citrea full node:

docker-compose -f docker/docker-compose.yml up

Run a Citrea Testnet Full Node

This guide goes over how to run a full node for Citrea testnet.

It demonstrates different methods for running required software.

Bitcoin Testnet Setup

Citrea testnet uses Bitcoin testnet4 as its DA and settlement layer.

So running a Citrea fullnode requires a fully synced Bitcoin testnet4 node.

Testnet4 is only enabled in version 28.0rc.1.

Option 1: Build from source

Step 1.1: Clone Bitcoin Core Repo

git clone https://github.com/bitcoin/bitcoin.git
cd bitcoin
git checkout v28.0rc1

Step 1.2: Build Bitcoin Core

Then follow the instructions on the links below for the build. However, don't clone the repository since we already did.

OSX: https://github.com/bitcoin/bitcoin/blob/v28.0rc1/doc/build-osx.md

Linux: https://github.com/bitcoin/bitcoin/blob/v28.0rc1/doc/build-unix.md

Step 1.3: Run testnet4 node:

After the setup, execute these commands to run a Bitcoin testnet4 node:

bitcoind -testnet4 -daemon -txindex=1 -rpcbind=0.0.0.0 -rpcport=18443 -rpcuser=citrea -rpcpassword=citrea

You can edit RPC parameters as you wish, but you also have to edit rollup_config.toml

Option 2: Run Docker container

If you are also going to run Citrea in Docker, follow these steps.

Step 2.1: Install Docker

Follow instructions to install Docker here: https://docs.docker.com/engine/install/

Step 2.2: Run testnet4 node:

After Docker is installed, run this command to pull Bitcoin v0.28rc.1 image and run it as a container:

docker run -d \
  -v ${PWD}/bitcoin-testnet4:/home/bitcoin/.bitcoin \
  --name bitcoin-testnet4 \
  -p 18443:18443 \
  -p 18444:18444 \
  bitcoin/bitcoin:28.0rc1 \
  -printtoconsole \
  -testnet4=1 \
  -rest \
  -rpcbind=0.0.0.0 \
  -rpcallowip=0.0.0.0/0 \
  -rpcport=18443 \
  -rpcuser=citrea \
  -rpcpassword=citrea \
  -server \
  -txindex=1

You can edit RPC parameters as you wish, but you have to also edit rollup_config.toml

Citrea Full Node Setup

There is three different ways to run a Citra full node: using a pre-built binary, building from source and using docker.

Option 1: Using pre-built binary

Before continueuing we suggest creating a citrea/ directory and executing these commands in that directory.

Step 1.1: Download neccessary files

Go to this webpage and download latest binary for your operating system under "Assets" section.

Run this command to download full node config and testnet genesis files:

curl https://raw.githubusercontent.com/chainwayxyz/citrea/nightly/resources/configs/testnet/rollup_config.toml --output rollup_config.toml
curl https://static.testnet.citrea.xyz/genesis.tar.gz --output genesis.tar.gz
tar -xzvf genesis.tar.gz

Look through the rollup_config.toml and apply changes as you wish, if you modified any Bitcoin RPC configs, change corresponding values under [da].

Step 1.2: Run Citrea Full Node

Finally run this command to run your Citrea full node:

Mac:

./citrea-v0.5.5-osx-arm64 --da-layer bitcoin --rollup-config-path ./rollup_config.toml --genesis-paths ./genesis

Linux:

./citrea-v0.5.5-linux-amd64 --da-layer bitcoin --rollup-config-path ./rollup_config.toml --genesis-paths ./genesis

Your full node should be serving RPC at http://0.0.0.0:8080 now.

Option 2: Build from source

Step 2.1: Install Rust

If you don't have it, install it from here.

Step 2.2: Clone the source code

Clone the repository and checkout the latest tag:

git clone https://github.com/chainwayxyz/citrea
cd citrea
git fetch --tags
git checkout $(git describe --tags `git rev-list --tags --max-count=1`)

Step 2.3: Build Citrea

If you wish to verify ZK-Proofs, then you'll need to compile our ZK VM binaries inside docker. To do so, follow instructions to install Docker: https://docs.docker.com/engine/install/

Install development dependencies:

make install-dev-tools

Compile Citrea by running command:

cargo build --release

If you wish to verify ZK-Proofs, add REPR_GUEST_BUILD=1 before cargo b...

Step 2.4: Run Citrea

Look through the rollup_config.toml and apply changes as you wish, if you modified any Bitcoin RPC configs, change corresponding values under [da].

And then run the full node by executing this command

./target/release/citrea --network testnet --da-layer bitcoin --rollup-config-path ./resources/configs/testnet/rollup_config.toml --genesis-paths ./resources/genesis/testnet

Option 3: Using Docker

See the top section.