Saltar al contenido principal

Agregar un nodo al conjunto de validadores

Introducción​

La Red Primaria es inherente a la plataforma Avalanche y valida las blockchains incorporadas en Avalanche. En este tutorial, agregaremos un nodo a la Red Primaria en Avalanche.

La P-Chain gestiona metadatos en Avalanche. Esto incluye rastrear qué nodos están en qué Subnets, qué blockchains existen y qué Subnets están validando qué blockchains. Para agregar un validador, emitiremos transacciones a la P-Chain.

warning

Ten en cuenta que una vez que emites la transacción para agregar un nodo como validador, no hay forma de cambiar los parámetros. No puedes eliminar tu participación temprano o cambiar la cantidad de participación, el ID del nodo o la dirección de recompensa. Asegúrate de usar los valores correctos en las llamadas de API a continuación. Si no estás seguro, no dudes en unirte a nuestro Discord para hacer preguntas.

Requisitos​

Has completado Ejecutar un Nodo Avalanche y estás familiarizado con la arquitectura de Avalanche](/learn/avalanche/avalanche-platform.md). En este tutorial, usamos AvalancheJS y la colección de Postman de Avalanche para ayudarnos a realizar llamadas de API.

Para asegurarte de que tu nodo esté bien conectado, asegúrate de que tu nodo pueda recibir y enviar tráfico TCP en el puerto de participación (9651 de forma predeterminada) y que tu nodo tenga una dirección IP pública (es opcional establecer --public-ip=[LA IP PÚBLICA DE TU NODO AQUÍ] cuando ejecutes el binario AvalancheGo, ya que de forma predeterminada, el nodo intentará realizar traversal NAT para obtener la IP del nodo según su enrutador). No hacer ninguno de estos puede poner en peligro tu recompensa de participación.

Agregar un validador con la extensión Core​

Primero, te mostramos cómo agregar tu nodo como validador usando Core web.

Obtener el ID del nodo​

Obtén el ID de tu nodo llamando a info.getNodeID:

curl -X POST --data '{
    "jsonrpc":"2.0",
    "id"     :1,
    "method" :"info.getNodeID"
}' -H 'content-type:application/json' 127.0.0.1:9650/ext/info

La respuesta tiene el ID de tu nodo:

{
  "jsonrpc": "2.0",
  "result": {
    "nodeID": "NodeID-5mb46qkSBj81k9g9e4VFjGGSbaaSLFRzD"
  },
  "id": 1
}

Agregar como validador​

Conecta la extensión Core a Core web y ve a la pestaña 'Staking'. Aquí, elige 'Validate' en el menú.

Completa los parámetros de participación. Se explican con más detalle en este documento. Cuando hayas completado todos los parámetros de participación y los hayas revisado, haz clic en Submit Validation. Asegúrate de que el período de participación sea al menos 2 semanas, la tasa de tarifa de delegación sea al menos 2% y estés participando con al menos 2,000 AVAX en Mainnet (1 AVAX en Fuji Testnet). Una guía completa sobre esto se puede encontrar aquí.

Deberías ver un mensaje de éxito y tu saldo debería actualizarse.

Vuelve a la pestaña Stake y verás aquí una descripción general de tu validación, con información como la cantidad de participación, el tiempo de participación y más.

Descripción general de la participación

Llamar a platform.getPendingValidators verifica que tu transacción fue aceptada. Ten en cuenta que esta llamada de API debe hacerse antes de la hora de inicio de validación de tu nodo, de lo contrario, el retorno no incluirá el ID de tu nodo ya que ya no está pendiente.

También puedes llamar a platform.getCurrentValidators para verificar que el ID de tu nodo esté incluido en la respuesta.

¡Eso es todo!

Agregar un validador con AvalancheJS​

También podemos agregar un nodo al conjunto de validadores usando AvalancheJS.

Instalar AvalancheJS​

Para usar AvalancheJS, puedes clonar el repositorio:

git clone https://github.com/ava-labs/avalanchejs.git
info

El método de clonación del repositorio utilizado es HTTPS, pero también se puede usar SSH:

git clone [email protected]:ava-labs/avalanchejs.git

Puedes encontrar más información sobre SSH y cómo usarlo aquí.

o agregarlo a un proyecto existente:

yarn add @avalabs/avalanchejs

Para este tutorial, usaremos ts-node para ejecutar los scripts de ejemplo directamente desde un directorio AvalancheJS.

