Commandes de transaction
Toutes les commandes de transaction suivent le modèle :
qorechaind tx <module> <command> [args] [flags]
Définissez --chain-id qorechain-vladi pour diffuser vos transactions sur le mainnet en production (version de chaîne v3.1.85), ou --chain-id qorechain-diana pour le testnet. Si ce paramètre est omis, le client utilise le chain-id de votre configuration locale.
Des drapeaux communs s'appliquent à chaque sous-commande tx :
| Drapeau | Type | Description |
|---|---|---|
--from | string | Nom ou adresse de la clé de signature |
--chain-id | string | Identifiant de la chaîne (par défaut : depuis la configuration) |
--fees | string | Frais de transaction (p. ex. 500uqor) |
--gas | string | Limite de gaz ou auto pour l'estimation |
--gas-adjustment | float | Multiplicateur de gaz lors de l'utilisation de auto (par défaut : 1.0) |
--keyring-backend | string | Backend du trousseau de clés : os, file, test |
--node | string | Point de terminaison RPC (par défaut : tcp://localhost:26657) |
--broadcast-mode | string | sync, async ou block |
-y | bool | Ignorer l'invite de confirmation |
bank
send
Transférer des jetons d'un compte à un autre.
qorechaind tx bank send <from_address> <to_address> <amount> [flags]
staking
create-validator
Créer un nouveau validateur sur le réseau.
qorechaind tx staking create-validator [flags]
| Drapeau | Type | Description |
|---|---|---|
--amount | string | Montant de l'auto-délégation (p. ex. 1000000uqor) |
--pubkey | string | Clé publique de consensus du validateur (JSON) |
--moniker | string | Nom d'affichage du validateur |
--commission-rate | string | Taux de commission initial (p. ex. 0.10) |
--commission-max-rate | string | Taux de commission maximal |
--commission-max-change-rate | string | Taux de variation quotidienne maximal de la commission |
--min-self-delegation | string | Auto-délégation minimale requise |
edit-validator
Modifier la description ou la commission d'un validateur existant.
qorechaind tx staking edit-validator [flags]
delegate
Déléguer des jetons à un validateur.
qorechaind tx staking delegate <validator_address> <amount> [flags]
redelegate
Déplacer une délégation d'un validateur vers un autre.
qorechaind tx staking redelegate <src_validator> <dst_validator> <amount> [flags]
unbond
Retirer des jetons délégués (unbonding) d'un validateur.
qorechaind tx staking unbond <validator_address> <amount> [flags]
distribution
withdraw-all-rewards
Retirer toutes les récompenses de staking en attente.
qorechaind tx distribution withdraw-all-rewards [flags]
withdraw-rewards
Retirer les récompenses d'un validateur spécifique.
qorechaind tx distribution withdraw-rewards <validator_address> [flags]
| Drapeau | Type | Description |
|---|---|---|
--commission | bool | Retirer également la commission du validateur |
gov
submit-proposal
Soumettre une proposition de gouvernance.
qorechaind tx gov submit-proposal <proposal_file.json> [flags]
Le fichier de proposition est un document JSON spécifiant le type de proposition, le titre, la description et les éventuels messages à exécuter.
vote
Voter sur une proposition active.
qorechaind tx gov vote <proposal_id> <option> [flags]
Options de vote : yes, no, abstain, no_with_veto.
deposit
Ajouter un dépôt à une proposition.
qorechaind tx gov deposit <proposal_id> <amount> [flags]
pqc
Le chemin de transaction cosmos exige par défaut une signature hybride (hybrid_signature_mode = required). Les commandes gen-key et cosign produisent la clé Dilithium-5 (ML-DSA-87) et l'extension PQCHybridSignature nécessaires pour effectuer des transactions sur le chemin cosmos aux côtés de la signature classique secp256k1.
gen-key
Générer une clé post-quantique Dilithium-5 (ML-DSA-87) pour la signature hybride.
qorechaind tx pqc gen-key [flags]
cosign
Attacher une cosignature Dilithium-5 à une transaction sous forme d'extension PQCHybridSignature, produisant une transaction hybride (secp256k1 + ML-DSA-87). Requis pour les transactions du chemin cosmos sous le mode d'application par défaut required. Les outils CosmJS / relayeurs standard doivent produire cette extension pour effectuer des transactions ; la fonction buildHybridTx du SDK QoreChain (avec includePqcPublicKey) fait l'équivalent.
qorechaind tx pqc cosign <unsigned_tx_file> [flags]
register-key
Enregistrer une clé publique post-quantique pour un compte.
qorechaind tx pqc register-key <algorithm> <pubkey_hex> [flags]
register-key-v2
Enregistrer une clé PQC avec des métadonnées étendues et une attestation.
qorechaind tx pqc register-key-v2 <algorithm> <pubkey_hex> [flags]
| Drapeau | Type | Description |
|---|---|---|
--attestation | string | Données d'attestation TEE (hex) |
--metadata | string | Métadonnées supplémentaires de la clé (JSON) |
migrate-key
Migrer une clé classique existante vers une paire de clés PQC hybride.
qorechaind tx pqc migrate-key <algorithm> <pqc_pubkey_hex> [flags]
recover-key
Reconstruire de manière déterministe la clé ML-DSA-87 du compte à partir de sa phrase mnémonique BIP-39 (lue depuis stdin) et la stocker localement (disponible à partir de la version de chaîne v3.1.85). Utilise la dérivation standard de l'écosystème SHAKE-256("qorechain:pqc:v1|address|mnemonic").
qorechaind tx pqc recover-key <name> <address> [flags]
| Drapeau | Type | Description |
|---|---|---|
--derivation | string | adapter (canonique, par défaut) ou bridge (héritée, SHAKE-256(mnemonic)) |
rotate-key
Effectuer une rotation de la clé ML-DSA-87 du compte au sein du même algorithme (disponible à partir de la version de chaîne v3.1.85) — p. ex. migrer une clé issue de la dérivation héritée vers la dérivation canonique, ou retirer une clé compromise. Lit la phrase mnémonique depuis stdin, effectue une double signature avec l'ancienne et la nouvelle clé, cosigne l'enveloppe avec l'ancienne clé, puis diffuse la transaction. N'émet que le JSON de la transaction sur stdout (les lignes informatives vont sur stderr), ce qui la rend composable avec -o json.
qorechaind tx pqc rotate-key [flags]
| Drapeau | Type | Description |
|---|---|---|
--old-derivation | string | Dérivation de la clé actuellement enregistrée (adapter | bridge) |
--new-derivation | string | Dérivation de la nouvelle clé (adapter | bridge) |
--new-random | bool | Générer une nouvelle clé aléatoire à la place |
xqore
lock
Verrouiller des jetons QOR dans une position de staking de gouvernance xQORE.
qorechaind tx xqore lock <amount> [flags]
| Drapeau | Type | Description |
|---|---|---|
--lock-duration | string | Durée de verrouillage (p. ex. 30d, 90d, 180d) |
unlock
Déverrouiller des xQORE pour les reconvertir en QOR. Un déverrouillage anticipé peut entraîner des pénalités selon le palier de pénalité.
qorechaind tx xqore unlock <amount> [flags]
bridge
deposit
Initier un dépôt via le pont depuis une chaîne externe.
qorechaind tx bridge deposit <chain_id> <amount> <asset> [flags]
| Drapeau | Type | Description |
|---|---|---|
--recipient | string | Adresse du destinataire sur QoreChain |
withdraw
Initier un retrait via le pont vers une chaîne externe.
qorechaind tx bridge withdraw <chain_id> <amount> <asset> <destination_address> [flags]
update-chain-config
Activer ou reconfigurer le pont d'une chaîne en une seule transaction signée (disponible à partir de la version de chaîne v3.1.80). Nécessite la clé bridge_admin ou une licence qcb_bridge — aucune proposition de gouvernance ni mise à niveau de la chaîne n'est requise. Définit l'adresse du contrat, le nombre de confirmations, l'architecture et le statut.
qorechaind tx bridge update-chain-config <chain_id> [flags] --from bridge-admin
set-verifier-bootstrap
Sélectionner le vérificateur actif d'une chaîne et installer sa racine de confiance (également réservé à bridge_admin).
qorechaind tx bridge set-verifier-bootstrap <chain_id> <verifier> [flags] --from bridge-admin
crossvm
call
Envoyer un message inter-VM entre environnements d'exécution (EVM, CosmWasm, SVM).
qorechaind tx crossvm call <target_vm> <contract_address> <payload_hex> [flags]
| Drapeau | Type | Description |
|---|---|---|
--source-vm | string | VM source : evm, cosmwasm, svm |
--gas-limit | uint | Limite de gaz pour l'exécution inter-VM |
process-queue
Traiter manuellement les messages inter-VM en attente (commande opérateur).
qorechaind tx crossvm process-queue [flags]
svm
deploy-program
Déployer un programme BPF sur l'environnement d'exécution SVM.
qorechaind tx svm deploy-program <program_binary_path> [flags]
| Drapeau | Type | Description |
|---|---|---|
--program-id | string | Identifiant de programme optionnel (base58) |
execute
Exécuter une instruction sur un programme SVM déployé.
qorechaind tx svm execute <program_id> <instruction_data_hex> [flags]
| Drapeau | Type | Description |
|---|---|---|
--accounts | string | Clés publiques des comptes pour l'instruction, séparées par des virgules |
create-account
Créer un nouveau compte SVM avec un espace de données alloué.
qorechaind tx svm create-account <pubkey> <space> [flags]
| Drapeau | Type | Description |
|---|---|---|
--owner | string | Programme propriétaire (base58, par défaut : programme système) |
multilayer
register-sidechain
Enregistrer une nouvelle couche sidechain.
qorechaind tx multilayer register-sidechain <layer-id> <description> [flags]
| Drapeau | Type | Description |
|---|---|---|
--block-time-ms | uint | Temps de bloc cible en ms (par défaut 2000) |
--domains | string | Domaines pris en charge, séparés par des virgules (par défaut defi) |
--max-tx | uint | Nombre maximal de transactions par bloc (par défaut 1000) |
--min-validators | uint32 | Taille minimale de l'ensemble de validateurs (par défaut 1) |
--settlement-interval | uint | Intervalle de règlement en blocs (par défaut 100) |
--vm-types | string | Types de VM pris en charge, séparés par des virgules (par défaut evm) |
register-paychain
Enregistrer une nouvelle couche paychain pour les microtransactions à haute fréquence.
qorechaind tx multilayer register-paychain <layer-id> <description> [flags]
| Drapeau | Type | Description |
|---|---|---|
--max-tx | uint | Nombre maximal de transactions par bloc (par défaut 5000) |
--settlement-interval | uint | Intervalle de règlement en blocs (par défaut 50) |
anchor-state
Soumettre un ancrage d'état (règlement) pour une couche enregistrée.
qorechaind tx multilayer anchor-state <layer-id> <layer-height> <state-root-hex> <pqc-agg-sig-hex> [flags]
route-tx
Acheminer une transaction vers la couche optimale.
qorechaind tx multilayer route-tx <tx_data_hex> [flags]
| Drapeau | Type | Description |
|---|---|---|
--target-layer | string | Forcer l'acheminement vers une couche spécifique |
update-layer-status
Mettre à jour le statut opérationnel d'une couche (opérateur uniquement).
qorechaind tx multilayer update-layer-status <layer_id> <status> [flags]
Valeurs de statut : active, paused, draining.
challenge-anchor
Soumettre une contestation pour fraude contre un ancrage d'état.
qorechaind tx multilayer challenge-anchor <layer_id> <anchor_hash> <proof_hex> [flags]
rdk
create-rollup
Enregistrer un nouveau rollup auprès du Rollup Development Kit.
qorechaind tx rdk create-rollup <rollup_id> [flags]
| Drapeau | Type | Description |
|---|---|---|
--settlement-type | string | optimistic, zk, pessimistic, sovereign |
--profile | string | Préréglage : defi, gaming, nft, enterprise, custom |
--stake | string | Montant de la mise de l'opérateur |
--da-enabled | bool | Activer la disponibilité des données native |
submit-batch
Soumettre un lot de règlement pour un rollup.
qorechaind tx rdk submit-batch <rollup_id> <state_root_hex> <batch_data_path> [flags]
challenge-batch
Soumettre une contestation pour fraude contre un lot de règlement (rollups optimistes).
qorechaind tx rdk challenge-batch <rollup_id> <batch_index> <proof_hex> [flags]
finalize-batch
Finaliser manuellement un lot dont la fenêtre de contestation est écoulée.
qorechaind tx rdk finalize-batch <rollup_id> <batch_index> [flags]
pause-rollup
Mettre en pause un rollup (opérateur uniquement).
qorechaind tx rdk pause-rollup <rollup_id> [flags]
resume-rollup
Reprendre un rollup mis en pause (opérateur uniquement).
qorechaind tx rdk resume-rollup <rollup_id> [flags]
stop-rollup
Arrêter définitivement un rollup et libérer sa mise (opérateur uniquement).
qorechaind tx rdk stop-rollup <rollup_id> [flags]
Le retrait depuis un rollup et le règlement inter-couches sont également exposés dans le groupe de transactions rdk (par exemple, une commande execute-withdrawal qui règle un retrait prouvé contre un lot finalisé). Les arguments et drapeaux exacts dépendent du type de règlement et de la configuration DA de votre rollup ; consultez la documentation du Rollup Development Kit pour connaître la surface de commandes faisant autorité avant de construire ces transactions.
babylon
submit-btc-checkpoint
Soumettre un point de contrôle BTC pour une époque.
qorechaind tx babylon submit-btc-checkpoint <epoch> <checkpoint_hex> [flags]
btc-restake
Restaker du BTC via l'intégration Babylon.
qorechaind tx babylon btc-restake <amount> [flags]
| Drapeau | Type | Description |
|---|---|---|
--btc-tx-hash | string | Hash de la transaction Bitcoin servant de preuve |
abstractaccount
create
Créer un compte abstrait avec des règles de dépense programmables.
qorechaind tx abstractaccount create [flags]
| Drapeau | Type | Description |
|---|---|---|
--spending-rules | string | Fichier JSON définissant les règles de dépense |
update-spending-rules
Mettre à jour les règles de dépense d'un compte abstrait existant.
qorechaind tx abstractaccount update-spending-rules <rules_file.json> [flags]
execute-cosmos
Relayer un envoi bancaire de la voie Native autorisé par un authentificateur depuis un compte canonique (disponible à partir de la version de chaîne v3.1.85). Le relayeur (--from) signe et paie l'enveloppe ; la signature de la clé liée sur les octets de signature protégés contre la relecture constitue l'autorisation. Voir Authentificateurs de portefeuilles liés.
qorechaind tx abstractaccount execute-cosmos <account> <to> <amount> \
<auth_pubkey_hex> <auth_signature_hex> <nonce> --from relayer -y
execute-evm
Relayer un appel ou un transfert EVM autorisé par un authentificateur depuis l'adresse EVM du compte canonique (disponible à partir de la version de chaîne v3.1.85). Le nonce est le nonce EVM actuel du compte.
qorechaind tx abstractaccount execute-evm <account> <to> <value> <data_hex> \
<auth_pubkey_hex> <auth_signature_hex> <nonce> --from relayer -y
rlconsensus
PRISM est la couche d'apprentissage par renforcement qui ajuste les paramètres de consensus. Ces commandes contrôlent l'agent PRISM ; le nom du module CLI rlconsensus et ses sous-commandes sont conservés tels quels.
set-agent-mode
Définir le mode opérationnel de l'agent PRISM (gouvernance uniquement).
qorechaind tx rlconsensus set-agent-mode <mode> [flags]
Valeurs de mode : 0 (désactivé), 1 (observation), 2 (suggestion), 3 (automatique).
resume-agent
Reprendre l'agent PRISM après le déclenchement d'un disjoncteur.
qorechaind tx rlconsensus resume-agent [flags]
update-policy
Mettre à jour la configuration de politique de l'agent PRISM (gouvernance uniquement).
qorechaind tx rlconsensus update-policy <policy_file.json> [flags]
update-reward-weights
Mettre à jour la configuration des poids de récompense pour l'agent PRISM.
qorechaind tx rlconsensus update-reward-weights [flags]
| Drapeau | Type | Description |
|---|---|---|
--throughput-weight | string | Poids de la récompense de débit |
--latency-weight | string | Poids de la récompense de latence |
--security-weight | string | Poids de la récompense de sécurité |