Tecnologías de vanguardia

La guía de Ejecución un Nodo de Symbol explica cómo crear fácilmente un nodo utilizando Symbol Bootstrap. En esa guía, el proceso de configuración se realiza en la misma máquina que albergará el nodo, lo que significa que las claves privadas se generan en una máquina conectada a Internet. Si necesita un nivel de seguridad reforzado, puede seguir la guia a continuación en su lugar, a costa de un proceso de configuración más complicado.

El resumen es que el comando de inicio symbol-bootstrap se divide en una fase de configuración que se ejecuta fuera de línea, lo que genera una carpeta de configuración y el resto del comando de inicio se ejecuta en la máquina en línea de destino que albergará el nodo. La clave privada de la cuenta principal nunca sale de la máquina sin conexión.

Maquina	Función
Configuración	-En línea para instalar software, luego fuera de línea. -Crea archivos de configuración -Prepara transacciones de configuración.
Node	-Permanentemente en línea – Ejecuta el nodo -Anuncia las transacciones de configuración.

También se puede configurar un nodo de tal manera que todas las recompensas de cosecha vayan a una cuenta externa sin requerir la clave privada de esta cuenta. Esto se conoce como configuración sin custodia y debe configurarse una vez que el nodo esté en funcionamiento, por lo que se proporciona un enlace a la guía adecuada al final de esta página.

Máquina de configuración

Configuración

En la máquina de configuración, mientras aún está en línea:

• Instale Symbol Bootstrap como se indica en la guía Uso de Symbol Bootstrap. Asegúrese de leer también la sección Configuración de esa guía para familiarizarse con los ajustes preestablecidos y los ensamblajes.

• Instale Symbol CLI como se indica en la guía symbol-cli. Solo necesitas ejecutar:

npm install --global symbol-cli

• Ejecute Symbol Bootstrap por primera vez para que pueda descargar las imágenes de Docker necesarias:

symbol-bootstrap config -p mainnet -a <assembly> --noPassword
rm -rf target

El resultado de esta primera ejecución es irrelevante, por eso se usa –noPassword y se elimina la carpeta target.

• Desconecte la máquina de configuración de Internet ya que las claves privadas se generarán en esta máquina a partir de este punto.

Crear configuración

Perfil

Cree el perfil de la cuenta principal. Esta es la cuenta que recibirá todas las tarifas de cosecha y cuya puntuación de importancia se utilizará al momento de la cosecha.

El propósito de esta guía es asegurarse de que la clave privada de esta cuenta nunca se utilice en una máquina en línea.

Este paso creará un perfil de symbol-cli para mantener la cuenta principal y firmar transacciones usando su clave privada. La máquina ahora está fuera de línea, por lo que debe proporcionar algunos datos relacionados con la red.

Nota

Con los siguientes comandos se asumen que desea crear una nueva cuenta principal y usar el comando de creación de perfil. Si ya tiene una cuenta que le gustaría usar como principal, use el comando de importación de perfil en su lugar.

Cuando se le solicite, ingrese una contraseña para asegurar su perfil y seleccione el tipo de importación de PrivateKey:

✔ Enter your wallet password: … *********
✔ Select an import type: › PrivateKey

Account
┌───────────────┬──────────────────────────────────────────────────────────────────────┐
│ Property      │ Value                                                                │
├───────────────┼──────────────────────────────────────────────────────────────────────┤
│ Address       │ NCCE5O-BMZHWM-IYZKR6-4WZKFD-4P7DTS-IRXJZ2-3LI                        │
├───────────────┼──────────────────────────────────────────────────────────────────────┤
│ Public Key    │ 51C2CB98B61D666A993FA9B25EEBCB48DE5F0B1B7D8B79ECB7AFCB1E5E601108     │
├───────────────┼──────────────────────────────────────────────────────────────────────┤
│ Private Key   │ ●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●     │
├───────────────┼──────────────────────────────────────────────────────────────────────┤
│ Password      │ ●●●●●●●●●                                                            │
└───────────────┴──────────────────────────────────────────────────────────────────────┘

SUCCESS Stored offline-main profile

symbol-cli ahora está listo para usarse más adelante. Todas las transacciones serán firmadas por su cuenta principal, así que asegúrese de que tenga algunos fondos para pagar las Tarifas.

Tome nota de la clave privada de la cuenta principal y guárdela en un lugar seguro.

Preestablecido

Cree un archivo predeterminado personalizado para Symbol Bootstrap y asígnele el nombre custom.yml. Debe incluir, al menos, estas líneas:

privateKeySecurityMode: PROMPT_MAIN
nodes:
-
  mainPrivateKey: ●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●

Puede leer más sobre estas propiedades en la sección de modo de seguridad en la documentación de Symbol Bootstrap.

Si tiene que realizar personalizaciones, como habilitar la votación o inscribirse en un programa de recompensas, también puede proporcionarlas:

