BTCNODE Toolkit

Windows installer and monitoring toolkit for a pruned Bitcoin Knots node with OCEAN DATUM Gateway on WSL2.

BTCNODE Toolkit prepares an isolated Ubuntu 24.04 WSL2 distribution, installs verified Bitcoin Knots binaries, builds DATUM Gateway from its official source, configures systemd services, and provides a Windows monitoring GUI. The blockchain is stored inside an ext4 VHDX at the location selected during setup.

This is an independent community project. It is not affiliated with or endorsed by Bitcoin Knots, OCEAN, Bitcoin Ocean, LLC, or the Bitcoin project.

Features

• Guided Windows .exe installer.
• Bitcoin Knots 29.3.knots20260508 with pinned SHA-256 verification.
• OCEAN DATUM Gateway v0.4.1beta, compiled locally from the official repository.
• Pruned mainnet node with configurable storage and memory.
• RPC restricted to localhost with generated credentials.
• DATUM Stratum forwarding on TCP 23334 for LAN miners.
• Real-time Windows GUI, synchronization progress, logs, pause/resume controls, and mining instructions.
• Optional experimental BIP-110/rdts policy setting, disabled by default.
• Recovery helper that never deletes blockchain data.

Requirements

• Windows 11 or a supported Windows 10 build with WSL2.
• x86-64 CPU with virtualization enabled.
• Administrator access during installation.
• SSD with at least 100 GB free for the recommended 50 GB prune target, WSL filesystem, indexes, and growth margin.
• Stable internet connection.
• A public Bitcoin mainnet payout address. Never enter a private key or seed phrase.

Install

1. Download BTCNODE-Toolkit-Setup-0.1.0.exe from GitHub Releases.
2. Run it as Administrator.
3. Select an SSD location for the WSL disk.
4. Enter a public payout address.
5. Keep the recommended resource values unless you understand the tradeoffs.
6. Wait for Bitcoin Knots to reach 100% before starting DATUM mining.

If Windows requests a restart while enabling WSL, restart and run the installer again. Existing node data is detected and preserved.

Mining connection

After synchronization and after starting DATUM from the monitor, configure each ASIC with:

URL:  stratum+tcp://WINDOWS_LAN_IP:23334
User: PAYOUT_ADDRESS.worker1
Pass: x

DATUM creates work from your local node. With OCEAN DATUM pooled mining, OCEAN coordinates reward accounting but does not construct your block templates. Review the official DATUM Gateway documentation before directing hashrate.

BIP-110

The installer can add consensusrules=rdts for compatible Bitcoin Knots builds. BIP-110 is experimental and its status or implementation may change. It is intentionally opt-in. Read BIP-110 and verify compatibility with your selected Knots release before enabling it.

Build locally

winget install JRSoftware.InnoSetup
git clone https://github.com/humanx123/btcnode-datum-toolkit.git
cd btcnode-datum-toolkit
powershell -ExecutionPolicy Bypass -File .\scripts\Test-Project.ps1
powershell -ExecutionPolicy Bypass -File .\installer\Build-Installer.ps1

The installer is written to installer\Output.

Security model

• Bitcoin RPC listens only on WSL localhost.
• RPC and DATUM admin passwords are randomly generated per installation.
• Only TCP 23334 is opened for miners.
• Wallets, blockchain data, credentials, logs, VHDX files, and generated configurations are excluded from Git.
• Release executables are currently unsigned. Verify the SHA-256 value published with each release.

See SECURITY.md and installation details.

Upstream projects

• Bitcoin Knots
• OCEAN DATUM Gateway
• Windows Subsystem for Linux

License

BTCNODE Toolkit is licensed under the MIT License. Downloaded or built upstream components retain their own licenses and copyrights.