Node Provider Reward Configuration Guide

From Internet Computer Wiki
Revision as of 18:30, 14 August 2023 by Andrew.battat (talk | contribs) (Created page with "After onboarding all your nodes, you must submit a reward configuration proposal in order to start receiving node rewards. If you do not do this, you will not receive node rew...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

After onboarding all your nodes, you must submit a reward configuration proposal in order to start receiving node rewards. If you do not do this, you will not receive node rewards.


In the next code block:

  • Replace the NEURON_ID value with your neuron ID from the NNS Frontend Dapp (step 4.6 from the Node Provider Onboarding).
  • Replace the NODE_OPERATOR_PRINCIPAL value with your node operator principal (step 8.1 from the Node Provider Onboarding).
  • Replace NODE_1_MACHINE_ID, NODE_2_MACHINE_ID ... NODE_N_MACHINE_ID with the node machine IDs for all N of your node machines (found on the dashboard)
  • Replace NODE_COUNT with the number of nodes you are setting a reward configuration for.

1. Create the proposal

$ NEURON_ID = XXXXXXXXXXXXXXXXXXXX
$ NODE_OPERATOR_PRINCIPAL = xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxx
$ ./ic-admin \
        --nns-url https://ic0.app \
        -s ~/.config/dfx/identity/node-provider-hotkey/identity.pem \
    propose-to-update-node-operator-config \
        --proposer $NEURON_ID \
        --summary "Set rewards for the following nodes:

        * NODE_1_MACHINE_ID
        * NODE_2_MACHINE_ID
        * ...
        * NODE_N_MACHINE_ID
        " \
        --node-operator-id $NODE_OPERATOR_PRINCIPAL \
        --rewardable-nodes '{"type3.1": NODE_COUNT}'

The default reward configuration for gen2 nodes is type3.1. If a different node configuration is applicable to your node models, replace this value.

Example reward configuration proposal for 3 gen2 nodes:

$ NEURON_ID = 13419667327548602649
$ NODE_OPERATOR_PRINCIPAL = uqquy-76uhn-2mys5-dh54e-85ntr-sr953-redif-zkte3-94ndi-st2i1-93t
$ ./ic-admin \
        --nns-url https://ic0.app \
        -s ~/.config/dfx/identity/node-provider-hotkey/identity.pem \
    propose-to-update-node-operator-config \
        --proposer $NEURON_ID \
        --summary "Set rewards for the following nodes:

        * sed94-atzdo-rltqy-tmnhr-fvspg-fat3p-sdbjp-7q3jg-dgfcq-zrlap-cqe
        * uq4uy-76uhn-2mys5-dh54e-85ntr-sr953-redif-zkte3-94ndi-st2i1-93t-sdjsl-vjlfn-6duch-vskdu-26pf5-cwibg-zooqk-sdn2e-cgugm-tae
        * 39esy-hmrb2-nfvao-t42co-tqfed-y3i7c-xqxyp-idt2w-wgmgr-l4x7l-gae
        " \
        --node-operator-id $NODE_OPERATOR_PRINCIPAL \
        --rewardable-nodes '{"type3.1": 3}'


2. Find the proposal on https://dashboard.internetcomputer.org/governance and wait until it's executed.

3. In order to expedite the speed of your proposal's approval, it is best to create a post in this forum thread to raise awareness of your proposal.