Get a Blocknet wallet and address for mining

To mine Blocknet you need an address for your rewards, and the official wallet gives you one in a few minutes. This guide shows how to create a wallet with the command-line or desktop wallet, back up its recovery seed, find the address to paste into seine, and check your balance when bntpool.com pays you.

Which Blocknet wallet should you use for mining?

• Command-line wallet. The blocknet program installs, starts and updates a Blocknet core, the background process that runs the node, wallet and network. You manage your wallet from an interactive shell. Download it from the command-line releases, which have builds for Windows, macOS and Linux.
• Desktop wallet. A graphical wallet that bundles the Blocknet daemon. Download it from the desktop releases.

Pick whichever you prefer. The steps below walk through the command-line wallet, because every command is documented, and then cover the desktop install.

How to create a wallet with the command-line wallet

1. Install and start a core. Unpack the release and run the setup wizard:

   blocknet setup

   The wizard asks whether to keep your node updated automatically, downloads the latest core and offers to start it. On Windows the program is blocknet.exe, so run blocknet.exe setup. To skip the wizard, run blocknet install latest and then blocknet start.

2. Open the shell. Attach to the running core:

   blocknet attach mainnet

   You get a > prompt. Closing the shell with quit leaves the core running, so you can attach again at any time.

3. Create the wallet. Type load. The wallet lists any wallet files it finds and offers “Create a new wallet”. Choose that option, enter a name and a password, and the core creates a new wallet with a fresh recovery seed:

   > load
     ...
     4) Create a new wallet
   
     Choose: 4
     Wallet name (without extension):
   > mining
     Password: ********
   
     Wallet created
     Address:  9PNo...
     Filename: mining.wallet.dat

The wallet is a single .wallet.dat file, and your password encrypts its spend key. The core remembers the wallet’s path, so the next blocknet start loads it for you. Blocknet also copies a loaded wallet to ~/.config/bnt/wallets/, which gives you a second copy in a known place.

How do you back up your recovery seed?

Your recovery seed is the backup that matters most. It is 12 words, and with them you can rebuild the wallet on any computer, even if you lose the wallet file or forget the password. Blocknet never stores your password, so the seed is also how you recover from a forgotten one.

Show it with the seed command. The wallet prints a warning, asks you to confirm and asks for your password, then shows the words:

> seed

# Seed
  WARNING: Your recovery seed controls all funds.
  Anyone with this seed can steal your coins.
  Never share it. Never enter it online.

  Show recovery seed? [y/N]: y
  Password: ********

Write the 12 words on paper and keep them somewhere safe and offline. The wallet guide says not to save them in a text file, a notes app or cloud storage, because anyone who has the words controls the funds. The guide to seed phrases explains how the 12 words become your keys and how to store them well.

To restore later, run import, choose 1) 12-word recovery seed, type the words, and give the new wallet a name and password. The core then scans the chain for your outputs.

How do you find your Blocknet address?

> addr

# Address

  9PNoFCqUa7K8e5JfV2Hs3TBt7kMzRGkPxJ4xVmn5cFb...

  Get a short name like @name or $name at https://blocknet.id

This is the address you give seine. When you start seine for the first time, it asks for your payout address and then for a pool; paste the address and press Enter to accept bntpool.com. You can also pass it directly:

./seine --address <your-address>

Once seine is mining, the pool balance panel on its dashboard shows the first and last six characters of the address you’re mining to, so you can check it matches your wallet.

If you’d rather mine to something shorter, a Blocknet ID shortname such as @yourname points to this address and works in seine and on bntpool.com.

Setting up the desktop wallet

The desktop wallet’s latest release (v0.22.0, published October 15, 2026) has these downloads:

Every release includes a SHA256SUMS.txt, so you can check your download before installing:

sha256sum -c SHA256SUMS.txt

On Linux, install the .deb or run the .AppImage directly. On macOS, move the app to Applications and run this once in Terminal before the first launch, as the README instructs:

xattr -cr /Applications/blocknet.app

On Windows, if Defender shows a prompt for the installer, click “More info” and then “Run anyway”.

The app runs its bundled Blocknet daemon on your computer and talks to it over 127.0.0.1, and it makes no requests to outside services. Create your wallet in the app, write down its recovery seed, and copy your receiving address into seine. The desktop wallet also opens blocknet:// payment links and fills in the send form for you to review.

Keep your keys on your own computer

A mining machine only needs your address. Seine needs only an address or shortname to mine, so the wallet file and the recovery seed can stay on the computer you trust. This matters most for rented servers, shared rigs and machines other people can reach.

• Run the wallet at home, mine anywhere. Put the same address on every machine running seine. bntpool.com adds their shares to one balance.
• Watch progress without keys. Look up your address on bntpool.com to see your hashrate, shares and balance from any browser.
• Watch-only access. If you want to see incoming funds on a second computer, viewkeys exports view-only keys. A view-only wallet shows incoming funds and cannot send or sign.
• Lock when you step away. lock blocks spending until you unlock with your password.

How do mining payouts show up in your wallet?

bntpool.com pays rewards once their block has matured. A pool block needs 60 confirmations, about five hours at Blocknet’s five-minute block time. When your confirmed balance reaches the 0.1 BNT minimum, the pool sends it to your address as a normal Blocknet transaction.

In the wallet, check balance (or bal):

> bal

# Balance
  spendable:  12.5 BNT
  confirming: 1 BNT
  total:      13.5 BNT

A new payout first appears under confirming. Regular transactions become spendable after 10 confirmations, about 50 minutes, and then move to spendable. The history command lists incoming transactions from oldest to newest, with each one’s block, amount and type: pool payouts show as regular, and blocks you find yourself in solo mode show as coinbase, which need 60 confirmations before you can spend them.

Your wallet lists a payout once its node has caught up with the chain. status shows Syncing: false when it has, and sync rescans the downloaded blocks for your outputs.

New to mining? The guide to mining Blocknet covers downloading seine, choosing threads and what to expect on bntpool.com.