Flujo de trabajo de Fuji​

En esta sección, usaremos Fuji Testnet para mostrar cómo agregar un nodo al conjunto de validadores.

Abre tu directorio AvalancheJS y selecciona la carpeta examples/platformvm para ver el código fuente de los scripts de ejemplo.

Usaremos el script buildAddValidatorTx.ts para agregar un validador. Para obtener más información sobre la API buildAddValidatorTx, haz clic aquí.

Clave privada​

Localiza esta línea en el archivo

const privKey: string = `${PrivateKeyPrefix}${DefaultLocalGenesisPrivateKey}`;

y reemplázala con una clave privada que controles. Puedes usar este código para generar una nueva clave.

const privKey: string = "<TU-CLAVE-PRIVADA-AQUÍ>";

Configuración de red​

La siguiente configuración funciona cuando se usa un nodo local iniciado con --network-id=fuji:

const ip: string = "localhost";
const port: number = 9650;
const protocol: string = "http";
const networkID: number = 5;

Sin embargo, para conectarse directamente al servidor de la API de la Avalanche Fuji Testnet, se necesitan los siguientes cambios:

const ip: string = "api.avax-test.network";
const port: number = 443;
const protocol: string = "https";
const networkID: number = 5;

Dependiendo del networkID pasado al instanciar un objeto Avalanche en el código, las direcciones codificadas utilizadas tendrán una Parte Legible por Humanos (HRP) distintiva por red.

Ejemplo de dirección: 5 - X-fuji19rknw8l0grnfunjrzwxlxync6zrlu33yxqzg0h

Para la Fuji Testnet, 5 es el valor correcto a usar.

Detalles sobre las direcciones Bech32

Las cadenas X y P utilizan Bech32 para codificar direcciones. Cabe destacar que la cadena C también utiliza Bech32 para codificar direcciones para importar y exportar activos; sin embargo, la Máquina Virtual de Ethereum (EVM), en general, utiliza codificación hexadecimal para las direcciones. Ejemplo: 0x46f3e64E4e3f5a46Eaf5c292301c6174B9B646Bf.

Cada dirección Bech32 está compuesta por los siguientes componentes:

Una Parte Legible por Humanos (HRP por sus siglas en inglés). El número 1 es un separador (el último dígito 1 visto se considera el separador). Cadena codificada en base-32 para la parte de datos de la dirección (la dirección de 20 bytes en sí). Un código de corrección de errores de 6 caracteres codificado en base-32 utilizando el algoritmo BCH. Por ejemplo, la siguiente dirección Bech32, X-avax19rknw8l0grnfunjrzwxlxync6zrlu33y2jxhrg, está compuesta de la siguiente manera:

HRP: avax Separador: 1 Dirección: 9rknw8l0grnfunjrzwxlxync6zrlu33y Suma de comprobación: 2jxhrg

Dependiendo del networkID, las direcciones codificadas tendrán un HRP distintivo para cada red.

  • 0 - X-custom19rknw8l0grnfunjrzwxlxync6zrlu33yeg5dya
  • 1 - X-avax19rknw8l0grnfunjrzwxlxync6zrlu33y2jxhrg
  • 2 - X-cascade19rknw8l0grnfunjrzwxlxync6zrlu33ypmtvnh
  • 3 - X-denali19rknw8l0grnfunjrzwxlxync6zrlu33yhc357h
  • 4 - X-everest19rknw8l0grnfunjrzwxlxync6zrlu33yn44wty
  • 5 - X-fuji19rknw8l0grnfunjrzwxlxync6zrlu33yxqzg0h
  • 1337 - X-custom19rknw8l0grnfunjrzwxlxync6zrlu33yeg5dya
  • 12345 - X-local19rknw8l0grnfunjrzwxlxync6zrlu33ynpm3qq

Aquí está el mapeo del networkID al HRP bech32.

 0: "custom",
  1: "avax",
  2: "cascade",
  3: "denali",
  4: "everest",
  5: "fuji",
  1337: "custom",
  12345: "local"

Configuración para la Validación​

A continuación, necesitamos especificar el período de validación y la tarifa de delegación del nodo.

const nodeID: string = "NodeID-7Xhw2mDxuDS44j42TCB6U5579esbSt3Lg";
const startTime: BN = UnixNow().add(new BN(60 * 1));
const endTime: BN = startTime.add(new BN(26300000));
const delegationFee: number = 10;

