Saltar al contenido principal

Conexión a la Mainnet

Únete a la mainnet activa de QoreChain Vladi configurando tu nodo con el archivo genesis oficial, los peers y los ajustes de red.

nota

Esta página cubre la mainnet qorechain-vladi (chain ID EVM 9801, hex 0x2649), activa desde el 7 de junio de 2026 y ejecutando la versión v3.2.7 sobre Cosmos SDK v0.53 desde el 12 de noviembre de 2026 (aplicada en la altura 4,164,600, los bloques se reanudaron hacia las 15:01 UTC, por la propuesta de gobernanza 16; v3.2.6 se había aplicado en la altura 4,020,000 el 4 de noviembre de 2026). Para la testnet qorechain-diana (chain ID EVM 9800), consulta Conexión a la Testnet y ensaya allí tu configuración antes de pasar a producción.

Endpoints públicos​

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

ServicioURL
RPC de consensohttps://rpc.qore.host (WebSocket: wss://rpc.qore.host/websocket)
REST de Cosmos (LCD)https://api.qore.host
JSON-RPC EVMhttps://evm.qore.host (chain ID 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 tal como se describe a continuación.

Los hosts públicos son compartidos y tienen límites (tasa de solicitudes, tamaños del RPC de SVM, filtros EVM); eth_call y la estimación de gas pasan por el host JSON-RPC de EVM. Consulte Límites de los endpoints públicos.


Instalación​

Instala el binario qorechaind a partir del paquete prebuilt oficial o compilándolo desde el código fuente.

Paquete de binario prebuilt (linux/amd64)​

La fuente de verdad canónica para el binario actual es el manifiesto de mainnet, un archivo JSON actualizado en vivo en https://download.qore.host/mainnet/latest.json. Contiene la URL y el SHA-256 del binario actual, la URL/SHA-256/tamaño del genesis actual, las listas actuales de peers y seeds, el puerto P2P, un punto de confianza para state-sync y la versión mínima de cadena compatible. Descárgalo y usa sus valores en lugar de fijar en tus scripts de instalación una versión de binario o un checksum: quedan obsoletos en cuanto se publica una nueva versión:

curl -s https://download.qore.host/mainnet/latest.json -o latest.json

BINARY_URL=$(jq -r .binary.url latest.json)
BINARY_SHA256=$(jq -r .binary.sha256 latest.json)

curl -fsSL "$BINARY_URL" -o qore.tgz
echo "${BINARY_SHA256} qore.tgz" | sha256sum -c -

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

El paquete contiene qorechaind junto con sus bibliotecas compartidas necesarias (libqorepqc.so, libqoresvm.so, libwasmvm.x86_64.so y, desde v3.2.8, libwasmvmqore_v1.x86_64.so). Copia el directorio lib/ completo, no archivos sueltos.

Mantén tu nodo actualizado — v3.2.3 y después v3.2.4

Los nodos completos deben seguir la versión activa de la red: instala siempre el binario que indica el manifiesto, no fijes uno antiguo. El manifiesto actual (comprobado el 12 de noviembre de 2026) es v3.2.7 con minCompatible 3.2.7 y upgradeHeight 4,164,600: la mainnet aplicó v3.2.7 en esa altura el 12 de noviembre de 2026 mediante la propuesta de gobernanza 16 (los bloques se reanudaron hacia las 15:01 UTC), y un nodo que siga en una versión anterior no puede seguir la cadena más allá de esa altura. El paquete es qorechaind-v3.2.7-b3-linux-amd64.tar.gz (99,472,930 bytes, SHA-256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5). El manifiesto indica copiar toda la carpeta lib/ del paquete; para v3.2.7 contiene libqorepqc.so, libqoresvm.so y libwasmvm.x86_64.so. Un nodo que siga en v3.2.6 y se haya perdido la actualización se detiene en la altura 4,164,600 con UPGRADE "v3.2.7" NEEDED, y la solución es instalar este paquete (con su carpeta lib/) y reiniciar (el estado se conserva). Las actualizaciones de gobernanza anteriores en la mainnet fueron v3.1.94 en la altura 2,122,074 (el tope de emisión), v3.2.0 en la altura 2,981,742 (la ventana de autorización EVM y los bytes de firma híbrida v2), v3.2.2 en la altura 3,556,788 (16 de octubre de 2026, propuesta 7), v3.2.3 en la altura 3,662,051 (20 de octubre de 2026, propuesta 11), v3.2.4 en la altura 3,742,566 (23 de octubre de 2026, propuesta 13), v3.2.5 en la altura 3,906,833 (29 de octubre de 2026, propuesta 14) y v3.2.6 en la altura 4,020,000 (4 de noviembre de 2026, propuesta 15). v3.2.1 fue una versión local del nodo sin altura. La firma de transacciones no cambió en v3.2.6; v3.2.7 añade el modo de firma textual como opción adicional. Un nodo que se une desde cero necesita el binario v3.2.7 que indica el manifiesto; prefiere el state sync (más abajo) a reproducir desde el genesis. El snapshot de datos de la cadena publicado es anterior a todas estas alturas de actualización, así que un nodo restaurado a partir de él debe reproducirlas.

