Run a GoldBrix Node

Anyone can run a full GoldBrix node. No permission, no registration, no keys required. Your node independently verifies every block and strengthens the network.

0. One command (recommended)

Full non-pruned node + public read endpoint (/api/status, /api/utxos) in one step. Keyless — the machine never holds funds. Needs x86_64 Linux, root, ≥40GB free disk (chain is ~4GB today and grows).

curl -fsSL https://raw.githubusercontent.com/GOLDBRIX-GBX/goldbrix-tools/main/run-node/install-node.sh -o install-node.sh
less install-node.sh   # read before running — verify, don't trust
sudo bash install-node.sh

The script pins the binary SHA-256 (also anchored on-chain) and installs systemd services goldbrixd, gbx-read-api, gbx-indexer. When synced, expose port 8088 behind HTTPS and the node publishes itself to the on-chain registry — nobody has to accept you, and wallets pick you up from the chain, no app rebuild.

1. Requirements

2. Download & verify the binary

The release is built with a fully reproducible process. Anyone rebuilding from source obtains byte-identical binaries — verify, don't trust.

wget https://github.com/GOLDBRIX-GBX/goldbrix-core/releases/download/v31-gbx-launchpad/goldbrix-1747c8e2d817-x86_64-linux-gnu.tar.gz
wget https://github.com/GOLDBRIX-GBX/goldbrix-core/releases/download/v31-gbx-launchpad/SHA256SUMS-v31-gbx-launchpad.txt
sha256sum goldbrix-1747c8e2d817-x86_64-linux-gnu.tar.gz

3. Install

tar -xzf goldbrix-1747c8e2d817-x86_64-linux-gnu.tar.gz
sudo cp goldbrix-1747c8e2d817/bin/goldbrixd goldbrix-1747c8e2d817/bin/goldbrix-cli /usr/local/bin/

4. Configure

mkdir -p /var/lib/goldbrix
cat > /var/lib/goldbrix/goldbrix.conf << 'EOF'
server=1
listen=1
txindex=1
EOF

Peers are discovered from the chain itself: the installer reads the on-chain node registry (GBX:NODE) through any node that answers, asks it for its live peers, and writes them as addnode entries. A set of seed nodes is also compiled into the binary. No manual configuration needed, and no single operator to depend on.

5. Run

goldbrixd -daemon
goldbrix-cli getblockcount
goldbrix-cli getpeerinfo

Block height should grow and match any federation node — open the explorer or query /api/status on any node from the on-chain registry.

6. Run as a service (recommended)

sudo tee /etc/systemd/system/goldbrixd.service << 'EOF'
[Unit]
Description=GoldBrix Core daemon
After=network.target
[Service]
ExecStart=/usr/local/bin/goldbrixd -datadir=/var/lib/goldbrix
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable --now goldbrixd

7. Verify your node's integrity (optional)

Compare your binary hash with the network's canonical release:

sha256sum /usr/local/bin/goldbrixd
curl -s https://ANY-NODE/gbx-node-info

Node URLs come from the on-chain registry (/api/node-registry) — no central list. Every node installed with install-node.sh exposes /gbx-node-info: the SHA-256 of the binary it is actually running, keyless and read-only.

The binary_sha256 field shows the hash of the reproducible Guix build currently running on public seed nodes.

8. Rebuild from source (verify, don't trust)

Source: goldbrix-core (git clone, tag v31-gbx-launchpad). Full reproducible-build instructions ship inside the source tree (contrib/guix/). Two independent builds of tag v31-gbx-launchpad produce identical SHA-256 sums.

9. Run the public watchtower (optional)

Independent, keyless liveness monitor. Records the network's uptime history on YOUR machine — proof the system runs without its founder.

wget https://raw.githubusercontent.com/GOLDBRIX-GBX/goldbrix-tools/main/watchtower/watchtower.py
python3 watchtower.py --seed https://ANY-NODE/api

Any registered node works as the seed; the full list is then read from the chain. It alarms on silence, compares block hashes at the same height (a real fork test), and records each node's binary hash.

10. Mine to your own address (solo, non-custodial)

Any federation node can expose a solo non-custodial stratum pool: the coinbase of every block pays your address directly; the pool never holds funds, fee 0 (code-is-law). Any federation node may run one — verify any pool live at its /pool-info.

./cpuminer -a sha256d -o stratum+tcp://ANY-POOL:3333 -u bn1youraddress.worker1 -p x

Login format: bn1address.workername. Any SHA-256d stratum miner works. Rewards mature after 100 blocks. You can also run this pool software against your own node — source: goldbrix-tools. Node source: goldbrix-core.