privateKeySecurityMode: PROMPT_MAIN
nodes:
-
  mainPrivateKey: ●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●●
  voting: true
  rewardProgram: SuperNode
  host: my-symbol-node.com # Could also be an IP address

Configurar

Ejecute Symbol Bootstrap nuevamente, esta vez con todos los parámetros requeridos:

symbol-bootstrap config -p mainnet -a <assembly> -c custom.yml

Se le pedirá la contraseña que utilizará para cifrar los archivos de configuración.

? Enter password to use to encrypt and decrypt custom presets, addresses.yml,
  and preset.yml files. When providing a password, private keys will be
  encrypted. Keep this password in a secure place! ******
info     Password has been provided
info     Generating config from preset testnet
info     Assembly preset dual
info     Generating Main account...
info     Generating Transport account...
info     Generating Remote account...
info     Generating VRF account...
info     User for docker resolved: 1000:1000
info     Running image using Exec: symbolplatform/symbol-server:tools-gcc-0.10.1.8 bash createNodeCertificates.sh
info     Certificate for node api-node created
info     Generating api-node server configuration
info     Generating api-broker broker configuration
info     Non-voting node api-node.
info     Configuration generated.

Esto genera un directorio de destino que contiene un archivo address.yml y varios archivos de configuración.

La clave privada de la cuenta principal no está presente en ninguno de estos archivos.

Vale la pena señalar que Symbol Bootstrap habilita la cosecha remota de forma predeterminada, lo que significa que la clave privada principal nunca está disponible en un archivo de texto sin formato en el servidor. Solo es la clave remota, que actúa como un proxy entre el nodo y su cuenta principal.

Copiar configuración

• Abra custom.yml y elimine la línea que contiene mainPrivateKey.

Ahora que Symbol Bootstrap ya lo ha usado en la etapa config , no es necesario que una clave tan sensible esté en un archivo de texto sin formato.

• Copie todo el directorio target en un pendrive (u otro soporte que no esté en red) para usarlo más tarde.

Preparar transacciones

Aún en la máquina de configuración fuera de línea preparare una serie de transacciones de enlace manualmente. Estas transacciones serán creadas por symbol-cli, firmadas por su cuenta principal, y serán movidas a una máquina en línea para ser anunciadas más adelante.

Los siguientes comandos usan todos –max-fee 1000000, lo que significa que se pagará 1 XYM por cada transacción. No dude en utilizar un número diferente después de leer la documentación de tarifas.

Respecto a los plazos

Todas las transacciones tienen una fecha límite, lo que significa que deben anunciarse (y confirmarse) antes de que expire la fecha límite.

Actualmente existe una limitación en symbol-cli que establece este plazo en 2 horas después de la creación de la transacción, para todas las transacciones que no sean de firma múltiple.

Ésta es una limitación conocida que se está rastreando.

Enlace de llave remota

Obtenga la carga útil de la transacción Account Key Link.

Esto vincula su cuenta principal a la cuenta remota utilizada para la cosecha remota. Symbol Bootstrap generó esta cuenta para usted, y puede encontrar su clave pública en el archivo target / direcciones.yml:

remote:
    publicKey: 1544FE6F504A8B8536C2407664916AFB5C917400FD1B941B981933CDFE52AE3F

En el parámetro –linked-public-key a continuación, use la clave pública de la cuenta remota:

symbol-cli transaction accountkeylink --max-fee 1000000 --mode normal \
   --linked-public-key 1544FE6F504A8B8536C2407664916AFB5C917400FD1B941B981933CDFE52AE3F \
   --action Link

Ingrese la contraseña que usó cuando creó el perfil symbol-cli y no anuncie la transacción (la máquina está fuera de línea).

✔ Enter your wallet password: … *********
┌──────────────────────────────────────────────────────────────────────────────────┐
│                                 ACCOUNT_KEY_LINK                                 │
├───────────────┬──────────────────────────────────────────────────────────────────┤
│ Max fee:      │ 1,000,000                                                        │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Network type: │ TEST_NET                                                         │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Deadline:     │ 2021-03-27 10:41:41.286                                          │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Action:       │ Link                                                             │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Linked key:   │ 1544FE6F504A8B8536C2407664916AFB5C917400FD1B941B981933CDFE52AE3F │
├───────────────┴──────────────────────────────────────────────────────────────────┤
│                                Signature details                                 │
├───────────────┬──────────────────────────────────────────────────────────────────┤
│ Payload:      │ A10000000000000042E0E0A0B8D7E1F27805F3537F80BFEAB6FEAC318908C486 │
│               │ 4D03260B83ED1D0332D6EA6E086A4B68C578DB690D78D50BDA5C706B1DC66472 │
│               │ 9326511547E42E0FCC6D13D64FB9BF69B72846C3FE99127D48C3293F473D528F │
│               │ B902600CB7DA10330000000001984C4140420F000000000026F54C1B0A000000 │
│               │ 1544FE6F504A8B8536C2407664916AFB5C917400FD1B941B981933CDFE52AE3F │
│               │ 01                                                               │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Hash:         │ 08C63D3AFAC3767F43053AFF1ACA61381FE81929B2384B91C450010A547AFA4A │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Signer:       │ CC6D13D64FB9BF69B72846C3FE99127D48C3293F473D528FB902600CB7DA1033 │
└───────────────┴──────────────────────────────────────────────────────────────────┘
✔ Do you want to announce this transaction? … no

