Zum Hauptinhalt springen

Transaktionsbefehle

Alle Transaktionsbefehle folgen dem Muster:

qorechaind tx <module> <command> [args] [flags]
hinweis

Setzen Sie --chain-id qorechain-vladi, um gegen das Live-Mainnet zu broadcasten, oder --chain-id qorechain-diana für das Testnet. Beide Netzwerke laufen auf der v3.2-Linie: Node-Release des Mainnets v3.2.7 (angewendet bei Höhe 4.164.600 am 12. November 2026 durch Governance-Vorschlag 16; v3.2.6 wurde bei Höhe 4.020.000 am 4. November 2026 angewendet; v3.2.5 wurde bei Höhe 3.906.833 am 29. Oktober 2026 angewendet und v3.2.4 wurde bei Höhe 3.742.566 am 23. Oktober 2026 angewendet und v3.2.3 bei Höhe 3.662.051 am 20. Oktober 2026), Testnet v3.2.8 (angewendet bei Höhe 9.929.500 am 12. November 2026, nach v3.2.7 bei Höhe 9.594.600 am 6. November, v3.2.6 bei Höhe 8.970.638 am 27. Oktober, v3.2.5 bei Höhe 8.890.800 am 26. Oktober und v3.2.4 bei Höhe 8.337.253 am 19. Oktober). Das aktuelle Release finden Sie in latest.json unter download.qore.host. Wird --chain-id weggelassen, verwendet der Client die chain-id aus Ihrer lokalen Client-Konfiguration.

Die Befehle und Flags auf dieser Seite wurden gegen die Release-Binary v3.2.3 sowie die Ergänzungen von v3.2.4 geprüft. Alles, was erst ab v3.2.4 existiert (Mainnet seit dem 23. Oktober 2026, Testnet seit dem 19. Oktober 2026), ist entsprechend gekennzeichnet. Die Quelle von v3.2.6 fügt keinen neuen tx-Befehl hinzu; sie ändert den Zustand des Testnets (Testtoken, ein aktiviertes Abstract-Account-Modul, offene Instanziierung von QoreChain Native), was die folgenden Abschnitte dort erwähnen, wo es relevant ist.

Die folgenden allgemeinen Flags gelten für jeden tx-Unterbefehl:

