QoreChain expone tres interfaces principales para el acceso programático:
| Interfaz | Puerto predeterminado | Protocolo | Descripción |
|---|
| REST | 1317 | HTTP/1.1 | API REST LCD (Light Client Daemon) |
| gRPC | 9090 | HTTP/2 | Servicio gRPC codificado con Protobuf |
| RPC | 26657 | HTTP + WS | RPC del motor de consenso de QoreChain |
Todos los endpoints REST devuelven JSON. Los endpoints gRPC usan Protocol Buffers y pueden consumirse con cualquier cliente gRPC. La interfaz RPC proporciona consultas a nivel de consenso y difusión de transacciones.
Estas interfaces están disponibles tanto en la mainnet qorechain-vladi (activa desde el 7 de junio de 2026 en la versión de cadena v3.1.85) como en la testnet qorechain-diana. Las URL base que aparecen a continuación asumen un nodo en ejecución local; los endpoints públicos alojados (rpc/api/evm/svm.qore.host y sus variantes -testnet) se enumeran en Redes.
URL base
REST: http://localhost:1317
gRPC: localhost:9090
RPC: http://localhost:26657
Módulo AI
| Método | Endpoint | Descripción |
|---|
| GET | /ai/v1/config | Devuelve la configuración actual del módulo AI |
| GET | /ai/v1/stats | Estadísticas agregadas de procesamiento de AI |
| GET | /ai/v1/fee-estimate | Estimación de comisión de gas asistida por AI para una transacción |
| GET | /ai/v1/fraud/investigations | Enumera todas las investigaciones de fraude activas |
| GET | /ai/v1/fraud/investigations/{id} | Devuelve los detalles de una investigación de fraude específica |
| GET | /ai/v1/network/recommendations | Recomendaciones de optimización de red generadas por AI |
| GET | /ai/v1/circuit-breakers | Estados y umbrales actuales de los circuit breakers |
Módulo Bridge
A partir de la versión de cadena v3.1.77, el estado de solo lectura del módulo bridge se expone por REST mediante grpc-gateway bajo el prefijo /qorechain/bridge/v1/... (antes solo estaba disponible por gRPC). Estos endpoints sirven JSON real de la cadena a través de HTTP para exploradores y telemetría de nodos ligeros. La config del bridge reporta, por ejemplo, min_validators=10 y threshold=7.
| Método | Endpoint | Descripción |
|---|
| GET | /qorechain/bridge/v1/config | Configuración actual del módulo bridge |
| GET | /qorechain/bridge/v1/chains | Enumera todas las cadenas bridge registradas |
| GET | /qorechain/bridge/v1/chains/{chain_id} | Detalles de una cadena puenteada específica |
| GET | /qorechain/bridge/v1/validators | Enumera los validadores bridge registrados |
| GET | /qorechain/bridge/v1/validators/{address} | Detalles de un validador bridge específico |
| GET | /qorechain/bridge/v1/operations | Enumera las operaciones de bridge |
| GET | /qorechain/bridge/v1/operations/{id} | Detalles de una operación de bridge específica |
Los siguientes endpoints de ruta más corta siguen disponibles:
| Método | Endpoint | Descripción |
|---|
| GET | /bridge/v1/chains | Enumera todas las cadenas bridge registradas |
| GET | /bridge/v1/chains/{id} | Detalles de una cadena puenteada específica |
| GET | /bridge/v1/validators | Enumera los validadores bridge activos |
| GET | /bridge/v1/operations | Enumera las operaciones de bridge recientes |
| GET | /bridge/v1/operations/{id} | Detalles de una operación de bridge específica |
| GET | /bridge/v1/locked/{chain}/{asset} | Valor total bloqueado para un par cadena/activo |
| GET | /bridge/v1/limits/{chain} | Límites de tasa y umbrales para una cadena puenteada |
| GET | /bridge/v1/estimate | Estima la comisión del bridge y el tiempo de transferencia |
Módulo PQC
| Método | Endpoint | Descripción |
|---|
| GET | /pqc/v1/params | Parámetros actuales del módulo PQC |
| GET | /pqc/v1/accounts/{address} | Estado de la clave PQC para una cuenta específica |
| GET | /pqc/v1/stats | Estadísticas agregadas de registro y migración PQC |
Módulo Reputation
| Método | Endpoint | Descripción |
|---|
| GET | /reputation/v1/validators | Puntuaciones de reputación de todos los validadores |
| GET | /reputation/v1/validators/{address} | Puntuación de reputación de un validador específico |
Módulo Cross-VM
| Método | Endpoint | Descripción |
|---|
| GET | /crossvm/v1/message/{id} | Recupera un mensaje cross-VM por ID |
| GET | /crossvm/v1/pending | Enumera los mensajes cross-VM pendientes en la cola |
| GET | /crossvm/v1/params | Parámetros actuales del módulo Cross-VM |
Módulo Multilayer
A partir de la versión de cadena v3.1.80, el servicio de consulta completo del módulo multilayer se expone por REST mediante grpc-gateway bajo el prefijo /qorechain/multilayer/v1/... (antes solo estaba disponible por gRPC), incluidas dos consultas de lectura de anclas de estado: anchor/{layer_id} devuelve el ancla de liquidación más reciente de una capa, y anchors/{layer_id} devuelve su historial de anclas. Cada ancla lleva una firma ML-DSA-87 (Dilithium-5) sobre sus campos canónicos, de modo que un cliente puede obtener un ancla y verificarla de forma independiente: la base en la cadena de los recibos de liquidación del Rollup Development Kit.
| Método | Endpoint | Descripción |
|---|
| GET | /qorechain/multilayer/v1/params | Parámetros actuales del módulo Multilayer |
| GET | /qorechain/multilayer/v1/layers | Enumera todas las capas registradas |
| GET | /qorechain/multilayer/v1/layers/{layer_id} | Detalles de una capa específica |
| GET | /qorechain/multilayer/v1/anchor/{layer_id} | Ancla de estado más reciente de una capa |
| GET | /qorechain/multilayer/v1/anchors/{layer_id} | Historial de anclas de estado de una capa |
| GET | /qorechain/multilayer/v1/routing-stats | Estadísticas de enrutamiento de transacciones entre capas |
Un StateAnchorView contiene layer_id, layer_height, state_root, validator_set_hash, main_chain_height, anchored_at, pqc_aggregate_signature, transaction_count y compressed_state_proof. El mensaje canónico firmado es layer_id || layer_height || state_root || validator_set_hash, verificado contra la clave PQC registrada del creador de la capa.
Los siguientes endpoints de ruta más corta siguen disponibles:
| Método | Endpoint | Descripción |
|---|
| GET | /multilayer/v1/layer/{id} | Detalles de una capa específica |
| GET | /multilayer/v1/layers | Enumera todas las capas registradas |
| GET | /multilayer/v1/anchor/{id} | Detalles de un registro de ancla específico |
| GET | /multilayer/v1/anchors | Enumera los envíos de anclas recientes |
| GET | /multilayer/v1/routing-stats | Estadísticas de enrutamiento de transacciones entre capas |
| GET | /multilayer/v1/params | Parámetros actuales del módulo Multilayer |
Módulo SVM
| Método | Endpoint | Descripción |
|---|
| GET | /svm/v1/params | Parámetros actuales del módulo SVM |
| GET | /svm/v1/account/{address} | Información de la cuenta SVM para una dirección dada |
| GET | /svm/v1/program/{address} | Información del programa desplegado para una dirección de programa dada |
Módulo RL Consensus
Los parámetros de ajuste de PRISM y el estado del agente de aprendizaje por refuerzo se exponen a través de este módulo.
| Método | Endpoint | Descripción |
|---|
| GET | /rlconsensus/v1/agent | Estado y modo actuales del agente PRISM |
| GET | /rlconsensus/v1/observation | Último vector de observación |
| GET | /rlconsensus/v1/rewards | Métricas de recompensa acumuladas |
| GET | /rlconsensus/v1/params | Parámetros actuales del módulo PRISM Consensus |
| GET | /rlconsensus/v1/policy | Configuración y pesos de la política activa |
Módulo Burn
A partir de la versión de cadena v3.1.77, el estado de solo lectura del módulo burn se expone por REST mediante grpc-gateway bajo el prefijo /qorechain/burn/v1/... (antes solo estaba disponible por gRPC). Estos endpoints sirven JSON real de la cadena a través de HTTP para exploradores y telemetría de nodos ligeros. Las stats de quema incluyen, por ejemplo, gas_burn_rate=0.30.
| Método | Endpoint | Descripción |
|---|
| GET | /qorechain/burn/v1/params | Parámetros actuales del módulo Burn |
| GET | /qorechain/burn/v1/stats | Estadísticas de quema en todos los canales |
| GET | /qorechain/burn/v1/records | Enumera los registros de quema |
| GET | /qorechain/burn/v1/milestone | Progreso del hito de quema |
Los siguientes endpoints de ruta más corta siguen disponibles:
| Método | Endpoint | Descripción |
|---|
| GET | /burn/v1/stats | Estadísticas de quema en todos los canales |
| GET | /burn/v1/params | Parámetros actuales del módulo Burn |
Módulo xQORE
| Método | Endpoint | Descripción |
|---|
| GET | /xqore/v1/position/{address} | Posición de staking xQORE para una dirección dada |
| GET | /xqore/v1/params | Parámetros actuales del módulo xQORE |
Módulo Inflation
| Método | Endpoint | Descripción |
|---|
| GET | /inflation/v1/rate | Tasa de inflación anualizada actual |
| GET | /inflation/v1/epoch | Número de época actual y su progreso |
| GET | /inflation/v1/params | Parámetros actuales del módulo Inflation |
Módulo RDK
| Método | Endpoint | Descripción |
|---|
| GET | /rdk/v1/rollup/{id} | Detalles de un rollup específico |
| GET | /rdk/v1/rollups | Enumera todos los rollups registrados |
| GET | /rdk/v1/batch/{id}/{index} | Recupera un lote de liquidación específico |
| GET | /rdk/v1/batches/{id} | Enumera los lotes de un rollup específico |
| GET | /rdk/v1/blob/{id}/{index} | Recupera un blob de DA específico |
| GET | /rdk/v1/params | Parámetros actuales del módulo RDK |
Módulo Babylon
| Método | Endpoint | Descripción |
|---|
| GET | /babylon/v1/staking/{address} | Posición de staking de BTC para una dirección dada |
| GET | /babylon/v1/checkpoint/{epoch} | Datos del checkpoint de BTC para una época dada |
| GET | /babylon/v1/params | Parámetros actuales del módulo Babylon |
Módulo Abstract Account
A partir de la versión de cadena v3.1.85, el servicio de consulta de abstract-account se expone por REST mediante grpc-gateway bajo el prefijo /qorechain/abstractaccount/v1/..., incluido el esquema de permisos utilizado para validar los alcances de los autenticadores sin valores codificados de forma fija.
| Método | Endpoint | Descripción |
|---|
| GET | /qorechain/abstractaccount/v1/config | Configuración del módulo (sonda de funcionalidad: enabled) |
| GET | /qorechain/abstractaccount/v1/accounts | Enumera las cuentas abstractas |
| GET | /qorechain/abstractaccount/v1/accounts/{address} | Estado de la cuenta abstracta para una dirección |
| GET | /qorechain/abstractaccount/v1/permission_schema | Taxonomía de permisos, mapa msg→permiso, msgs no delegables |
Los siguientes endpoints de ruta más corta siguen disponibles:
| Método | Endpoint | Descripción |
|---|
| GET | /abstractaccount/v1/account/{address} | Detalles de la cuenta abstracta para una dirección dada |
| GET | /abstractaccount/v1/params | Parámetros actuales del módulo Abstract Account |
Módulo FairBlock
| Método | Endpoint | Descripción |
|---|
| GET | /fairblock/v1/config | Configuración actual de cifrado de FairBlock |
| GET | /fairblock/v1/params | Parámetros actuales del módulo FairBlock |
Módulo Gas Abstraction
| Método | Endpoint | Descripción |
|---|
| GET | /gasabstraction/v1/accepted-tokens | Enumera los tokens aceptados para el pago de gas |
| GET | /gasabstraction/v1/params | Parámetros actuales del módulo Gas Abstraction |
Reflexión gRPC
La reflexión del servidor gRPC está habilitada de forma predeterminada, lo que permite que herramientas como grpcurl descubran los servicios disponibles:
grpcurl -plaintext localhost:9090 list
Para consultar un servicio específico:
grpcurl -plaintext localhost:9090 qorechain.pqc.v1.Query/Params
Autenticación
Todos los endpoints REST y gRPC no requieren autenticación de forma predeterminada. Para despliegues en producción, coloque un proxy inverso (por ejemplo, Nginx o Caddy) delante del nodo para gestionar la terminación TLS y el control de acceso.