Developers
La página Developers (/developers, barra lateral grupo Build, entrada Developers) es una página pública de herramientas para construir sobre QoreChain. No necesita cuenta. Tiene siete pestañas: SDKs, Transaction inspector, PQ key status, Simulator, Signing playground, QoreX test wallet y AI agents (MCP). Juntas te permiten encontrar e instalar el paquete adecuado, leer cualquier transacción confirmada y ver si su capa post-cuántica se verifica, comprobar qué clave post-cuántica tiene registrada una cuenta y si su ventana de autorización EVM está abierta, hacer una simulación de una transacción firmada, practicar la firma híbrida con una clave desechable y probar una dApp contra una wallet QoreX simulada, todo en el navegador. Está pensada para desarrolladores de dApps, wallets y backends. Para las bibliotecas en sí, consulta Paquetes para desarrolladores, la Visión General del SDK e Instalación.
Innovaciones
- Una puerta de enlace de solo lectura a la cadena. Las herramientas leen datos públicos de la cadena y simulan una transacción a través de una puerta de enlace de solo lectura bajo las rutas de consulta
cosmos/,cosmwasm/yqorechain/más la llamada de simulación. Nada en la página puede transmitir una transacción. La puerta de enlace existe porque los endpoints REST de la cadena no envían cabeceras CORS de navegador. - Claves que nunca salen del navegador. Las claves del signing playground y de la test wallet se generan en tu navegador y se conservan solo en memoria. Nunca se guardan ni se envían, y desaparecen al recargar. Esas dos pestañas son solo de testnet y rechazan mainnet.
- La biblioteca de firma de producción, no una demo. El playground usa QoreSign, la misma biblioteca de código abierto que usan las integraciones de producción. Produce y verifica firmas híbridas: una firma secp256k1 más una firma ML-DSA-87 sobre el mismo mensaje.
- Un centro de paquetes generado a partir de datos probados. La pestaña SDKs lista 48 paquetes a partir de un único manifiesto. Las versiones se leen en vivo de cada registro (se actualizan cada 10 minutos, y se muestra la última versión comprobada con su fecha si no se puede alcanzar un registro), y cada inicio rápido fue ejecutado por el equipo del SDK contra los registros públicos, con la salida que observaron mostrada a su lado.
- Un veredicto que puedes reproducir. El Transaction inspector lee una transacción confirmada e informa de si su capa ML-DSA-87 se verifica contra la clave que el firmante tiene registrada, con la versión de los bytes de firma y el motivo cuando no se verifica, usando la función
inspectTransactionde QoreSign 0.1.1, de modo que la misma comprobación se ejecuta en tu propio código. Es de solo lectura. - Respuestas de la cadena, no suposiciones. PQ key status lee la clave ML-DSA-87 registrada y el estado de la ventana EVM desde las propias rutas de consulta del nodo, de modo que puedes ver por qué se rechazaría una transacción EVM antes de enviarla.
Cómo usarlo
Abre dashboard.qorechain.io/developers. La página se abre en SDKs. Las pestañas PQ key status y Simulator muestran un selector Network (Testnet o Mainnet) que es local a la página y que por defecto está en Testnet, sea cual sea el valor del encabezado. Es local a la página a propósito: el interruptor del encabezado recarga la página, lo que borraría las claves en memoria y la test wallet.
SDKs
Qué hace. Lista todas las bibliotecas de QoreChain, agrupadas por producto. El manifiesto contiene 48 paquetes en TypeScript, Python, Go, Rust, Java, Kotlin y Swift. 46 son estables, 1 está obsoleto y 1 todavía no está en su registro y se marca como Not published yet (QoreSeal para npm). Los productos, en el orden mostrado, son: QoreChain SDK (core, hooks de React, EVM, SVM, el starter de dApps y los ports a Python, Rust, Go y Java), QoreSign (incluido QoreSign para Python), QoreSeal (cifrado hacia cuentas con ML-KEM-1024, testnet; consulta QoreSeal, en Rust, Go, Python, Swift, Kotlin y Android), RDK (el kit de desarrollo de rollups, su herramienta de línea de comandos, el starter de rollups y los ports a Python, Rust, Go y Java), la biblioteca PQC, el wallet adapter, el chain bridge, Handles, las integraciones de QoreX, y MCP y la CLI qore.
Cómo funciona. Cada producto es una tarjeta. Si el producto se distribuye en varios lenguajes, un selector de lenguaje (pills) cambia el paquete mostrado. Cada paquete muestra:
- una pill de estado (Stable, Not published yet o Deprecated);
- la última versión, leída en vivo de su registro (npm, PyPI, crates.io, el proxy de Go, Maven Central o las versiones de GitHub) y actualizada cada 10 minutos. Si no se puede alcanzar un registro, se muestra la última versión comprobada con su fecha y una nota de que no se pudieron leer las versiones en vivo;
- Registry, Source (repositorio) y License (Apache-2.0), y los requisitos de ejecución;
- el comando Install y la línea Import, cada uno con un botón de copiar, además de las dependencias peer, las exportaciones por subruta, los transportes y un endpoint alojado cuando el paquete los tiene (Maven muestra un bloque de
pom.xml); - el Quickstart: una pill que dice Tested con la fecha, Failed in testing o Not tested, el nombre del archivo, el código con un botón de copiar, el Observed output y How it was tested. Un inicio rápido que falló queda oculto tras Show the quickstart, con una advertencia para leer antes los problemas conocidos;
- Known issues y notas, palabra por palabra del equipo del SDK.
Un paquete que no está publicado muestra "This package is not on its registry yet, so there is no install command." y ninguna línea de instalación. El paquete obsoleto (@qorechain/connect) queda plegado al final, en Deprecated packages, con sus sustitutos (los paquetes @qorechain/qorex-*).
Pasos.
- Escribe en el cuadro de filtro ("Filter by name or language") para acotar la lista; Clear filter la restablece. Cuando coinciden varios productos, una fila Jump to enlaza con cada uno.
- Elige el producto y luego la pill del lenguaje.
- Comprueba la línea de versión ("latest on npm", o "checked" con una fecha) y copia el comando Install.
- Copia la línea Import y luego el inicio rápido en el archivo indicado en File name, y ejecútalo.
- Abre Network endpoints para copiar los ids de cadena y los endpoints públicos de testnet y mainnet. La nota que hay debajo explica las convenciones de los inicios rápidos: los ejemplos solo leen y firman con la frase de prueba pública, así que nunca financies una cuenta derivada de ella.
Ejemplo mínimo. Escribe python en el filtro, abre QoreChain SDK, elige la pill Python, copia el comando de instalación de Install, y luego copia el inicio rápido y ejecútalo.
Red. Lista estática más lecturas de registros en vivo; no se aplica ninguna elección de red.
Transaction inspector
Qué hace. Lee una transacción confirmada a partir de su hash y explica quién la firmó, cuánto costó, si su capa post-cuántica se verifica y en qué nivel de seguridad se sitúa. Es de solo lectura: no se firma ni se envía nada.
Cómo funciona. La página pide a la puerta de enlace de solo lectura del Dashboard la transacción en la red que elijas y ejecuta sobre ella la función inspectTransaction de QoreSign 0.1.1 (consulta el inicio rápido de QoreSign para ejecutar la misma comprobación en código). La capa post-cuántica se comprueba contra la clave ML-DSA-87 que el firmante tiene registrada ahora, así que una rotación de clave posterior puede hacer que una transacción más antigua aparezca como no verificada.
Pasos.
- Abre la pestaña Transaction inspector (está justo después de SDKs) y elige Testnet o Mainnet con el selector.
- Pega el Transaction hash: 64 caracteres hexadecimales, con o sin
0x. Un hash mal formado se rechaza antes de pedir nada. - Selecciona Inspect.
- Lee el resultado:
-
Overview: Status (Success, o Failed con el codespace y el código), Height, Chain id, Memo, Fee con el Gas limit (y el pagador o el concedente de la comisión cuando se indican) y Open in explorer. El explorador sigue la red elegida en el encabezado, así que una nota te indica que la cambies cuando la transacción está en la otra red.
-
Signer: Address, Key type, Sequence, Public key y Classical signature valid. Las transacciones del carril EVM no llevan aquí información del firmante, y la pestaña lo indica.
-
Post-quantum layer: Present, Count, Algorithm (ML-DSA-87), Verified (sí o no), Sign-bytes version y, cuando no está verificada, el Reason.
-
Security tier, con estas definiciones:
Nivel Significado PQC Lleva la capa ML-DSA-87: una firma híbrida. Enrollment Registra o gestiona la clave ML-DSA-87 de la cuenta, y está firmada con la clave clásica por diseño. SHAKE Una transacción del carril nativo sin la capa ML-DSA-87. Classical Una transacción del carril EVM, firmada solo con secp256k1. -
Messages: la URL de tipo de cada mensaje y su valor sin procesar (Show raw value (base64)), y el Raw JSON.
-
- Un hash desconocido muestra "No transaction with this hash was found on ..." con una indicación para comprobar el hash o cambiar de red. Los nodos de testnet podan el historial antiguo, así que una transacción antigua de testnet puede haber desaparecido.
Ejemplo mínimo. Elige Testnet y pega 124E5B2B5B5A8AE7CBA254224CBA07F5014BD1B0014C164A8208E5D7EC0C664E: el nivel muestra PQC y la capa post-cuántica muestra Verified (comprobado el 27 de octubre de 2026; si esa transacción ya se ha podado, usa el hash de una transferencia reciente de testnet).
Red. Mainnet o testnet, mediante el selector de la pestaña (por defecto testnet).
PQ key status
Qué hace. Muestra la clave ML-DSA-87 que una cuenta ha registrado en la cadena y el estado de su ventana de autorización EVM, en mainnet o testnet.
Cómo funciona. La página analiza tu entrada, la convierte en una cuenta qor1... y hace dos consultas al nodo: la clave PQC registrada (a través de QoreSign) y la ventana EVM de la cuenta (GET /qorechain/pqc/v1/evm_window/{address}). Una dirección 0x... son los mismos 20 bytes que su forma qor1..., y una dirección qorvaloper1... se busca como la cuenta propia del operador. Los resultados pertenecen a una sola red: cambiar el selector los borra.
Pasos.
- Abre la pestaña PQ key status y elige la red.
- Introduce una Account address (
qor1...,0x...oqorvaloper1...). La página comprueba el formato y el checksum e informa de un error tipográfico. - Selecciona Check.
- Lee Registered PQC key: si hay una clave registrada, el Algorithm (ML-DSA-87), el Key type (hybrid), Proof of possession (con la nota de que la cadena la trata como opcional) y la Public key (2592 bytes, truncada, con un botón de copiar). Una cuenta sin clave dice "This account has no PQC key registered on this network."
- Lee EVM authorisation window: State (Open o Closed), Blocks left, Transactions used (estilo "3 of 20"), Value used, Opened / expiry height, y si la ventana permite Native QOR transfers only, con los destinos permitidos si los hay. Una cuenta que nunca abrió una dice "No EVM authorisation window has been opened for this account."
La ventana se abre desde el carril nativo con la clave ML-DSA-87 de la cuenta y se cierra cuando se alcanza su límite de bloques o de transacciones; consulta Ventana de autorización EVM.
Ejemplo mínimo. Elige Testnet, pega la forma 0x... de una dirección que uses con MetaMask y selecciona Check: si la ventana está Closed o no existe, una transacción EVM desde esa cuenta sería rechazada.
Simulator
Qué hace. Hace una simulación de una transacción firmada contra la cadena e informa de lo que costaría y cambiaría. No se transmite nada.
Cómo funciona. La página decodifica tu entrada (base64 o hex, hasta unos 180 KB), cuenta sus firmas y la envía a la ruta de simulación del nodo. La llamada de simulación es la única ruta de escritura que permite la puerta de enlace.
Pasos.
- Abre Simulator y elige la red.
- Pega la transacción firmada (un
TxRaw, en base64 o hex) en Signed TxRaw. La página muestra el tamaño decodificado y el número de firmas, y avisa si no hay ninguna (lo más probable es que la cadena se niegue a simular una transacción sin firmar). - Selecciona Simulate.
- Lee Gas used, el Suggested gas limit, Balance changes (dirección, denominación, cambio) y los Events en la lista desplegable.
- Si la cadena la rechaza, la página muestra su Code, Codespace y Log bajo "The chain refused the simulation".
Primero necesitas los bytes firmados: construye y firma con un SDK o qorechaind (consulta Firma post-cuántica). Ejemplo mínimo: firma una pequeña transferencia con el SDK en testnet, pega el TxRaw en base64, selecciona Simulate y comprueba el límite de gas sugerido antes de transmitir.
Signing playground (solo testnet)
Qué hace. Te permite generar una clave híbrida desechable y firmar y verificar mensajes y solicitudes de Sign In With QoreChain en el navegador.
Cómo funciona. Se genera en la página una frase de 24 palabras que se conserva solo en memoria. QoreSign deriva de ella una clave secp256k1 y una clave ML-DSA-87. Las firmas cubren el mismo mensaje con ambas claves, para la cadena qorechain-diana. Como una clave desechable no está registrada en la cadena, la verificación usa la clave pública ML-DSA-87 de esta sesión.
Pasos.
- Abre Signing playground. Advierte: "Throwaway testnet key: never use it for real funds."
- Selecciona Generate throwaway key. La página muestra la dirección
qor1..., la clave pública secp256k1 (33 bytes) y la clave ML-DSA-87 (clave pública de 2592 bytes, clave secreta de 4896 bytes). New key la reemplaza. - Message: escribe texto y selecciona Sign; el resultado es una firma híbrida como JSON. Selecciona Verify: la página muestra "Valid signature", o "Invalid signature" con el código de error.
- Sign In With QoreChain: selecciona Build message (un mensaje de inicio de sesión para este sitio con el dominio, la dirección, el id de cadena, un nonce aleatorio y las horas de emisión y de expiración), luego Sign y luego Verify. Verify lo comprueba como lo haría un servidor y lista los campos analizados. Consulta la especificación SIWQ y la guía de inicio de sesión.
Ejemplo mínimo. Generate throwaway key, escribe hello, Sign, Verify: la página muestra "Valid signature".
Red. Solo testnet; la clave no se puede usar en mainnet y se pierde al recargar.
QoreX test wallet (solo testnet)
Qué hace. Instala un simulado de la wallet QoreX en la pestaña actual para que puedas probar los flujos de conexión y firma de una dApp sin una wallet real.
Cómo funciona. Start test wallet crea una test wallet con una clave desechable (el paquete publicado @qorechain/qorex-wallet-mock) y la anuncia a las dApps de la página como "QoreX (mock)", mediante el descubrimiento estándar de wallets para navegadores (EIP-6963); también expone window.qorex. Nada se aprueba automáticamente. No transmite transacciones. Si hay una extensión QoreX real en la pestaña, el simulado la reemplaza hasta que recargues.
Pasos.
- Abre QoreX test wallet y lee la advertencia: cada inicio genera una clave desechable de testnet en memoria; nunca envíes fondos reales a ella.
- Selecciona Start test wallet. La tarjeta Addresses lista las direcciones QoreChain Native, EVM y SVM.
- Conéctate desde una dApp que se ejecute en esta pestaña, o llama a
window.qorexdesde la consola del navegador. - Cada solicitud aparece en Waiting for approval; selecciona Approve o Reject. La lista Requests registra cada solicitud con su estado de aprobación y su resultado.
- Selecciona Stop (reloads the page) para quitar el simulado.
Ejemplo mínimo. Inicia la test wallet, abre una dApp en la misma pestaña, elige "QoreX (mock)" en su diálogo de conexión y Approve la conexión.
Red. Solo testnet.
AI agents (MCP)
Qué hace. Muestra el estado del servidor MCP de QoreChain (un servidor Model Context Protocol que permite a un cliente MCP leer datos de la cadena de QoreChain y usar las herramientas para desarrolladores) y cómo configurarlo en un cliente MCP.
Cómo funciona. Al abrir la pestaña, la página consulta el registro de paquetes en vivo y muestra el estado (Published) con la versión actual (@qorechain/mcp, 0.1.0 en el momento de escribir esto, que también está en PyPI como qorechain-mcp). A continuación muestra la configuración para un cliente MCP, en bloques copiables:
- Local (stdio), la opción principal. Añade
{ "mcpServers": { "qorechain": { "command": "npx", "args": ["-y", "@qorechain/mcp"] } } }a la configuración de servidores de tu cliente MCP. No necesita clave. - Autoalojado (Streamable HTTP). Ejecuta
qorechain-mcp serve --port 8787y apunta el cliente ahttp://localhost:8787/mcp. - Endpoint alojado.
https://mcp.qorechain.io/mcpsirve la testnet por defecto. Cada solicitud necesita una clave de API, enviada en una cabeceraAuthorization: Bearer <key>. Solicita una desde tu panel (consulta el flujo de la clave más abajo). Para la mayoría de los usos, la configuración local no necesita clave.
Clave de API para el endpoint alojado. Inicia sesión y, en la sección API key de la pestaña:
- Rellena el nombre o la organización, un contacto, el uso previsto y el volumen esperado, y pulsa Request API key. El estado indica "waiting for approval".
- El equipo de QoreChain aprueba o rechaza la solicitud. Un rechazo muestra su nota, y puedes volver a solicitarla.
- Tras la aprobación, pulsa Generate key. La clave se muestra una sola vez, con un botón de copiar y un fragmento de configuración listo para usar, y queda activa en uno o dos minutos. QoreChain no conserva ninguna copia de la clave, solo una huella (un hash), así que una clave perdida no puede volver a mostrarse: revócala y solicita una nueva.
- Revoke key está disponible en cualquier momento y surte efecto en aproximadamente un minuto.
Límites: una clave activa por cuenta, 10 solicitudes por segundo (ráfaga de 20) y 100 000 solicitudes por día.
Pasos. Abre la pestaña, copia la configuración local en tu cliente MCP, reinícialo y pídele que lea un bloque o una cuenta. Para los detalles de las herramientas y las opciones consulta Servidor MCP de QoreChain. Ejemplo mínimo: pega el bloque stdio en tu cliente, reinícialo y pídele el último bloque.
Cómo acceder
- URL: dashboard.qorechain.io/developers, o Developers en el grupo Build de la barra lateral (y en el menú móvil).
- Inicio de sesión: ninguno para la página y sus herramientas. Solicitar una clave de API para el endpoint MCP alojado requiere iniciar sesión.
- Red: Transaction inspector, PQ key status y Simulator funcionan en mainnet o testnet mediante el selector de la pestaña (por defecto testnet). Signing playground y QoreX test wallet son solo de testnet. SDKs y AI agents (MCP) no dependen de una red.
- Wallet: ninguna. Las herramientas generan sus propias claves desechables.
- Coste: gratis. No se envía nada a la cadena salvo consultas de lectura y llamadas de simulación.
- Privacidad: las claves desechables existen solo en la memoria de la página. No pegues una frase de recuperación real en ninguna herramienta.
Dónde está publicado
| Superficie | Dirección | Redes |
|---|---|---|
| Página Developers | dashboard.qorechain.io/developers | Herramientas de lectura en mainnet y testnet; herramientas de firma solo en testnet |
| Biblioteca de firma | npm @qorechain/qoresign (0.1.1 añade inspectTransaction), PyPI QoreSign para Python, código fuente github.com/qorechain/qoresign, consulta QoreSign | n/a |
| Paquete de la test wallet | npm @qorechain/qorex-wallet-mock, código fuente github.com/qorechain/qorex-integrations | Testnet |
| Índice de paquetes | Paquetes para desarrolladores | n/a |
| Servidor MCP | npm @qorechain/mcp 0.1.0 y @qorechain/qore-cli 0.1.0, PyPI qorechain-mcp 0.1.0; guía: Servidor MCP de QoreChain | Testnet por defecto |
Las versiones de los paquetes cambian; consulta las actuales en la pestaña SDKs o en los registros.
Límites y problemas conocidos
- El inspector juzga contra la clave registrada ahora. Tras una rotación de clave, una transacción más antigua puede aparecer como no verificada. Solo lee transacciones confirmadas.
- El endpoint MCP alojado necesita una clave de API. Solicita una desde tu panel (una clave activa por cuenta, 10 solicitudes por segundo, 100 000 por día); la configuración local no necesita ninguna. Usa la configuración local para la mayor parte del trabajo.
- Dos inicios rápidos están marcados como "Not tested": QoreSign para Android y QoreSeal para Android (el mismo código se ejecutó en el artefacto JVM, no en un dispositivo). Los demás inicios rápidos probados se ejecutaron y pasaron.
- El simulador necesita bytes firmados. No puede firmar por ti y nunca transmite.
- El playground y la test wallet son solo de testnet, usan claves desechables que desaparecen al recargar y no pueden guardar ni mover fondos reales.
- Una extensión QoreX real en la misma pestaña es reemplazada por la test wallet hasta que recargues.
- Las lecturas pasan por la puerta de enlace del Dashboard. Desde tu propio código, llama directamente a los endpoints públicos:
api.qore.hostyapi-testnet.qore.host.