Seleccione todo el texto en el cuadro Payload y péguelo en un nuevo archivo de texto llamado payloads.txt. Elimine todos los espacios y otras decoraciones para obtener una sola línea que contenga sólo números y letras mayúsculas:

A100000000000000703C88DEDC4ABC2917F00ADB12C45F2C333B1113405C3CFAB289E78D9C54DDFCB1FE7C3048B6DA735568A935C6C08AF7E70AEC614A2EE9590967A7A044E52B0DCC6D13D64FB9BF69B72846C3FE99127D48C3293F473D528FB902600CB7DA10330000000001984C4140420F000000000038F32C1B0A0000001544FE6F504A8B8536C2407664916AFB5C917400FD1B941B981933CDFE52AE3F01

Enlace clave VRF

Obtenga la carga útil de la transacción VRF Key Link.

Esta clave es necesaria para la cosecha.

Una vez más, Symbol Bootstrap ya ha generado esta clave para usted y puede encontrarla en el archivo target / direcciones.yml:

vrf:
    publicKey: 856B6CCA574508158D66046CACEA2D81CB626DEEFDD3B6C466514CE31F32A52B

Utilice la clave pública de la cuenta VRF en el parámetro –linked-public-key a continuación y no anuncie la transacción (la máquina está fuera de línea):

symbol-cli transaction vrfkeylink --max-fee 1000000 --mode normal \
   --linked-public-key 856B6CCA574508158D66046CACEA2D81CB626DEEFDD3B6C466514CE31F32A52B \
   --action Link

Nuevamente, copie el contenido del cuadro Payload, recórtelo y agréguelo a payloads.txt, en una nueva línea.

Enlace de la clave de votación

Obtenga la carga útil de la Voting Key Link transaction.

Esta clave sólo es necesaria para los nodos de votación.

Si agregó vote: true a custom.yml al crear la configuración, entonces Symbol Bootstrap también ha creado esta clave en target / address.yml:

voting:
    publicKey: 05693B4300ABFD28CD6BA434DD26F9FAF2342927FE32840898DCB895B8A17E84

Utilice la clave pública de la cuenta de votación en el parámetro –linked-public-key a continuación y no anuncie la transacción (la máquina está fuera de línea):

symbol-cli transaction votingkeylink --max-fee 1000000 --mode normal \
   --linked-public-key 05693B4300ABFD28CD6BA434DD26F9FAF2342927FE32840898DCB895B8A17E84 \
   --action Link --start-point 1 --end-point 360

Nuevamente, copie el contenido del cuadro Payload, recórtelo y agréguelo a payloads.txt, en una nueva línea

Copiar cargas útiles

Copie payloads.txt en el pendrive donde previamente copió la carpeta de destino.

Máquina en línea

Pase ahora a la máquina en línea, la que está conectada permanentemente a Internet y albergará el nodo. Conecte el pendrive con la configuración del nodo.

Configuración

• Instale Symbol Bootstrap como se indica en la guía Uso de Symbol Bootstrap.
• Instale Symbol CLI como se indica en la guía symbol-cli. Solo necesitas ejecutar:

npm install --global symbol-cli

Cree un perfil de locutor para symbol-cli. Esta es solo una cuenta temporal que se usa para anunciar las cargas útiles; no requiere fondos:

Cuando se le solicite, ingrese una contraseña para proteger su perfil y seleccione el tipo de importación de PrivateKey:

✔ Enter your wallet password: ... *********
✔ Select an import type: » PrivateKey
...
SUCCESS Stored announcer profile

Anunciar enlaces

Ahora usará symbol-cli para anunciar a la red las transacciones que preparó en payloads.txt.

Enlace de llave remota

Anuncie el enlace de la llave remota:

symbol-cli transaction payload --sync --announce
✔ Enter the transaction payload:

Pegue la primera línea de texto largo de payloads.txt y presione Entrar:

