Skip to main content
This guide covers how to operate a community RPC node on Celo.
TerminologyThe term “validator” appears in code and documentation due to historical reasons, but refers to community RPC providers.
Registered and elected nodes must operate independent RPC endpoints; see Penalties for how uptime is scored. This guide assumes your node has been properly registered.

​
Running the RPC service

To operate the required RPC endpoint, follow the Running a node guide.

​
Rewards

The per-epoch USDm payment to elected providers is 0: governance set targetValidatorEpochPayment on the EpochRewards contract to 0 in CGP-0218. Elections continue, and voters for elected groups still earn CELO rewards. The commands below send and track any payment already allocated to a validator and not yet sent.

​
Claiming Rewards

If a payment was allocated before CGP-0218 and not yet sent, claim it with this CLI command:
Where:
  • $YOUR_ADDRESS is your Celo account address sending the transaction
  • $VALIDATOR_ADDRESS is your validator’s Celo account address
Note: anyone can run this command; the payment is split according to your validator group’s commission rate.

​
Verifying Rewards

Confirm successful reward distribution by checking for ValidatorEpochPaymentDistributed events on a block explorer like CeloScan.

​
Tracking Rewards

For accounting purposes, you can:
  • Query Celo nodes for ValidatorEpochPaymentDistributed events.
  • Query the EpochManager contract for validatorPendingPayments to view total allocated payments.

​
Group Commission Settings

The group commission rate applies to any validator payment allocated before CGP-0218 and not yet sent; a rate of 1 sends the whole payment to the group. Since CGP-0241, a group can also set a separate voter reward commission on the CELO rewards paid to its voters. Check commission settings with:
Update commission settings with the celocli validatorgroup:commission command.