Saltar al contenido principal

Conexión a la red principal

Únete a la red principal activa QoreChain Vladi configurando tu nodo con el archivo génesis oficial, los pares y los ajustes de red.

nota

Esta página cubre la red principal qorechain-vladi (ID de cadena EVM 9801, hex 0x2649), activa desde el 7 de junio de 2026 a las 23:59 UTC y ejecutando la versión de cadena v3.1.85 sobre Cosmos SDK v0.53. Para la red de pruebas qorechain-diana (ID de cadena EVM 9800), consulta Conexión a la red de pruebas y ensaya allí tu configuración antes de ponerla en producción.

Endpoints públicos

Si solo necesitas consultar la cadena o transmitir transacciones, no necesitas tu propio nodo — los endpoints públicos son:

ServicioURL
RPC de consensohttps://rpc.qore.host (WebSocket: wss://rpc.qore.host/websocket)
Cosmos REST (LCD)https://api.qore.host
JSON-RPC EVMhttps://evm.qore.host (ID de cadena 9801)
JSON-RPC SVM (solo lectura)https://svm.qore.host
Explorador de bloquesexplore.qore.network

Para cargas de trabajo intensivas o de producción (exchanges, indexadores), ejecuta tu propio nodo como se describe a continuación.


Instalación

Instala el binario qorechaind desde el paquete oficial precompilado o compilándolo desde el código fuente.

Paquete de binarios precompilados (linux/amd64)

El paquete de la versión oficial contiene qorechaind junto con sus bibliotecas compartidas requeridas (libqorepqc.so, libqoresvm.so, libwasmvm.x86_64.so):

curl -fsSL https://download.qore.host/qorechaind-v3.1.83-linux-amd64.tar.gz -o qore.tgz
# Verify the checksum before installing:
sha256sum qore.tgz
# fa035b3699e92d755f47445cbf7dde4e1f6c224343008546aa159b7eb46a805c