FlagTypBeschreibung
--fromstringName oder Adresse des Signaturschlüssels
--chain-idstringChain-Kennung (Standard: aus der Client-Konfiguration)
--feesstringTransaktionsgebühr, z. B. 40000uqor
--gas-pricesstringGaspreis anstelle von --fees, z. B. 0.1uqor
--gasstringGas-Limit oder auto zur Schätzung (Standard 200000)
--gas-adjustmentfloatMultiplikator, der auf die auto-Schätzung angewendet wird (Standard 1)
--keyring-backendstringos, file, kwallet, pass, test oder memory
--nodestringRPC-Endpunkt (Standard tcp://localhost:26657)
--broadcast-modestringsync oder async
--generate-onlyboolDie unsignierte Transaktion ausgeben, statt sie zu signieren
-yboolBestätigungsabfrage überspringen

Gebühren und Gas​

Die Netzwerk-Gebührenuntergrenze beträgt 0.1 uqor pro Gas-Einheit (query feemarket params zeigt min_gas_price; die aktuelle Basisgebühr kann unter Last über die Untergrenze steigen, siehe query feemarket base-fee). Eine Transaktion wird abgelehnt, sofern nicht fee >= gas limit x gas price gilt; --fees 500uqor funktioniert daher nur bei einem Gas-Limit von höchstens 5.000 und schlägt bei jeder realen Transaktion fehl.

TransaktionEmpfohlenes --gasPassendes --fees
Hybrid signierte Überweisung, Delegation, Abstimmung, Claim40000040000uqor
Registrierung eines PQC-Schlüssels60000060000uqor
lightnode register30000030000uqor

Eine hybride Signatur fügt einer Transaktion etwa 4,7 KB hinzu, die mit 10 Gas pro Byte berechnet werden; das Standard---gas 200000 reicht daher nicht immer aus: Hybrid signierte Überweisungen im Mainnet haben zwischen etwa 160.000 und 240.000 Gas verbraucht. Setzen Sie --gas stets explizit zusammen mit --fees (oder --gas-prices).


Hybride Signatur ist auf dem Cosmos-Pfad erforderlich​

hybrid_signature_mode steht in beiden Netzwerken auf required (qorechaind query pqc hybrid-mode). Jede Transaktion auf dem Cosmos-Pfad muss neben der secp256k1-Signatur eine ML-DSA-87-Signatur (Dilithium-5) tragen; ein einfaches tx bank send ... -y wird abgelehnt (Codespace pqc, Code 20). Die einzigen Ausnahmen sind seit Mainnet v3.2.3:

  • die erste Registrierung eines PQC-Schlüssels für ein Konto, das noch keinen Schlüssel hat (register-key oder register-key-v2), damit ein neues Konto sich selbst einrichten kann;
  • die Reparatur eines Kontodatensatzes, der keinen nutzbaren Schlüssel enthält, mit register-key-v2;
  • tx slashing unjail für ein Konto ohne registrierten PQC-Schlüssel.

Ein Konto, das bereits einen PQC-Schlüssel besitzt, muss alles hybrid signieren, einschließlich register-key-v2 und migrate-key (ein Versuch nur mit klassischer Signatur wird mit Code 234 abgelehnt). Ein Konto ohne Schlüssel kann ebenfalls keine hybride Signatur anfügen: Es hat nichts, wogegen verifiziert werden könnte, daher registriert es zuerst.

Jeder Befehl auf dieser Seite außer der ersten Registrierung (pqc register-key / pqc register-key-v2 bei einem Konto ohne Schlüssel) wird deshalb in zwei Schritten ausgeführt: Erstellen Sie die Transaktion mit --generate-only und signieren und broadcasten Sie sie dann mit tx pqc cosign. pqc rotate-key übernimmt Cosignierung und Broadcast selbst; pqc gen-key und pqc recover-key erzeugen nur lokal eine Schlüsseldatei:

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

Der Schlüsselname mypqc steht für einen mit tx pqc gen-key erzeugten Schlüssel, der für das Konto registriert ist (siehe pqc). Verwenden Sie dafür das offizielle Release-Binary von download.qore.host: Ein aus dem öffentlichen Quellbaum gebautes Binary kann keine Dilithium-Signatur erzeugen oder anwenden (gen-key und cosign melden, dass sie den vollständigen Build benötigen). QoreX und die SDKs übernehmen dieselbe Signierung für Sie.


bank​

send​

Token von einem Konto auf ein anderes übertragen.

qorechaind tx bank send <from_key_or_address> <to_address> <amount> [flags]

Beispiel: qorechaind tx bank send mykey qor1recipient... 1000000uqor --gas 400000 --fees 40000uqor --chain-id qorechain-vladi --generate-only > tx.json, anschließend tx pqc cosign wie oben gezeigt. 1 QOR = 1.000.000 uqor.


staking​

create-validator​

Einen Validator aus einer JSON-Datei erstellen (die Flag-basierte Form wurde entfernt). Im Mainnet sind zusätzlich eine aktive validator_operator-Lizenz und ein registrierter PQC-Schlüssel erforderlich; siehe 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​

Beschreibung oder Provision eines bestehenden Validators bearbeiten.

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. Weggelassene Felder bleiben unverändert.

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​

Einen laufenden Unbonding-Eintrag abbrechen.

qorechaind tx staking cancel-unbond <validator_address> <amount> <creation_height> [flags]

slashing​

unjail​

Einen inhaftierten (jailed) Validator nach Ablauf der Jail-Dauer in das aktive Set zurückführen.

qorechaind tx slashing unjail --from mykey [flags]

distribution​

withdraw-all-rewards​

Alle ausstehenden Staking-Belohnungen abheben.

qorechaind tx distribution withdraw-all-rewards [flags]

withdraw-rewards​

Belohnungen von einem Validator abheben.

qorechaind tx distribution withdraw-rewards <validator_address> [flags]
FlagTypBeschreibung
--commissionboolZusätzlich die Provision abheben (Operator-Adressen von Validatoren)

gov​

submit-proposal​

Einen Governance-Vorschlag aus einer JSON-Datei mit messages, metadata, deposit, title, summary und optional expedited einreichen. Ein Grundgerüst erzeugen Sie mit qorechaind tx gov draft-proposal.

qorechaind tx gov submit-proposal <proposal_file.json> [flags]

vote​

qorechaind tx gov vote <proposal_id> <option> [flags]

Abstimmungsoptionen: yes, no, abstain, no_with_veto. Mit tx gov weighted-vote <proposal_id> yes=0.6,no=0.4 lässt sich eine Stimme aufteilen.

deposit​

qorechaind tx gov deposit <proposal_id> <amount> [flags]

pqc​

gen-key​

Einen Dilithium-5-Schlüssel (ML-DSA-87) erzeugen und unter <home>/pqc/<name>.dilithium speichern (Modus 0600, nicht verschlüsselt). Der öffentliche Schlüssel wird als Hex ausgegeben.

qorechaind tx pqc gen-key <name>

gen-key und recover-key weigern sich, eine vorhandene Schlüsseldatei dieses Namens zu überschreiben; --force ersetzt sie und behält die alte Datei als <name>.dilithium.bak-<unix-time>.

register-key​

Einen öffentlichen PQC-Schlüssel für Ihr Konto registrieren (Legacy-Befehl: der Algorithmus ist Dilithium-5). Eine Erstregistrierung wird nur mit dem klassischen Schlüssel signiert; dies ist die Bootstrap-Ausnahme. Ein Konto, das bereits einen Schlüssel hat, muss sie hybrid signieren (--generate-only, dann 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 ist hybrid (empfohlen) oder pqc_only. classical_only wird abgelehnt (Code 230): Es registriert keinen Post-Quanten-Schlüssel, sodass das Konto nie wieder signieren könnte. Der 2.592 Byte große öffentliche Schlüssel macht die Registrierung teurer als eine Überweisung; deshalb ist das höhere Gas-Limit nötig.

Die Chain lehnt außerdem einen Schlüssel ab, der keinen Post-Quanten-Schutz bietet (Code 230), sowie einen Schlüssel, den dieses Konto bereits früher verwendet hat (Code 232). Sie lehnt eine Registrierung ab, deren klassischer Schlüssel nicht der eigene des Signierenden ist (Code 45).

register-key-v2​

Einen Schlüssel mit expliziter Algorithmusauswahl registrieren und optional nachweisen, dass Sie das Geheimnis des Schlüssels besitzen.

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 ist dilithium5 (oder 1) oder mlkem1024 (oder 2); key_type ist hybrid oder pqc_only.

Besitznachweis (optional). Mit --pqc-key <name> (ein mit gen-key oder recover-key erzeugter Schlüssel) fügt der Befehl einen Besitznachweis (Proof of Possession) an: die eigene Signatur des neuen Schlüssels über qorechain-pqc-pop-v1|<chain-id>|<algorithm id>|<address>|<public key hex>. Die Chain verifiziert ihn, wenn er vorhanden ist, und lehnt die Registrierung ab, wenn er nicht verifiziert werden kann (Code 231); eine Registrierung ohne ihn wird weiterhin akzeptiert. Der Nachweis benennt die Chain, den Algorithmus, das Konto und den Schlüssel, beweist also nichts für ein anderes Konto oder Netzwerk. Er fügt der Transaktion eine 4.627 Byte große Signatur hinzu, behalten Sie das Gas-Limit daher bei 600000. Der Nachweis wird im Feld proof_of_possession der Nachricht übertragen. Das TypeScript-SDK 0.9.0 fügt über ensurePqcRegistered selbst einen an, sobald das Netzwerk v3.2.3 angewendet hat; frühere SDK-Releases und @qorechain/wallet-adapter tun das nicht, sodass eine damit vorgenommene Registrierung keinen Nachweis trägt (wird weiterhin akzeptiert).

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

Ab v3.2.4 (Mainnet seit dem 23. Oktober 2026, Testnet seit dem 19. Oktober 2026) meldet der Kontodatensatz außerdem, ob ein Nachweis verifiziert wurde, als possession_proven (siehe REST- / gRPC-Endpunkte).

cosign​

Eine unsignierte Transaktion mit dem PQC-Schlüssel und dem klassischen Schlüssel des Kontos signieren und anschließend broadcasten.

qorechaind tx pqc cosign <unsigned_tx_file> --from <key> --pqc-key <name> --chain-id <id>
FlagBeschreibung
--pqc-keyName des mit gen-key oder recover-key erzeugten Schlüssels
--sign-bytesauto (Standard: fragt die Chain, welche Sign-Bytes-Form gilt), v1 oder v2
--generate-only / --offlineDie signierte Transaktion als JSON ausgeben, statt sie zu broadcasten; später mit tx broadcast absenden; --offline benötigt zusätzlich --account-number, --sequence und --sign-bytes v1|v2
--dry-runSimulieren und die Gas-Schätzung ausgeben

v3.2.7 (Testnet seit dem 6. November 2026, Mainnet seit dem 12. November 2026): cosign unterstützt auch SIGN_MODE_TEXTUAL mit der Post-Quanten-Erweiterung, für Hardware-Wallets; Web-Wallets erhalten das Dokument von POST /qorechain/pqc/v1/textual_sign_doc (siehe REST-/gRPC-Endpunkte). Die Flags für den textuellen Modus sind hier nicht aufgeführt, weil sie nicht gegen die v3.2.7-Binary geprüft wurden: Führen Sie qorechaind tx pqc cosign --help mit einer v3.2.7-Binary aus.

Beide Netzwerke haben das Upgrade eingespielt, das die hybride Verifikation auf die v2-Sign-Bytes umgestellt hat; die v1-Form wird abgelehnt. Eine Transaktion darf nur eine hybride Signaturerweiterung tragen (mehr als eine wird seit v3.2.3 abgelehnt).

migrate-key​

Den PQC-Schlüssel Ihres Kontos von einem Algorithmus auf einen anderen migrieren. Für Ihren aktuellen Algorithmus muss eine Migration aktiv sein (von der Governance gestartet); beide Schlüssel signieren die Migrations-Bytes, und die Transaktion selbst benötigt Ihre hybride Signatur (--generate-only, dann tx pqc cosign). Ein Schlüssel, den das Konto bereits früher verwendet hat, wird abgelehnt (Code 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​

Den ML-DSA-87-Schlüssel des Kontos aus seiner BIP-39-Mnemonic rekonstruieren (von stdin gelesen) und lokal speichern. Verwendet SHAKE-256("qorechain:pqc:v1|address|mnemonic").

echo "<mnemonic>" | qorechaind tx pqc recover-key <name> <address> [flags]
FlagTypBeschreibung
--derivationstringadapter (kanonisch, Standard) oder bridge (Legacy: SHAKE-256(mnemonic))

rotate-key​

Den ML-DSA-87-Schlüssel des Kontos innerhalb desselben Algorithmus rotieren. Liest die Mnemonic von stdin, signiert doppelt mit dem alten und dem neuen Schlüssel, cosigniert mit dem alten Schlüssel und broadcastet.

echo "<mnemonic>" | qorechaind tx pqc rotate-key --from mykey --old-derivation bridge --new-derivation adapter \
--gas 600000 --fees 60000uqor --chain-id qorechain-vladi
FlagTypBeschreibung
--old-derivationstringAbleitung des derzeit registrierten Schlüssels: bridge (Standard) oder adapter
--new-derivationstringAbleitung des neuen Schlüssels: adapter (Standard) oder bridge
--new-randomboolAuf einen frischen Zufallsschlüssel rotieren; erfordert --new-key-out
--new-key-outstringDen neuen privaten Schlüssel als <home>/pqc/<name>.dilithium speichern, bevor etwas gesendet wird
--sign-bytesstringauto (Standard), v1 oder v2

Seit v3.2.3 lehnt eine Rotation einen neuen Schlüssel ab, der keinen Post-Quanten-Schutz bietet (Code 230), sowie einen Schlüssel, den das Konto bereits früher verwendet hat (Code 232); das Konto merkt sich die Schlüssel, von denen es weg rotiert hat, sodass eine Rotation nicht wiederholt werden kann, um zu einem alten Schlüssel zurückzukehren.

open-evm-window​

Der EVM-Pfad lässt eine Transaktion nur von einem Konto zu, das einen registrierten PQC-Schlüssel besitzt und ein offenes Autorisierungsfenster hat. Ein Fenster wird mit einer Nachricht auf dem Cosmos-Pfad geöffnet und trägt damit die PQC-Signatur, die eine Ethereum-Wallet nicht liefern kann. Innerhalb des Fensters funktionieren gewöhnliche MetaMask-Transaktionen unverändert.

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
ArgumentGrenzeBedeutung
blocks1 bis 17.280Wie lange das Fenster offen bleibt, gerechnet ab dem Block, der es öffnet
max-txs1 bis 1.000Wie viele EVM-Transaktionen es zulässt
max-valuepositivZulässige Gesamtsumme, bestehend aus dem übertragenen Wert und der maximalen Gebühr, die jede Transaktion zahlen könnte; uqor oder qor, z. B. 1000qor

Das Öffnen eines Fensters ersetzt ein eventuell bestehendes. Prüfen Sie es mit qorechaind query pqc evm-window <address>.

Fenster mit eingeschränktem Umfang (Mainnet v3.2.3 und später). Die Wertgrenze zählt nur natives QOR: Eine Token-Überweisung, eine Genehmigung (Approval) oder jeder andere Contract-Aufruf trägt den Wert null und wird nicht darauf angerechnet. Zwei optionale Flags schränken ein, welche Empfänger das Fenster zulässt (sie begrenzen keine Token-Beträge):

FlagWirkung
--native-onlyNur einfache QOR-Überweisungen zulassen: keine Calldata, keine Contract-Erstellung, kein Empfänger mit Code, keine EIP-7702-Autorisierung
--allowed-targetsNur diese Empfänger zulassen (kommagetrennte 0x-Adressen); Contract-Erstellung wird abgelehnt
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

allowed_targets begrenzt, welche Contracts und Token ein Fenster berühren darf, nicht wie viel. Ein aufgelisteter Token lässt jeden Betrag dieses Tokens zu, einschließlich approve, und ein aufgelisteter Contract kann alles bewegen, was sein Code und bestehende Genehmigungen (Approvals) erlauben; listen Sie daher keine generischen Forwarder- oder Router-Contracts auf. Ein Fenster begrenzt nur Transaktionen auf der EVM-Lane (klassisch signiert); Cosmos-Nachrichten, die mit der hybriden PQC-Signatur signiert sind, etwa VM-übergreifende Aufrufe und authz, liegen außerhalb davon.

Ein Fenster, das ohne eines der beiden Flags geöffnet wird, lässt zu, was es schon immer zugelassen hat. Der Umfang wird von der Fensterabfrage als native_only und allowed_targets gemeldet.

close-evm-window​

Ihr Fenster sofort schließen, zum Beispiel wenn Sie vermuten, dass der klassische Schlüssel kompromittiert ist. Es widerruft außerdem eine ausstehende EIP-7702-Delegationszustimmung.

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 und clear-evm-delegation​

Eine EIP-7702-Delegation Ihres Kontos wird nur mit Ihrer eigenen Post-Quanten-Zustimmung wirksam (Mainnet seit v3.2.2). authorize-evm-delegation hält diese Zustimmung für eine Delegate-Adresse fest; sie ist einmalig verwendbar, läuft nach der angegebenen Anzahl von Blöcken ab und wird durch close-evm-window widerrufen. clear-evm-delegation entfernt eine bereits gesetzte Delegation. Beides sind hybrid signierte Nachrichten auf dem Cosmos-Pfad (--generate-only, dann 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

Die Nulladresse als delegate stimmt dem Löschen der Delegation zu. Den Zustand prüfen Sie mit qorechaind query pqc evm-delegation-consent <address>.

Keine der PQC-Schlüsselnachrichten (register-key, register-key-v2, rotate-key, migrate-key) kann im Auftrag eines Kontos über authz gesendet werden (Mainnet v3.2.3 und später).


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 ist sx oder ux. Die Registrierung erfordert eine aktive lightnode_operator-Lizenz, die von der Lizenzautorität des Netzwerks vergeben wird; den aktuellen Status des Programms finden Sie unter Light Node. Weitere Befehle: tx lightnode heartbeat, tx lightnode claim-rewards, tx lightnode deregister.

Seit v3.2.3 ist die Belohnung, die ein Node ansammeln kann, pro Monat begrenzt (max_reward_per_month_per_node in GET /qorechain/lightnode/v1/reward_pool, 2.000 QOR pro 30 Tage), anteilig nach Blockzeit und Uptime, sodass die Grenze nicht mehr davon abhängt, wie schnell Blöcke erzeugt werden. Eine Grenze ist eine Obergrenze, kein zugesagter Betrag. Ab v3.2.4 (Mainnet seit dem 23. Oktober 2026, Testnet seit dem 19. Oktober 2026) beginnt die Grenze eines Nodes mit seiner eigenen Registrierung statt mit der vorherigen Abrechnung.


bridge​

Die Bridge ist nicht in Produktion: In beiden Netzwerken befindet sich jede konfigurierte Chain im Status pending, und es sind keine Bridge-Validatoren registriert (query bridge chains, query bridge validators).

withdraw​

qorechaind tx bridge withdraw <destination_chain> <destination_address> <asset> <amount> [flags]

deposit​

Von einer Quell-Chain per Bridge hereingeholte Assets gutschreiben. Trägt Validator-Signaturen (--validator-sigs, --pqc-commitment); es ist eine Nachricht für Bridge-Operatoren und nicht der Weg, auf dem ein Endnutzer eine Einzahlung startet.

qorechaind tx bridge deposit <source_chain> <source_tx_hash> <asset> <amount> [flags]

register-validator / attest​

Nachrichten für Bridge-Validatoren. register-validator <pqc_pubkey_hex> <supported_chains_csv> registriert einen Validator für die Attestierungsaufgabe, und attest <chain> <event_type> <operation_id> <tx_hash> <amount> <asset> [--pqc-signature <hex>] [--proof <hex>] reicht eine Attestierung ein. In keinem der beiden Netzwerke ist ein Bridge-Validator registriert. Ab v3.2.4 (Mainnet seit dem 23. Oktober 2026, Testnet seit dem 19. Oktober 2026) benötigt die Registrierung eines Bridge-Validators außerdem einen Besitznachweis und einen Schlüssel, den kein anderer Bridge-Validator verwendet.

update-chain-config / set-verifier-bootstrap / update-circuit-breaker-limits​

Administrativ (bridge_admin- oder qcb_bridge-Lizenz; die Circuit-Breaker-Limits können auch per Governance gesetzt werden).

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]

Limits werden in Basiseinheiten angegeben, und 0 bedeutet unbegrenzt. Nur eine Route, deren Status genau active ist, bewegt Werte.


ibc-transfer​

qorechaind tx ibc-transfer transfer transfer <channel> <receiver> <amount> [flags]

Das erste transfer ist der Unterbefehl, das zweite der Quell-Port. Zum Zeitpunkt der Erstellung ist im Mainnet kein IBC-Kanal geöffnet; das Testnet hat einen offenen Transferkanal (channel-0), geprüft am 27. Oktober 2026 mit query ibc channel channels.


amm​

Native AMM-Nachrichten. Zum Zeitpunkt der Erstellung existiert in keinem der beiden Netzwerke ein Pool, daher haben diese Befehle noch nichts, worauf sie wirken könnten.

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]

Seit v3.2.2 muss ein Swap beide Denominationen des Pools nennen, max_swap_impact_bps wird durchgesetzt und die Protokollgebühr wird über das Burn-Modul geleitet.

Im Testnet kann ein Pool uqor mit einem der drei Fest-Testtoken (ohne Wert; nur Testnet) paaren. Die Einlage und die Swap-Beträge verwenden die Bank-Denomination erc20:<EIP-55 0x address>, bei der die Groß-/Kleinschreibung beachtet wird, zum Beispiel qorechaind tx amm create-pool constant_product 1000000000uqor 2000000000erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA --from mykey --generate-only > tx.json (danach tx pqc cosign). Ein auf der EVM-Seite gehaltener Token muss zuerst mit MsgConvertERC20 in eine Bank-Coin umgewandelt werden, deren Sender eine qor1-Adresse ist; der CLI-Befehl qorechaind tx erc20 convert-erc20 des Node-Releases v3.2.6 schreibt den Sender als 0x-Adresse, und die Chain lehnt ihn ab (decoding bech32 failed); bauen Sie diese Nachricht daher stattdessen mit dem qor1-Sender. Details: Fest-Testtoken im Testnet. Das Erstellen eines Pools kostet zusätzlich zu den Einlagen die Pool-Erstellungsgebühr (pool_creation_fee in query amm params).


gasabstraction​

qorechaind tx gasabstraction fund-float <amount> [flags]

Überträgt native Token (zum Beispiel 1000000uqor) in den Gebührenumrechnungs-Float, die QOR-Reserve, mit der das Modul Validatoren bezahlt, wenn eine Gebühr in einem anderen akzeptierten Token entrichtet wird. Die Governance entscheidet, welche Token akzeptiert werden. In beiden Netzwerken akzeptiert die Konfiguration nur natives uqor, daher findet keine Umrechnung statt; prüfen Sie dies mit qorechaind query gasabstraction accepted-tokens.


crossvm​

qorechaind tx crossvm call <evm|cosmwasm|svm> <target_contract> --payload <hex> [--funds <coins>] [--async] [flags]

call ist im Mainnet durch den Circuit Breaker abgeschaltet (siehe unten) und funktioniert im Testnet nur dort, wo der Ziel-Pfad verfügbar ist. Ein eingereihter Aufruf (--async), der fehlschlägt, hinterlässt keine Nebeneffekte, nur seinen Failed-Datensatz (seit v3.2.3), und ein Aufruf, dessen abgeleiteter Quell-Pfad dem Ziel-Pfad entspricht, wird abgelehnt. Siehe Cross-VM-Interoperabilität.


stakingtier (v3.2.4)​

Ab v3.2.4 verfügbar

Das Staking-Tiers-Modul kam mit dem Release v3.2.4: Es läuft seit dem 19. Oktober 2026 im qorechain-diana-Testnet und seit dem 23. Oktober 2026 im Mainnet (Höhe 3.742.566, Governance-Vorschlag 13). Ein Node mit einem älteren Release hat das Modul nicht, und diese Befehle werden abgelehnt; prüfen Sie zuerst GET /qorechain/stakingtier/v1/params auf dem Node, den Sie ansprechen.

Optionale zeitgesperrte Delegationen: Ein Delegator kann einen Teil einer bestehenden Delegation für 3, 6 oder 12 Monate sperren (die Mindestsperre beträgt 10 QOR) und später den Bonus abrufen, den das Modul dafür gutschreibt. Eine Sperre ist ein Datensatz zusätzlich zur Delegation: Die delegierten Mittel bleiben beim Validator.

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]

Die Sperre wird vom Staking-Message-Server durchgesetzt und erfasst daher auch das Undelegieren über authz, eine Gruppe oder einen Contract. Eine vorzeitig beendete Sperre verwirkt ihren nicht ausgezahlten Bonus und verbrennt eine Strafe; der Mindestsperrbetrag und die übrigen Parameter stehen in GET /qorechain/stakingtier/v1/params. Wie jede Transaktion auf dem Cosmos-Pfad benötigen diese die hybride Cosignierung (--generate-only, dann tx pqc cosign) und ein großzügiges Gas-Limit (zum Beispiel --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 ist defi, gaming, nft, enterprise oder custom; stake_amount wird in uqor angegeben (das aktuelle Minimum steht in query rdk config). Die Voreinstellung des Profils liefert Settlement, Sequencer, DA und Gas-Modell; nur die VM lässt sich auf der Kommandozeile überschreiben. Einen Befehl finalize-batch gibt es nicht.

Bei einem Rollup, dessen Data Availability native (oder both) ist, lassen Sie --data-hash leer: Keine Transaktion veröffentlicht einen Data-Availability-Blob, und die Chain lehnt einen Batch ab, der für ein solches Rollup einen Datenhash angibt (so verhält sich das Node-Release v3.2.4, das zum Zeitpunkt der Erstellung aktuelle Mainnet-Release). Für ein optimistisches Rollup setzt der Client @qorechain/rdk (0.8.0) den State Root eines Batches auf den kanonischen Übergangs-Root der Chain (batchTransitionRoot im RDK); siehe Rollups.

--anchor-signature ist die ML-DSA-Signatur des Rollup-Erstellers über die v2-Anchor-Sign-Bytes; damit wird der Batch zusätzlich im Multilayer-Modul verankert. Die genauen zu signierenden Bytes gibt qorechaind query rdk anchor-sign-bytes <layer_id> <batch_index> <state_root_hex> --tx-count <n> --validator-set-hash <hex> aus; die Werte müssen mit den Flags von submit-batch übereinstimmen. Seit v3.2.3 führt das Modul ein Escrow-Hauptbuch pro Rollup: Eine Auszahlung wird nur aus dem bezahlt, was das Hauptbuch dieses Rollups enthält, und sie wird auf Denomination, einen positiven Betrag, Beweistiefe und Geschwistergröße geprüft; das Stoppen eines Rollups erstattet nur, was in seinem Hauptbuch übrig ist, und ein gestopptes Rollup zahlt keine weiteren Auszahlungen. Zum Zeitpunkt der Erstellung existiert in keinem der beiden Netzwerke ein Rollup.


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 ist proposed, active, suspended oder decommissioned. update-layer-status ist im Mainnet durch den Circuit Breaker deaktiviert (siehe unten).


Derzeit deaktivierte oder nicht verfügbare Nachrichten​

Einige Befehle existieren im Binary, können in den Live-Netzwerken aber nicht erfolgreich sein:

BefehlGrund
tx wasm store, tx wasm instantiate, instantiate2Mainnet: Die Berechtigung zum Hochladen und Instanziieren ist Nobody, und die drei Nachrichtentypen stehen auf der Circuit-Breaker-Liste. Testnet: Das Hochladen ist Nobody und MsgStoreCode steht auf der Liste (die Governance speichert Code), während die Instanziierung offen ist (Everybody) und nicht auf der Liste steht
tx crossvm callIm Mainnet durch den Circuit Breaker deaktiviert; im Testnet aktiviert
tx vesting create-vesting-account, create-periodic-vesting-account, create-permanent-locked-accountAuf der Circuit-Breaker-Liste des Mainnets; seit v3.2.3 kann ein Vesting-Konto ohnehin nur für den Signierenden selbst erstellt werden
PQC MsgDeprecateAlgorithm / MsgDisableAlgorithmNachrichten für Governance-Vorschläge (kein CLI-Befehl), auf der Circuit-Breaker-Liste des Mainnets; seit v3.2.3 kann die Governance außerdem den letzten aktiven Signaturalgorithmus nicht entfernen
tx svm deploy-program, execute, create-accountDer SVM-Transaktionspfad ist netzwerkweit deaktiviert
tx abstractaccount create, register-authenticator, execute-cosmos, execute-evmMainnet: Das Abstract-Account-Modul ist abgeschaltet (query abstractaccount config zeigt enabled: false). Testnet: per Governance eingeschaltet (enabled: true, geprüft am 27. Oktober 2026)
tx rlconsensus *, tx amm pause-pool/resume-poolNachrichten der Governance-Autorität; stehen ebenfalls auf der Circuit-Breaker-Liste des Mainnets
tx license *Nur für die Autorität (Lizenzen werden von der Lizenzautorität des Netzwerks vergeben; seit v3.2.3 kann die Governance diese Autorität mit MsgUpdateAuthority ersetzen)

Die aktuelle Liste liefert qorechaind query circuit disabled-list.