Aller au contenu

Récompenses des validateurs

En me connectant à DoubleZero, j'accepte les Conditions d'utilisation de DoubleZero

Fonctionnement

Les validateurs qui publient des leader shreds vers DoubleZero Edge gagnent des récompenses à chaque epoch. Avant que les récompenses puissent être versées, chaque validateur doit enregistrer où les récompenses seront envoyées en configurant un compte ValidatorPublisherRewards sur Solana. Ce compte stocke :

  • le mint des récompenses — le jeton dans lequel les récompenses sont versées 2z (sauf modification manuelle)
  • le propriétaire des récompenses — le portefeuille qui possède le compte de jetons associé (ATA) recevant les récompenses

La commande configure définira ces champs, et les paiements automatiques se feront ensuite sur une base epoch par epoch. Vous pouvez relancer configure ultérieurement pour modifier l'un ou l'autre champ.

Si vous n'avez pas encore terminé la Configuration, la Connexion du validateur au Mainnet-Beta et la Connexion Multicast du validateur, faites-le d'abord.

Prérequis

  • Validateurs publiant des leader shreds - voir Connexion Multicast du validateur.
  • Le dernier CLI doublezero-solana : sudo apt update && sudo apt install doublezero-solana, au minimum 0.5.6.
  • Accès à la paire de clés d'identité du validateur, soit sur la même machine, soit conservée hors ligne avec la possibilité de signer un message.
  • Une clé publique de portefeuille de destination qui sera propriétaire de l'ATA des récompenses.

1. Configurer pour réclamer les récompenses

Exécutez configure avec la paire de clés d'identité du validateur comme -k.

doublezero-solana shreds publisher-rewards configure \
    --node-id <ValidatorIdentity111111111111111111111111111> \
    --rewards-token-owner <Wallet567Identity111111111111111111111111111> \
    -k <path-to-validator-identity-keypair.json>
Exemple de sortie 
Shred subscription - Configure Validator Publisher Rewards
Node ID:           ValidatorIdentity111111111111111111111111111
Rewards owner:     ValidatorIdentity111111111111111111111111111
Rewards mint:      J6pQQ3FAcJQeWPPGppWRb4nM8jU3wLyYbRrLh7feMfvd
Rewards ATA:       11111111111Pt3PatTj59dG5BhYuqPb9QJDUr1111111
Auth path:         direct
Configured validator publisher rewards: 41111111ntmoBTnvcKcP1g2a1111111HPoN3z5uf11111112jjzBJsr1B2JrTRff4dSGe1pdM1111111TMADi3Nz
Configured validator publisher rewards: affiche la transaction que vous pouvez consulter dans un explorateur de blocs.

Drapeau Description
--node-id Clé publique d'identité du nœud validateur.
--rewards-token-owner Portefeuille qui sera propriétaire de l'ATA de réception.
--rewards-token-mint Le jeton dans lequel les récompenses du portefeuille seront reçues 2z. Les jetons pris en charge incluent également usdc et wsol.
-k Chemin vers la paire de clés d'identité du validateur. Sur le chemin direct, la clé publique de la paire de clés doit correspondre à --node-id, sinon la commande renverra une erreur et vous indiquera de passer au chemin offchain.

L'ATA est automatiquement initialisé dans la même transaction s'il n'existe pas encore.

Si une erreur est retournée

Si la clé publique de -k ne correspond pas à --node-id

La paire de clés du payeur de frais que vous avez passée n'est pas l'identité du validateur. Passez soit la paire de clés d'identité du validateur comme -k, soit passez au chemin offchain.

2. Vérifier la configuration

doublezero-solana shreds publisher-rewards show --node-id <NODE_ID>

La commande affiche le Node ID, le Rewards owner, le Rewards mint, l'adresse ATA résolue et le statut de l'ATA. L'ATA résolu est l'adresse déterministe dérivée du propriétaire des récompenses + le mint des récompenses — c'est là que les récompenses seront déposées à chaque epoch.

Annexe : Alternative du chemin offchain

Trois sous-étapes : préparer, signer, configurer.

1. Préparer le message offchain

Exécutez ceci n'importe où — c'est en lecture seule et ne nécessite pas la paire de clés d'identité du validateur. La commande affiche le blob hexadécimal à signer et le slot absolu auquel la signature expire.