Establece evm-chain-id = 9801 en app.toml (un valor distinto se registra como error) y mantén el reloj del sistema sincronizado por NTP: un nodo se detiene si su reloj se desvía más de 60 segundos. Comprueba siempre los campos "version" y "minCompatible" del manifiesto antes de confiar en binary.url: el manifiesto se promueve de forma deliberada (primero en testnet, en mainnet después de un período de estabilización). El formato de firma, las direcciones, los decimales, los memos y las comisiones no cambiaron en v3.2.3 ni en v3.2.4.

La testnet (qorechain-diana) ejecuta v3.2.8, una versión por delante de la mainnet (aplicó la v3.2.5 el 26 de octubre de 2026, la v3.2.6 el 27 de octubre de 2026, la v3.2.7 el 6 de noviembre de 2026 y la v3.2.8 el 12 de noviembre de 2026; la mainnet no ha aplicado la v3.2.8). Nunca copies un binario de una red a la otra: sigue siempre el manifiesto de la red que ejecutas.

Cuando se programa una actualización coordinada, el texto de la propuesta indica la altura y te dice que permanezcas en la versión anterior hasta entonces: el nodo se detiene en esa altura y lo reinicias con el nuevo binario. Lee el status de la propuesta (curl -s https://api.qore.host/cosmos/gov/v1/proposals/<id>) y los campos version y upgradeHeight del manifiesto de mainnet antes de cambiar cualquier binario, y no instales nunca un binario de actualización antes de su altura: un nodo que lo lleve antes también se detiene. El 12 de noviembre de 2026 no había ningún plan de actualización establecido (curl -s https://api.qore.host/cosmos/upgrade/v1beta1/current_plan devolvía "plan": null). La última, la propuesta de gobernanza 16, aplicó la v3.2.7 (build 3) en la altura 4,164,600 el 12 de noviembre de 2026 (la anterior, la propuesta 15, aplicó la v3.2.6 en la altura 4,020,000 el 4 de noviembre de 2026); el manifiesto anterior es la fuente de verdad de lo que instala un nodo nuevo.

Compilar desde el código fuente (solo desarrollo)​

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

Esto compila el binario de la comunidad con keepers stub y sin firmante poscuántico, que no puede reproducir el estado de consenso de las redes ni crear transacciones con firma híbrida. Para ejecutar un nodo en mainnet, instala el binario de la versión indicado arriba. Consulta Compilación desde el código fuente para ver todos los requisitos previos (Go 1.26+, CGO, 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 genesis​

Reemplaza tu archivo genesis local por el genesis oficial de mainnet, usando la URL y el SHA-256 del manifiesto descargado anteriormente:

GENESIS_URL=$(jq -r .genesis.url latest.json)
GENESIS_SHA256=$(jq -r .genesis.sha256 latest.json)

curl -fsSL "$GENESIS_URL" -o ~/.qorechaind/config/genesis.json
echo "${GENESIS_SHA256} $HOME/.qorechaind/config/genesis.json" | sha256sum -c -

El mismo archivo también lo sirve en vivo la propia cadena, por lo que puedes verificar la descarga cruzá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 mainnet Vladi, incluyendo el conjunto de validadores del genesis, las asignaciones de tokens (TGE en el genesis) y los parámetros de los módulos.


Configurar los peers​

Edita la configuración de tu nodo para conectarte a los nodos sentry públicos de mainnet. Lee las listas actuales de peers y seeds desde el manifiesto en lugar de fijar IDs de nodo y hosts: estos rotan:

PEERS=$(jq -r '.peers | join(",")' latest.json)
SEEDS=$(jq -r '.seeds | join(",")' latest.json)

Abre ~/.qorechaind/config/config.toml y establece los campos persistent_peers (y seeds) con esos valores:

persistent_peers = "<value of $PEERS>"
seeds = "<value of $SEEDS>"

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

minimum-gas-prices = "0.1uqor"

Ajustes recomendados​

Un nodo completo no elige el tiempo de bloque: lo eligen los validadores (la mainnet produce actualmente un bloque cada 3,1 segundos aproximadamente). Deja los timeouts de consenso en sus valores por defecto, a menos que operes un validador y el grupo de validadores te haya dado valores. Un ajuste útil de mempool para un nodo RPC público, en config.toml:

[mempool]
size = 5000

Arranque rápido (snapshot o state sync)​

Sincronizar desde el genesis puede tardar mucho tiempo. El campo stateSync del manifiesto lleva un par de altura/hash de confianza actualizado cada hora; úsalo para configurar el state sync en lugar de buscar una altura manualmente:

TRUST_HEIGHT=$(jq -r .stateSync.trustHeight latest.json)
TRUST_HASH=$(jq -r .stateSync.trustHash latest.json)

Luego establece la sección [statesync] de config.toml con esos valores; consulta Ejecutar un nodo para ver el flujo completo, incluyendo un método manual basado en RPC como alternativa si necesitas derivar tú mismo un punto de confianza.

El manifiesto también incluye un snapshot de los datos de la cadena (snapshot.url, snapshot.sha256, snapshot.height). Lee los valores del manifiesto en lugar de fijar un nombre de archivo o una altura, ya que un nuevo snapshot sustituye al anterior. El snapshot es grande (decenas de gigabytes) y, tal como se publicó en octubre de 2026, se tomó en la altura 1,966,629 (21 de agosto de 2026), antes de todas las alturas de actualización indicadas arriba, por lo que un nodo restaurado a partir de él debe reproducir esas actualizaciones; el state sync suele ser más rápido y lo evita:

SNAPSHOT_URL=$(jq -r .snapshot.url latest.json)
SNAPSHOT_SHA256=$(jq -r .snapshot.sha256 latest.json)

curl -fsSL "$SNAPSHOT_URL" -o snapshot.tar.gz
echo "${SNAPSHOT_SHA256} snapshot.tar.gz" | sha256sum -c -

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

Iniciar el nodo​

Lanza tu nodo para empezar a sincronizar con la red:

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

El nodo se conecta a los peers y empieza a descargar bloques (desde el genesis, o desde la altura del snapshot si restauraste uno).


Comprobar el estado de sincronización​

Verifica que tu nodo está poniéndose 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 en bruto están disponibles en:

http://localhost:26660/metrics

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

Paneles de Grafana​

Si lo ejecutas 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 throughput de transacciones, las conexiones de peers y el uso de recursos.

Comprobación de salud REST​

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

http://localhost:1317

Referencia de puertos​

PuertoProtocoloDescripción
26657TCPRPC — consultar y difundir 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 (chain ID 9801)
8546WebSocketWebSocket EVM — suscripciones a eventos EVM en tiempo real
8899HTTPRPC SVM — RPC compatible con Solana (solo lectura; el carril de transacciones SVM está deshabilitado)
26660HTTPEndpoint de métricas de Prometheus

Datos de la red​

CampoValor
Chain IDqorechain-vladi
Chain ID EVM9801 (hex 0x2649)
Versión de cadenav3.2.7 (aplicada en la altura 4,164,600 el 12 de noviembre de 2026)
Activa desde7 de junio de 2026
Tiempo de bloqueunos 3,1 segundos (promedio medido)
TokenQOR (uqor, 10^6 micro-unidades = 1 QOR)
Precio mínimo de gas0.1uqor
Prefijo de cuentaqor
Prefijo de validadorqorvaloper
SDKCosmos SDK v0.53

Próximos pasos​