SUCCESS Transaction loaded:
┌──────────────────────────────────────────────────────────────────────────────────┐
│                                 ACCOUNT_KEY_LINK                                 │
├───────────────┬──────────────────────────────────────────────────────────────────┤
│ Max fee:      │ 1,000,000                                                        │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Network type: │ TEST_NET                                                         │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Deadline:     │ 2021-03-27 10:41:41.286                                          │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Signer:       │ TBGPYD-CO35V2-AMOYEJ-LEM44H-372M3I-6RWVFY-QCY                    │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Action:       │ Link                                                             │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Linked key:   │ 1544FE6F504A8B8536C2407664916AFB5C917400FD1B941B981933CDFE52AE3F │
└───────────────┴──────────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────────┐
│                                 ACCOUNT_KEY_LINK                                 │
├───────────────┬──────────────────────────────────────────────────────────────────┤
│ Max fee:      │ 1,000,000                                                        │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Network type: │ TEST_NET                                                         │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Deadline:     │ 2021-03-27 10:41:41.286                                          │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Signer:       │ CC6D13D64FB9BF69B72846C3FE99127D48C3293F473D528FB902600CB7DA1033 │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Action:       │ Link                                                             │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Linked key:   │ 1544FE6F504A8B8536C2407664916AFB5C917400FD1B941B981933CDFE52AE3F │
├───────────────┴──────────────────────────────────────────────────────────────────┤
│                                Signature details                                 │
├───────────────┬──────────────────────────────────────────────────────────────────┤
│ Payload:      │ A10000000000000042E0E0A0B8D7E1F27805F3537F80BFEAB6FEAC318908C486 │
│               │ 4D03260B83ED1D0332D6EA6E086A4B68C578DB690D78D50BDA5C706B1DC66472 │
│               │ 9326511547E42E0FCC6D13D64FB9BF69B72846C3FE99127D48C3293F473D528F │
│               │ B902600CB7DA10330000000001984C4140420F000000000026F54C1B0A000000 │
│               │ 1544FE6F504A8B8536C2407664916AFB5C917400FD1B941B981933CDFE52AE3F │
│               │ 01                                                               │
├───────────────┼──────────────────────────────────────────────────────────────────┤
│ Hash:         │ 08C63D3AFAC3767F43053AFF1ACA61381FE81929B2384B91C450010A547AFA4A │
└───────────────┴──────────────────────────────────────────────────────────────────┘
...
SUCCESS Transaction announced
SUCCESS Transaction confirmed

Nota

Si la transacción se anuncia pero nunca se confirma (symbol-cli está bloqueado en Procesamiento durante más de un minuto) puede deberse a varias cosas. Sin interrumpir symbol-cli, copie el hash de la transacción, abra una nueva terminal y ejecute:

symbol-cli transaction status --hash <transaction hash>

Si ha habido algún problema con la transacción, esto debería darle la causa y luego puede interrumpir symbol-cli.

Si necesita intentarlo de nuevo, nunca vuelva a anunciar la misma carga útil. Cree una nueva (desde la máquina de configuración) y vuelva a anunciarla.

Los problemas más comunes son:

–No hay fondos suficientes (Failure_Core_Insufficient_Balance): la cuenta principal (que firmó la transacción) no tiene fondos suficientes para pagar la tarifa. Transfiera algunos fondos y pruebe con una nueva carga útil.
–Fecha límite vencida (Failure_Core_Past_Deadline): cree una nueva carga útil y vuelva a anunciarla antes de que venza la fecha límite (consulte el cuadro Concerniente a las fechas límite más arriba).
–Tarifa insuficiente: no se informará ningún error, pero si la tarifa es demasiado baja, la mayoría de los nodos la ignorarán. Vuelva a intentarlo con una tarifa más alta o prepárese para esperar mucho tiempo.
–Payload reanunciado: symbol-cli se bloqueará en Procesamiento y no obtendrá información relevante del estado de la transacción. No anuncies la misma carga útil más de una vez.

Enlace clave VRF

Anuncie el enlace de la clave VRF:

payload de la transacción symbol-cli –sync –announce
✔ Ingrese la carga útil de la transacción:

Pegue la segunda línea de texto larga de payloads.txt y espere a que se acepte la transacción.

Enlace de la clave de votación

Anuncie el enlace de la clave de votación (si el suyo es un nodo de votación):

symbol-cli transaction payload --sync --announce
✔ Enter the transaction payload:

Pegue la tercera línea de texto largo de payloads.txt y espere a que se acepte la transacción.

Inicie el nodo

Si se confirmaron todas las transacciones de enlaces clave, el nodo ahora está configurado y finalmente puede iniciarlo.

Vaya al directorio que contiene el target de destino copiado de la máquina de configuración e inicie el nodo:

symbol-bootstrap start

No se requieren otros parámetros, la configuración ya está presente en el directorio target y Symbol Bootstrap la usará.

info Password has been provided
info The generated preset target/preset.yml already exist, ignoring configuration. (run -r to reset or –upgrade to upgrade)
…

Su nodo ahora debería estar en funcionamiento y su clave privada principal nunca ha salido de la máquina de configuración (fuera de línea).

Para mayor seguridad, ahora puede convertir la cuenta principal del nodo en una cuenta multifirma. Esto es útil, por ejemplo, para proveedores de nodos que trabajan sin custodia. Lea sobre este proceso en la guía de configuración de nodos sin custodia.

