Saltar al contenido principal

Comandos del nodo

Referencia de los comandos qorechaind utilizados para inicializar, configurar y operar un nodo de QoreChain.

nota

QoreChain opera dos redes: la mainnet qorechain-vladi (activa desde el 7 de junio de 2026; versión del nodo v3.2.7, aplicada en la altura 4,164,600 el 12 de noviembre de 2026 por la propuesta de gobernanza 16; la v3.2.6 se aplicó en la altura 4,020,000 el 4 de noviembre de 2026; la v3.2.5 se aplicó en la altura 3,906,833 el 29 de octubre de 2026, la v3.2.4 en la altura 3,742,566 el 23 de octubre de 2026 y la v3.2.3 en la altura 3,662,051 el 20 de octubre de 2026) y la testnet qorechain-diana (versión del nodo v3.2.8, aplicada en la altura 9,929,500 el 12 de noviembre de 2026, tras la v3.2.7 en la altura 9,594,600 el 6 de noviembre, la v3.2.6 en la altura 8,970,638 el 27 de octubre, la v3.2.5 en la altura 8,890,800 el 26 de octubre y la v3.2.4 en la altura 8,337,253 el 19 de octubre; la mainnet no ha aplicado v3.2.8). Indica el --chain-id correspondiente a la red a la que quieras unirte — los ejemplos a continuación apuntan a la testnet; usa --chain-id qorechain-vladi para la mainnet. La versión actual de cada red figura en latest.json, en download.qore.host.

Los comandos de esta página se comprobaron con el binario de la versión v3.2.3. El binario v3.2.4 añade comandos que un binario v3.2.3 no tiene (por ejemplo stakingtier); se ejecutan en ambas redes (testnet desde el 19 de octubre de 2026, mainnet desde el 23 de octubre de 2026), y cuando este manual menciona uno, lo indica. El binario v3.2.6 (ambas redes) añade dos comandos de consulta más, query rlconsensus applied-params y last-action (consulte Comandos de consulta). Todo lo demás de esta página se comporta igual en ambas versiones.


init​

Inicializa un nuevo nodo con el moniker indicado.

qorechaind init <moniker> --chain-id qorechain-diana
FlagTipoDescripción
--chain-idstringIdentificador de la cadena (indícalo siempre; si se omite, se crea uno aleatorio)
--homestringDirectorio home del nodo (por defecto: ~/.qorechaind)
--overwriteboolSobrescribir el genesis.json existente
--recoverboolProporcionar una frase semilla para recuperar una clave existente en lugar de crear una nueva

Crea la estructura de directorios bajo --home con config/, data/ y un genesis.json inicial. Para un nodo de red, sustituye ese genesis.json por el archivo de genesis de la red antes de iniciar (consulta Conectarse a la Mainnet).

init también escribe el ID de cadena EVM de la red (9801 para qorechain-vladi, 9800 para qorechain-diana) en el ajuste evm-chain-id de app.toml, así que indica el --chain-id correcto.


start​

Inicia el nodo y comienza a sincronizar o producir bloques.

qorechaind start [flags]
FlagTipoDescripción
--homestringDirectorio home del nodo
--minimum-gas-pricesstringPrecio mínimo de gas que acepta este nodo. El mínimo de la red es 0.1uqor; establece al menos ese valor
--pruningstringEstrategia de poda: default, nothing, everything, custom (con --pruning-keep-recent y --pruning-interval)
--halt-heightuintDetener el nodo en esta altura de bloque
--halt-timeuintDetener el nodo en esta marca de tiempo Unix
--log_levelstringVerbosidad del registro: info, debug, warn, error
--traceboolHabilitar traza completa de pila en caso de errores

Un binario compilado a partir del árbol de código fuente público (la compilación de la comunidad) se niega a iniciarse en qorechain-vladi o qorechain-diana: no puede verificar firmas poscuánticas ni reproducir fielmente los bloques de las redes (versión del nodo v3.2.3 y posteriores). Usa el binario de la versión publicado en download.qore.host; consulta Compilar desde el código fuente.


version​

qorechaind version no informa del número de versión en los binarios de las versiones publicadas: imprime una línea vacía, y version --long no añade detalles de compilación. No cuentes con él para distinguir versiones. Para confirmar qué ejecutas:

  • Compara el SHA-256 del archivo descargado con binary.sha256 en el manifiesto de la red antes de extraerlo (y conserva ese archivo, o su checksum, como registro de lo que instalaste).
  • Pregunta a la cadena qué actualizaciones ha aplicado: GET /cosmos/upgrade/v1beta1/applied_plan/<upgrade_name> devuelve la altura en la que se aplicó una actualización, o 0 si no se ha aplicado.
