Skip to content

Configure your RSK node to be used from a merge mining pool

Adrián Eidelman edited this page Jan 12, 2018 · 5 revisions

Download configuration sample file

MainNet

sudo wget -O /etc/rsk/node.conf https://raw.githubusercontent.com/rsksmart/artifacts/master/rskj-ubuntu-installer/config/mainnet.conf

TestNet

sudo wget -O /etc/rsk/node.conf https://raw.githubusercontent.com/rsksmart/artifacts/master/rskj-ubuntu-installer/config/testnet.conf

RegTest

sudo wget -O /etc/rsk/node.conf https://raw.githubusercontent.com/rsksmart/artifacts/master/rskj-ubuntu-installer/config/regtest.conf

Update configuration file settings

Replace constants

Detailed information about how to create your own unique identifiers can be found here. Once created, replace them (privateKey, publicKey, address, nodeId, coinbase) in /etc/rsk/node.conf file.

Add miner options

These can be added to the node.conf sample configuration to turn your node into a miner instance.

Enable RPC mining methods

Add 'mnr' module inside 'modules' section

modules = [
        {
            name: "mnr",
            version: "1.0",
            enabled: "true"
         },
         #Other enabled modules
         ...
    ]

Enable mining components and set reward address

  • Current Testnet minGasPrice value = 0
# miner options
miner {
    server.enabled = true
    client.enabled = false
    minGasPrice = 183000000

    # this is a hex-encoded, 20-byte length address where the miner gets the reward
    reward.address = <ENCODED_ADDRESS>
}
  • Your "<ENCODED_ADDRESS>" should be a 20-byte value, for example:
reward.address = "83e5356c8Bb19109f5dg19900EC6c130049F8034"

Miner with coinbase secret (alternative to setting a reward address)

This configuration is usually used for testing, along with a local wallet hosted in the node. This is not recommended to be used in Mainnet.

# miner options
miner {
    server.enabled = true
    client.enabled = false
    minGasPrice = 183000000

    # this is a secret passphrase that is used to derive the address where the miner gets the reward.
    # please note this is stored in a local wallet and not recommended for production.
    coinbase.secret = <COINBASE_SECRET>
}

Restart RSK node

Once settings have been properly configured, restart node for changes to take effect.

Clone this wiki locally