GPU Miner Guide

You must first follow the steps in the Full Node Starter Guide in order to download, start your node and use Swagger http://127.0.0.1:12973/docs.

Mining Information

  • 4 address groups and 16 chains in total
  • the target block time is 64 seconds
  • everyday, 24 * 60 * 60 / 64 * 16 = 21600 blocks are mined on average
  • the block rewards are 3 ALPH right now
  • all of the mined coins are locked for 500 minutes

For more information about mining rewards, please read this article Block Rewards.

You could get the estimated network hashrate from the log of your full node, or from the Grafana dashboard of the full node if you run it with docker-compose.

Create Miner Wallet

First, you must create a dedicated wallet for mining. As opposed to a traditional wallet, a miner wallet has multiple addresses which are used to collect mining rewards for each address group.

Create your miner wallet

miner-wallet-create-query

The server will return you the new wallet mnemonic. Please backup and store it securely.

miner-wallet-create-response

List your miner addresses

miner-wallet-list-addresses-query

The server will return you 4 addresses for the next step:

miner-wallet-list-addresses-response

Configure Miner Addresses

Now that you have gotten your 4 miner addresses, you must assign it to your node so you can earn rewards when it starts mining. This can be done by adding the following content in the file .alephium/user.conf under your home folder1:

alephium.network.external-address = "x.x.x.x:9973" // put your public IP here; otherwise remove this line
alephium.mining.miner-addresses = [
  "1HiYeRbypJQK4nc6EFYWiRVdsdYukQKq8SvKQsfJ3wiR8",
  "1HD3q1G7qVoeyNA4U6HbBhFvv1FLUWNGwNavPamScpVLa",
  "1CQiD2RQ58ymszcgPEszRomyMZxEjH1Rtp4tB84JY2qgL",
  "19vvD3QbfEYbJexk6yCtnDNpRrfr3xQv2Pzc6x265MRhD"
]

Please restart your node to make these new configs take effect. Please be sure to add them in the same order they were returned by the endpoint, as they are sorted according to their group.

Start Mining

The full node needs to be fully synced to the Alephium network before you could start mining. You could verify that by executing this endpoint:

full-node-synced-query

Nvidia GPU

Please follow the instructions on https://github.com/alephium/gpu-miner to run the gpu miner for Nvidia GPUs.

Alternatively, you could run the gpu-miner with docker by following the documents here https://github.com/alephium/alephium/tree/master/docker#gpu-miner-optional

AMD GPU

Please follow the instructions on https://github.com/alephium/amd-miner to run the gpu miner for AMD GPUs. Note that the performance of AMD miner is not in par with Nvidia miner.

If you have any questions, feel free to reach out to the developers on Discord.

Miner Wallet More

Here are more endpoints that are useful for miners.

Get your balance

miner-wallet-balance-query

Change your active address

miner-wallet-change-active-address

Transfer all your funds on the active address to another address

miner-wallet-sweep-all-query

Unlock your wallet

miner-wallet-unlock-query

1

The home folder depends on your system: C:\Users\<your-username> in Windows, /Users/<your-username> in macOS, /home/<your-username> in Linux.