Esta es una traducción al español del artículo original (en inglés) escrito en la Plataforma Oficial de Symbol  . Traducido y editado por NEM en Español. Juntos estamos haciendo que NEM sea más fuerte y que Symbol sea más brillante.

Para más información y noticias sobre NEM, le invitamos a seguirnos en nuestras redes sociales: Facebook, Twitter e Instagram 

Esta guía lo lleva a través del proceso de configuración de un nodo para unirse a la red de Symbol sin usar Symbol Bootstrap.

Symbol Bootstrap es una herramienta muy útil que permite el despliegue rápido de los nodos de Symbol, Sin embargo se basa en la tecnología Docker y node.js que puede no estar disponible (o permitida) en todos los escenarios. Esta guía toma la ruta más larga y explica cómo configurar un nodo de Symbol manualmente. Si desea utilizar Symbol Bootstrap, utilice esta guía en su lugar.

La siguiente sección explica cómo construir un nodo de pares y la siguiente expande el nodo para convertirlo en un nodo API.

Nota

Las siguientes instrucciones solo se han verificado para funcionar en Linux.

Construye un nodo Pares

Construye el servidor

Siga las instrucciones del servidor Catapult para construir sus binarios, ya sea manualmente o usando Conan.

Generar claves

Un nodo de Symbol requiere varias claves para funcionar correctamente. Estas claves generalmente se generan de forma aleatoria, por lo que debe generar algunas para usar en los siguientes pasos.

Este paso se puede realizar en una máquina fuera de línea para mayor seguridad.

Principal, remoto y VRF

Desde el directorio _build que creó en la sección anterior, ejecute:

./bin/catapult.tools.addressgen --count 3 --network public

Esto generará 3 pares de claves similares a este:

address (public): NDPPBHSMLVEU75DNUMFX6GWPTGB6PP6AFQU7WSY
   address decoded: 68DEF09E4C5D494FF46DA30B7F1ACF9983E7BFC02C29FB4B
      public key: 1E886BA00B4F85DBC0B31DBB78DADFAA29945DF7290DB7A4243D94864483C627
      private key: 3DDDC333029BC8ACDB460435BBC71041D460B911725B03D6F93805521AAD60CB

Cada bloque es un par de claves (hay un bloque que se muestra arriba) compuesto por una clave privada, una clave pública y una dirección.

Cópielos todos en un archivo de texto temporal para su uso posterior y etiquete los pares de claves Main, Remote y VRF.

Nota

Si ya tiene alguna de estas claves, puede usarlas en lugar de las generadas aleatoriamente.

El escenario más relevante es cuando se utiliza una cuenta principal habilitada desde una cuenta NIS1. En este caso, puede usar directamente la clave obtenida en el proceso de suscripción como clave principal en lugar de la clave generada.

Votación

Si su nodo va a ser un nodo de votación, debe haber vinculado una clave de votación para el período en el que desea votar. Esto es interesante ya que los nodos de votación reciben recompensas de votación.

La generación de la clave de votación es un poco más compleja que las anteriores:

1. Aún desde dentro del directorio _build, cree otro directorio llamado votekeys.
2. Cree la clave de votación:

Las claves de votación se diferencian de las demás claves en el hecho de que tienen un período de validez, por ejemplo. Solo son válidas desde una Época inicial hasta una Época final (consulte el recuadro lateral).

Los nodos solo son elegibles como votantes si están vinculados a una clave de votación válida para la época actual de blockchain, así que recuerde renovar su clave de votación periódicamente

Para ayudarlo con esa tarea, puede tener hasta 3 claves de votación vinculadas, con diferentes períodos, para que pueda renovar fácilmente una clave mientras todavía hay otra activa (deberá desvincular una clave anterior para poder vincular más de 3 llaves).

Épocas

La votación ocurre una vez en cada época. Una época de votación dura 1440 bloques o alrededor de 12 h (consulte voteSetGrouping en las propiedades de la red).

La duración máxima de la clave de votación (End Epoch – Start Epoch) es de 360 épocas o aproximadamente 6 meses (consulte maxVotingKeyLifetime).

Puede averiguar la época actual dividiendo la altura actual de la cadena de bloques por 1440 y descartando los decimales.

Una clave de votación se crea usando catapult.tools.votingkey y proporcionando su período de validez (tenga en cuenta que no se usa catapult.tools.addressgen como antes):

bin/catapult.tools.votingkey --output votingkeys/private_key_tree1.dat \
                             --startEpoch 100 --endEpoch 460

Esto crea un archivo llamado votekeys / private_key_tree1.dat e imprime la clave de votación en la terminal. A medida que expiren sus claves de votación y cree otras nuevas, aumente el número en el nombre del archivo.

generating 361 keys, this might take a while
votingkeys\private_key_tree1.dat generated
verifying generated file
 saved voting public key: ****************
