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)
port=33388

# Maximum number of peer connections
maxconnections=125

# Peers are found through the built-in mainnet seeds. To add one by hand:
# addnode=<host>:33388

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)
rpcport=33389

# 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 (optional; on a port other than the RPC port)
zmqpubhashblock=tcp://127.0.0.1:28334

# 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=33388

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

# Data
txindex=1

# ZMQ block notifications (optional)
zmqpubhashblock=tcp://127.0.0.1:28334

# Performance
maxconnections=40

Command-Line Flags¶

Any config option can also be passed as a flag:

soqucoind -daemon -server -rpcuser=soqucoin -rpcpassword=mypass

Flags override config file values.

Selecting the network

With no flag the daemon runs mainnet (ports 33388 / 33389). Pass -stagenet for the stagenet test network (ports 28333 / 28332) or -regtest for a local chain.

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. On mainnet, USDSOQ and the covenant opcodes are not scheduled; they are active on regtest and the stagenet test network.