Skip to content

node soqucoin

Odenrider edited this page May 4, 2026 · 2 revisions

🌐 Run a Soqucoin Node

Help secure the world's first post-quantum blockchain. Running a full node validates transactions, relays blocks, and strengthens the network. No mining hardware required.


Quick Facts

Consensus Scrypt PoW + AuxPoW
Signatures Dilithium ML-DSA-44 (NIST FIPS 204)
Block Time 60 seconds
P2P Port 44556
RPC Port 44555
Address Format Bech32m (soq1...)
Data Directory ~/.soqucoin/

1. System Requirements

Component Minimum Recommended
CPU 2 cores 4+ cores
RAM 2 GB 4+ GB
Storage 20 GB SSD 50+ GB SSD
Network 10 Mbps 25+ Mbps
OS Linux, macOS, Windows (WSL2), Raspberry Pi

💡 Raspberry Pi 4/5 makes an excellent always-on node — low power, silent, and reliable.


2. Installation

Option A: Docker (All Platforms) — Fastest

docker run -d --name soqucoin-node \
  -p 44556:44556 \
  -v soqucoin-data:/root/.soqucoin \
  soqucoin/soqucoin
Install Docker first (if needed)
# Linux
sudo apt install docker.io && sudo usermod -aG docker $USER

# Raspberry Pi
curl -fsSL https://get.docker.com | sh && sudo usermod -aG docker $USER

# macOS
brew install --cask docker

Option B: One-Line Install (Linux & macOS)

curl -sSL https://soqu.org/install.sh | bash

Automatically detects your platform (Linux x64, macOS Intel, macOS Apple Silicon).

Option C: Download Binaries

Pre-built binaries for all platforms are available at:

👉 soqu.org/download.html

Option D: Build from Source

git clone https://github.com/soqucoin/soqucoin.git
cd soqucoin
./autogen.sh
./configure
make -j$(nproc)
macOS Apple Silicon note

If you encounter dyld library errors, set the dynamic library path:

export DYLD_LIBRARY_PATH="$(pwd)/src/secp256k1/.libs:${DYLD_LIBRARY_PATH}"

3. Configuration

After installation, create or edit your configuration file:

mkdir -p ~/.soqucoin
nano ~/.soqucoin/soqucoin.conf

Basic Node Configuration

# Accept incoming connections
server=1
listen=1

# Network
port=44556

# Seed nodes for initial peer discovery
# (automatic via DNS seeders)

If You Also Want to Mine (Solo)

These settings enable the SOQ Solo Miner:

server=1
listen=1
rpcuser=soqucoin
rpcpassword=YOUR_STRONG_PASSWORD_HERE
rpcallowip=127.0.0.1
rpcport=44555
rpcworkqueue=128
rpcthreads=8

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

4. Running the Node

Start

# Foreground
soqucoind

# Background (daemon mode)
soqucoind -daemon

Verify It's Working

# Check sync status
soqucoin-cli getblockchaininfo

# View connected peers
soqucoin-cli getpeerinfo

# Get network info
soqucoin-cli getnetworkinfo

Stop

soqucoin-cli stop

5. Node Types

Type Description Port Forwarding
Full Node Validates all transactions and blocks. The backbone of the network. Recommended (port 44556)
Pruned Node Full validation with reduced storage. Keeps only recent blocks. Optional
Seed Node Public entry point for new nodes joining the network. Required

Enable Port Forwarding (Recommended)

To accept inbound connections and help the network, forward port 44556 on your router to your node's local IP.


6. Regtest (Local Development)

For local development and testing, use regtest mode:

soqucoind -regtest -daemon

Regtest lets you generate blocks instantly for testing:

soqucoin-cli -regtest generatetoaddress 10 $(soqucoin-cli -regtest getnewaddress)

7. Useful Commands

# How many peers am I connected to?
soqucoin-cli getconnectioncount

# What block am I on?
soqucoin-cli getblockcount

# Network hashrate
soqucoin-cli getnetworkhashps

# Generate a new receiving address
soqucoin-cli getnewaddress

# Check wallet balance
soqucoin-cli getbalance

# Node uptime
soqucoin-cli uptime

8. Troubleshooting

Issue Solution
Node not syncing Check internet connection; verify port 44556 is not blocked by firewall
No peers found Ensure listen=1 in config; try restarting the node
RPC connection refused Verify server=1 and correct rpcuser/rpcpassword in config
Disk full Enable pruning: add prune=550 to config (keeps ~550 MB)
macOS dyld error See the build-from-source section above for DYLD_LIBRARY_PATH fix

9. Why Run a Node?

  • 🔒 Verify your own transactions. Don't trust, verify.
  • 🌍 Strengthen the network. More nodes = more decentralized = more secure.
  • ⚡ Faster transaction validation. Direct access, no third-party relay.
  • ⛏️ Enable solo mining. Run the SOQ Solo Miner and mine blocks directly to your wallet.

10. Community & Support

Channel Link
Website soqu.org
Discord discord.gg/kc6GMmbZvX
Telegram t.me/soqucoin
X (Twitter) @soqucoin
GitHub github.com/soqucoin

© 2026 Soqucoin™ Project. Released under the MIT License.