Comandos de transacción
Todos los comandos de transacción siguen el patrón:
qorechaind tx <module> <command> [args] [flags]
Establece --chain-id qorechain-vladi para transmitir contra la mainnet en vivo (versión de la cadena v3.1.85), o --chain-id qorechain-diana para la testnet. Si se omite, el cliente usa el chain-id de tu configuración local.
Las flags comunes se aplican a todos los subcomandos tx:
| Flag | Tipo | Descripción |
|---|---|---|
--from | string | Nombre o dirección de la clave firmante |
--chain-id | string | Identificador de la cadena (por defecto: de la configuración) |
--fees | string | Comisiones de la transacción (p. ej., 500uqor) |
--gas | string | Límite de gas o auto para estimación |
--gas-adjustment | float | Multiplicador de gas al usar auto (por defecto: 1.0) |
--keyring-backend | string | Backend del keyring: os, file, test |
--node | string | Endpoint RPC (por defecto: tcp://localhost:26657) |
--broadcast-mode | string | sync, async o block |
-y | bool | Omitir el mensaje de confirmación |
bank
send
Transfiere tokens de una cuenta a otra.
qorechaind tx bank send <from_address> <to_address> <amount> [flags]
staking
create-validator
Crea un nuevo validador en la red.
qorechaind tx staking create-validator [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--amount | string | Monto de autodelegación (p. ej., 1000000uqor) |
--pubkey | string | Clave pública de consenso del validador (JSON) |
--moniker | string | Nombre visible del validador |
--commission-rate | string | Tasa de comisión inicial (p. ej., 0.10) |
--commission-max-rate | string | Tasa de comisión máxima |
--commission-max-change-rate | string | Tasa máxima de cambio diario de la comisión |
--min-self-delegation | string | Autodelegación mínima requerida |
edit-validator
Edita la descripción o la comisión de un validador existente.
qorechaind tx staking edit-validator [flags]
delegate
Delega tokens a un validador.
qorechaind tx staking delegate <validator_address> <amount> [flags]
redelegate
Mueve una delegación de un validador a otro.
qorechaind tx staking redelegate <src_validator> <dst_validator> <amount> [flags]
unbond
Retira tokens en bonding de un validador.
qorechaind tx staking unbond <validator_address> <amount> [flags]
distribution
withdraw-all-rewards
Retira todas las recompensas de staking pendientes.
qorechaind tx distribution withdraw-all-rewards [flags]
withdraw-rewards
Retira las recompensas de un validador específico.
qorechaind tx distribution withdraw-rewards <validator_address> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--commission | bool | Retirar también la comisión del validador |
gov
submit-proposal
Envía una propuesta de gobernanza.
qorechaind tx gov submit-proposal <proposal_file.json> [flags]
El archivo de la propuesta es un documento JSON que especifica el tipo de propuesta, el título, la descripción y los mensajes a ejecutar.
vote
Vota sobre una propuesta activa.
qorechaind tx gov vote <proposal_id> <option> [flags]
Opciones de voto: yes, no, abstain, no_with_veto.
deposit
Añade un depósito a una propuesta.
qorechaind tx gov deposit <proposal_id> <amount> [flags]
pqc
La ruta de transacción cosmos requiere una firma híbrida por defecto (hybrid_signature_mode = required). Los comandos gen-key y cosign producen la clave Dilithium-5 (ML-DSA-87) y la extensión PQCHybridSignature necesarias para transaccionar en la ruta cosmos junto con la firma clásica secp256k1.
gen-key
Genera una clave poscuántica Dilithium-5 (ML-DSA-87) para la firma híbrida.
qorechaind tx pqc gen-key [flags]
cosign
Adjunta una cofirma Dilithium-5 a una transacción como extensión PQCHybridSignature, produciendo una transacción híbrida (secp256k1 + ML-DSA-87). Es obligatorio para las transacciones de la ruta cosmos bajo el modo de aplicación por defecto required. Las herramientas estándar de CosmJS / relayers deben producir esta extensión para poder transaccionar; el buildHybridTx del SDK de QoreChain (con includePqcPublicKey) hace el equivalente.
qorechaind tx pqc cosign <unsigned_tx_file> [flags]
register-key
Registra una clave pública poscuántica para una cuenta.
qorechaind tx pqc register-key <algorithm> <pubkey_hex> [flags]
register-key-v2
Registra una clave PQC con metadatos extendidos y atestación.
qorechaind tx pqc register-key-v2 <algorithm> <pubkey_hex> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--attestation | string | Datos de atestación TEE (hex) |
--metadata | string | Metadatos adicionales de la clave (JSON) |
migrate-key
Migra una clave clásica existente a un par de claves PQC híbrido.
qorechaind tx pqc migrate-key <algorithm> <pqc_pubkey_hex> [flags]
recover-key
Reconstruye de forma determinista la clave ML-DSA-87 de la cuenta a partir de su mnemónico BIP-39 (leído desde stdin) y la almacena localmente (disponible a partir de la versión de la cadena v3.1.85). Usa la derivación estándar del ecosistema SHAKE-256("qorechain:pqc:v1|address|mnemonic").
qorechaind tx pqc recover-key <name> <address> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--derivation | string | adapter (canónica, por defecto) o bridge (legada SHAKE-256(mnemonic)) |
rotate-key
Rota la clave ML-DSA-87 de la cuenta dentro del mismo algoritmo (disponible a partir de la versión de la cadena v3.1.85) — p. ej. para migrar una clave con derivación legada a la derivación canónica, o para retirar una clave comprometida. Lee el mnemónico desde stdin, firma doblemente con la clave antigua y la nueva, cofirma el sobre con la clave antigua y transmite la transacción. Emite únicamente el JSON de la transacción por stdout (las líneas informativas van a stderr), por lo que se compone bien con -o json.
qorechaind tx pqc rotate-key [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--old-derivation | string | Derivación de la clave registrada actualmente (adapter | bridge) |
--new-derivation | string | Derivación de la nueva clave (adapter | bridge) |
--new-random | bool | Generar en su lugar una clave aleatoria nueva |
xqore
lock
Bloquea tokens QOR en una posición de staking de gobernanza xQORE.
qorechaind tx xqore lock <amount> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--lock-duration | string | Duración del bloqueo (p. ej., 30d, 90d, 180d) |
unlock
Desbloquea xQORE de vuelta a QOR. Un desbloqueo anticipado puede incurrir en penalizaciones según el nivel de penalización.
qorechaind tx xqore unlock <amount> [flags]
bridge
deposit
Inicia un depósito de puente desde una cadena externa.
qorechaind tx bridge deposit <chain_id> <amount> <asset> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--recipient | string | Dirección del destinatario en QoreChain |
withdraw
Inicia un retiro de puente hacia una cadena externa.
qorechaind tx bridge withdraw <chain_id> <amount> <asset> <destination_address> [flags]
update-chain-config
Activa o reconfigura el puente de una cadena en una única transacción firmada (disponible a partir de la versión de la cadena v3.1.80). Requiere la clave bridge_admin o una licencia qcb_bridge — sin propuesta de gobernanza ni actualización de la cadena. Establece la dirección del contrato, el número de confirmaciones, la arquitectura y el estado.
qorechaind tx bridge update-chain-config <chain_id> [flags] --from bridge-admin
set-verifier-bootstrap
Selecciona el verificador activo de una cadena e instala su raíz de confianza (también restringido a bridge_admin).
qorechaind tx bridge set-verifier-bootstrap <chain_id> <verifier> [flags] --from bridge-admin
crossvm
call
Envía un mensaje cross-VM entre entornos de ejecución (EVM, CosmWasm, SVM).
qorechaind tx crossvm call <target_vm> <contract_address> <payload_hex> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--source-vm | string | VM de origen: evm, cosmwasm, svm |
--gas-limit | uint | Límite de gas para la ejecución cross-VM |
process-queue
Procesa manualmente los mensajes cross-VM pendientes (comando de operador).
qorechaind tx crossvm process-queue [flags]
svm
deploy-program
Despliega un programa BPF en el runtime SVM.
qorechaind tx svm deploy-program <program_binary_path> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--program-id | string | ID de programa opcional (base58) |
execute
Ejecuta una instrucción en un programa SVM desplegado.
qorechaind tx svm execute <program_id> <instruction_data_hex> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--accounts | string | Claves públicas de cuentas para la instrucción, separadas por comas |
create-account
Crea una nueva cuenta SVM con espacio de datos asignado.
qorechaind tx svm create-account <pubkey> <space> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--owner | string | Programa propietario (base58, por defecto: programa del sistema) |
multilayer
register-sidechain
Registra una nueva capa sidechain.
qorechaind tx multilayer register-sidechain <layer-id> <description> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--block-time-ms | uint | Tiempo de bloque objetivo en ms (por defecto 2000) |
--domains | string | Dominios admitidos separados por comas (por defecto defi) |
--max-tx | uint | Máximo de transacciones por bloque (por defecto 1000) |
--min-validators | uint32 | Tamaño mínimo del conjunto de validadores (por defecto 1) |
--settlement-interval | uint | Intervalo de liquidación en bloques (por defecto 100) |
--vm-types | string | Tipos de VM admitidos separados por comas (por defecto evm) |
register-paychain
Registra una nueva capa paychain para microtransacciones de alta frecuencia.
qorechaind tx multilayer register-paychain <layer-id> <description> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--max-tx | uint | Máximo de transacciones por bloque (por defecto 5000) |
--settlement-interval | uint | Intervalo de liquidación en bloques (por defecto 50) |
anchor-state
Envía un ancla de estado (liquidación) para una capa registrada.
qorechaind tx multilayer anchor-state <layer-id> <layer-height> <state-root-hex> <pqc-agg-sig-hex> [flags]
route-tx
Enruta una transacción a la capa óptima.
qorechaind tx multilayer route-tx <tx_data_hex> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--target-layer | string | Forzar el enrutamiento a una capa concreta |
update-layer-status
Actualiza el estado operativo de una capa (solo operador).
qorechaind tx multilayer update-layer-status <layer_id> <status> [flags]
Valores de estado: active, paused, draining.
challenge-anchor
Envía una impugnación por fraude contra un ancla de estado.
qorechaind tx multilayer challenge-anchor <layer_id> <anchor_hash> <proof_hex> [flags]
rdk
create-rollup
Registra un nuevo rollup con el Rollup Development Kit.
qorechaind tx rdk create-rollup <rollup_id> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--settlement-type | string | optimistic, zk, pessimistic, sovereign |
--profile | string | Preajuste: defi, gaming, nft, enterprise, custom |
--stake | string | Monto del stake del operador |
--da-enabled | bool | Habilitar la disponibilidad de datos nativa |
submit-batch
Envía un lote de liquidación para un rollup.
qorechaind tx rdk submit-batch <rollup_id> <state_root_hex> <batch_data_path> [flags]
challenge-batch
Envía una impugnación por fraude contra un lote de liquidación (rollups optimistas).
qorechaind tx rdk challenge-batch <rollup_id> <batch_index> <proof_hex> [flags]
finalize-batch
Finaliza manualmente un lote que ha superado la ventana de impugnación.
qorechaind tx rdk finalize-batch <rollup_id> <batch_index> [flags]
pause-rollup
Pausa un rollup (solo operador).
qorechaind tx rdk pause-rollup <rollup_id> [flags]
resume-rollup
Reanuda un rollup pausado (solo operador).
qorechaind tx rdk resume-rollup <rollup_id> [flags]
stop-rollup
Detiene permanentemente un rollup y libera su stake (solo operador).
qorechaind tx rdk stop-rollup <rollup_id> [flags]
El retiro de rollups y la liquidación entre capas también se exponen bajo el grupo de transacciones rdk (por ejemplo, un comando execute-withdrawal que liquida un retiro probado contra un lote finalizado). Los argumentos y flags exactos dependen del tipo de liquidación y de la configuración de DA de tu rollup; consulta la documentación del Rollup Development Kit para conocer la superficie de comandos autoritativa antes de construir estas transacciones.
babylon
submit-btc-checkpoint
Envía un checkpoint de BTC para una época.
qorechaind tx babylon submit-btc-checkpoint <epoch> <checkpoint_hex> [flags]
btc-restake
Vuelve a hacer staking de BTC a través de la integración con Babylon.
qorechaind tx babylon btc-restake <amount> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--btc-tx-hash | string | Hash de la transacción de Bitcoin como prueba |
abstractaccount
create
Crea una cuenta abstracta con reglas de gasto programables.
qorechaind tx abstractaccount create [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--spending-rules | string | Archivo JSON que define las reglas de gasto |
update-spending-rules
Actualiza las reglas de gasto de una cuenta abstracta existente.
qorechaind tx abstractaccount update-spending-rules <rules_file.json> [flags]
execute-cosmos
Retransmite un envío bancario de la vía Native autorizado por un autenticador desde una cuenta canónica (disponible a partir de la versión de la cadena v3.1.85). El relayer (--from) firma y paga el sobre; la autorización es la firma de la clave vinculada sobre los sign bytes ligados a la protección anti-repetición. Consulta Autenticadores de billeteras vinculadas.
qorechaind tx abstractaccount execute-cosmos <account> <to> <amount> \
<auth_pubkey_hex> <auth_signature_hex> <nonce> --from relayer -y
execute-evm
Retransmite una llamada o transferencia EVM autorizada por un autenticador desde la dirección EVM de la cuenta canónica (disponible a partir de la versión de la cadena v3.1.85). El nonce es el nonce EVM actual de la cuenta.
qorechaind tx abstractaccount execute-evm <account> <to> <value> <data_hex> \
<auth_pubkey_hex> <auth_signature_hex> <nonce> --from relayer -y
rlconsensus
PRISM es la capa de aprendizaje por refuerzo que ajusta los parámetros de consenso. Estos comandos controlan el agente PRISM; el nombre del módulo CLI rlconsensus y sus subcomandos se conservan textualmente.
set-agent-mode
Establece el modo operativo del agente PRISM (solo gobernanza).
qorechaind tx rlconsensus set-agent-mode <mode> [flags]
Valores de modo: 0 (apagado), 1 (observar), 2 (sugerir), 3 (automático).
resume-agent
Reanuda el agente PRISM tras la activación de un cortacircuitos.
qorechaind tx rlconsensus resume-agent [flags]
update-policy
Actualiza la configuración de la política del agente PRISM (solo gobernanza).
qorechaind tx rlconsensus update-policy <policy_file.json> [flags]
update-reward-weights
Actualiza la configuración de los pesos de recompensa para el agente PRISM.
qorechaind tx rlconsensus update-reward-weights [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--throughput-weight | string | Peso para la recompensa de rendimiento |
--latency-weight | string | Peso para la recompensa de latencia |
--security-weight | string | Peso para la recompensa de seguridad |