tar xzf qore.tgz
sudo install -m0755 qorechaind /usr/local/bin/
sudo mkdir -p /opt/qorechain/lib && sudo cp lib/*.so /opt/qorechain/lib/
export LD_LIBRARY_PATH=/opt/qorechain/lib

Los paquetes versionados se publican en download.qore.host; cada versión se distribuye con su suma de verificación SHA-256 — instala siempre el paquete publicado más reciente.

Mantén tu nodo actualizado

Los nodos completos deben seguir la versión de cadena de la red (actualmente v3.1.85). Un nodo desactualizado no puede decodificar los tipos de transacción más recientes (por ejemplo, las transacciones firmadas con eth_secp256k1 introducidas en v3.1.83) y dejará de sincronizar en cuanto aparezca una en un bloque.

Compilar desde el código fuente

git clone https://github.com/qorechain/qorechain-core.git
cd qorechain-core
CGO_ENABLED=1 go build -o qorechaind ./cmd/qorechaind/

Consulta Compilar desde el código fuente para conocer todos los requisitos previos (Go 1.26+, CGO, toolchain de Rust, bibliotecas nativas).

Inicializar el nodo

qorechaind init my-node --chain-id qorechain-vladi

Esto crea los directorios de configuración y de datos por defecto en ~/.qorechaind/.


Descargar el génesis

Reemplaza tu archivo génesis local por el génesis oficial de la red principal:

curl -fsSL https://download.qore.host/genesis.json -o ~/.qorechaind/config/genesis.json

El mismo archivo también lo sirve en vivo la propia cadena — puedes verificar la descarga contrastándola con él:

curl -s https://rpc.qore.host/genesis | jq '.result.genesis' > /tmp/genesis-live.json

Este archivo define el estado inicial de la red principal Vladi, incluido el conjunto de validadores del génesis, las asignaciones de tokens (TGE en el génesis) y los parámetros de los módulos.


Configurar pares

Edita la configuración de tu nodo para conectarte a los nodos centinela públicos de la red principal.

Abre ~/.qorechaind/config/config.toml y establece el campo persistent_peers:

persistent_peers = "0c9b83801ad519671daf19387b6635f72cb9ddd3@44.200.237.4:26656,83cab9ae05d17073c4e45c25d2422b25fff71fe7@35.174.136.254:26656"

Establece también el precio mínimo de gas en ~/.qorechaind/config/app.toml (el mínimo de comisiones de la red es 0.1uqor):

minimum-gas-prices = "0.1uqor"

Ajustes recomendados

Puede que también quieras ajustar lo siguiente en config.toml:

[mempool]
size = 5000

[consensus]
timeout_propose = "3s"
timeout_commit = "5s"

Estos valores están afinados para los tiempos de bloque y el rendimiento de la red principal Vladi.


Arranque rápido (snapshot)

Sincronizar desde el génesis puede llevar mucho tiempo. Se publica un snapshot reciente de los datos de la cadena en download.qore.host:

curl -fsSL https://download.qore.host/qore-vladi-snapshot-90833.tar.gz -o snapshot.tar.gz
# Verify before extracting:
sha256sum snapshot.tar.gz
# ebe469796ad96e692877846c7bfd8513d773321c77e415b1358790b7c4e53396

tar xzf snapshot.tar.gz -C ~/.qorechaind/

Los snapshots se publican con nombres de archivo marcados con la altura de bloque — consulta download.qore.host para obtener el más reciente. Como alternativa, usa state sync — consulta Ejecutar un nodo para ver el flujo de trabajo completo.


Iniciar el nodo

Lanza tu nodo para comenzar a sincronizar con la red:

qorechaind start --minimum-gas-prices=0.1uqor

El nodo se conecta a los pares y comienza a descargar bloques (desde el génesis, o desde la altura del snapshot si restauraste uno).


Comprobar el estado de sincronización

Verifica que tu nodo se está poniendo al día con el último bloque:

curl localhost:26657/status | jq '.result.sync_info.catching_up'
  • true — El nodo todavía está sincronizando. Espera a que se ponga al día.
  • false — El nodo está completamente sincronizado y procesando bloques nuevos.

También puedes comprobar la altura del último bloque:

curl localhost:26657/status | jq '.result.sync_info.latest_block_height'

Confirma que estás en la red correcta — el campo network debe indicar qorechain-vladi:

curl localhost:26657/status | jq '.result.node_info.network'

Monitorización

QoreChain expone varios endpoints para monitorizar la salud y el rendimiento del nodo.

Métricas de Prometheus

Las métricas sin procesar están disponibles en:

http://localhost:26660/metrics

Estas métricas pueden ser recolectadas por cualquier colector compatible con Prometheus.

Paneles de Grafana

Si se ejecuta mediante Docker Compose, Grafana está disponible en:

http://localhost:3001

En el primer inicio de sesión, establece tus propias credenciales cuando se te solicite — no dejes las credenciales por defecto. Los paneles preconfigurados muestran la producción de bloques, el rendimiento de transacciones, las conexiones con pares y el uso de recursos.

Comprobación de estado REST

La API REST proporciona un endpoint de estado rápido:

http://localhost:1317

Referencia de puertos

PuertoProtocoloDescripción
26657TCPRPC — consultar y transmitir transacciones
26656TCPP2P — comunicación de red entre pares
1317HTTPAPI REST — consultar el estado de la cadena vía HTTP
9090gRPCAPI gRPC — acceso programático a la cadena
8545HTTPJSON-RPC EVM — RPC compatible con Ethereum (ID de cadena 9801)
8546WebSocketWebSocket EVM — suscripciones a eventos EVM en tiempo real
8899HTTPRPC SVM — RPC compatible con Solana
26660HTTPEndpoint de métricas de Prometheus

Datos de la red

CampoValor
ID de cadenaqorechain-vladi
ID de cadena EVM9801 (hex 0x2649)
Versión de cadenav3.1.85
Activa desde7 de junio de 2026, 23:59 UTC
TokenQOR (uqor, 10^6 microunidades = 1 QOR)
Precio mínimo de gas0.1uqor
Prefijo de cuentaqor
Prefijo de validadorqorvaloper
SDKCosmos SDK v0.53

Próximos pasos