loaded voting public key: ****************

Copie la clave pública de la clave de votación en el archivo de texto temporal donde guarda el resto de las claves, etiquétela como Voto y guárdela para más tarde.

Configuración

Symbol es altamente personalizable y esto significa que hay muchos parámetros que se pueden ajustar para satisfacer las necesidades de su nodo. Algunos de estos parámetros están relacionados con la red y deben coincidir con el resto de nodos de la red (por ejemplo, currencyMosaicId), mientras que otros están relacionados con los nodos y puede configurarlos libremente (por ejemplo, friendlyName).

Puede editar estos archivos manualmente (eche un vistazo a estas plantillas para saber cómo se ven), pero es más conveniente utilizar la Herramienta de Configuración del nodo de Symbol como se muestra a continuación.

Este paso se puede realizar en una máquina fuera de línea para mayor seguridad.

• Prerrequisitos
  • Instale Python 3.
  • Instale OpenSSL (por ejemplo, ejecutando sudo apt install openssl en Linux).
• Install symbol-node-configurator.
  • Descargue y extraiga symbol-node-configurator.zip. Alternativamente, clone el repositorio de GitHub si sabe cómo usar Git.
  • Vaya al directorio symbol-node-configurator e instale los requisitos de la herramienta ejecutando:

python3 -m pip install -r requirements.txt

• Cree certificados
  • Cree una carpeta llamada certificados y muévase a ella.
  • Cree un archivo de texto llamado private.main.txt y coloque la clave privada de la cuenta principal dentro.
  • Descargue y ejecute este script de generación de certificados.
  • Elimina private.main.txt.
  • Vuelve a la carpeta principal.

Ahora deberías tener al menos los siguientes archivos en la carpeta de certificados: ca.pubkey.pem, ca.crt.pem, node.full.crt.pem, node.crt.pem y node.key.pem.

• Cree archivos de claves de cosecha y VRF
  • Cree un archivo llamado private.harvesting.txt y coloque la clave privada remota dentro.
  • Cree un archivo llamado private.vrf.txt y coloque la clave privada VRF dentro.

• Ejecute la herramienta de configuración

La herramienta de configuración de nodos se llama generator.py y acepte una serie de parámetros según el tipo de nodo que desee:

Parametro	Descripción
--mode	(Obligatorio) Tipo de nodo. Los valores aceptados son api, peer and dual.
--harvesting	(Opcional) Para crear un nodo de cosecha. La llave remota se utilizará automáticamente para que la cosecha remota esté habilitada de forma predeterminada.
--voting	(Opcional) Para crear un nodo de votación. Si habilita esto, copie el archivo private_key_tree1.dat que creó anteriormente en este directorio.
--output	(Opcional) Carpeta donde se almacenará la configuración resultante.

Por ejemplo:

python3 generator.py --mode dual --harvesting --voting --output settings
  i     | extracting nemesis seed
  i     | preparing base settings
  i     | turning on harvesting
  i     | turning on voting
  i     | extracting mongo scripts
  i     | copying certificates
  i     | moving private_key_tree1.dat

Este comando producirá todos los archivos de configuración de nodo requeridos en el directorio de configuración y debe copiarlos en _build, en la máquina donde se ejecutará su nodo:

• Copiar settings/resources to _build/resources.
• Copiar settings/certificates to _build/certificates.
• Copiar settings/nemesis/seed to _build/seed (Omitir la parte de némesis).

• Edite config-user.properties
  • Regrese al directorio _build.
  • Edite resources / config-user.properties para que apunte a los lugares correctos:

seedDirectory = ../seed
certificateDirectory = ../certificates
dataDirectory = ../data
pluginsDirectory = ../lib
votingKeysDirectory = ../votingkeys

• Edite config-node.properties

Edite resources / config-node.properties para personalizar el nodo. Obtenga más información sobre las propiedades disponibles en la guía Configuración de propiedades del nodo.

Los más comunes están en la sección [localnode]:

Propiedades	Descripción
host	Dirección IP o nombre de dominio de su nodo.
friendlyName	Nombre de su nodo para fines de visualización.
version	Versión de catapult-server utilizada por su nodo. Déjelo vacío para usar el actual.
roles	Una lista separada por comas de los siguientes valores: Peer, Api, Voting, IPv4, IPv6.

Por ejemplo:

[localnode]
host = <YOUR_NODE_IP>
friendlyName = myPeerNode
version = 1.0.0.0
roles = IPv4,Peer

Ejecutar el servidor

Cree una última carpeta:

mkdir data

¡Y finalmente encienda el servidor!

cd bin
./catapult.server

Debería ver una gran cantidad de resultados de depuración mientras el nodo comienza a sincronizarse con el resto de la red:

... peer returned 42 blocks (heights 2 - 43)

El nodo puede detenerse presionando Ctrl-C y reiniciarse simplemente ejecutando catapult.server nuevamente.

