Saltar al contenido principal

Comandos de consulta

Todos los comandos de consulta siguen el patrón:

qorechaind query <module> <command> [args] [flags]
nota

Las consultas se ejecutan contra el nodo al que apunte --node. Utiliza un endpoint RPC de mainnet qorechain-vladi para datos en vivo (por ejemplo --node https://rpc.qore.host:443), o un endpoint de testnet qorechain-diana (--node https://rpc-testnet.qore.host:443) para pruebas. El valor por defecto tcp://localhost:26657 apunta a un nodo que ejecutas tú mismo. Mainnet ejecuta la versión de nodo v3.2.3 hasta la altura 3,742,566 y v3.2.4 desde ese bloque (propuesta de gobernanza 13); la testnet ejecuta v3.2.4 desde el 19 de octubre de 2026. La versión v3.2.4 añade algunas rutas y comandos (marcados como v3.2.4 más abajo): funcionan en la testnet ahora y en mainnet desde la altura 3,742,566, y un nodo de mainnet que todavía esté en v3.2.3 los responde con Not Implemented. Los comandos de esta página se comprobaron con el binario de la versión v3.2.3, ejecutado contra https://rpc.qore.host:443.

Los flags comunes se aplican a todos los subcomandos de query:

FlagTipoDescripción
--nodestringEndpoint RPC (por defecto: tcp://localhost:26657)
--outputstringFormato de salida: json o text
--heightintConsultar el estado a una altura de bloque específica

No todos los módulos tienen una consulta de CLI. Cuando falta un comando, usa el endpoint REST (https://api.qore.host/...); consulta API REST.

bank​

qorechaind query bank balances <address>
qorechaind query bank total-supply
qorechaind query bank total-supply-of uqor
qorechaind query bank spendable-balances <address>

(No existe query bank total.)

staking​

qorechaind query staking validator <validator_address>
qorechaind query staking validators
qorechaind query staking validators --status BOND_STATUS_BONDED
qorechaind query staking delegation <delegator_address> <validator_address>
qorechaind query staking delegations <delegator_address>
qorechaind query staking delegations-to <validator_address>
qorechaind query staking unbonding-delegation <delegator_address> <validator_address>
qorechaind query staking unbonding-delegations <delegator_address>
qorechaind query staking redelegation <delegator_address> <src_validator> <dst_validator>
qorechaind query staking params
qorechaind query staking pool

--status acepta el nombre completo del enum: BOND_STATUS_BONDED, BOND_STATUS_UNBONDING o BOND_STATUS_UNBONDED (--status bonded se rechaza).

distribution​

qorechaind query distribution rewards <delegator_address>
qorechaind query distribution commission <validator_address>
qorechaind query distribution validator-outstanding-rewards <validator_address>
qorechaind query distribution community-pool
qorechaind query distribution params

gov​

qorechaind query gov proposals
qorechaind query gov proposals --proposal-status voting-period
qorechaind query gov proposal <proposal_id>
qorechaind query gov votes <proposal_id>
qorechaind query gov vote <proposal_id> <voter_address>
qorechaind query gov tally <proposal_id>
qorechaind query gov params

--proposal-status acepta deposit-period, voting-period, passed, rejected o failed. Otros filtros: --voter, --depositor.

tx​

qorechaind query tx <txhash>
qorechaind query txs --query "message.sender='<address>'"

pqc​

qorechaind query pqc account <address>
qorechaind query pqc algorithms
qorechaind query pqc algorithm dilithium5
qorechaind query pqc stats
qorechaind query pqc params
qorechaind query pqc migration <algorithm_id>
qorechaind query pqc hybrid-mode
qorechaind query pqc evm-window <address>
qorechaind query pqc evm-delegation-consent <address>
  • algorithm acepta un nombre de algoritmo (dilithium5, mlkem1024) o un ID numérico.
  • migration acepta un ID de algoritmo (por ejemplo 1), no una dirección, e informa No active migration cuando no hay ninguna en curso.
  • account informa la clave registrada. Además de la clave, key_type y algorithm_name, el registro tiene classical_key_source (stored, auth_account o none: de dónde procede la clave pública clásica). Desde v3.2.4 (en la testnet desde el 19 de octubre de 2026; en mainnet desde la altura 3,742,566) también incluye possession_proven, que es true cuando la clave se registró con una prueba de posesión verificada.
  • evm-window muestra si la dirección tiene una ventana de autorización abierta en la vía EVM y cuántos bloques, transacciones y valor quedan (found, live, remaining_blocks, remaining_txs, remaining_value), además del alcance de la ventana (native_only, allowed_targets; desde la mainnet v3.2.3). REST: GET /qorechain/pqc/v1/evm_window/{address}.
  • evm-delegation-consent muestra el consentimiento de delegación EIP-7702 de la dirección (found, live, delegate, granted_height, expiry_height), su delegación actual y su nonce EVM. REST: GET /qorechain/pqc/v1/evm_delegation_consent/{address}.
  • params y hybrid-mode informan hybrid_signature_mode (2 = obligatorio en ambas redes) y allow_classical_fallback (false).

burn​

El módulo burn no tiene consulta de CLI. Usa REST:

curl -s https://api.qore.host/qorechain/burn/v1/params
curl -s https://api.qore.host/qorechain/burn/v1/stats
curl -s https://api.qore.host/qorechain/burn/v1/records
curl -s https://api.qore.host/qorechain/burn/v1/milestone
curl -s https://api.qore.host/qorechain/burn/v1/stranded_rewards

stranded_rewards informa la parte de los stakers que se depositó en el módulo de distribución sin respaldar ningún derecho (reserved, released, snapshot_height). Solo puede liberarse mediante una votación de gobernanza. La reserva se registró por primera vez en la actualización a v3.2.0 y se recalculó en la altura de la actualización a v3.2.3, así que lee los valores en vivo en lugar de una cifra citada en otro lugar.

stats desglosa la quema acumulada por origen, incluido failed_tx, que es distinto de cero desde la actualización a v3.2.2.

mint e inflation​

qorechaind query mint params|inflation|annual-provisions lee el módulo mint estándar, cuya tasa es 0 en ambas redes; no informa el calendario de emisión del protocolo. No existe el comando de CLI query inflation. Los ajustes de emisión propios del protocolo y su progreso se sirven por REST desde v3.2.2:

curl -s https://api.qore.host/qorechain/inflation/v1/params       # emission_mode, fixed_epoch_emission, max_total_emission, epoch_length
curl -s https://api.qore.host/qorechain/inflation/v1/epoch_info   # current_epoch, next_epoch_height, total_minted, remaining_emission

En mainnet estos informan emission_mode: "fixed", una emisión fija de 86,000 QOR por época de 43,200 bloques y un tope acumulado de 590,000,000 QOR (propuesta de gobernanza 10, aprobada el 19 de octubre de 2026; la primera época con el nuevo monto comienza en el bloque 3,672,000). Los montos están en uqor. La testnet sigue informando sus propios valores, distintos; la versión v3.2.4 añade otro modo de emisión (en la testnet desde el 19 de octubre de 2026; en mainnet desde la altura 3,742,566), pero una red solo cambia a él mediante su propia votación de gobernanza, así que mainnet mantiene fixed hasta que prospere una votación así.

ai​

qorechaind query ai config
qorechaind query ai stats

reputation y qca​

qorechaind query reputation params
qorechaind query qca config

No hay consultas de reputación por validador ni de clasificación de pools.

lightnode​

qorechaind query lightnode params
qorechaind query lightnode stats
qorechaind query lightnode light-nodes
qorechaind query lightnode light-node <operator_address>
qorechaind query lightnode rewards <operator_address>
qorechaind query lightnode reward-pool

reward-pool muestra cómo se divide el saldo de recompensas del módulo en reserved, outstanding, payable y distributable, y los límites por nodo: max_reward_per_block_per_node y, desde v3.2.3, max_reward_per_month_per_node (2,000 QOR, prorrateado por tiempo de bloque y disponibilidad). Desde v3.2.4 (en la testnet desde el 19 de octubre de 2026; en mainnet desde la altura 3,742,566) también informa monthly_cap_active, last_distribution_time y last_distribution_height.

license​

qorechaind query license check <grantee_address> <feature_id>
qorechaind query license holders <feature_id>
qorechaind query license list <grantee_address>

check devuelve un error NotFound cuando el beneficiario no tiene una licencia para la función.

bridge​

qorechaind query bridge config
qorechaind query bridge chains
qorechaind query bridge chain <chain_id>
qorechaind query bridge validators
qorechaind query bridge operations
qorechaind query bridge operation <operation_id>

crossvm​

qorechaind query crossvm message <message_id>
qorechaind query crossvm pending
qorechaind query crossvm params

svm​

qorechaind query svm account <base58_address>
qorechaind query svm program <base58_address>
qorechaind query svm params
qorechaind query svm slot

multilayer​

qorechaind query multilayer layer <layer_id>
qorechaind query multilayer layers
qorechaind query multilayer routing-stats
qorechaind query multilayer params

rdk​

qorechaind query rdk config
qorechaind query rdk rollup <rollup_id>
qorechaind query rdk list-rollups
qorechaind query rdk batch <rollup_id>            # latest batch
qorechaind query rdk batch <rollup_id> --index 42 # a specific batch
qorechaind query rdk batches <rollup_id> [--start 0] [--limit 100]   # batches in index order
qorechaind query rdk anchor-sign-bytes <layer_id> <batch_index> <state_root_hex> --tx-count <n> --validator-set-hash <hex>

config muestra los parámetros del módulo (stake mínimo, tasa de quema en la creación, ventana de desafío, límites de DA). anchor-sign-bytes imprime, en hex, los bytes de firma de anclaje v2 que firma el creador de un rollup para tx rdk submit-batch --anchor-signature. Las mismas consultas se sirven por REST bajo /qorechain/rdk/v1/... desde v3.2.2 (consulta Endpoints REST / gRPC). suggest-profile <use_case> no consulta la cadena; solo imprime una referencia a un método JSON-RPC que los endpoints públicos no sirven, así que elige un perfil entre los Perfiles predefinidos.

rlconsensus​

qorechaind query rlconsensus agent-status
qorechaind query rlconsensus observation
qorechaind query rlconsensus reward
qorechaind query rlconsensus params
qorechaind query rlconsensus policy

abstractaccount​

El módulo de cuentas abstractas está actualmente desactivado en ambas redes (config.enabled es false), por lo que estas consultas no devuelven cuentas.

qorechaind query abstractaccount config
qorechaind query abstractaccount accounts
qorechaind query abstractaccount account <address>
qorechaind query abstractaccount permission-schema

auth-keygen, auth-sign-cosmos <chain_id> <account> <to> <amount> <nonce> y auth-sign-evm <chain_id> <account> <to_0x> <value_wei> <data_hex> <nonce> generan firmas de autenticador sin conexión. La semilla del autenticador nunca es un argumento: se lee de --seed-file <file> (o - para la entrada estándar), de la variable de entorno QORE_AUTH_SEED o de un aviso sin eco, y auth-keygen la escribe en un nuevo archivo 0600 (--out) en lugar de imprimirla.

gasabstraction​

Las consultas de abstracción de gas se sirven en ambas redes desde v3.2.2:

qorechaind query gasabstraction config
qorechaind query gasabstraction accepted-tokens
qorechaind query gasabstraction conversion-rate <denom>   # what one unit of a fee token is worth in uqor, and whether it can pay fees
qorechaind query gasabstraction float                     # the conversion float's balances and this block's usage

La lista de tokens aceptados contiene solo uqor nativo en ambas redes, así que las comisiones se pagan en uqor y no se realiza ninguna conversión; la gobernanza decide qué otros tokens se aceptan. REST: /qorechain/gasabstraction/v1/config, /conversion_rate?denom=, /float. Consulta Abstracción de gas.

amm​

qorechaind query amm params
qorechaind query amm pools
qorechaind query amm pool <pool_id>
qorechaind query amm pool-by-denoms <denom_a> <denom_b>
qorechaind query amm lp-balance <pool_id> <address>
qorechaind query amm quote-exact-in <pool_id> <denom_in> <amount_in>
qorechaind query amm quote-exact-out <pool_id> <denom_out> <amount_out>

En el momento de escribir esto no existe ningún pool en ninguna de las dos redes.

stakingtier (v3.2.4)​

qorechaind query stakingtier params
qorechaind query stakingtier locks <holder_address>
qorechaind query stakingtier pool

El módulo de niveles de staking forma parte de la versión v3.2.4: se ejecuta en la testnet desde el 19 de octubre de 2026 y en mainnet desde la altura 3,742,566 (propuesta de gobernanza 13). Antes de esa altura, un nodo de mainnet responde a estas consultas con Not Implemented. REST: /qorechain/stakingtier/v1/params, /locks/{holder}, /pool. Consulta Comandos de transacción.

circuit, feemarket, upgrade​

qorechaind query circuit disabled-list        # message types switched off network-wide
qorechaind query feemarket params
qorechaind query feemarket base-fee
qorechaind query upgrade plan
qorechaind query upgrade applied <upgrade_name>
qorechaind query upgrade module-versions

query upgrade applied <name> es la forma de leer cuándo entró en vigor una actualización: en mainnet v3.2.2 se aplicó en la altura 3,556,788 y v3.2.3 en la altura 3,662,051; en la testnet v3.2.2 en 6,905,034, v3.2.3 en 8,003,746 y v3.2.4 en 8,337,253 (0 significa no aplicada). La lista del circuit breaker de mainnet (disabled-list) contiene actualmente los mensajes de creación de cuentas de vesting, el almacenamiento e instanciación de QoreChain Native, la pausa y reanudación de pools AMM, la llamada cross-VM, la actualización del estado de capa multilayer, la deprecación y deshabilitación de algoritmos PQC, y los mensajes de gobernanza de consenso PRISM; la de la testnet contiene solo los tres mensajes de QoreChain Native.

evm, erc20, wasm​

Los comandos wasm leen QoreChain Native, el nombre que QoreChain da a su runtime de contratos inteligentes CosmWasm; los nombres de comandos y módulos conservan la grafía wasm.

qorechaind query evm params
qorechaind query evm balance-bank <0x_address> uqor
qorechaind query erc20 token-pairs
qorechaind query wasm params
qorechaind query wasm list-code
qorechaind query wasm list-contract-by-code <code_id>
qorechaind query wasm contract <contract_address>
qorechaind query wasm contract-state smart <contract_address> '<json_query>'

Módulos sin CLI​

xqore, babylon y fairblock no tienen comandos de transacción ni de consulta. No se pueden usar desde la CLI ni desde ninguna API pública por el momento.