Vai al contenuto

Ricompense per i Validatori

Collegandomi a DoubleZero, accetto i Termini di Utilizzo di DoubleZero

Come Funziona

I validatori che pubblicano leader shred su DoubleZero Edge guadagnano ricompense ogni epoca. Prima che le ricompense possano essere pagate, ogni validatore deve registrare dove le ricompense vengono inviate configurando un account ValidatorPublisherRewards su Solana. Quell'account memorizza:

  • il rewards mint — il token in cui vengono pagate le ricompense 2z (salvo modifica manuale)
  • il rewards owner — il wallet che possiede l'Associated Token Account (ATA) che riceve le ricompense

Il comando configure imposterà questi campi e i pagamenti automatici avverranno su base epocale da quel momento in poi. Puoi rieseguire configure in seguito per modificare uno dei due campi.

Se non hai ancora completato Setup, Connessione Validator Mainnet-Beta e Connessione Validator Multicast, fallo prima.

Prerequisiti

  • Validatori che pubblicano leader shred - vedi Connessione Validator Multicast.
  • L'ultima versione della CLI doublezero-solana: sudo apt update && sudo apt install doublezero-solana, almeno la versione 0.5.6.
  • Accesso alla keypair di identità del validatore, sia sulla stessa macchina sia conservata offline con la possibilità di firmare un messaggio.
  • Una chiave pubblica del wallet di destinazione che possiederà l'ATA delle ricompense.

1. Configura per Richiedere le Ricompense

Esegui configure con la keypair di identità del validatore come -k.

doublezero-solana shreds publisher-rewards configure \
    --node-id <ValidatorIdentity111111111111111111111111111> \
    --rewards-token-owner <Wallet567Identity111111111111111111111111111> \
    -k <path-to-validator-identity-keypair.json>
Output di Esempio 
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: restituisce la transazione che puoi visualizzare in un block explorer.

Flag Descrizione
--node-id Chiave pubblica di identità del nodo validatore.
--rewards-token-owner Wallet che possiederà l'ATA ricevente.
--rewards-token-mint Il token in cui verranno ricevute le ricompense del wallet 2z. I token supportati includono anche usdc e wsol.
-k Percorso alla keypair di identità del validatore. Nel percorso diretto, la chiave pubblica della keypair deve corrispondere a --node-id altrimenti il comando restituirà un errore indicando di passare al percorso offchain.

L'ATA viene auto-inizializzato nella stessa transazione se non esiste ancora.

Se Viene Restituito un Errore

Se la chiave pubblica di -k non corrisponde a --node-id

La keypair del fee-payer che hai passato non è l'identità del validatore. Passa la keypair di identità del validatore come -k, oppure passa al percorso offchain.

2. Verifica la Configurazione

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

Il comando stampa il Node ID, il Rewards owner, il Rewards mint, l'indirizzo ATA risolto e lo stato dell'ATA. L'ATA Risolto è l'indirizzo deterministico derivato dal rewards owner + rewards mint — è dove le ricompense verranno depositate ogni epoca.

Appendice: Alternativa con Percorso Offchain

Tre sotto-passaggi: preparazione, firma, configurazione.

1. Prepara il messaggio offchain

Esegui questo ovunque — è in sola lettura e non necessita della keypair di identità del validatore. Stampa il blob esadecimale da firmare e lo slot assoluto alla scadenza della firma.

doublezero-solana shreds publisher-rewards prepare-offchain-message \
    --node-id <ValidatorIdentity111111111111111111111111111> \
    --rewards-token-owner <Wallet567Identity111111111111111111111111111> \
    --valid-for 1h
Output di Esempio

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>
Flag Descrizione
--node-id Chiave pubblica di identità del nodo validatore.
--rewards-token-owner Wallet che possiederà l'ATA ricevente.
--rewards-token-mint Il token in cui verranno ricevute le ricompense del wallet 2z. I token supportati includono anche usdc e wsol.
--valid-for Durata della firma relativa allo slot corrente. Accetta <n>s, <n>m o <n>h. Predefinito: 1h.
--deadline-slot Alternativa a --valid-for: slot assoluto alla scadenza dell'autorizzazione. Mutuamente esclusivo con --valid-for.
--json Produce JSON ({ hex, deadline_slot }) invece del riepilogo leggibile.

Il comando stampa il messaggio di autorizzazione codificato in esadecimale, lo slot di scadenza risolto e frammenti di comandi shell pronti all'uso per i due passaggi successivi.

2. Firma il messaggio

Sulla macchina che detiene la keypair di identità del validatore:

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

Questo stampa una firma in base58.

Output di Esempio

SignatureTBUwGq511mPLMCEE4f5fNsmX1PQrozXBBJeCdSrcbhqSX1MwFp8NsNZbhCNMZ1kPWakjsLL9e3GUxxp

3. Invia configure

Di nuovo sulla macchina con il tuo wallet fee-payer:

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

--signature e --deadline-slot devono essere passati insieme. I valori devono corrispondere a quelli prodotti nei passaggi 2b.i e 2b.ii.

L'ATA viene auto-inizializzato nella stessa transazione se non esiste ancora.

Output di Esempio

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

Nota: Se la Firma è Scaduta

Ogni firma offchain ha uno slot di scadenza. Se passa troppo tempo tra prepare-offchain-message e configure, riesegui prepare-offchain-message, rifirma e reinvia. La validità predefinita è 1 ora — estendila con --valid-for 4h o simile se hai bisogno di più tempo per un flusso di firma offline.