Si no ve ningún mensaje de error, su servidor está funcionando y puede continuar con esta guía.

Vincular las claves

El servidor ahora se está ejecutando, pero no podrá cosechar porque es necesario vincular varias claves. Estos enlaces se crean a través de transacciones anunciadas a la red.

Estas transacciones se pueden anunciar desde CUALQUIER máquina. En particular, esto se puede hacer desde una máquina que no sea la que ejecuta su nodo, por lo que la clave privada de su cuenta principal nunca se almacena en el nodo.

Utilizará la herramienta symbol-cli para esto. Instale symbol-cli ejecutando:

npm install --global symbol-cli

Todas las transacciones se enviarán desde (y las tarifas pagadas por) su cuenta principal, por lo que debe informar a symbol-cli al crear un perfil.

Nota

Este perfil contendrá la clave privada de su cuenta principal en forma encriptada. Se solicitará una contraseña cada vez que se acceda.

El perfil se almacena en ~ / symbol-cli.config.json. Puede eliminar este archivo una vez que haya terminado con symbol-cli.

• Abra este archivo y elija cualquiera de los hosts enumerados en las líneas que comienzan con “host” :. Utilizará esto en el siguiente comando en lugar de HOST.

Ejecutar:

$ symbol-cli profile import --network MAIN_NET --url http://HOST:3000 --default
✔ Enter a profile name: ... Main
✔ Enter your wallet password: ... *********
✔ Select an import type: › PrivateKey
✔ Enter your account private key: ... ********************************

• Ingrese un nombre para su perfil (por ejemplo, Principal).
• Ingrese una contraseña para proteger el perfil.
• Seleccione PrivateKey como tipo de importación.
• Ingrese su clave privada principal.

La información del perfil se almacena (encripta) en ~ / symbol-cli.config.json y symbol-cli ahora está listo para usar.

Nota

Todos los enlaces clave creados en las siguientes subsecciones se pueden deshacer en cualquier momento al anunciar una transacción de desvinculación equivalente (–action Unlink). Por lo tanto, siempre puede corregir cualquier error o cambiar la configuración de su nodo (aunque cada transacción tiene una tarifa).

Llave remota

Configuró el nodo para firmar los bloques creados con la clave remota, pero las tarifas de recolección deben ir a su cuenta principal. Esto se logra al anunciar una transacción AccountKeyLink:

ymbol-cli transaction accountkeylink --sync --action Link \
           --max-fee 1000000 --mode normal
✔ Enter your wallet password: ... *********
✔ Enter the public key of the remote account:  ********************************

• Ingrese su contraseña de perfil.
• Ingrese su clave pública remota.

...
✔ Do you want to announce this transaction? ... yes
SUCCESS Transaction announced
SUCCESS Transaction confirmed

Clave VRF

Para ser elegible para la cosecha, una cuenta debe tener vinculada una clave VRF. Esto se logra al anunciar una transacción VrfKeyLink:

symbol-cli transaction vrfkeylink --sync --action Link \
                       --max-fee 1000000 --mode normal
✔ Enter your wallet password: ... *********
✔ Enter the public key to link: ... ********************************

• Ingrese su clave pública VRF.

Clave de votación

Si su nodo va a ser un nodo de votación, debe vincular la clave de votación que generó anteriormente. El enlace se logra al anunciar una transacción VotingKeyLink:

symbol-cli transaction votingkeylink --sync --action Link \
            --max-fee 1000000 --mode normal
✔ Enter your wallet password: ... *********
✔ Enter the public key of the voting key account:  ****************
✔ Enter the start point: ... 100
✔ Enter the end point: ... 460

• Ingrese su contraseña de perfil.
• Ingrese la clave pública de votación que obtuvo anteriormente.
• Ingrese las épocas de inicio y finalización que utilizó al crear la clave de votación.

✔ Do you want to announce this transaction? ... yes
SUCCESS Transaction announced
SUCCESS Transaction confirmed

Cuando comience la próxima época, si está dentro de las épocas de inicio y finalización de una de sus claves registradas, su nodo debe participar en el proceso de finalización y cosechar recompensas de votación.

Nota

Cada época, al menos el 70% de todos los nodos de votación elegibles deben emitir sus votos o puestos de finalización.

Por lo tanto, si planea desconectar su nodo (por ejemplo, para mantenimiento), es importante que desvincule sus claves de votación para ese período para que la finalización no se vea afectada.

Construye un nodo de API

Una vez que tenga Catapult Server en ejecución, puede agregar servicios adicionales para convertirlo en un nodo API:

Como se muestra en el diagrama anterior, además del servidor Catapult también necesitará:

• Una base de datos que contiene los datos REST.
• Un Catapult Broker serializa los accesos a la base de datos.
• Una puerta de enlace REST que acepta solicitudes de clientes y las convierte en comandos de servidor o consultas de base de datos.

