Configuration Reference¶

All configuration is done through ~/.soqucoin/soqucoin.conf or via command-line flags.

Config File Location¶

OS	Path
Linux	`~/.soqucoin/soqucoin.conf`
macOS	`~/Library/Application Support/Soqucoin/soqucoin.conf`
Windows	`%APPDATA%\Soqucoin\soqucoin.conf`
Docker	Mounted via `-v soqucoin-data:/root/.soqucoin`

Network Settings¶

# Listen for incoming peer connections
listen=1

# P2P port (mainnet default 33388; the current stagenet network uses 28333)
port=28333

# Maximum number of peer connections
maxconnections=125

# Add a specific seed node
addnode=seed1.soqu.org
addnode=seed2.soqu.org

RPC Settings¶

Required for CLI tools, mining, and API access.

# Enable RPC server
server=1

# RPC credentials
rpcuser=your_username
rpcpassword=your_password

# RPC port (mainnet default 33389; the current stagenet network uses 28332)
rpcport=28332

# Allow RPC from localhost only (recommended)
rpcallowip=127.0.0.1

# Performance (increase for mining workloads)
rpcworkqueue=128
rpcthreads=8

Security

Never expose RPC to the public internet. Use rpcallowip=127.0.0.1 and firewall rules to restrict access.

Mining Settings¶

# ZMQ block notifications (required for solo miner)
zmqpubhashblock=tcp://127.0.0.1:28332

# Generate blocks (regtest only)
# gen=1

Storage Settings¶

# Maintain a full transaction index (recommended)
txindex=1

# Prune old blocks to save disk space
# prune=550  # Keep ~550 MB of block data

# Custom data directory
# datadir=/path/to/data

Logging¶

# Enable debug logging (verbose)
# debug=1

# Log to file instead of stdout
# debuglogfile=/path/to/debug.log

# Shrink debug.log on startup (default: 1)
shrinkdebugfile=1

Regtest Settings¶

For local development:

regtest=1
port=18444
rpcport=18332

Full Example (Mining Node)¶

# Soqucoin Mining Node Configuration

# Network
server=1
listen=1
daemon=1
port=28333

# RPC
rpcuser=soqucoin
rpcpassword=CHANGE_THIS_TO_A_STRONG_PASSWORD
rpcallowip=127.0.0.1
rpcport=28332
rpcworkqueue=128
rpcthreads=8

# Data
txindex=1

# ZMQ (for solo miner)
zmqpubhashblock=tcp://127.0.0.1:28332

# Performance
maxconnections=40

Command-Line Flags¶

Any config option can also be passed as a flag:

soqucoind -daemon -server -stagenet -rpcuser=soqucoin -rpcpassword=mypass -port=28333

Flags override config file values.

Selecting the network

With no flag the daemon runs mainnet (not yet launched). Pass -stagenet to join the current public network (ports 28333 / 28332), or -testnet / -regtest for those networks.

Consensus flags¶

A few consensus behaviors are fixed per network in chainparams, not set by the operator:

Strict AuxPoW chain ID (fStrictChainId) is enforced on mainnet, testnet, and regtest, and disabled on stagenet. When enforced, the parent (LTC/DOGE) block must not itself carry Soqucoin's AuxPoW chain ID 0x5351. See Merge Mining.
Feature activation (USDSOQ and the covenant opcodes) is gated at fixed flag-day heights defined in chainparams, rather than by BIP9 signaling. USDSOQ is active on stagenet today; the covenant opcodes remain gated on mainnet pending the Phase 2 audit.