ID del Nodo​

Este es el ID del nodo del validador que se está agregando. Consulta la sección anterior sobre cómo obtener el ID del nodo utilizando la API info.getNodeID.

Período de Stake​

startTime y endTime son necesarios para especificar el tiempo de inicio/fin de la validación. La duración mínima en la que se puede validar la Red Primaria es de 2 semanas, y la duración máxima es de un año. Se puede iniciar una nueva validación en la Red Primaria después de terminar una, simplemente que la duración máxima continua es de un año. startTime y endTime son los tiempos Unix en los que tu validador comenzará y dejará de validar la Red Primaria, respectivamente. startTime debe estar en el futuro en relación con el momento en que se emite la transacción.

El código de ejemplo usa const startTime: BN = UnixNow().add(new BN(60 * 1)) y const endTime: BN = startTime.add(new BN(26300000)) para calcular el tiempo Unix 1 minuto y 304 días en el futuro (en el momento en que se escribió este artículo) para usar como valores de startTime y endTime, respectivamente.

tip

Puedes crear tu propio timestamp Unix aquí o utilizando el método UnixNow()

Para crear tus propios tiempos de inicio, sigue los pasos a continuación:

Localiza esta línea en el archivo

const startTime: BN = UnixNow().add(new BN(60 * 1));
const endTime: BN = startTime.add(new BN(26300000));

Cambia startTime y endTime por nuevos valores de BN, por ejemplo:

const startTime: BN = new BN(1654656829); // Mié Jun 08 2022 02:53:49 GMT+0000
const endTime: BN = new BN(1662602029); // Jue Sep 08 2022 01:53:49 GMT+0000

Tarifa de Delegación​

Avalanche permite la delegación de stake. Este parámetro es la tarifa porcentual que cobra este validador cuando otros delegan stake en él. Por ejemplo, si la tarifa de delegación es 10 y alguien delega en este validador, entonces cuando el período de delegación haya terminado, el 10% de la recompensa va al validador y el resto va al delegador, si este nodo cumple con los requisitos de recompensa de validación.

Cantidad de Stake​

Establece la cantidad adecuada de stake al llamar a pchain.buildAddValidatorTx reemplazando stakeAmount.minValidatorStake con un número en la unidad de gwei, por ejemplo, BN(1e12) que son 10,000 AVAX.

Direcciones​

Por defecto, el ejemplo utiliza la variable pAddressStrings para definir toAddresses, fromAddresses, changeAddresses y rewardAddresses:

const pAddressStrings: string[] = pchain.keyChain().getAddressStrings();

Esto recupera las direcciones de la P-Chain que pertenecen a la clave privada que aparece antes en el ejemplo.

No se necesita ningún cambio en las direcciones para la acción predeterminada. Para personalización, consulta esta sección.

Ejecutar el Código​

Ahora que hemos realizado todos los cambios necesarios en el script de ejemplo, es hora de agregar un validador a la Red Fuji.

Ejecuta el comando:

ts-node examples/platformvm/buildAddValidatorTx.ts

La respuesta tiene el ID de transacción.

¡Éxito! TXID: 2ftDVwmss5eJk8HFsNVi6a3vWK9s3szZFhEeSY2HCS8xDb8Cra

Podemos verificar el estado de la transacción ejecutando el script de ejemplo: getTxStatus.ts siguiendo los pasos a continuación:

  1. Asegúrate de que tu configuración de red sea correcta antes de ejecutar el script.

  2. Localiza esta línea en el archivo

const main = async (): Promise<any> => {
  const txID: string = "x1NLb9JaHkKTXvSRReVSsFwQ38mY7bfD1Ky1BPv721VhrpuSE"
  ...
  }

y reemplázala con el TXID de buildAddValidator

const main = async (): Promise<any> => {
 const txID: string = "2ftDVwmss5eJk8HFsNVi6a3vWK9s3szZFhEeSY2HCS8xDb8Cra"
 ...
 }

Ejecuta el comando:

ts-node examples/platformvm/getTxStatus.ts

Esto devuelve:

{ status: 'Committed' }

El estado debería ser Committed, lo que significa que la transacción fue exitosa.

Podemos ver si el nodo está ahora en el conjunto de validadores pendientes para la red Fuji utilizando el ejemplo: getPendingValidators.ts. Simplemente cambia la configuración de red para cumplir con los requisitos de Fuji y luego ejecuta el script:

