Mine Iron Fish
Miners are essential to the health of the Iron Fish network. Without them, blocks won't be generated and transactions won't be transmitted.
Requirements
Install Iron Fish by following the instructions here.
Quick start
Start your node by running the following command:
Open a new terminal window and run:
Changing the default account
If you want to use a different account to store the miners fee, you can create a new account by running the following command:
And then set it up as default:
Set block graffiti (optional)
Iron Fish blocks contain a 32-byte publicly-visible field called graffiti
that can be set by the block's miner. To set this value to a UTF-8 encoded string on the blocks you mine, update the blockGraffiti
config option:
Join a mining pool
You can join a mining pool in order to increase your chances of mining a block. Block rewards are typically split among miners based on their respective contributions. We also run a basic mining pool that anyone can join. To get started, retrieve the public key of the account you want to use:
And use that public key to join the mining pool:
Join our Discord if you're interested in creating a different pool for Iron Fish.
Troubleshooting
My miner has been running for a long time - but I haven't mined a block yet
- Difficulty (and therefore time to mine a block) can change depending on how fast blocks are mined on the Iron Fish network.
- Make sure you are correctly connected to the Iron Fish network (you should see
Connected to the Iron Fish network
in your node logs).
Not connected to a node - waiting 5s before retrying
Make sure that your node is currently running. If you are using a different datadir
argument to start your node, make sure to use it as well when starting the miner. For example:
The trees aren't the same size as the chain
- Make sure your node is synced with the network before starting the miner. Run
ironfish status
to check if your node is still syncing.