Node Provider Reward Configuration Guide

From Internet Computer Wiki
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. Proposals must be executed prior to the next minting date in order to be included.

In the next code block:

  • Replace the NEURON_ID value with your neuron ID from the NNS Frontend Dapp (step 3.6 from the Node Provider Onboarding).
  • Replace the NODE_OPERATOR_PRINCIPAL value with your node operator principal (step 7.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. *Important : If you adding nodes to a previous node allocation or updating a previous node operator record, you have to make sure the total node count should be accounted for in the NODE_COUNT parameter.

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 has been executed.