# archive checksum, as published
curl -s https://download.qore.host/mainnet/latest.json | jq -r '.version, .binary.sha256'
# has v3.2.3 / v3.2.4 / v3.2.5 / v3.2.6 / v3.2.7 been applied on mainnet, and at which height? (a name that was not applied returns {"height":"0"})
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.3 # {"height":"3662051"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.4 # {"height":"3742566"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.6 # {"height":"4020000"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.7 # {"height":"4164600"}

status​

Consulta al nodo en ejecución su estado actual, incluyendo el estado de sincronización, la altura del último bloque y la información de consenso.

qorechaind status
FlagTipoDescripción
--nodestringEndpoint RPC (por defecto: tcp://localhost:26657)

Devuelve un JSON con las secciones node_info, sync_info y validator_info.


client configuration​

No existe un subcomando config. Los valores por defecto del cliente (chain-id, keyring-backend, output, node) se leen de <home>/config/client.toml; edita ese archivo o indica el flag en cada comando (--chain-id, --keyring-backend, --output, --node).


keys​

Gestiona el keyring local para firmar transacciones.

Añadir una nueva clave​

qorechaind keys add <name> [flags]
FlagTipoDescripción
--keyring-backendstringBackend: os, file, kwallet, pass, test, memory
--key-typestringAlgoritmo de clave: secp256k1 (por defecto) o eth_secp256k1
--coin-typeuint32Coin type HD (por defecto 118)
--recoverboolRecuperar la clave a partir de la frase mnemónica
--multisigstringLista de claves separadas por comas para multisig
--multisig-thresholduintNúmero mínimo de firmas requeridas

Listar todas las claves​

qorechaind keys list --keyring-backend <backend>

Mostrar detalles de una clave​

qorechaind keys show <name> [flags]
FlagTipoDescripción
--bechstringFormato de salida: acc, val, cons
--addressboolMostrar solo la dirección
--pubkeyboolMostrar solo la clave pública

Eliminar una clave​

qorechaind keys delete <name> --keyring-backend <backend>

Exportar una clave (cifrada con armor)​

qorechaind keys export <name>

Importar una clave​

qorechaind keys import <name> <keyfile>

genesis​

Gestiona el archivo de genesis.

Añadir una cuenta de genesis​

qorechaind genesis add-genesis-account <address> <coins> [flags]
FlagTipoDescripción
--vesting-amountstringMonto de vesting
--vesting-start-timeintHora de inicio del vesting (marca de tiempo Unix)
--vesting-end-timeintHora de finalización del vesting (marca de tiempo Unix)

Crear una transacción de genesis​

qorechaind genesis gentx <key-name> <stake-amount> [flags]
FlagTipoDescripción
--chain-idstringIdentificador de la cadena
--monikerstringMoniker del validador
--commission-ratestringTasa de comisión inicial
--commission-max-ratestringTasa de comisión máxima

Recopilar transacciones de genesis​

qorechaind genesis collect-gentxs

Otros subcomandos de genesis: bulk-add-genesis-account y migrate.

Validar el archivo de genesis​

qorechaind genesis validate

Motor de consenso​

Estos subcomandos interactúan con la capa del motor de consenso de QoreChain.

Mostrar clave del validador​

qorechaind comet show-validator

Muestra la clave pública de consenso en formato JSON. Se usa para verificar la identidad del validador.

Mostrar ID del nodo​

qorechaind comet show-node-id

Muestra el identificador P2P del nodo (codificado en hexadecimal). Se usa para la configuración de pares persistentes.


export​

Exporta el estado actual de la cadena como un archivo de genesis JSON. Útil para actualizaciones de la cadena o snapshots.

qorechaind export [flags]
FlagTipoDescripción
--for-zero-heightboolPreparar la exportación para reiniciar en la altura 0
--heightintExportar el estado en una altura de bloque específica
--homestringDirectorio home del nodo
--output-documentstringEscribir la exportación en este archivo en lugar de STDOUT
--modules-to-exportstringsLista de módulos a exportar separados por comas (por defecto: todos)
--jail-allowed-addrsstringsDirecciones de operador de los validadores encarcelados (jailed) que se van a liberar

rollback​

Revierte el estado de la cadena un bloque. Útil para recuperarse de un fallo de consenso.

qorechaind rollback [flags]
FlagTipoDescripción
--hardboolEliminar también el último bloque del almacén de bloques
--homestringDirectorio home del nodo

Este comando revierte tanto el estado de la aplicación como el estado de consenso. Úsalo con precaución, ya que no se puede deshacer.