doublezero-solana shreds publisher-rewards prepare-offchain-message \
    --node-id <ValidatorIdentity111111111111111111111111111> \
    --rewards-token-owner <Wallet567Identity111111111111111111111111111> \
    --valid-for 1h
Exemple de sortie

Hex message:    123457fc138f556a2578bdb079dc923342cc4e4a376683dc4c6cb923051e0be3
Deadline slot:  422954444

Sign with:
  solana sign-offchain-message 123457fc138f556a2578bdb079dc923342cc4e4a376683dc4c6cb923051e0be3 --keypair <validator-identity>

Then submit:
  doublezero-solana shreds publisher-rewards configure \
    --node-id ValidatorIdentity111111111111111111111111111 --rewards-token-mint J6pQQ3FAcJQeWPPGppWRb4nM8jU3wLyYbRrLh7feMfvd --rewards-token-owner Wallet567Identity111111111111111111111111111 \
    --deadline-slot 422954444 --signature <BASE58>
Drapeau Description
--node-id Clé publique d'identité du nœud validateur.
--rewards-token-owner Portefeuille qui sera propriétaire de l'ATA de réception.
--rewards-token-mint Le jeton dans lequel les récompenses du portefeuille seront reçues 2z. Les jetons pris en charge incluent également usdc et wsol.
--valid-for Durée de vie de la signature relative au slot actuel. Accepte <n>s, <n>m ou <n>h. Par défaut : 1h.
--deadline-slot Alternative à --valid-for : slot absolu auquel l'autorisation expire. Mutuellement exclusif avec --valid-for.
--json Émet du JSON ({ hex, deadline_slot }) au lieu du résumé lisible.

La commande affiche le message d'autorisation encodé en hexadécimal, le slot d'échéance résolu et des extraits de commandes prêts à l'emploi pour les deux étapes suivantes.

2. Signer le message

Sur la machine qui détient la paire de clés d'identité du validateur :

solana sign-offchain-message <123457fc138f556a2578bdb079dc923342cc4e4a376683dc4c6cb923051e0be3> \
--keypair <path-to-validator-identity-keypair.json>

Cela affiche une signature en base58.

Exemple de sortie

SignatureTBUwGq511mPLMCEE4f5fNsmX1PQrozXBBJeCdSrcbhqSX1MwFp8NsNZbhCNMZ1kPWakjsLL9e3GUxxp

3. Soumettre configure

De retour sur la machine avec votre portefeuille payeur de frais :

doublezero-solana shreds publisher-rewards configure \
    --node-id <ValidatorIdentity111111111111111111111111111> \
    --rewards-token-owner <Wallet567Identity111111111111111111111111111> \
    --signature <SignatureTBUwGq511mPLMCEE4f5fNsmX1PQrozXBBJeCdSrcbhqSX1MwFp8NsNZbhCNMZ1kPWakjsLL9e3GUxxp> \
    --deadline-slot <DEADLINE_SLOT>

--signature et --deadline-slot doivent être passés ensemble. Les valeurs doivent correspondre à celles produites aux étapes 2b.i et 2b.ii.

L'ATA est automatiquement initialisé dans la même transaction s'il n'existe pas encore.

Exemple de sortie

Shred subscription - Configure Validator Publisher Rewards
Node ID:           ValidatorIdentity111111111111111111111111111
Rewards owner:     ValidatorIdentity111111111111111111111111111
Rewards mint:      J6pQQ3FAcJQeWPPGppWRb4nM8jU3wLyYbRrLh7feMfvd
Rewards ATA:       11111111111Pt3PatTj59dG5BhYuqPb9QJDUr1111111
Auth path:         offchain
Configured validator publisher rewards: 41111111ntmoBTnvcKcP1g2a1111111HPoN3z5uf11111112jjzBJsr1B2JrTRff4dSGe1pdM1111111TMADi3Nz

Note : Si la signature est expirée

Chaque signature offchain a un slot d'échéance. Si trop de temps s'écoule entre prepare-offchain-message et configure, relancez prepare-offchain-message, re-signez et resoumettez. La validité par défaut est de 1 heure — prolongez avec --valid-for 4h ou similaire si vous avez besoin de plus de temps pour un flux de signature hors ligne.