Skip to content

Commit 92792f5

Browse files
Update Validator Rewards.md (#174)
* Update Validator Rewards.md * chore: auto-translate docs --------- Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
1 parent 7b29743 commit 92792f5

8 files changed

Lines changed: 320 additions & 424 deletions

docs/Validator Rewards.es.md

Lines changed: 41 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,28 @@
11
# Recompensas para Validadores
22
!!! warning "Al conectarse a DoubleZero, acepto los [Términos de Uso de DoubleZero](https://doublezero.xyz/terms-protocol)"
33

4-
Los validadores que publican leader shreds en DoubleZero Edge obtienen recompensas en cada epoch. Antes de que las recompensas puedan ser pagadas, cada validador debe registrar **dónde** se enviarán las recompensas configurando una cuenta `ValidatorPublisherRewards` en Solana. Dicha cuenta almacena:
4+
## Cómo Funciona
55

6-
- el **mint de recompensas** — el token en el que se pagan las recompensas `2z` (a menos que se cambie manualmente)
7-
- el **propietario de recompensas** — la wallet que posee la Cuenta de Token Asociada (ATA) que recibe las recompensas
6+
Los validadores que publican leader shreds en DoubleZero Edge obtienen recompensas en cada época. Antes de que se puedan pagar las recompensas, cada validador debe registrar **dónde** se envían las recompensas configurando una cuenta `ValidatorPublisherRewards` en Solana. Esa cuenta almacena:
87

9-
El comando `configure` establecerá estos campos, y los pagos automáticos se realizarán epoch a epoch a partir de ese momento. Puede volver a ejecutar `configure` más adelante para cambiar cualquiera de los campos.
8+
- el **mint de recompensas** — el token en el que se pagan las recompensas es 2z (a menos que se cambie manualmente)
9+
- el **propietario de recompensas** — la wallet que posee la Associated Token Account (ATA) que recibe las recompensas
10+
11+
El comando `configure` establecerá estos campos, y los pagos automáticos se realizarán época por época a partir de ese momento. Puede volver a ejecutar `configure` más adelante para cambiar cualquiera de los campos.
1012

1113
!!! info "Si aún no ha completado la [Configuración](setup.md), la [Conexión del Validador a Mainnet-Beta](DZ%20Mainnet-beta%20Connection.md) y la [Conexión Multicast del Validador](Validator%20Multicast%20Connection.md), hágalo primero."
1214

13-
## Requisitos previos
15+
## Requisitos Previos
1416

15-
- Validadores publicando leader shreds consulte [Conexión Multicast del Validador](Validator%20Multicast%20Connection.md).
17+
- Validadores publicando leader shreds - consulte [Conexión Multicast del Validador](Validator%20Multicast%20Connection.md).
1618
- La última versión del CLI `doublezero-solana`: `sudo apt update && sudo apt install doublezero-solana`, como mínimo `0.5.6`.
1719
- Acceso al **keypair de identidad del validador**, ya sea en la misma máquina o mantenido offline con la capacidad de firmar un mensaje.
1820
- Una pubkey de wallet de destino que será propietaria de la ATA de recompensas.
1921

20-
---
21-
22-
## 1. Elija una ruta de autenticación
23-
24-
Configurar la cuenta de recompensas requiere autorización de la clave de identidad del validador. Hay dos formas de proporcionarla:
25-
26-
| Ruta | Cuándo usarla |
27-
|---|---|
28-
| **Directa** | El keypair de identidad del validador está en la máquina desde la que ejecuta los comandos. |
29-
| **Offchain** | El keypair de identidad del validador se mantiene offline o en una máquina diferente a la de la wallet que paga las comisiones. |
3022

3123
---
3224

33-
## 2a. Ruta directa
25+
## 1. Configurar para Reclamar Recompensas
3426

3527
Ejecute `configure` con el keypair de identidad del validador como `-k`.
3628

@@ -40,7 +32,7 @@ doublezero-solana shreds publisher-rewards configure \
4032
--rewards-token-owner <Wallet567Identity111111111111111111111111111> \
4133
-k <path-to-validator-identity-keypair.json>
4234
```
43-
Salida de ejemplo
35+
Ejemplo de Salida
4436
```bash
4537
Shred subscription - Configure Validator Publisher Rewards
4638
Node ID: ValidatorIdentity111111111111111111111111111
@@ -50,26 +42,39 @@ Rewards ATA: 11111111111Pt3PatTj59dG5BhYuqPb9QJDUr1111111
5042
Auth path: direct
5143
Configured validator publisher rewards: 41111111ntmoBTnvcKcP1g2a1111111HPoN3z5uf11111112jjzBJsr1B2JrTRff4dSGe1pdM1111111TMADi3Nz
5244
```
53-
`Configured validator publisher rewards: ` muestra la transacción que puede visualizar en un explorador de bloques.
45+
`Configured validator publisher rewards: ` muestra el txt que puede ver en un explorador de bloques.
5446

5547
| Flag | Descripción |
5648
|---|---|
5749
| `--node-id` | Pubkey de identidad del nodo validador. |
5850
| `--rewards-token-owner` | Wallet que será propietaria de la ATA receptora. |
59-
| `--rewards-token-mint` | El token en el que se recibirán las recompensas de la wallet `2z`. Los tokens compatibles también incluyen `usdc` y `wsol`. |
60-
| `-k` | Ruta al keypair de identidad del validador. En la ruta directa, la pubkey del keypair debe coincidir con `--node-id` o el comando dará error e indicará que cambie a la ruta offchain. |
51+
| `--rewards-token-mint` | El token en el que se recibirán las recompensas de la wallet en `2z`. Los tokens soportados también incluyen `usdc` y `wsol`. |
52+
| `-k` | Ruta al keypair de identidad del validador. En la ruta directa, la pubkey del keypair debe coincidir con `--node-id` o el comando devolverá un error indicando que cambie a la ruta offchain. |
6153

6254
La ATA se inicializa automáticamente en la misma transacción si aún no existe.
6355

64-
Continúe directamente al [paso 3](#3-verificar-la-configuracion).
56+
57+
!!! note "Si se Devuelve un Error"
58+
Si la pubkey de `-k` no coincide con `--node-id`
59+
60+
El keypair del pagador de comisiones que proporcionó no es la identidad del validador. Proporcione el keypair de identidad del validador como `-k`, o cambie a la [ruta offchain](#apendix-alternativa-de-ruta-offchain).
61+
---
62+
63+
## 2. Verificar la Configuración
64+
65+
```bash
66+
doublezero-solana shreds publisher-rewards show --node-id <NODE_ID>
67+
```
68+
69+
El comando muestra el `Node ID`, `Rewards owner`, `Rewards mint`, la dirección ATA resuelta y el estado de la ATA. La **ATA Resuelta** es la dirección determinística derivada del propietario de recompensas + mint de recompensas — es donde se depositarán las recompensas en cada época.
6570

6671
---
6772

68-
## 2b. Ruta offchain
73+
## Apéndice: Alternativa de Ruta Offchain
6974

70-
Tres subpasos: preparar, firmar, configurar.
75+
Tres sub-pasos: preparar, firmar, configurar.
7176

72-
### 2b.i. Preparar el mensaje offchain
77+
### 1. Preparar el mensaje offchain
7378

7479
Ejecute esto en cualquier lugar — es de solo lectura y no necesita el keypair de identidad del validador. Imprime el blob hexadecimal a firmar y el slot absoluto en el que expira la firma.
7580

@@ -79,7 +84,7 @@ doublezero-solana shreds publisher-rewards prepare-offchain-message \
7984
--rewards-token-owner <Wallet567Identity111111111111111111111111111> \
8085
--valid-for 1h
8186
```
82-
Salida de ejemplo
87+
Ejemplo de Salida
8388

8489
```bash
8590
Hex message: 123457fc138f556a2578bdb079dc923342cc4e4a376683dc4c6cb923051e0be3
@@ -99,14 +104,14 @@ Then submit:
99104
|---|---|
100105
| `--node-id` | Pubkey de identidad del nodo validador. |
101106
| `--rewards-token-owner` | Wallet que será propietaria de la ATA receptora. |
102-
| `--rewards-token-mint` | El token en el que se recibirán las recompensas de la wallet `2z`. Los tokens compatibles también incluyen `usdc` y `wsol`. |
103-
| `--valid-for` | Tiempo de vida de la firma relativo al slot actual. Acepta `<n>s`, `<n>m` o `<n>h`. Valor predeterminado: `1h`. |
107+
| `--rewards-token-mint` | El token en el que se recibirán las recompensas de la wallet en `2z`. Los tokens soportados también incluyen `usdc` y `wsol`. |
108+
| `--valid-for` | Tiempo de vida de la firma relativo al slot actual. Acepta `<n>s`, `<n>m`, o `<n>h`. Por defecto: `1h`. |
104109
| `--deadline-slot` | Alternativa a `--valid-for`: slot absoluto en el que expira la autorización. Mutuamente excluyente con `--valid-for`. |
105110
| `--json` | Emite JSON (`{ hex, deadline_slot }`) en lugar del resumen legible. |
106111

107-
El comando imprime el mensaje de autorización codificado en hexadecimal, el slot límite resuelto y fragmentos de shell listos para ejecutar para los dos pasos siguientes.
112+
El comando imprime el mensaje de autorización codificado en hexadecimal, el slot de vencimiento resuelto y fragmentos de shell listos para ejecutar para los dos pasos siguientes.
108113

109-
### 2b.ii. Firmar el mensaje
114+
### 2. Firmar el mensaje
110115

111116
En la máquina que contiene el keypair de identidad del validador:
112117

@@ -117,13 +122,13 @@ solana sign-offchain-message <123457fc138f556a2578bdb079dc923342cc4e4a376683dc4c
117122

118123
Esto imprime una firma en base58.
119124

120-
Salida de ejemplo
125+
Ejemplo de Salida
121126

122127
```bash
123128
SignatureTBUwGq511mPLMCEE4f5fNsmX1PQrozXBBJeCdSrcbhqSX1MwFp8NsNZbhCNMZ1kPWakjsLL9e3GUxxp
124129
```
125130

126-
### 2b.iii. Enviar `configure`
131+
### 3. Enviar `configure`
127132

128133
De vuelta en la máquina con su wallet pagadora de comisiones:
129134

@@ -135,12 +140,11 @@ doublezero-solana shreds publisher-rewards configure \
135140
--deadline-slot <DEADLINE_SLOT>
136141
```
137142

138-
`--signature` y `--deadline-slot` deben pasarse juntos. Los valores deben coincidir con los producidos en los pasos 2b.i y 2b.ii.
143+
`--signature` y `--deadline-slot` deben proporcionarse juntos. Los valores deben coincidir con los producidos en los pasos 2b.i y 2b.ii.
139144

140145
La ATA se inicializa automáticamente en la misma transacción si aún no existe.
141146

142-
143-
Salida de ejemplo
147+
Ejemplo de Salida
144148

145149
```bash
146150
Shred subscription - Configure Validator Publisher Rewards
@@ -154,22 +158,5 @@ Configured validator publisher rewards: 41111111ntmoBTnvcKcP1g2a1111111HPoN3z5uf
154158

155159
---
156160

157-
## 3. Verificar la configuración
158-
159-
```bash
160-
doublezero-solana shreds publisher-rewards show --node-id <NODE_ID>
161-
```
162-
163-
El comando imprime el `Node ID`, `Rewards owner`, `Rewards mint`, la dirección ATA resuelta y el estado de la ATA. La **ATA resuelta** es la dirección determinística derivada del propietario de recompensas + mint de recompensas — es donde se depositarán las recompensas en cada epoch.
164-
165-
---
166-
167-
## Solución de problemas
168-
169-
### Ruta directa: la pubkey de `-k` no coincide con `--node-id`
170-
171-
El keypair pagador de comisiones que proporcionó no es la identidad del validador. Pase el keypair de identidad del validador como `-k`, o cambie a la [ruta offchain](#2b-ruta-offchain).
172-
173-
### Firma expirada
174-
175-
Cada firma offchain tiene un slot límite. Si pasa demasiado tiempo entre `prepare-offchain-message` y `configure`, vuelva a ejecutar `prepare-offchain-message`, firme nuevamente y reenvíe. La validez predeterminada es de 1 hora — extiéndala con `--valid-for 4h` o similar si necesita más tiempo para un flujo de firma offline.
161+
!!! note "Nota: Si la Firma ha Expirado"
162+
Cada firma offchain tiene un slot de vencimiento. Si pasa demasiado tiempo entre `prepare-offchain-message` y `configure`, vuelva a ejecutar `prepare-offchain-message`, firme de nuevo y reenvíe. La validez por defecto es de 1 hora — extiéndala con `--valid-for 4h` o similar si necesita más tiempo para un flujo de firma offline.

0 commit comments

Comments
 (0)