Las siguientes secciones explican cómo instalar cada servicio. Los necesitará todos.

Vaya a la carpeta _build creada durante la construcción del servidor y cree las carpetas adicionales solicitadas en los siguientes pasos dentro de _build.

Ejecutar la base de datos

• Instale MongoDB (al menos la versión 4.4).

Se recomienda seguir las propias instrucciones de instalación del programa y NO instalar desde los paquetes de su distribución.

• Cree un directorio para almacenar los archivos de datos y ejecutar la base de datos:

mkdir dbfiles
mongod --dbpath=dbfiles --wiredTigerCacheSizeGB 2 --bind_ip 127.0.0.1

Mantenga mongod funcionando mientras se ejecute su nodo.

• Genere índices para optimizar los accesos a la base de datos.

El repositorio de catapult-server que clonaste para construir el servidor en el primer paso contiene una carpeta con scripts mongo. Ejecuta este:

mongo 127.0.0.1/catapult < ../scripts/mongo/mongoDbPrepare.js

Sin este paso, el rendimiento de la base de datos será inaceptablemente lento.

Ejecutar el broker

• Edite resources/config-database.properties y los puntos databaseUri to 127.0.0.1:27017:

[database]

databaseUri = mongodb://127.0.0.1:27017
databaseName = catapult

• Ejecutar el broker:

Muévase al directorio bin y ejecute:

./catapult.broker ..

Mantenga el intermediario en ejecución mientras se ejecute su nodo.

Construya y ejecute la puerta de enlace REST

Clone el repositorio de catapult-rest e instale sus dependencias:

(Volviendo al directorio _build primero)

cd ..
git clone https://github.com/nemtech/catapult-rest.git
cd catapult-rest
npm install -g yarn
./yarn_setup.sh

• Construya la puerta de enlace REST:

cd rest
yarn build

• Configure la puerta de enlace REST:

Toda la configuración se almacena en el archivo resources / rest.json.

Edite este archivo para asegurarse de que las siguientes propiedades apunten a los archivos correctos:

Property	File	Default location
tlsClientCertificatePath	node.crt.pem	_build/certificate/
tlsClientKeyPath	node.key.pem	_build/certificate/
tlsCaCertificatePath	ca.crt.pem	_build/certificate/
networkPropertyFilePath	config-network.properties	_build/resources/
nodePropertyFilePath	config-node.properties	_build/resources/

Utilice caminos absolutos. Por ejemplo:

{
   "host": "127.0.0.1",
   "port": 7900,
   "timeout": 1000,
   "tlsClientCertificatePath":
         "/home/symbol/catapult-server/_build/certificate/node.crt.pem",
   "tlsClientKeyPath":
         "/home/symbol/catapult-server/_build/certificate/node.key.pem",
   "tlsCaCertificatePath":
         "/home/symbol/catapult-server/_build/certificate/ca.crt.pem",
   "networkPropertyFilePath":
         "/home/symbol/catapult-server/_build/resources/config-network.properties",
   "nodePropertyFilePath":
         "/home/symbol/catapult-server/_build/resources/config-node.properties"
}

• Ejecute la puerta de enlace REST:

node _build/index.js resources/rest.json

Mantenga la puerta de enlace REST en funcionamiento mientras se ejecute su nodo.

Verificación

Si la puerta de enlace REST funciona correctamente, ahora puede realizar consultas en el puerto 3000. Si Catapult Server, Broker y MongoDB funcionan correctamente, los valores devueltos por REST se sincronizarán correctamente con el resto de la cadena de bloques.

Apunte un navegador a las siguientes URL y verifique que los valores devueltos sean similares a los esperados:

http: // localhost: 3000 / node / info: Estado de los servicios.

{
“status”:{
“apiNode”:”up”,
“db”:”up”
}
}

http: // localhost: 3000 / chain / info: conexión del nodo a la red.

{
   "scoreHigh": "0",
   "scoreLow": "11485261672816562840",
   "height": "161138",
   "latestFinalizedBlock": {
      "finalizationEpoch": 224,
      "finalizationPoint": 44,
      "height": "160560",
      "hash": "52D3B01920C695B9194FABD869804E4D2A18D9B5509E47B2C70B0E6C3E275E33"
   }
}

El campo de altura debe coincidir con la altura real de la cadena de bloques, pero, al iniciar el nodo por primera vez, la sincronización puede llevar un tiempo.

Finalmente, vaya a la página del Explorador de Symbol y verifique que su nodo aparezca en la lista (se actualiza cada 30 segundos).

Esta es una traducción al español del artículo original (en inglés) escrito en la Plataforma Oficial de Symbol . Traducido y editado por NEM en Español. Juntos estamos haciendo que NEM sea más fuerte y que Symbol sea más brillante.

Para más información y noticias sobre NEM, le invitamos a seguirnos en nuestras redes sociales: Facebook, Twitter e Instagram