Skip to content

About

Container based Arc Regression Test setup for localhost

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

localnet — BSV Regtest + ARC Development Stack

Local Bitcoin SV regtest network with ARC transaction processor for Monocelo e2e testing.

Quick Start

./scripts/setup.sh

This clones the ARC repository, builds the Docker image, starts all services, and mines 101 blocks to mature coinbase rewards.

Prerequisites

  • Docker & Docker Compose v2
  • Git
  • ~4 GB RAM available for containers

Services

Service Host Port Purpose
node1 (BSV) 18332 (RPC), 18333 (P2P), 28332 (ZMQ) Primary regtest node / miner
node2 (BSV) — Secondary peer
ARC API 9090 (HTTP), 8033 (gRPC) Transaction broadcast & status
PostgreSQL 15432 ARC databases
NATS 4222, 4223 Message queue
Redis 6379 Cache

Monocelo Configuration

Point Monocelo at localnet with these properties:

# ARC
monocelo.arc.base-url=http://localhost:9090
monocelo.arc.api-key=

# P2P header sync
monocelo.p2p.enabled=true
monocelo.p2p.network=REGTEST
monocelo.p2p.seed-peers=localhost:18333
monocelo.p2p.min-peers=1

Scripts

Script Usage
scripts/setup.sh Full bootstrap (clone, build, start, mine)
scripts/mine.sh [count] [address] Mine regtest blocks
scripts/fund.sh <address> [amount] Send BSV to an address

Common Operations

# Tail ARC logs
docker compose logs -f api

# Check ARC health
curl http://localhost:9090/v1/health

# Query blockchain
docker exec localnet-node1 /entrypoint.sh bitcoin-cli getblockchaininfo

# Stop everything
docker compose down

# Stop and wipe all data
docker compose down -v

Architecture

Host (Monocelo)
  │
  ├── P2P :18333 ──► node1 ◄──► node2
  │
  └── HTTP :9090 ──► ARC API ──► Metamorph ──► BlockTx
                                     │              │
                                     ▼              ▼
                                 Callbacker     PostgreSQL
                                     │
                                    NATS

Bitcoin nodes run in regtest mode with genesis activation at height 1. They run SV Node 1.2.2 and ARC is built from v1.5.11 (ARC_VERSION in scripts/setup.sh).

Chronicle activates at block 15,000 on regtest, not at genesis. That is the default of both SV Node 1.2 (-chronicleactivationheight) and ARC, and ARC hard-codes it (ChronicleForkBlockRegtest), so do not move the node's height alone: node and ARC would then validate the same transaction under different rules. Below 15,000 the chain runs pre-Chronicle rules; mine past it to test under the rules mainnet has had since April 2026.

maxscriptsizepolicy=0 in config/bitcoin.conf lifts the node's 500 KB script policy. ARC v1.5.11 still cannot parse a scriptSig over 1,636,802 bytes in its P2P handler; submit such transactions to the node's RPC (sendrawtransaction) instead. ARC monitors both nodes via P2P and ZMQ, processes transactions, and tracks their lifecycle through to block confirmation.

About

Container based Arc Regression Test setup for localhost

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages