CLI PoP Miner
Last updated
Was this helpful?
Last updated
Was this helpful?
This guide provides straightforward steps to download, set up, and run your PoP Miner, either by downloading pre-built binaries or by building from source.
Ensure you have your development environment ready and follow the steps below to start PoP mining.
Basic CLI skills are required.
Basic CLI Knowledge
BTC (See Bitcoin fee/vB to understand how much BTC is required to PoP mine)
The package you will need to download depends on your OS and architecture:
Windows (Intel/AMD CPU): heminetwork_v1.0.0_windows_amd64.zip
Mac (Intel CPU): heminetwork_v1.0.0_darwin_amd64.tar.gz
Mac (Apple Silicon "M" CPU): heminetwork_v1.0.0_darwin_arm64.tar.gz
Linux (Intel/AMD CPU): heminetwork_v1.0.0_linux_amd64.tar.gz
Linux (ARM CPU): heminetwork_v1.0.0_linux_arm64.tar.gz
After downloading the necessary files, you must extract them from their compressed format before you can use or access the software. On most operating systems, you can right-click on the downloaded archive and choose "Extract" or similar.
Launch your CLI:
Navigate to the folder you extracted by typing cd
(don't press Enter
yet) and then drag the path of the extracted folder into your CLI, or type the path in manually and then press Enter
.
For example on Linux if you downloaded the package to your Downloads folder and extracted it through the GUI, you might run a command like:
cd '/home/<user>/Downloads/heminetwork_v1.0.0_linux_amd64'
List the files:
Your output should be:
Linux & macOS
For Windows
To ensure you downloaded the correct binaries and are able to run them, execute the command below:
This will display the help menu for popmd
, indicating that it's installed and operational.
If you prefer to PoP mine using a preexisting private key, you may skip step 6a and 6b. You may import a private key from either an EVM or BTC address. For your BTC wallet (Unisat for example), use the HEX private key and not the WIF private key.
If you chose to generate a new private key in Step 6a, open your JSON to view your file contents.
You should see a result like:
Find your wallet address:
New Address: If you generated a new public key in Step 6a, check the JSON file from Step 6b for your pubkey_hash
.
Best Practices for BTC Allocation
We advise against sending large amounts of Bitcoin to the private key connected to your PoP miner. To run the miner, ~0.002 BTC
is required per day assuming a Bitcoin fee rate of 2-3 sat/vB. As a safety practice, consider sending only enough BTC for a week or a month at a time and refilling periodically.
To determine how much BTC to send to your wallet, review Bitcoin fee/vB.
In your console, execute the following commands while:
replacing <private_key>
with either the value from your JSON file in Step 5 OR your preexisting EVM/BTC private key,
replacing <fee_per_vB_integer>
with the fee in sat/vB you want to pay.
Linux & macOS
Windows
The Bitcoin transaction (normally represented in satoshis per virtual byte or sats/vB) is a fee paid to the Bitcoin miners to include a transaction in a Bitcoin block. It varies with network congestion, typically rising during periods of high transaction volume and decreasing when there is less activity.
The PoP Miner consumes BTC to pay the Bitcoin miners to include PoP transactions in Bitcoin blocks.
In order to ensure PoP transactions from your PoP miner are included in Bitcoin blocks, ensure the configured fee is set to an appropriate value. The PoP miner can be configured to use a certain fee in sats/vB by changing the POPM_STATIC_FEE
environment variable when running the PoP miner. In a future version, the PoP miner will automatically calculate the current network fee to guarantee PoP transactions are included in Bitcoin blocks.
The lower you set the fee, the less BTC you will pay per PoP transaction. If your fees are too low, Bitcoin miners may not include your transaction quickly enough for you to successfully PoP mine.
Bitcoin fee determination:
Set the Static Fee: Re-run the command to set the POPM_STATIC_FEE
environment variable from above (export
on Linux/macOS, set
on Windows) each time you want to change the fee, and restart the PoP Miner afterwards.
or . Choose the release you want to use (if unsure, choose the latest), and click on Assets
dropdown:
Existing BTC Address: If you are importing a private key from an existing BTC address, to P2PKH (Legacy) and locate the pubkey hash.
Existing EVM Address: If you are importing a private key from an existing EVM address, and select P2PKH (Legacy) as your wallet type.
If you want to test out PoP mining on testnet, you can get tBTC from faucets .
Read the section below if you need help determining what value to set here.
Let us know how this process was for you via . We are constantly looking for ways to improve our documentation.
Check Current Fee Levels: Visit to see the current fee levels. Look at the "sat/vB" numbers for the different transaction fee priorities. It is recommended to set the value to the "High Priority" value or slightly higher.
Linux & macOS
⚠️ On Mac you will need to first remove the quarantine by running the following command in your Terminal:
xattr -d com.apple.quarantine ./popmd
Run
./popmd --help
Windows
⚠️ Important Note for Windows Users: To successfully execute this command, you must use the Command Prompt (CMD), not PowerShell (which is the default terminal in environments like Visual Studio Code).
Run
popmd.exe --help
Linux & macOS
⚠️ On Mac you will need to remove the quarantine by running:
xattr -d com.apple.quarantine ./keygen
Run the following command:
Windows
⚠️ Important Note for Windows Users: To successfully execute this command, you must use the Command Prompt, not PowerShell (which is the default terminal in environments like Visual Studio Code). Follow these steps to open Command Prompt:
Click on the Start Menu button or press the Windows key on your keyboard.
Type cmd
into the search bar and open it.
Type the following command and press Enter:
Note: After running the command, you might not see any immediate feedback in the Command Prompt. This is expected behavior.
Open the generated key file
After generating the key file, you'll want to check its contents. To do this, use the following command in Command Prompt:
This command opens the popm-address.json
file in Notepad, allowing you to view or edit the generated key.