ts-node examples/platformvm/getPendingValidators.ts

La respuesta debería incluir el nodo que acabamos de agregar:

{
  "validators": [
    {
      "nodeID": "NodeID-7Xhw2mDxuDS44j42TCB6U5579esbSt3Lg",
      "startTime": "1654656829",
      "endtime": "1662602029",
      "stakeAmount": "1000000000"
    }
  ],
  "delegators": []
}

Cuando el tiempo alcance 1654656829 (Mié Jun 08 2022 02:53:49 GMT+0000), este nodo comenzará a validar la Red Primaria. Cuando alcance 1662602029 (Jue Sep 08 2022 01:53:49 GMT+0000), este nodo dejará de validar la Red Primaria. El AVAX con stake y las recompensas, si las hay, se devolverán a pAddressStrings.

Personalización de Direcciones​

Hay 4 direcciones que se necesitan al llamar a pchain.buildAddValidatorTx. Solo 2 de ellas se pueden cambiar: toAddresses y rewardAddresses. Por razones de compatibilidad con versiones anteriores, fromAddresses y changeAddresses son solo marcadores de posición y se ignoran.

toAddresses

Un arreglo de direcciones que reciben los tokens apostados al final del período de apuesta.

rewardAddresses

Cuando un validador deja de validar la Red Primaria, recibirá una recompensa si fue suficientemente receptivo y correcto mientras validaba la Red Primaria. Estos tokens se envían a rewardAddresses. La apuesta original se enviará de vuelta a las direcciones definidas en toAddresses.

La apuesta de un validador nunca se recorta, sin importar su comportamiento, siempre recibirán su apuesta de vuelta cuando terminen de validar.

Localiza esta parte del código

let privKey: string = `${PrivateKeyPrefix}${DefaultLocalGenesisPrivateKey}`;
pKeychain.importKey(privKey);

y reemplaza privKey con las claves privadas que controlas. Para generar un nuevo par de claves, podemos usar el script de ejemplo createKeypair.ts junto con la Configuración de la Red Fuji.

let privKey: string =
  "PrivateKey-PY2dvfxzvBAe1a5nn7x23wmZMgAYJaS3XAZXzdUa22JtzUvKM";
pKeychain.importKey(privKey);
privKey = "PrivateKey-2Y3Vg9LShMJyUDBHzQqv5WtKDJ8yAVHyM3H5CNCBBmtg3pQEQG";
pKeychain.importKey(privKey);
privKey = "PrivateKey-NaV16owRSfa5TAtxtoU1BPUoM2y1ohttRbwKJG1j7onE4Ge1s";
pKeychain.importKey(privKey);
priKey = "PrivateKey-26JMUsR5RCkf5k9ME8WxKCWEuCK5s2SrALUn7vEa2urwyDDc91";
pKeychain.importKey(privKey);

const pAddressStrings: string[] = pchain.keyChain().getAddressStrings();

Este ejemplo crearía una cadena de claves con 4 direcciones:

  "P-fuji1jx644d9y00y5q4hz8cq4wr75a2erne2y4e32xc", // pAddressStrings[0]
  "P-fuji1wchdgdp94j8tszlpsp56qvgkvdn20svpmnm8qk", // pAddressStrings[1]
  "P-fuji1f36kkpy6yzd7ayrywxvvprns7qlrcu3hwqdya8", // pAddressStrings[2]
  "P-fuji1qw7yt3fp43kuwsufff4vhezs2yl00slr09vmh5", // pAddressStrings[3]

Ahora podemos pasar cada dirección según su posición en el arreglo pAddressStrings:

const unsignedTx: UnsignedTx = await pchain.buildAddValidatorTx(
  utxoSet,
  [pAddressStrings[0], pAddressStrings[1]], // toAddresses, una o más direcciones
  [pAddressStrings[0]], // fromAddresses, requerido para compatibilidad con versiones anteriores
  [pAddressStrings[0]], // changeAddresses, requerido para compatibilidad con versiones anteriores
  nodeID,
  startTime,
  endTime,
  stakeAmount.minValidatorStake,
  [pAddressStrings[2], pAddressStrings[3]], //rewardAddresses, una o más direcciones
  delegationFee,
  locktime,
  threshold,
  memo,
  asOf
);

Flujo de trabajo en Mainnet​

El flujo de trabajo en Fuji anterior se puede adaptar a Mainnet con las siguientes modificaciones:

Was this page helpful?