Node Provider Reward Configuration Guide
From Internet Computer Wiki
Revision as of 21:07, 14 August 2023 by Andrew.battat (talk | contribs)
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.
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.