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, o --chain-id qorechain-diana para la testnet. Ambas redes ejecutan la línea v3.2: versión de nodo de la mainnet v3.2.3 (aplicada en la altura 3,662,051 el 20 de octubre de 2026; la mainnet ejecuta v3.2.3 hasta la altura 3,742,566 y v3.2.4 desde ese bloque, programada por la propuesta de gobernanza 13), testnet v3.2.4 (aplicada en la altura 8,337,253 el 19 de octubre de 2026). Consulta latest.json en download.qore.host para ver la versión actual. Si se omite --chain-id, el cliente usa el chain-id de tu configuración local de cliente.
Los comandos y las flags de esta página se comprobaron con el binario de la versión v3.2.3. Todo lo que existe solo a partir de v3.2.4 (la testnet ahora, la mainnet desde la altura 3,742,566) se marca como tal.
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 del cliente) |
--fees | string | Comisión de la transacción, p. ej. 40000uqor |
--gas-prices | string | Precio del gas en lugar de --fees, p. ej. 0.1uqor |
--gas | string | Límite de gas, o auto para estimarlo (por defecto 200000) |
--gas-adjustment | float | Multiplicador aplicado a la estimación auto (por defecto 1) |
--keyring-backend | string | os, file, kwallet, pass, test o memory |
--node | string | Endpoint RPC (por defecto tcp://localhost:26657) |
--broadcast-mode | string | sync o async |
--generate-only | bool | Imprime la transacción sin firmar en lugar de firmarla |
-y | bool | Omitir el mensaje de confirmación |
Comisiones y gas
El mínimo de comisión de la red es 0.1 uqor por unidad de gas (query feemarket params muestra min_gas_price; la comisión base en vivo puede subir por encima del mínimo bajo carga, consulta query feemarket base-fee). Una transacción se rechaza a menos que fee >= gas limit x gas price, por lo que --fees 500uqor solo funciona con un límite de gas de 5,000 o menos y falla en cualquier transacción real.
| Transacción | --gas sugerido | --fees correspondiente |
|---|---|---|
| Transferencia, delegación, voto o reclamación con firma híbrida | 400000 | 40000uqor |
| Registro de clave PQC | 600000 | 60000uqor |
lightnode register | 300000 | 30000uqor |
Una firma híbrida añade unos 4.7 KB a una transacción, que se cobran a 10 de gas por byte, por lo que el --gas 200000 por defecto no siempre es suficiente: las transferencias con firma híbrida en la mainnet han usado entre aproximadamente 160,000 y 240,000 de gas. Establece siempre --gas de forma explícita junto con --fees (o --gas-prices).
La firma híbrida es obligatoria en la vía Cosmos
hybrid_signature_mode es required en ambas redes (qorechaind query pqc hybrid-mode). Toda transacción de la vía Cosmos debe llevar una firma ML-DSA-87 (Dilithium-5) junto a la firma secp256k1; un simple tx bank send ... -y se rechaza (codespace pqc, código 20). Las únicas excepciones, desde la mainnet v3.2.3, son:
- el primer registro de clave PQC de una cuenta que aún no tiene ninguna clave (
register-keyoregister-key-v2), para que una cuenta nueva pueda arrancar (bootstrap); - la reparación, con
register-key-v2, de un registro de cuenta que no contiene ninguna clave utilizable; tx slashing unjailpara una cuenta que no tiene ninguna clave PQC registrada.
Una cuenta que ya tiene una clave PQC debe firmar todo con firma híbrida, incluidos register-key-v2 y migrate-key (un intento solo con firma clásica se rechaza con el código 234). Una cuenta sin clave tampoco puede adjuntar una firma híbrida: no tiene nada contra lo que verificar, así que primero se registra.
Por ello, todos los comandos de esta página excepto el primer registro (pqc register-key / pqc register-key-v2 en una cuenta sin clave) se ejecutan en dos pasos: construye la transacción con --generate-only y luego fírmala y transmítela con tx pqc cosign. pqc rotate-key realiza por sí mismo la cofirma y la transmisión; pqc gen-key y pqc recover-key solo crean un archivo de clave en local:
qorechaind tx bank send mykey qor1recipient... 1000000uqor \
--gas 400000 --fees 40000uqor --chain-id qorechain-vladi \
--generate-only > tx.json
qorechaind tx pqc cosign tx.json --from mykey --pqc-key mypqc --chain-id qorechain-vladi
El nombre de clave mypqc es una clave creada con tx pqc gen-key y registrada en la cuenta (consulta pqc). Usa para ello el binario oficial de la versión publicado en download.qore.host: un binario compilado a partir del árbol de código fuente público no puede crear ni aplicar una firma Dilithium (gen-key y cosign informan de que necesitan la compilación completa). QoreX y los SDK realizan esta misma firma por ti.
bank
send
Transfiere tokens de una cuenta a otra.
qorechaind tx bank send <from_key_or_address> <to_address> <amount> [flags]
Ejemplo: qorechaind tx bank send mykey qor1recipient... 1000000uqor --gas 400000 --fees 40000uqor --chain-id qorechain-vladi --generate-only > tx.json, y después tx pqc cosign como se muestra arriba. 1 QOR = 1,000,000 uqor.
staking
create-validator
Crea un validador a partir de un archivo JSON (la forma basada en flags fue eliminada). La mainnet además requiere una licencia validator_operator activa y una clave PQC registrada; consulta Running a Validator.
qorechaind tx staking create-validator validator.json \
--from mykey --gas 600000 --fees 60000uqor --chain-id qorechain-vladi \
--generate-only > tx.json
validator.json:
{
"pubkey": {"@type": "/cosmos.crypto.ed25519.PubKey", "key": "<base64 key from: qorechaind comet show-validator>"},
"amount": "100000000000uqor",
"moniker": "my-validator",
"identity": "",
"website": "",
"security": "",
"details": "",
"commission-rate": "0.10",
"commission-max-rate": "0.20",
"commission-max-change-rate": "0.01",
"min-self-delegation": "1"
}
edit-validator
Edita la descripción o la comisión de un validador existente.
qorechaind tx staking edit-validator --new-moniker "new-name" --website "https://example.org" --from mykey [flags]
Flags: --new-moniker, --website, --identity, --security-contact, --details, --commission-rate, --min-self-delegation. Los campos omitidos se dejan sin cambios.
delegate
qorechaind tx staking delegate <validator_address> <amount> [flags]
redelegate
qorechaind tx staking redelegate <src_validator> <dst_validator> <amount> [flags]
unbond
qorechaind tx staking unbond <validator_address> <amount> [flags]
cancel-unbond
Cancela una entrada de unbonding en curso.
qorechaind tx staking cancel-unbond <validator_address> <amount> <creation_height> [flags]
slashing
unjail
Devuelve un validador encarcelado (jailed) al conjunto activo una vez transcurrido el periodo de encarcelamiento.
qorechaind tx slashing unjail --from mykey [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.
qorechaind tx distribution withdraw-rewards <validator_address> [flags]
| Flag | Tipo | Descripción |
|---|---|---|
--commission | bool | Retirar también la comisión (direcciones de operador de validador) |
gov
submit-proposal
Envía una propuesta de gobernanza a partir de un archivo JSON con messages, metadata, deposit, title, summary y, opcionalmente, expedited. Genera un esqueleto con qorechaind tx gov draft-proposal.
qorechaind tx gov submit-proposal <proposal_file.json> [flags]
vote
qorechaind tx gov vote <proposal_id> <option> [flags]
Opciones de voto: yes, no, abstain, no_with_veto. Usa tx gov weighted-vote <proposal_id> yes=0.6,no=0.4 para dividir un voto.
deposit
qorechaind tx gov deposit <proposal_id> <amount> [flags]
pqc
gen-key
Genera una clave Dilithium-5 (ML-DSA-87) y la almacena en <home>/pqc/<name>.dilithium (modo 0600, sin cifrar). Imprime la clave pública en hex.
qorechaind tx pqc gen-key <name>
gen-key y recover-key se niegan a sobrescribir un archivo de clave existente con ese nombre; --force lo reemplaza y conserva el archivo anterior como <name>.dilithium.bak-<unix-time>.
register-key
Registra una clave pública PQC para tu cuenta (comando heredado: el algoritmo es Dilithium-5). Un primer registro se firma solo con la clave clásica; esta es la excepción de arranque (bootstrap). Una cuenta que ya tiene una clave debe firmarlo con firma híbrida (--generate-only y luego tx pqc cosign).
qorechaind tx pqc register-key <pubkey_hex> <key_type> --from mykey --gas 600000 --fees 60000uqor --chain-id qorechain-vladi -y
key_type es hybrid (recomendado) o pqc_only. classical_only se rechaza (código 230): no registra ninguna clave poscuántica, por lo que la cuenta nunca podría volver a firmar. La clave pública de 2,592 bytes hace que el registro sea más costoso que una transferencia, por lo que necesita el límite de gas más alto.
La cadena también rechaza una clave que no ofrece protección poscuántica (código 230) y una clave que esta cuenta ya ha usado antes (código 232). Rechaza un registro cuya clave clásica no es la del propio firmante (código 45).
register-key-v2
Registra una clave con selección explícita del algoritmo y, opcionalmente, demuestra que posees el secreto de la clave.
qorechaind tx pqc register-key-v2 <algorithm> <pubkey_hex> <key_type> [--pqc-key <name>] \
--from mykey --gas 600000 --fees 60000uqor --chain-id qorechain-vladi -y
algorithm es dilithium5 (o 1) o mlkem1024 (o 2); key_type es hybrid o pqc_only.
Prueba de posesión (opcional). Con --pqc-key <name> (una clave creada con gen-key o recover-key), el comando adjunta una prueba de posesión: la firma de la propia clave nueva sobre qorechain-pqc-pop-v1|<chain-id>|<algorithm id>|<address>|<public key hex>. La cadena la verifica cuando está presente y rechaza el registro si no se verifica (código 231); un registro sin ella se sigue aceptando. La prueba nombra la cadena, el algoritmo, la cuenta y la clave, por lo que no prueba nada para otra cuenta ni otra red. Añade una firma de 4,627 bytes a la transacción, así que mantén el límite de gas en 600000. La prueba viaja en el campo proof_of_possession del mensaje. El SDK de TypeScript 0.9.0 adjunta una por sí mismo mediante ensurePqcRegistered una vez que la red haya aplicado v3.2.3; las versiones anteriores del SDK y @qorechain/wallet-adapter no lo hacen, por lo que un registro hecho con ellos no lleva prueba (se sigue aceptando).
qorechaind tx pqc gen-key mypqc # prints the public key hex
qorechaind tx pqc register-key-v2 dilithium5 <pubkey_hex> hybrid --pqc-key mypqc \
--from mykey --gas 600000 --fees 60000uqor --chain-id qorechain-vladi -y
Desde v3.2.4 (en la testnet desde el 19 de octubre de 2026; en la mainnet desde la altura 3,742,566) el registro de la cuenta también informa si se verificó una prueba, como possession_proven (consulta Endpoints REST / gRPC); un nodo de la mainnet que todavía esté en v3.2.3 no lo informa.
cosign
Firma una transacción sin firmar con la clave PQC y la clave clásica de la cuenta, y después la transmite.
qorechaind tx pqc cosign <unsigned_tx_file> --from <key> --pqc-key <name> --chain-id <id>
| Flag | Descripción |
|---|---|
--pqc-key | Nombre de la clave creada con gen-key o recover-key |
--sign-bytes | auto (por defecto: pregunta a la cadena qué forma de sign-bytes se aplica), v1 o v2 |
--generate-only / --offline | Imprime la transacción firmada como JSON en lugar de transmitirla; envíala después con tx broadcast; --offline también necesita --account-number, --sequence y --sign-bytes v1|v2 |
--dry-run | Simula e imprime la estimación de gas |
Ambas redes han aplicado la actualización que trasladó la verificación híbrida a los sign-bytes v2; la forma v1 se rechaza. Una transacción solo puede llevar una extensión de firma híbrida (desde v3.2.3 se rechaza más de una).
migrate-key
Migra la clave PQC de tu cuenta de un algoritmo a otro. Debe haber una migración activa para tu algoritmo actual (iniciada por gobernanza); ambas claves firman los bytes de la migración, y la propia transacción necesita tu firma híbrida (--generate-only y luego tx pqc cosign). Una clave que la cuenta ya ha usado antes se rechaza (código 232).
qorechaind tx pqc migrate-key <new_algorithm> <old_pubkey_hex> <new_pubkey_hex> <old_sig_hex> <new_sig_hex> --generate-only [flags] > m.json
qorechaind tx pqc cosign m.json --from mykey --pqc-key mypqc --chain-id qorechain-vladi
recover-key
Reconstruye la clave ML-DSA-87 de la cuenta a partir de su mnemónico BIP-39 (leído desde stdin) y la almacena localmente. Usa SHAKE-256("qorechain:pqc:v1|address|mnemonic").
echo "<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. Lee el mnemónico desde stdin, firma doblemente con la clave antigua y la nueva, cofirma con la clave antigua y transmite.
echo "<mnemonic>" | qorechaind tx pqc rotate-key --from mykey --old-derivation bridge --new-derivation adapter \
--gas 600000 --fees 60000uqor --chain-id qorechain-vladi
| Flag | Tipo | Descripción |
|---|---|---|
--old-derivation | string | Derivación de la clave registrada actualmente: bridge (por defecto) o adapter |
--new-derivation | string | Derivación de la nueva clave: adapter (por defecto) o bridge |
--new-random | bool | Rotar a una clave aleatoria nueva; requiere --new-key-out |
--new-key-out | string | Guardar la nueva clave privada como <home>/pqc/<name>.dilithium antes de enviar nada |
--sign-bytes | string | auto (por defecto), v1 o v2 |
Desde v3.2.3, una rotación rechaza una clave nueva que no ofrece protección poscuántica (código 230) y una clave que la cuenta ya ha usado antes (código 232); la cuenta recuerda las claves que ha dejado atrás al rotar, por lo que una rotación no puede repetirse para volver a una clave antigua.
open-evm-window
La vía EVM admite una transacción solo de una cuenta que tenga una clave PQC registrada y una ventana de autorización abierta. La ventana se abre con un mensaje de la vía Cosmos, de modo que lleva la firma PQC que una billetera Ethereum no puede aportar. Dentro de la ventana, las transacciones normales de MetaMask funcionan sin cambios.
qorechaind tx pqc open-evm-window <blocks> <max-txs> <max-value> --from mykey \
--gas 400000 --fees 40000uqor --chain-id qorechain-vladi --generate-only > w.json
qorechaind tx pqc cosign w.json --from mykey --pqc-key mypqc --chain-id qorechain-vladi
| Argumento | Límite | Significado |
|---|---|---|
blocks | 1 a 17,280 | Cuánto tiempo permanece abierta la ventana, contado desde el bloque que la abre |
max-txs | 1 a 1,000 | Cuántas transacciones EVM admite |
max-value | positivo | Total admitido, contando el valor transferido y la comisión máxima que podría pagar cada transacción; uqor o qor, p. ej. 1000qor |
Abrir una ventana sustituye a cualquier ventana existente. Compruébala con qorechaind query pqc evm-window <address>.
Ventanas con alcance (mainnet v3.2.3 y posteriores). El límite de valor cuenta solo QOR nativo: una transferencia de tokens, una aprobación o cualquier otra llamada a un contrato lleva valor cero y no se cuenta contra él. Dos flags opcionales restringen lo que admite la ventana:
| Flag | Efecto |
|---|---|
--native-only | Admite solo transferencias simples de QOR: sin calldata, sin creación de contratos, sin destinatario que contenga código, sin autorización EIP-7702 |
--allowed-targets | Admite solo estos destinatarios (direcciones 0x separadas por comas); la creación de contratos se rechaza |
qorechaind tx pqc open-evm-window 7200 20 1000qor --native-only --from mykey \
--gas 400000 --fees 40000uqor --chain-id qorechain-vladi --generate-only > w.json
Una ventana abierta sin ninguna de las dos flags admite lo que siempre admitió. La consulta de la ventana informa el alcance como native_only y allowed_targets.
close-evm-window
Cierra tu ventana de inmediato, por ejemplo cuando sospechas que la clave clásica está comprometida. También revoca un consentimiento de delegación EIP-7702 pendiente.
qorechaind tx pqc close-evm-window --from mykey --gas 400000 --fees 40000uqor --chain-id qorechain-vladi --generate-only > c.json
qorechaind tx pqc cosign c.json --from mykey --pqc-key mypqc --chain-id qorechain-vladi
authorize-evm-delegation y clear-evm-delegation
Una delegación EIP-7702 de tu cuenta solo surte efecto con tu propio consentimiento poscuántico (mainnet desde v3.2.2). authorize-evm-delegation registra ese consentimiento para una dirección delegada; es de un solo uso, caduca tras el número de bloques indicado y se revoca con close-evm-window. clear-evm-delegation elimina una delegación que ya está establecida. Ambos son mensajes de la vía Cosmos con firma híbrida (--generate-only y luego tx pqc cosign).
qorechaind tx pqc authorize-evm-delegation <delegate_0x_address> <blocks> --from mykey \
--gas 400000 --fees 40000uqor --chain-id qorechain-vladi --generate-only > d.json
qorechaind tx pqc clear-evm-delegation --from mykey \
--gas 400000 --fees 40000uqor --chain-id qorechain-vladi --generate-only > d.json
La dirección cero como delegate consiente en eliminar la delegación. Comprueba el estado con qorechaind query pqc evm-delegation-consent <address>.
Ninguno de los mensajes de clave PQC (register-key, register-key-v2, rotate-key, migrate-key) puede enviarse en nombre de una cuenta mediante authz (mainnet v3.2.3 y posteriores).
lightnode
qorechaind tx lightnode register <node_type> <version> [--capabilities <csv>] --from operator \
--gas 300000 --fees 30000uqor --chain-id qorechain-vladi --generate-only > register.json
qorechaind tx pqc cosign register.json --from operator --pqc-key <name> --chain-id qorechain-vladi
node_type es sx o ux. El registro requiere una licencia lightnode_operator activa concedida por la autoridad de licencias de la red; consulta Light Node para ver el estado actual del programa. Otros comandos: tx lightnode heartbeat, tx lightnode claim-rewards, tx lightnode deregister.
Desde v3.2.3, la recompensa que un nodo puede acumular está limitada por mes (max_reward_per_month_per_node en GET /qorechain/lightnode/v1/reward_pool, 2,000 QOR por 30 días), prorrateada por tiempo de bloque y disponibilidad, de modo que el límite ya no depende de la rapidez con que se producen los bloques. Un límite es un techo, no una cantidad prometida. Desde v3.2.4 (en la testnet desde el 19 de octubre de 2026; en la mainnet desde la altura 3,742,566) el límite de un nodo comienza en su propio registro y no en la liquidación anterior.
bridge
El puente no está en producción: en ambas redes todas las cadenas configuradas están en estado pending y no hay validadores de puente registrados (query bridge chains, query bridge validators).
withdraw
qorechaind tx bridge withdraw <destination_chain> <destination_address> <asset> <amount> [flags]
deposit
Acredita activos transferidos por el puente desde una cadena de origen. Lleva firmas de validadores (--validator-sigs, --pqc-commitment); es un mensaje de operador del puente, no la forma en que un usuario final inicia un depósito.
qorechaind tx bridge deposit <source_chain> <source_tx_hash> <asset> <amount> [flags]
register-validator / attest
Mensajes de validador del puente. register-validator <pqc_pubkey_hex> <supported_chains_csv> registra un validador para la función de atestación y attest <chain> <event_type> <operation_id> <tx_hash> <amount> <asset> [--pqc-signature <hex>] [--proof <hex>] envía una atestación. No hay ningún validador de puente registrado en ninguna de las dos redes. Desde v3.2.4 (en la testnet desde el 19 de octubre de 2026; en la mainnet desde la altura 3,742,566), el registro de un validador de puente también necesita una prueba de posesión y una clave que no use ningún otro validador de puente.
update-chain-config / set-verifier-bootstrap / update-circuit-breaker-limits
Administrativos (licencia bridge_admin o qcb_bridge; los límites del cortacircuitos también pueden establecerse por gobernanza).
qorechaind tx bridge update-chain-config <chain_id> [--status active|paused|pending] [--verifier <kind>] [--contract <addr>] [--confirmations <n>] [--architecture <a>] [--lock-event-sig <hex>] [flags]
qorechaind tx bridge set-verifier-bootstrap <kind> <chain_id> [flags]
qorechaind tx bridge update-circuit-breaker-limits <chain_id> <max_single_transfer> <daily_limit> [flags]
Los límites están en unidades base y 0 significa ilimitado. Solo una ruta cuyo estado es exactamente active mueve valor.
ibc-transfer
qorechaind tx ibc-transfer transfer transfer <channel> <receiver> <amount> [flags]
El primer transfer es el subcomando y el segundo es el puerto de origen. En el momento de escribir esto no hay canales IBC abiertos en ninguna de las dos redes (query ibc channel channels).
amm
Mensajes del AMM nativo. En el momento de escribir esto no existe ningún pool en ninguna de las dos redes, así que estos comandos todavía no tienen nada sobre lo que actuar.
qorechaind tx amm create-pool <pool_type> <deposit_a> <deposit_b> [flags] # pool_type: constant_product | stable_swap; deposits as coins, e.g. 1000000uqor
qorechaind tx amm add-liquidity <pool_id> <amount_a> <amount_b> <min_lp_out> [flags]
qorechaind tx amm remove-liquidity <pool_id> <lp_amount> <min_a> <min_b> [flags]
qorechaind tx amm swap-exact-in <pool_id> <token_in> <denom_out> <min_out> [flags]
qorechaind tx amm swap-exact-out <pool_id> <denom_in> <token_out> <max_in> [flags]
Desde v3.2.2, un swap debe nombrar las dos denominaciones del pool, se aplica max_swap_impact_bps y la comisión del protocolo se canaliza a través del módulo burn.
gasabstraction
qorechaind tx gasabstraction fund-float <amount> [flags]
Traslada tokens nativos (por ejemplo 1000000uqor) al float de conversión de comisiones, la reserva de QOR que el módulo usa para pagar a los validadores cuando una comisión se paga en otro token aceptado. La gobernanza decide qué tokens se aceptan. En ambas redes la configuración acepta solo uqor nativo, por lo que no se realiza ninguna conversión; compruébalo con qorechaind query gasabstraction accepted-tokens.
crossvm
qorechaind tx crossvm call <evm|cosmwasm|svm> <target_contract> --payload <hex> [--funds <coins>] [--async] [flags]
call está desactivado en la mainnet por el cortacircuitos (consulta más abajo) y en la testnet solo funciona donde la vía de destino está disponible. Una llamada en cola (--async) que falla no deja efectos secundarios, solo su registro Failed (desde v3.2.3), y se rechaza una llamada cuya vía de origen derivada es igual a su vía de destino. Consulta Interoperabilidad Cross-VM.
stakingtier (v3.2.4)
El módulo de niveles de staking llegó con la versión v3.2.4: se ejecuta en la testnet qorechain-diana desde el 19 de octubre de 2026 y en la mainnet desde la altura 3,742,566 (propuesta de gobernanza 13). Antes de esa altura, un nodo de la mainnet no tiene el módulo y estos comandos son rechazados; comprueba primero GET /qorechain/stakingtier/v1/params en el nodo al que apuntes.
Delegaciones opcionales bloqueadas en el tiempo: un delegador puede bloquear parte de una delegación existente durante 3, 6 o 12 meses (el bloqueo mínimo es de 10 QOR) y reclamar después la bonificación que el módulo acredita por ello. Un bloqueo es un registro encima de la delegación: los fondos delegados permanecen con el validador.
qorechaind tx stakingtier lock <validator_address> <amount_uqor> <months> [flags] # months: 3, 6 or 12
qorechaind tx stakingtier unlock-early <lock_id> [flags]
qorechaind tx stakingtier claim [flags]
El bloqueo lo aplica el servidor de mensajes de staking, por lo que también cubre la retirada de la delegación mediante authz, un grupo o un contrato. Terminar un bloqueo anticipadamente hace perder su bonificación no pagada y quema una penalización; el monto mínimo del bloqueo y los demás parámetros están en GET /qorechain/stakingtier/v1/params. Como toda transacción de la vía Cosmos, estas necesitan la cofirma híbrida (--generate-only y luego tx pqc cosign) y un límite de gas generoso (por ejemplo --gas 900000 --fees 90000uqor).
rdk
qorechaind tx rdk create-rollup <rollup_id> <profile> <stake_amount> [--vm evm|cosmwasm|svm|custom] [flags]
qorechaind tx rdk submit-batch <rollup_id> <batch_index> <state_root_hex> [--prev-state-root <hex>] [--tx-count <n>] [--data-hash <hex>] [--withdrawals-root <hex>] [--validator-set-hash <hex>] [--anchor-signature <hex>] [flags]
qorechaind tx rdk challenge-batch <rollup_id> <batch_index> --proof <hex> [flags]
qorechaind tx rdk pause-rollup <rollup_id> <reason> [flags]
qorechaind tx rdk resume-rollup <rollup_id> [flags]
qorechaind tx rdk stop-rollup <rollup_id> [flags]
qorechaind tx rdk execute-withdrawal <rollup_id> <batch_index> <withdrawal_index> <recipient> <denom> <amount> --proof <hex,hex,...> [flags]
profile es defi, gaming, nft, enterprise o custom; stake_amount está en uqor (el mínimo actual figura en query rdk config). El preajuste del perfil aporta la liquidación, el secuenciador, la DA y el modelo de gas; solo la VM puede sobrescribirse desde la línea de comandos. No existe un comando finalize-batch.
--anchor-signature es la firma ML-DSA del creador del rollup sobre los bytes de firma de anclaje v2; con ella el lote también se ancla en el módulo multilayer. Imprime los bytes exactos que hay que firmar con qorechaind query rdk anchor-sign-bytes <layer_id> <batch_index> <state_root_hex> --tx-count <n> --validator-set-hash <hex>; los valores deben coincidir con las flags de submit-batch. Desde v3.2.3, el módulo mantiene un libro de depósito en garantía (escrow) por rollup: una retirada se paga solo con lo que contiene el libro de ese rollup, y se comprueban la denominación, un monto positivo, la profundidad de la prueba y el tamaño de los hermanos; detener un rollup reembolsa solo lo que queda en su libro, y un rollup detenido no paga más retiradas. En el momento de escribir esto no existe ningún rollup en ninguna de las dos redes.
multilayer
qorechaind tx multilayer register-sidechain <layer_id> <description> [--block-time-ms 2000] [--domains defi] [--max-tx 1000] [--min-validators 1] [--settlement-interval 100] [--vm-types evm] [flags]
qorechaind tx multilayer register-paychain <layer_id> <description> [--max-tx 5000] [--settlement-interval 50] [--base-fee-multiplier 0.01] [flags]
qorechaind tx multilayer anchor-state <layer_id> <layer_height> <state_root_hex> <pqc_agg_sig_hex> [flags]
qorechaind tx multilayer route-transaction <payload_hex> [--preferred-layer <id>] [--max-latency-ms 10000] [--max-fee 1000000] [flags]
qorechaind tx multilayer challenge-anchor <layer_id> <anchor_height> <fraud_proof_hex> <reason> [flags]
qorechaind tx multilayer update-layer-status <layer_id> <new_status> <reason> [flags]
new_status es proposed, active, suspended o decommissioned. update-layer-status está deshabilitado en la mainnet por el cortacircuitos (consulta más abajo).
Mensajes deshabilitados o no disponibles hoy
Algunos comandos existen en el binario pero no pueden tener éxito en las redes en vivo:
| Comando | Motivo |
|---|---|
tx wasm store, tx wasm instantiate, instantiate2 | El permiso de carga e instanciación es Nobody en ambas redes, y los tipos de mensaje también están en la lista del cortacircuitos |
tx crossvm call | Deshabilitado en la mainnet por el cortacircuitos; habilitado en la testnet |
tx vesting create-vesting-account, create-periodic-vesting-account, create-permanent-locked-account | En la lista del cortacircuitos de la mainnet; desde v3.2.3, en cualquier caso una cuenta de vesting solo puede crearse para el propio firmante |
PQC MsgDeprecateAlgorithm / MsgDisableAlgorithm | Mensajes de propuesta de gobernanza (sin comando de CLI), en la lista del cortacircuitos de la mainnet; desde v3.2.3, la gobernanza tampoco puede eliminar el último algoritmo de firma activo |
tx svm deploy-program, execute, create-account | La vía de transacciones SVM está deshabilitada en toda la red |
tx abstractaccount create, register-authenticator, execute-cosmos, execute-evm | El módulo de cuenta abstracta está desactivado (query abstractaccount config muestra enabled: false) |
tx rlconsensus *, tx amm pause-pool/resume-pool | Mensajes de la autoridad de gobernanza; también están en la lista del cortacircuitos de la mainnet |
tx license * | Solo para la autoridad (las licencias las concede la autoridad de licencias de la red; desde v3.2.3 la gobernanza puede sustituir esa autoridad con MsgUpdateAuthority) |
La lista en vivo es qorechaind query circuit disabled-list.