Blocknet

A client for running Blocknet cores.

Network upgrade

Blocknet plans a network upgrade around 2027-02-16. After it, you will have 1 year to move your coins to the new format, until about 2028-02-16. Coins not moved by then cannot be spent. The wallet will guide you.

What is this?

This program helps you install, upgrade and manage Blocknet cores.

Quick start

1. Download Blocknet
2. Run blocknet setup: the setup wizard walks you through everything
3. Or do it manually: blocknet install latest then blocknet start
4. Optional: open the interactive shell with blocknet attach mainnet

Windows users: The binary is blocknet.exe. Use blocknet.exe setup, etc. All other commands and documentation apply the same way.

Android users: Run blocknet in Termux from F-Droid or GitHub. The Play Store build of Termux cannot run downloaded programs. Use the blocknet-arm64-android download. For auto-updates, run pkg install cronie termux-services and sv-enable crond first.

Build instructions

1. Install Go
2. Clone this repository
3. In the Blocknet repository's folder, run go build, you may need go mod tidy first.

Note: The build process doesn't generate any text output, only a blocknet or blocknet.exe in the same directory.

Documentation

• Command Reference: all blocknet commands (start, stop, install, upgrade, logs, doctor, etc.)
• Shell Reference: all commands inside blocknet attach
• Configuration Reference: full config.json schema, defaults, and examples
• Wallet Management: loading, passwords, backups, recovery, and security
• Version Management & Upgrades: installing, pinning, upgrading, cleanup, and nightly builds
• Troubleshooting & FAQ: common issues and how to fix them