Preguntas frecuentes y resolución de problemas
¿Está la mainnet en funcionamiento?
Sí. La mainnet está en funcionamiento (id de cadena qorechain-vladi, en
funcionamiento desde el 7 de junio de 2026) y ejecuta la versión de cadena v3.2.7 (aplicada en la altura 4,164,600 el 12 de noviembre de 2026, propuesta de gobernanza 16; la v3.2.6 se aplicó en la altura 4,020,000 el 4 de noviembre de 2026, propuesta 15; la v3.2.5 se aplicó en la altura 3,906,833 el 29 de octubre de 2026 y la v3.2.4 en la altura 3,742,566 el 23 de octubre de 2026); la testnet ejecuta v3.2.6 desde el 27 de octubre de 2026, v3.2.7 desde el 6 de noviembre y v3.2.8 desde el 12 de noviembre de 2026 (altura 9,929,500; la mainnet no la ha aplicado). El preajuste de testnet (qorechain-diana)
también sigue disponible. Desde el SDK 0.12.0 ambos preajustes usan por defecto los
endpoints públicos; selecciona la red con createClient({ network: "mainnet" }) y
sobrescribe endpoints solo para tu propio nodo. Consulta
Red y endpoints.
¿Por qué mis llamadas van a localhost?
Estás en un SDK anterior a la 0.12.0, cuyos preajustes usan por defecto endpoints de localhost:
actualiza, o pasa un objeto endpoints. Desde la 0.12.0 createClient() y
createClient({ network: "mainnet" }) usan los endpoints públicos, y el preajuste
localnet es el que usa localhost.
const client = createClient({
endpoints: {
rest: "https://api-testnet.qore.host",
rpc: "https://rpc-testnet.qore.host",
evmRpc: "https://evm-testnet.qore.host",
},
});
Si en cambio obtienes "endpoint ... is not configured for the mainnet preset", la llamada
necesita un endpoint que los preajustes públicos no definen (gRPC, un RPC de SVM, el
WebSocket EVM de la mainnet); pásalo en endpoints.
La ruta de firma (connectTx) necesita el endpoint de consenso rpc; las
lecturas de QoreChain Native también lo usan. Las lecturas REST usan rest; las llamadas
EVM usan evmRpc (y las llamadas qor_ también, en un nodo que sirva ese
espacio de nombres). Las URL de la mainnet están en la
referencia de red.
"Cannot find module 'viem'" / "'@solana/web3.js'"
Estas son dependencias de pares de @qorechain/evm y @qorechain/svm
respectivamente. Instálalas en tu proyecto:
npm i @qorechain/evm viem
npm i @qorechain/svm @solana/web3.js
Una llamada a un precompilado lanza "returned no data" / "feature not present"
Los precompilados EVM de QoreChain están compilados en el nodo pero no están
activos en la mainnet, y solo tres están activos en la testnet: solo responden donde
sus direcciones figuran en el parámetro active_static_precompiles del módulo EVM.
Esa lista está vacía en la mainnet; en la testnet contiene los precompilados de
verificación PQC (0x…0A01), de estado de clave PQC (0x…0A02) y de parámetros de
consenso (0x…0C01) (comprobado el 27 de octubre de 2026; la lista de la testnet también contenía el puente cross-VM 0x…0901 desde el 4 de noviembre y el 7 de noviembre de 2026, activo con una lista de permitidos (probado con eth_call), y la de la mainnet seguía vacía), así que el par de IA sigue
sin responder nada allí. Donde un precompilado está inactivo la
llamada devuelve datos vacíos, así que viem informa returned no data ("0x") y el
auxiliar lanza un error (consulta
Precompilados EVM: estado de la red).
En un nodo EVM normal las llamadas fallan del mismo modo. Revisa
GET /cosmos/evm/vm/v1/params y envuelve cada llamada a un precompilado para que
el error se maneje por llamada.
Mi llamada a client.qor falla con -32601
client.qor llama al espacio de nombres JSON-RPC qor_, que ninguna compilación
publicada del nodo sirve; rpc_modules en los endpoints EVM públicos solo lista
eth, net, rpc, txpool y web3. Usa en su lugar una ruta REST, por ejemplo
GET /qorechain/pqc/v1/account/{address} (estado de la clave PQC) o
GET /qorechain/burn/v1/stats, mediante client.rest.get(...). Consulta
el espacio de nombres qor_.
Mis cantidades están desfasadas por un factor de un millón
QOR tiene 10^6 unidades base uqor. Usa toBase / fromBase y haz todas las
operaciones matemáticas en unidades base:
toBase("1.5"); // "1500000"
fromBase("1500000"); // "1.5"
Ten en cuenta que el runtime EVM representa QOR con 18 decimales (convención
de EVM), lo cual es distinto de la base uqor Native de 10^6.
¿Qué paquetes están publicados y dónde?
Todos (comprobado el 12 de noviembre de 2026). El núcleo de TypeScript
(@qorechain/sdk, 0.14.0), el kit de React (@qorechain/react, 0.14.0), el
generador de proyectos create-qorechain-dapp (0.14.0, que también incluye las correcciones de plantillas de la 0.13.1) y los adaptadores EVM/SVM
(@qorechain/evm, @qorechain/svm, 0.14.0) están en npm; el cliente de Python
está en PyPI (pip install qorechain-sdk en 0.14.0, importa qorsdk); el cliente
de Go está en el proxy de módulos
(go get github.com/qorechain/qorechain-sdk/packages/go@v0.14.0); el cliente de
Rust está en crates.io (cargo add qorechain-sdk, 0.14.0); y el cliente de Java
está en Maven Central (io.github.qorechain:qorechain-sdk, 0.14.0, JDK 17 o posterior). Consulta
Instalación para ver los comandos completos por lenguaje.
Mi frase mnemotécnica es rechazada
El SDK valida tanto la lista de palabras BIP-39 como la suma de comprobación
antes de derivar cualquier clave, de modo que una frase con una errata genera un
error en lugar de producir silenciosamente la cuenta equivocada. Vuelve a revisar
las palabras; usa validateMnemonic para probar una frase.
Transacciones híbridas (PQC)
El envío híbrido (clásico + ML-DSA-87) está en funcionamiento y es
obligatorio en la ruta Native: las transacciones Native solo clásicas son
rechazadas en la cadena (chain v3.2.0). Antes de que una transacción híbrida se
verifique con PQC, la clave pública PQC del firmante debe registrarse de forma
explícita con MsgRegisterPQCKeyV2 (una transacción firmada de forma clásica y
exenta del requisito híbrido); incrustar la clave pública en la extensión
(includePqcPublicKey: true) no la registra, y la cadena no registra una
clave en el primer uso. En TypeScript, entrega al cliente el par de claves
(client.connectTx(signer, { pqcKeypair }), SDK 0.9.0 o posterior) y cada transacción que
envíe se firma de forma híbrida.
La cadena acepta cualquier firma ML-DSA-87 válida según FIPS-204, hedged o
determinista. El SDK firma de forma determinista por defecto (desde 0.5.1) para
que una transacción tenga siempre la misma firma y el mismo hash de tx. Si una tx
híbrida falla con el código 21 de pqc (hybrid_verify_failed), la causa es la
versión de los sign-bytes, el chain-id, una biblioteca PQC obsoleta o una clave no
registrada o distinta, nunca la firma hedged.
Ambas redes verifican la forma v2 de los sign-bytes, así que usa el SDK 0.8.1 o
posterior (la 0.14.0 es la actual) y pasa rest (o signBytesVersion): los
constructores lanzan un error en qorechain-vladi / qorechain-diana si no se
indica uno de ellos. Consulta
Solución de problemas del código 21 y
Cuentas y firma PQC.
Mi transacción EVM es rechazada con "no open EVM authorisation window"
Desde chain v3.2.0, el carril EVM admite una transacción solo de una cuenta que
tenga una clave PQC registrada y una ventana de autorización abierta. Registra una
clave, abre una ventana y luego envía. Consulta
Ventana de autorización EVM. Con el SDK,
classifyEvmWindowRejection(err) devuelve "no-pqc-key", "no-window",
"exhausted" o "invalid".
Mis transacciones híbridas fallan en CheckTx con un error de análisis de la transacción
Actualiza el SDK. Las versiones 0.6.0 y anteriores serializaban en JSON la
extensión del cuerpo de la transacción /qorechain.pqc.v1.PQCHybridSignature,
que el decodificador de transacciones de la cadena rechaza en CheckTx. Desde
0.6.1 la extensión se codifica en protobuf (el valor comienza con 0x08) en
los cinco lenguajes: las transacciones híbridas construidas con versiones
anteriores son rechazadas en la cadena, en todos los carriles (incluido
eth-native).
¿Con qué versiones de la cadena funciona el SDK?
El SDK 0.12.0 es la versión de cliente para la cadena v3.2.5 (la mainnet
desde el 29 de octubre de 2026 en la altura 3,906,833; la testnet desde el 26 de
octubre). La mainnet ejecuta la v3.2.7
(desde el 12 de noviembre) y la testnet la v3.2.8 (desde el 12 de noviembre; la v3.2.7 desde el 6 de noviembre, la v3.2.6 desde el 27 de octubre); el formato de firma no
cambió hasta la v3.2.7, así que la 0.12.0 funciona en la mainnet. La 0.12.0 no tiene constructores para las novedades de la v3.2.7 (el registro de multifirma PQC, el modo de firma textual, el APR, la identidad de clúster y los mensajes de verification key), que están en la mainnet desde el 12 de noviembre de 2026, y su ruta de firma no se volvió a comprobar contra la v3.2.7; usa la CLI para ellos. Añade la regla exacta de gas para las transacciones híbridas, los
constructores y la lectura del registro de claves ML-KEM, las lecturas de cuentas
abstractas y los constructores verificados de parámetros de gobernanza (consulta
Qué añade la 0.12.0), además de lo que la 0.10.0 añadió
para v3.2.4 (los constructores y lecturas de los niveles de staking, fetchAuthNonce
y las lecturas de funcionalidades del protocolo, consulta
Qué añadió la 0.10.0) y lo que la 0.9.0 añadió para
v3.2.2 y v3.2.3: constructores para la prueba de posesión opcional en el registro
(la adjunta automáticamente ensurePqcRegistered una vez que la red haya aplicado
v3.2.3), las ventanas EVM con alcance y los mensajes de consentimiento EIP-7702. El SDK 0.8.1 o posterior
también opera en ambas redes (la forma v2 de los sign-bytes híbridos, el registro,
los envíos híbridos y la ventana EVM funcionan sin cambios), pero no tiene ninguno
de esos constructores: usa la CLI para ellos (consulta
Versiones anteriores a la 0.9.0). El formato de firma no
cambió en v3.2.4, v3.2.5 ni v3.2.6. La mainnet ejecuta v3.2.7 y la testnet v3.2.8 (la testnet aplicó la v3.2.5 el 26 de octubre
de 2026, la v3.2.6 el 27 de octubre, la v3.2.7 el 6 de noviembre y la v3.2.8 el 12 de noviembre; la mainnet aplicó la v3.2.5 el 29 de octubre, la v3.2.6 el 4 de noviembre y la v3.2.7 el 12 de noviembre). El SDK 0.10.0 y el 0.9.0 siguen funcionando en ellas, pero no tienen constructores para las
novedades de la v3.2.5 (el registro de claves ML-KEM, la regla exacta de gas); con esas versiones usa la CLI, o actualiza a la 0.14.0. La 0.12.0 se construyó y se verificó contra la v3.2.5.
Mi registro de clave PQC fue rechazado pero se cobró la comisión
Un registro para una cuenta que ya tiene una clave es rechazado por la cadena
después de descontar la comisión. ensurePqcRegistered en la 0.9.0 y posteriores lee primero
GET /qorechain/pqc/v1/account/{address} (pasa rest), omite el registro cuando
la clave de este par de claves ya está registrada, y lanza PqcKeyMismatchError
cuando hay una distinta. Las versiones anteriores no miraban primero, a menos que
pasaras tú mismo status: { registered: found }, donde found proviene de esa
ruta. Desde v3.2.3 la cadena también rechaza las claves débiles, degeneradas y
reutilizadas; las claves de derivePqcCanonical o tx pqc gen-key son válidas.
create-qorechain-dapp instala un SDK que no puede firmar
Solo la versión 0.8.0 del generador lo hacía: escribía rangos ^0.3.0 para
@qorechain/sdk y @qorechain/evm, y un rango con caret sobre una versión 0.x se
queda dentro de la 0.3. Las versiones 0.9.0 y posteriores generan el proyecto sobre el SDK actual;
si usaste la 0.8.0, ejecuta npm i @qorechain/sdk@latest (y
@qorechain/evm@latest) después de generar el proyecto.
VERSION dice 0.8.0 pero instalé la 0.8.3
La constante exportada VERSION de la 0.8.3 no se actualizó e informa 0.8.0;
desde la 0.9.0 coincide con el paquete. En versiones anteriores, lee la versión
instalada de package.json.
Mi gasto mediante authenticator es rechazado con authenticator_replay
(El módulo abstractaccount está desactivado en la mainnet; un gasto allí se
rechaza con abstract account module is disabled antes de comprobar ningún
nonce. Está activado en la testnet. Consulta
Authenticators y gasto delegado. La
orientación siguiente se aplica dondequiera que el módulo esté activado.)
El nonce es incorrecto. Tanto MsgExecuteEVM.nonce como MsgExecuteCosmos.nonce
son la secuencia de authenticator de la clave vinculada para
(account, pubkey): un contador que la cadena mantiene por cada clave vinculada,
que empieza en 0 y se incrementa con cada ejecución correcta. No es el nonce
EVM de la cuenta. Léelo con fetchAuthNonce (SDK 0.10.0 o posterior, cadena v3.2.4 o
posterior), o llévalo tú por cada clave vinculada en versiones anteriores. Desde
v3.2.3 el carril EVM también firma
evmAuthSignBytesV2, que vincula el límite de gas de la llamada
(resolveEvmAuthDigestVersion elige la forma). Usa el contador que leas (o lleves)
para esa clave y firma de nuevo.
Otros fallos de authenticator se decodifican mediante decodeTxError: códigos de
abstractaccount 5 (spending_limit_exceeded), 6 (session_key_expired) y
10 (permission_denied). Consulta
Authenticators y gasto delegado.