Dev Node

Node Version: v0.0.2

Setup Guide

This guide will walk you through the process of setting up and running a local Sova devnet node using Docker Compose.

Prerequisites

• Software

  • Docker (version 20.10.0 or higher)

  • Docker Compose (version 2.0.0 or higher)

  • Git

• Hardware

  • CPU: 2+ cores recommended

  • RAM: 4GB

  • Storage: 16GB

Note: Requirements may vary based on network activity, transaction volume, number of connected peers, and chain state growth.

Installation Steps

1. Clone the Repository

git clone https://github.com/SovaNetwork/running-sova
cd running-sova

# checkout release version
git checkout v0.0.2

# Initialize submodules
git submodule sync
git submodule update --init --recursive

2. Configure Environment Variables

# Create and edit the .env file
cp dockerfiles/env.example dockerfiles/.env

In the .env file, update the variables if necessary. The `ENCLAVE_SEED` is the seed for computing the BIB-32 derivation path for the network signing service.

3. Build and Start the Services

# run single node devnet locally
docker-compose -f dockerfiles/dev-docker-compose.yml -p sova-devnet --profile core up --build -d

# View all active containers
docker ps

# remove all containers and volumes with:
docker-compose -f dockerfiles/dev-docker-compose.yml -p sova-devnet --profile core down -v --rmi all

Service Architecture

The stack consists of the following services:

• nginx-proxy (Port 18444)

  • Reverse proxy service based on nginx:alpine

  • Handles routing and load balancing

  • Configured via mounted nginx.conf file

• bitcoin-regtest (Port 18443)

  • Bitcoin Core node running in regtest mode

  • Provides the underlying Bitcoin network functionality

• sova-reth (Port 8545)

  • EVM-compatible JSON-RPC endpoint

  • Handles EVM-compatible transactions and smart contracts

• sova-sentinel (port 50051)

  • Handles double spend protection

• network-enclave (Port 5555)

  • Handles network signing operations

  • Manages cryptographic operations

• network-utxos (Port 5557)

  • Tracks and manages UTXO state

  • Provides UTXO-related services

• network-indexer

  • Indexes Bitcoin blockchain data

  • Maintains synchronization with the Bitcoin node

Network Health Checks

Verify the execution client JSON-RPC endpoint:

curl -X POST -H "Content-Type: application/json" \
  --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}' \
  http://localhost:8545

Verify the bitcoin regtest client JSON-RPC endpoint:

curl -X POST -H "Content-Type: application/json" \
  --data '{"jsonrpc":"1.0","method":"getblockchaininfo","params":[],"id":1}' \
  -u user:password http://localhost:18443