Difference between revisions of "Node Provider Reward Configuration Guide"

Latest revision as of 16:08, 12 July 2024

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 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}'

@@ Line 1: / Line 1: @@
 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 <code>NEURON_ID</code> value with your neuron ID from the NNS Frontend Dapp (step 4.6 from the [[Node Provider Onboarding]]).
+*Replace the <code>NEURON_ID</code> value with your neuron ID from the NNS Frontend Dapp (step 3.6 from the [[Node Provider Onboarding]]).
-*Replace the <code>NODE_OPERATOR_PRINCIPAL</code> value with your node operator principal (step 8.1 from the [[Node Provider Onboarding]]).
+*Replace the <code>NODE_OPERATOR_PRINCIPAL</code> value with your node operator principal (step 7.1 from the [[Node Provider Onboarding]]).
 *Replace <code>NODE_1_MACHINE_ID</code>, <code>NODE_2_MACHINE_ID</code> ... <code>NODE_N_MACHINE_ID</code> with the node machine IDs for all N of your node machines (found on the [https://dashboard.internetcomputer.org/ dashboard])
-*Replace <code>NODE_COUNT</code> with the number of nodes you are setting a reward configuration for.
+*Replace <code>NODE_COUNT</code> 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'' <code>NODE_COUNT</code> ''parameter.''
-. Create the proposal<syntaxhighlight lang="shell">
+==== 1. Create the proposal ====
+<syntaxhighlight lang="shell">
 $ NEURON_ID = XXXXXXXXXXXXXXXXXXXX
 $ NODE_OPERATOR_PRINCIPAL = xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxx
@@ Line 28: / Line 28: @@
 </syntaxhighlight>
-The default reward configuration for gen2 nodes is <code>type3.1</code>. If a different node configuration is applicable to your node models, replace this value.
+The default reward configuration for Gen2 nodes is <code>type3.1</code>. If a different node configuration is applicable to your node models, replace this value.
-Example reward configuration proposal for 3 gen2 nodes:
+Example reward configuration proposal for 3 Gen2 nodes:
 <syntaxhighlight lang="shell">
 $ NEURON_ID = 13419667327548602649
@@ Line 49: / Line 49: @@
 </syntaxhighlight>
+==== 2. Find the proposal on https://dashboard.internetcomputer.org/governance and wait until it has been executed. ====
-. Find the proposal on <nowiki>https://dashboard.internetcomputer.org/governance</nowiki> and wait until it's executed.
-. 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.