EVM-Entwicklung
QoreChain betreibt eine vollständig EVM-kompatible Ausführungsumgebung auf der QoreChain EVM Engine und ermöglicht es, Solidity-Smart-Contracts mit vertrauten Werkzeugen bereitzustellen und mit ihnen zu interagieren. Das EVM-Modul stellt eine JSON-RPC-Schnittstelle auf Port 8545 bereit (WebSocket auf 8546), die gängige Ethereum-Entwicklungsworkflows unterstützt.
Die folgenden Beispiele richten sich an das qorechain-vladi-Mainnet (EVM-Chain-ID 9801), das seit dem 7. Juni 2026 live ist und zum Zeitpunkt der Erstellung das Node-Release v3.2.7 ausführt (angewendet durch Governance-Vorschlag 16 auf Höhe 4.164.600 am 12. November 2026; v3.2.6 war durch Vorschlag 15 auf Höhe 4.020.000 am 4. November 2026 angewendet worden; v3.2.5 war auf Höhe 3.906.833 am 29. Oktober 2026 und v3.2.4 war auf Höhe 3.742.566 am 23. Oktober 2026 und v3.2.3 auf Höhe 3.662.051 am 20. Oktober 2026 angewendet worden). Das qorechain-diana-Testnet läuft seit dem 12. November 2026 mit v3.2.8 (v3.2.4 seit Höhe 8.337.253 am 19. Oktober 2026, v3.2.5 auf Höhe 8.890.800 am 26. Oktober, v3.2.6 auf Höhe 8.970.638 am 27. Oktober, v3.2.7 auf Höhe 9.594.600 am 6. November, v3.2.8 auf Höhe 9.929.500 am 12. November); verwenden Sie dort die EVM-Chain-ID 9800. Wo diese Seite etwas beschreibt, das sich zwischen den Netzwerken unterscheidet (die Testnet-Precompiles, die Fest-Test-Token), sagt sie es. Die Codebeispiele verwenden http://localhost:8545 für einen selbst betriebenen Node; der öffentliche Mainnet-Endpunkt ist https://evm.qore.host und der Testnet-Endpunkt ist https://evm-testnet.qore.host.
Seit dem Upgrade v3.2.0 (Mainnet-Höhe 2,981,742, Testnet-Höhe 5,920,000) lässt die EVM-Lane eine Transaktion nur von einem Konto zu, das (1) einen registrierten ML-DSA-87-Post-Quanten-Schlüssel und (2) ein offenes EVM-Autorisierungsfenster besitzt, in dem noch Platz für sie ist. Sie signieren mit gewöhnlichen Werkzeugen (MetaMask, ethers.js, Hardhat, Foundry), aber ohne registrierten Schlüssel und offenes Fenster wird eth_sendRawTransaction abgelehnt (Codespace pqc, Codes 26, 27 oder 28). Lesezugriffe, eth_call und die Gasschätzung benötigen weder das eine noch das andere. Siehe EVM-Autorisierungsfenster weiter unten und die Schritt-für-Schritt-Anleitung unter Ihre erste Transaktion.
Zwei weitere Regeln gelten seit v3.2.2 im Mainnet: Ungeschützte Transaktionen (vor EIP-155) werden abgelehnt, sowohl vom Mempool des Nodes als auch bei der Blockausführung; signieren Sie daher mit einer Chain-ID (das tun alle aktuellen Wallets und Bibliotheken); und Modulkonten können nicht über die EVM beansprucht werden.
JSON-RPC-Endpunkt
| Eigenschaft | Wert |
|---|---|
| Standard-URL | http://localhost:8545 |
| WebSocket-URL | ws://localhost:8546 |
| Unterstützte Namespaces | eth_, web3_, net_, txpool_ |
| Chain-ID (Mainnet) | 9801 (qorechain-vladi) |
| Chain-ID (Testnet) | 9800 (qorechain-diana) |
| Währungssymbol | QOR |
QoreChain-spezifische Lesezugriffe werden über REST (api.qore.host) bereitgestellt; der unten beschriebene JSON-RPC-Namespace qor_ ist auf den öffentlichen Endpunkten und in der Standard-Node-Konfiguration nicht aktiviert. Die Standardliste api eines frisch initialisierten Nodes (v3.2.3 und später) lautet eth,net,web3; txpool muss ausdrücklich aktiviert werden, weil es die ausstehenden Transaktionen des Nodes veröffentlicht.
Ab dem Node-Release v3.2.4 (Mainnet seit 23. Oktober 2026, Testnet seit 19. Oktober 2026) begrenzt ein Node seinen eigenen JSON-RPC-Server: Anfragekörper über 256 KiB werden abgelehnt (HTTP 413), es werden nicht mehr als 256 Anfragen gleichzeitig bedient (darüber hinaus HTTP 503), und ein eth_getLogs- oder eth_newFilter-Filter mit mehr als 4 Topic-Positionen, 1000 Alternativen in einer Position oder 1000 Adressen wird abgelehnt. Die Grenzen sind node-lokale Einstellungen im Abschnitt [json-rpc] der app.toml; siehe Einen Node betreiben.
Wallet-Konfiguration (MetaMask)
Fügen Sie QoreChain als benutzerdefiniertes Netzwerk in MetaMask hinzu:
| Feld | Mainnet-Wert | Testnet-Wert |
|---|---|---|
| Netzwerkname | QoreChain (qorechain-vladi) | QoreChain Diana |
| RPC-URL | https://evm.qore.host | https://evm-testnet.qore.host |
| Chain-ID | 9801 | 9800 |
| Währungssymbol | QOR | QOR |
| Block-Explorer-URL | https://explore.qore.network | (optional) |
Das Senden aus MetaMask erfordert zusätzlich einen registrierten PQC-Schlüssel und ein offenes EVM-Autorisierungsfenster auf dem Konto.
Hardhat
Installieren Sie Hardhat und konfigurieren Sie Ihre hardhat.config.js:
require("@nomicfoundation/hardhat-toolbox");
module.exports = {
solidity: "0.8.24",
networks: {
qorechain: {
url: "http://localhost:8545",
accounts: ["0xYOUR_PRIVATE_KEY_HEX"],
chainId: 9801, // mainnet qorechain-vladi (use 9800 for qorechain-diana testnet)
},
},
};
Einen Contract bereitstellen (das bereitstellende Konto benötigt einen registrierten PQC-Schlüssel und ein offenes Autorisierungsfenster; eine Bereitstellung zählt im Fenster als eine EVM-Transaktion):
npx hardhat run scripts/deploy.js --network qorechain
Tests gegen die QoreChain-EVM ausführen:
npx hardhat test --network qorechain
Foundry
Einen Contract mit Foundry erstellen und bereitstellen:
# Create a new project
forge init my-project && cd my-project
# Build
forge build
# Deploy
forge create --rpc-url http://localhost:8545 \
--private-key 0xYOUR_PRIVATE_KEY_HEX \
src/MyContract.sol:MyContract
# Interact
cast call <contract-address> "myFunction()" --rpc-url http://localhost:8545
cast send <contract-address> "setValue(uint256)" 42 \
--rpc-url http://localhost:8545 \
--private-key 0xYOUR_PRIVATE_KEY_HEX
Ethers.js
import { ethers } from "ethers";
// Connect to QoreChain EVM
const provider = new ethers.JsonRpcProvider("http://localhost:8545");
// Get chain info
const network = await provider.getNetwork();
console.log("Chain ID:", network.chainId); // 9801n on mainnet (9800n on testnet)
// Read balance
const balance = await provider.getBalance("0xYourAddress");
console.log("Balance:", ethers.formatEther(balance), "QOR");
// Send transaction
const wallet = new ethers.Wallet("0xYOUR_PRIVATE_KEY_HEX", provider);
const tx = await wallet.sendTransaction({
to: "0xRecipientAddress",
value: ethers.parseEther("1.0"),
});
await tx.wait();
Gas-Modell
QoreChain verwendet für EVM-Transaktionen ein dynamisches EIP-1559-Basisgebührenmodell:
- Die Basisgebühr passt sich pro Block je nach Auslastung an
- Nutzer können
maxFeePerGasundmaxPriorityFeePerGasfestlegen - Prioritätsgebühren gehen an den Block-Proposer
Gaslimits
Ab Release v3.2.8 (nur Testnet, bis ein späteres Mainnet-Upgrade folgt) darf eine einzelne EVM-Transaktion ein Gaslimit von höchstens 30,000,000 setzen, und die EVM-Ausführungen, die eine Cosmos-Nachricht startet (ein VM-übergreifender Aufruf, eine ERC-20-Umwandlung, die Weiterleitung eines eingehenden IBC-Pakets), teilen sich dasselbe Budget. Eine Transaktion über dem Limit wird abgelehnt, bevor sie läuft. Lesen Sie die geltenden Werte über GET /qorechain/pqc/v1/evm_limits (gRPC EVMLimitsQuery/EVMLimits) und begrenzen Sie das Gas, das Ihre Tools senden, insbesondere Gas, das eine dApp ungeprüft an Ihre Wallet übergibt. Eine Cosmos-Transaktion hat ein eigenes Limit von 50,000,000 Gas. Einfache Transfers (21,000 Gas) und gewöhnliche Token-Aufrufe liegen weit unter beiden.
Denominierungs-Brücke
Das native QOR-Token hat 6 Dezimalstellen (uqor), während die EVM 18 Dezimalstellen erwartet. Das Modul x/precisebank übernimmt die nahtlose Umrechnung:
| Kontext | Denomination | Dezimalstellen | Beispiel |
|---|---|---|---|
| Native Chain | uqor | 6 | 1000000 uqor = 1 QOR |
| EVM | wei | 18 | 1e18 wei = 1 QOR |
Diese Umrechnung ist transparent — wenn Sie ein Guthaben über eth_getBalance abfragen, wird die Antwort mit 18 Dezimalstellen in wei angegeben. Wird dasselbe Konto über das native Bank-Modul abgefragt, erscheint das Guthaben mit 6 Dezimalstellen in uqor.
ERC-20-Token-Paare
Das Modul x/erc20 stellt Token-Paare zwischen nativen Cosmos-SDK-Denominationen und ERC-20-Contracts bereit:
- Native Token können innerhalb von EVM-Contracts als ERC-20-Token verwendet werden
- Auf der EVM bereitgestellte ERC-20-Token können in native Denominationen umgewandelt werden
- Die Umwandlung ist bidirektional und wird auf Protokollebene abgewickelt
# Register a native ERC-20 contract as a token pair (permissioned: `permissionless_registration` is false)
qorechaind tx erc20 register-erc20 <contract-addr> --from mykey
# Convert native tokens to ERC-20
qorechaind tx erc20 convert-coin 1000000uqor --from mykey --gas 400000 --fees 40000uqor
# Convert ERC-20 back to native
qorechaind tx erc20 convert-erc20 <contract-addr> 1000000000000000000 --from mykey --gas 400000 --fees 40000uqor
Dies sind Transaktionen der Cosmos-Lane: In den Live-Netzwerken benötigen sie ebenfalls den hybriden Post-Quanten-Cosign (mit --generate-only erstellen, dann qorechaind tx pqc cosign; siehe Post-Quanten-Signierung). Der einfache Befehl convert-erc20 oben wird im Node-Release v3.2.6 abgelehnt, weil die CLI einen 0x-Absender schreibt; die funktionierende Form finden Sie unter Umwandlung zwischen den beiden Formen. Token-Paare werden unter einer berechtigungsbeschränkten Richtlinie registriert (die Governance registriert sie). Im Mainnet existiert zum Zeitpunkt der Erstellung keines; das Testnet hat die Fest-Test-Token im nächsten Abschnitt.
Fest-Test-Token und ERC20-Umwandlung
Die Token in diesem Abschnitt existieren nur im qorechain-diana-Testnet (EVM-Chain-ID 9800). Es sind Test-Token für Builder und haben keinen Wert. Das Mainnet hat kein ERC-20-Token-Paar (geprüft am 27. Oktober 2026), daher existiert keine der unten stehenden Denominationen dort.
Am 27. Oktober 2026 hat die Testnet-Governance (Vorschlag 26) drei ERC-20-Contracts als Token-Paare registriert. Sie geben Buildern ein zweites Token, das sie in einem AMM-Pool mit QOR paaren können:
| Token | ERC-20-Contract (EIP-55) | Dezimalstellen | Bank-Denom |
|---|---|---|---|
| fUSD (FestUSD) | 0x97143B771D34ddb9130b807b135Ae675A5a963CA | 6 | erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA |
| fETH (FestETH) | 0x02292293c13880a26242690eb70a0e42B8E91c28 | 18 | erc20:0x02292293c13880a26242690eb70a0e42B8E91c28 |
| fBTC (FestBTC) | 0x4604e7E45b2ecdbfbDc157103f5B2b62cb16451A | 8 | erc20:0x4604e7E45b2ecdbfbDc157103f5B2b62cb16451A |
- Die Bank-Denom lautet
erc20:<address>mit einem Doppelpunkt, und die Adresse muss in der exakt gezeigten gemischten Groß-/Kleinschreibung nach EIP-55 stehen. Denominationen sind groß-/kleinschreibungsabhängig:erc20:0x97143b771d34...(kleingeschrieben) ist ein anderer String, und eine Abfrage dafür antwortet mit404. Kopieren Sie die Denom vonGET https://api-testnet.qore.host/cosmos/bank/v1beta1/denoms_metadata, das die drei Token mit ihremsymbol(fUSD,fETH,fBTC), dem Anzeigenamendisplay(FestUSD,FestETH,FestBTC) und den Dezimalstellen auflistet. - Der Faucet zahlt Bank-Coins aus. Um ein Fest-Token aus der EVM (MetaMask, Solidity) zu verwenden, wandeln Sie den Bank-Coin zuerst mit
MsgConvertCoinin seine ERC-20-Form um; um ein ERC-20-Guthaben wieder in die Bank-Form zu bringen (zum Beispiel, um es in der AMM zu paaren), verwenden SieMsgConvertERC20. Beide werden als Nächstes beschrieben. - Token existieren in zwei Formen. Ein ERC-20-Guthaben wird mit
balanceOfdes Contracts über EVM-JSON-RPC gelesen; das umgewandelte Guthaben ist ein Bank-Coin, das mitGET /cosmos/bank/v1beta1/balances/{address}gelesen wird. Nur die Bank-Coin-Form kann in der AMM gepaart werden. Die Umwandlung verschiebt Wert zwischen den beiden Formen; sie erzeugt ihn nicht. - Beträge verwenden die eigenen Dezimalstellen des Tokens (6, 18 und 8 für fUSD, fETH und fBTC), nicht die 6 Dezimalstellen von
uqor.
curl -s https://api-testnet.qore.host/cosmos/evm/erc20/v1/token_pairs
curl -s "https://api-testnet.qore.host/cosmos/evm/erc20/v1/token_pairs/0x97143B771D34ddb9130b807b135Ae675A5a963CA"
Umwandlung zwischen den beiden Formen
Beide Umwandlungsnachrichten sind Transaktionen der Cosmos-Lane: Sie benötigen Ihren registrierten Post-Quanten-Schlüssel und den hybriden Cosign, wie jede andere native Transaktion (erstellen, dann qorechaind tx pqc cosign; siehe Post-Quanten-Signierung). Die Gebühren müssen mindestens Gas × 0.1 uqor betragen.
Die REST-Lesezugriffe auf dieser Seite (token_pairs, denoms_metadata) wurden am 27. Oktober 2026 gegen das Testnet ausgeführt. Die beiden Umwandlungsbefehle unten wurden für diese Seite nicht Ende-zu-Ende ausgeführt: Ihre Nachrichtenformen und die Absenderregel stammen aus dem Node-Quellcode von v3.2.6 und der Referenz des Chain-Teams. Betrachten Sie sie als die dokumentierte Form und bestätigen Sie sie zunächst mit einem kleinen Betrag.
Bank-Coin zu ERC-20: MsgConvertCoin. Die coin ist die exakte, groß-/kleinschreibungsabhängige Bank-Denom (erc20:<EIP-55 address>), der sender ist Ihre Adresse qor1... (der Signierer), und der receiver ist eine Adresse 0x..., die das ERC-20 halten wird. Es verbraucht etwa 432,000 Gas; setzen Sie ein Gas-Limit von 600,000.
# Write the message by hand (not run for this page)
cat > convert-coin.json <<'JSON'
{
"body": {
"messages": [{
"@type": "/cosmos.evm.erc20.v1.MsgConvertCoin",
"coin": { "denom": "erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA", "amount": "1000000" },
"receiver": "0xYOUR_EVM_ADDRESS",
"sender": "qor1youraddr..."
}],
"memo": ""
},
"auth_info": { "signer_infos": [], "fee": { "amount": [{ "denom": "uqor", "amount": "60000" }], "gas_limit": "600000" } },
"signatures": []
}
JSON
qorechaind tx pqc cosign convert-coin.json --from mykey --pqc-key mypqc --chain-id qorechain-diana
ERC-20 zu Bank-Coin: MsgConvertERC20. Auch ihr Feld sender muss die bech32-Adresse qor1... des Kontos sein. Ein 0x-Absender wird mit decoding bech32 failed abgelehnt. Im Node-Release v3.2.6 und früher schreibt der CLI-Befehl qorechaind tx erc20 convert-erc20 (das einfache Beispiel unter ERC-20-Token-Paare) den Absender in der Form 0x und wird aus diesem Grund abgelehnt: Verwenden Sie ihn dort nicht. Ab v3.2.7 (Testnet seit dem 6. November 2026, Mainnet seit dem 12. November 2026) schreibt der Befehl den Absender in der Form qor1. Mit jedem Release können Sie die Nachricht selbst mit der qor1-Adresse als Absender erstellen, auf dieselbe Weise wie oben:
# Workaround: write the message with a qor1 sender (not run for this page)
cat > convert-erc20.json <<'JSON'
{
"body": {
"messages": [{
"@type": "/cosmos.evm.erc20.v1.MsgConvertERC20",
"contract_address": "0x97143B771D34ddb9130b807b135Ae675A5a963CA",
"amount": "1000000",
"receiver": "qor1youraddr...",
"sender": "qor1youraddr..."
}],
"memo": ""
},
"auth_info": { "signer_infos": [], "fee": { "amount": [{ "denom": "uqor", "amount": "60000" }], "gas_limit": "600000" } },
"signatures": []
}
JSON
qorechaind tx pqc cosign convert-erc20.json --from mykey --pqc-key mypqc --chain-id qorechain-diana
Hier ist receiver das Konto qor1..., das den Bank-Coin erhält (das Modul akzeptiert die bech32-Form für den Empfänger einer Umwandlung in einen Bank-Coin). Der Betrag steht in den Basiseinheiten des Tokens (6, 18 oder 8 Dezimalstellen). Kopieren Sie die Denom für MsgConvertCoin nur aus denoms_metadata; die kleingeschriebene Form wird mit token pair not found abgelehnt.
PQC und EVM-Kompatibilität
EVM-Transaktionen werden mit klassischem ECDSA (secp256k1) signiert, sodass MetaMask, Hardhat, Foundry, ethers.js und andere Standardwerkzeuge sie ohne Änderung erstellen und signieren. Was sich in v3.2.0 geändert hat, ist die Zulassung: Eine Transaktion wird nur akzeptiert, wenn ihr Absender einen registrierten Post-Quanten-Schlüssel und ein aktives Autorisierungsfenster besitzt (nächster Abschnitt). Das Registrieren eines Schlüssels und das Öffnen eines Fensters sind Transaktionen der Cosmos-Lane und benötigen die hybride Signatur (ML-DSA-87 + secp256k1).
Für Post-Quanten-Sicherheit innerhalb von Contracts:
- Das PQC-Verify-Precompile (
0x0000...0A01) verifiziert ML-DSA-87-Signaturen on-chain aus Solidity heraus. Es ist im Testnet aktiv (aktiviert durch Governance-Vorschlag 21, angenommen am 27. Oktober 2026) und zum Zeitpunkt der Erstellung im Mainnet nicht aktiv. Siehe EVM-Precompiles: Netzwerkstatus. - Cross-VM-Nachrichten von der EVM zu QoreChain Native oder SVM sind Transaktionen der Cosmos-Lane und tragen wie jede andere die hybride Signatur; ihre aktuelle Verfügbarkeit finden Sie unter Cross-VM-Interoperabilität.
Ab Node-Release v3.2.7 (Testnet seit dem 6. November 2026, Mainnet seit dem 12. November 2026) sind eth_getBlockByNumber, eth_getBlockReceipts und eth_feeHistory zuverlässiger, auch für Blöcke, die eine fehlgeschlagene EVM-Transaktion enthalten. Am 7. November 2026 antworteten die drei Methoden auf dem öffentlichen Endpunkt des Testnets normal (nach dem Upgrade des Mainnets vom 12. November 2026 dort nicht erneut ausgeführt).
EVM-Autorisierungsfenster
Schlüsseltyp. Die EVM-Lane und das Fenster funktionieren nur mit einem eth_secp256k1-Schlüssel, dem Ethereum-Schlüsseltyp (Coin-Typ 60). Ein standardmäßiger secp256k1-Cosmos-Schlüssel (Coin-Typ 118, das Standardkonto qor1… in QoreX) kann für seine EVM-Adresse nicht signieren, daher bewirkt ein auf einem solchen Konto geöffnetes Fenster nichts. Verwenden Sie in QoreX unter Ihre Konten Ethereum-Konto hinzufügen (coin 60); siehe Phrase aus MetaMask oder dem Dashboard wiederherstellen.
Ab v3.2.7 (Testnet seit dem 6. November 2026, Mainnet seit dem 12. November 2026) emittiert eine EVM-Transaktion, die das Fenster verbraucht, das Event pqc_evm_window_used, mit einem Attribut source, das angibt, welcher Pfad es verbraucht hat.
Eine Post-Quanten-Signatur kann nicht mit einer Ethereum-Transaktion reisen (Wallets wie MetaMask können keine zweite Signatur anhängen), also reist sie vor ihr. Das Konto öffnet mit der Cosmos-Lane-Nachricht MsgOpenEVMWindow ein begrenztes Fenster; die EVM-Lane lässt dann nur Transaktionen zu, die von einem aktiven Fenster abgedeckt sind. Ein gestohlener klassischer Schlüssel allein kann kein Fenster öffnen und kann daher auf der EVM-Lane nur innerhalb dessen handeln, was ein bereits geöffnetes Fenster erlaubt (das Fenster begrenzt weder Token-Beträge noch bestehende Genehmigungen).
| Grenze | Bereich | Bedeutung |
|---|---|---|
blocks | 1 – 17,280 | Wie lange das Fenster offen bleibt, in Blöcken gezählt ab dem Block, der es öffnet |
max-txs | 1 – 1,000 | Wie viele EVM-Transaktionen es zulässt |
max-value | über 0, in uqor | Gesamter Abfluss, den es zulässt: übertragener Wert plus die maximale Gebühr, die jede Transaktion zahlen könnte (Gaslimit × maximale Gebühr pro Gas), in uqor umgerechnet und aufgerundet |
Welche Grenze zuerst aufgebraucht ist, schließt das Fenster. Die drei Grenzen sind erforderlich; das Öffnen eines Fensters ersetzt ein bestehendes; eine Transaktion, die zugelassen wird und dann fehlschlägt, verbraucht trotzdem ihren Platz und ihr Wertbudget; Contract-Bereitstellungen zählen wie jede andere Transaktion. blocks ist eine Blockanzahl, keine Dauer: 17,280 Blöcke entsprechen im Mainnet etwa 15 Stunden (etwa 3.1 s pro Block) und im Testnet etwa 6 Stunden (etwa 1.3 s pro Block am 27. Oktober 2026; die Testnet-Blockzeit schwankt).
Die Wertgrenze zählt nur natives QOR. Ein Token-Transfer, eine Genehmigung (Approval) oder jeder andere Contract-Aufruf trägt den Wert null und wird daher nicht auf max-value angerechnet (nur seine maximale Gebühr). Der Scope des Fensters (Mainnet v3.2.3 und später) schränkt ein, welche Empfänger es zulässt, begrenzt aber keine Token-Beträge:
| Scope-Option (CLI-Flag) | Nachrichtenfeld | Was das Fenster zulässt |
|---|---|---|
--native-only | native_only | Nur einfache Transfers von nativem QOR: keine Calldata, keine Contract-Erstellung, kein Empfänger, der Code trägt, keine EIP-7702-Autorisierung |
--allowed-targets 0xA,0xB | allowed_targets | Nur Transaktionen, deren Empfänger eine der aufgelisteten 20-Byte-Adressen ist; die Contract-Erstellung wird abgelehnt |
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, liegen außerhalb davon. Vor v3.2.8 betraf das auch VM-übergreifende Aufrufe und authz; ab v3.2.8 (nur Testnet, bis ein späteres Mainnet-Upgrade folgt) verwenden ein VM-übergreifender Aufruf in die EVM und eine ERC-20-Umwandlung, die unter einem authz-Grant gesendet werden, das Fenster des Granters, und der Bridge-Precompile 0x0901 benötigt ein Fenster, das ihn auflistet.
Ein ohne Scope geöffnetes Fenster verhält sich exakt wie zuvor. Eine Transaktion außerhalb des Scopes wird mit Code 27 abgelehnt (die Meldung besagt, dass das Fenster „diese Transaktion nicht zulässt“). GET /qorechain/pqc/v1/evm_window/{address} und qorechaind query pqc evm-window melden native_only und allowed_targets, und das Ereignis pqc_evm_window_opened trägt sie, wenn sie gesetzt sind.
Schritte (die vollständige Anleitung finden Sie unter Ihre erste Transaktion):
-
Registrieren Sie Ihren ML-DSA-87-Schlüssel einmalig (
tx pqc register-key-v2oderregister-key, mit--gas 600000 --fees 60000uqor; diese eine Transaktion ist von der Hybrid-Anforderung ausgenommen, sodass ein neues Konto den Einstieg schafft). Siehe Post-Quanten-Signierung. -
Öffnen Sie ein Fenster. Es ist eine Transaktion der Cosmos-Lane, also erzeugen Sie sie unsigniert und cosignen Sie sie mit Ihrem ML-DSA-Schlüssel (
max-valueakzeptiertuqoroderqor;1000qorsind 1,000 QOR):qorechaind tx pqc open-evm-window 7200 20 1000qor --from mykey \--chain-id qorechain-vladi --gas 400000 --fees 40000uqor --generate-only > w.jsonqorechaind tx pqc cosign w.json --from mykey --pqc-key mypqc --chain-id qorechain-vladi# the same window narrowed to plain QOR transfers (mainnet v3.2.3 and later):qorechaind tx pqc open-evm-window 7200 20 1000qor --native-only --from mykey \--chain-id qorechain-vladi --gas 400000 --fees 40000uqor --generate-only > w.json -
Prüfen Sie, was übrig ist:
qorechaind query pqc evm-window <address>oderGET /qorechain/pqc/v1/evm_window/{address}(antwortet mitfound: false, wenn keines vorhanden ist). -
Senden Sie Ihre EVM-Transaktionen wie gewohnt. Das Öffnen eines Fensters ist eine Transaktion der Cosmos-Lane und erhöht die Sequenz des Kontos, die zugleich seine EVM-Nonce ist; lesen Sie die Nonce daher nach dem Öffnen des Fensters und signieren Sie dann.
Fensteroptionen ab v3.2.8
Ab Release v3.2.8 (nur Testnet, bis ein späteres Mainnet-Upgrade folgt) trägt MsgOpenEVMWindow drei optionale Listen mit je bis zu 16 Einträgen. Ein Fenster ohne sie verhält sich wie bisher, abgesehen von der Deny-by-default-Regel unten.
| Nachrichtenfeld | CLI-Flag | Was es benennt |
|---|---|---|
validators (7) | --validators | Contracts, deren Prüfung der Signatur des Kontos für seine Aktionen zählt: ein Validator-Modul, das ein Wallet-Contract aufruft, oder der ERC-4337-Entry-Point |
staking_validators (8) | --staking-validators | Operator-Adressen von Validatoren (qorvaloper…), an die das Konto über das Fenster delegieren oder umdelegieren darf |
ibc_receivers (9) | --ibc-receivers | Genaue Paare <channel>/<receiver>, an die ein nativer IBC-Transfer von QOR gehen darf; Channel und Empfänger werden Byte für Byte verglichen (channel-0, bech32-Empfänger in Kleinbuchstaben) |
Standard-Precompiles sind Deny-by-default. Für ein Konto, das ein Fenster autorisiert, wird eine Methode eines Standard-Precompiles (Staking, Distribution, ICS-20, Gov, Slashing, ERC-20-Token-Precompiles) abgelehnt, sofern sie nicht in der folgenden Tabelle steht und das Fenster den Precompile in allowed_targets auflistet.
| Precompile | Methode | Zugelassen, wenn |
|---|---|---|
| distribution | claimRewards, withdrawDelegatorRewards | die Rewards an das Konto selbst gezahlt werden |
| distribution | withdrawValidatorCommission | der Validator der eigene des Kontos ist und an das Konto selbst zahlt |
| distribution | depositValidatorRewardsPool | der Validator in staking_validators steht und jede Coin natives QOR ist |
| staking | delegate, redelegate | der Ziel-Validator in staking_validators steht |
| ICS-20 | transfer | natives QOR, über den Port transfer, ohne Memo, an ein Paar in ibc_receivers |
| ERC-20-Token-Precompiles | transfer, transferFrom, approve | natives QOR; ein anderer Token nur, wenn das Fenster die Adresse dieses Tokens auflistet |
Die Staking-Precompiles (0x…0800) und Distribution-Precompiles (0x…0801) sind, wie die anderen Standard-Precompiles in dieser Tabelle, derzeit weder im Testnet noch im Mainnet aktiv; die Governance kann sie aktivieren. Ein Aufruf an die Adresse eines inaktiven Precompiles trifft eine Adresse ohne Code: Er gelingt, bewirkt nichts und verbraucht trotzdem Gas. Die Fensterfelder staking_validators, validators und ibc_receivers gelten, sobald ein Precompile aktiv ist. Für Staking und für das Einfordern von Belohnungen verwenden Sie die nativen Cosmos-Nachrichten (QoreX oder die qorechaind-Befehle für Staking und Distribution). Ist ein Precompile aktiv, werden seine Beträge in uqor (6 Dezimalstellen) angegeben, nicht in EVM-Einheiten mit 18 Dezimalstellen.
Alles andere wird über ein Fenster abgelehnt: Undelegieren, Abstimmen und andere Governance-Aktionen, Ändern der Withdraw-Adresse, Erstellen oder Bearbeiten eines Validators, Einzahlen in den Community Pool. Senden Sie diese als Post-Quanten-signierte Cosmos-Transaktionen.
Auf der Chain geprüfte Signaturen brauchen den prüfenden Contract im Fenster. Ein EIP-2612-Permit, ein Permit2-Transfer, eine EIP-712-Order oder eine Meta-Transaktion wird von einem Contract mit ecrecover geprüft. Ab v3.2.8 (beide Netzwerke, sobald ein Netzwerk es anwendet) gelingt diese Prüfung für ein Konto mit einem nutzbaren Post-Quanten-Schlüssel nur, solange das eigene aktive Fenster des Kontos den prüfenden Contract zulässt, also den Token oder Permit2 selbst, nicht den Router, der den Aufruf weiterleitet. Listen Sie ihn in allowed_targets auf und öffnen Sie das Fenster, bevor der Nutzer signiert. Ohne dieses Fenster gilt die Signatur als ungültig, und der Contract lehnt sie ab. Ein in einem Fenster erteiltes Permit oder eine dort erteilte Genehmigung bleibt nach dem Schließen des Fensters bestehen; prüfen und widerrufen Sie Genehmigungen daher, wenn die Sitzung endet.
Schlüsseländerungen schließen das Fenster. Das Rotieren, Migrieren oder erneute Registrieren des Post-Quanten-Schlüssels des Kontos löscht sein offenes Fenster und seine EIP-7702-Zustimmung; öffnen Sie das Fenster danach erneut. Fenster- und Zustimmungsnachrichten müssen die eigene, Post-Quanten-signierte Top-Level-Nachricht des Kontos sein: Sie können nicht über authz gesendet oder einem anderen Konto gewährt werden.
Schließen Sie ein Fenster vorzeitig mit qorechaind tx pqc close-evm-window (gleiches Muster mit --generate-only und cosign), zum Beispiel wenn Sie vermuten, dass der klassische Schlüssel offengelegt wurde: Was das Fenster noch zugelassen hätte, wird ab dem nächsten Block abgelehnt.
EIP-7702-Delegationen
Eine EIP-7702-Delegation Ihres Kontos (eine Typ-4-Transaktion) wird seit v3.2.2 nur mit der eigenen Post-Quanten-Einwilligung Ihres Kontos wirksam. Erfassen Sie die Einwilligung zuerst mit der hybrid signierten Cosmos-Lane-Nachricht MsgAuthorizeEVMDelegation (qorechaind tx pqc authorize-evm-delegation <delegate_0x> <blocks>); sie ist einmalig verwendbar, läuft nach der angegebenen Anzahl von Blöcken ab und wird durch close-evm-window widerrufen. Wert, der ein delegiertes Konto verlässt, wird dem Fenster dieses Kontos belastet, eine fehlgeschlagene Typ-4-Transaktion behält die Autorisierungen, die sie angewendet hat, und qorechaind tx pqc clear-evm-delegation entfernt eine Delegation. Eine abgelehnte Delegation antwortet mit den Codes 60 bis 63. Lesen Sie die Einwilligung mit GET /qorechain/pqc/v1/evm_delegation_consent/{address}.
Ablehnung (Codespace pqc) | Bedeutung |
|---|---|
| Code 26 | Kein offenes Fenster für den Absender, oder der Absender hat keinen registrierten PQC-Schlüssel |
| Code 27 | Das Fenster ist abgelaufen oder erschöpft (die Meldung zeigt, welche Grenze), oder die Transaktion liegt außerhalb des Scopes des Fensters |
| Code 28 | Ungültige Fenstergrenzen beim Öffnen, oder zu diesem Zeitpunkt kein registrierter Schlüssel |
Mit dem TypeScript-SDK (ab 0.8.2): openEvmWindowMsg, closeEvmWindowMsg, fetchEvmWindow({ rest, address }) und classifyEvmWindowRejection(err) ("no-pqc-key" | "no-window" | "exhausted" | "invalid"). Das SDK ab 0.9.0 (0.13.0 ist das aktuelle Release) ergänzt openEvmWindowMsg um die Scope-Optionen (nativeOnly, allowedTargets) und fügt die Builder für die EIP-7702-Einwilligung hinzu (authorizeEvmDelegationMsg, clearEvmDelegationMsg, fetchEvmDelegationConsent); Releases vor 0.9.0 bauen nur das Fenster ohne Scope, nutzen Sie für den Rest daher qorechaind (siehe den SDK-EVM-Leitfaden).
Benutzerdefinierter qor_-Namespace
QoreChain erweitert JSON-RPC um einen qor_-Namespace für kettenspezifische Abfragen. Die folgenden Methoden sind geplant:
Die Methoden in der folgenden Tabelle sind geplant und werden nicht bereitgestellt: Jede liefert -32601 (Methode nicht gefunden). Die einzige bereitgestellte Methode des Namespace ist qor_getKEMKey, und nur dort, wo der Node qor in seinen Namespaces listet: Beobachtet am 7. November 2026, listet das Testnet qor und beantwortet sie, während der öffentliche Mainnet-Endpunkt nur eth, net, rpc, txpool und web3 listet und mit -32601 antwortet. Siehe den qor_-Namespace für den Status und die REST-Alternativen (zum Beispiel GET /qorechain/pqc/v1/account/{address} für den Status des PQC-Schlüssels).
| Methode | Beschreibung |
|---|---|
qor_getPQCKeyStatus | Prüft, ob ein Konto einen registrierten PQC-öffentlichen Schlüssel besitzt |
| KI-Statistiken (geplant) | Ruft Statistiken der KI-Engine ab (Anomaliezahlen, Risikoverteilung); Methodenname nicht endgültig |
qor_getCrossVMMessage | Fragt den Status einer Cross-VM-Nachricht anhand ihrer ID ab |
qor_getPoolClassification | Ruft die Validator-Pool-Klassifizierung ab (RPoS/DPoS/PoS) |
qor_getReputationScore | Fragt den Reputationswert eines Validators ab |
qor_getAbstractAccount | Ruft die Konfiguration eines abstrakten Kontos ab |
Beispiel mit curl:
curl -X POST http://localhost:8545 \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "qor_getPQCKeyStatus",
"params": ["0xYourAddress"],
"id": 1
}'
Nächste Schritte
- EVM-Precompiles — Referenz für die Precompile-Schnittstellen von QoreChain (drei im Testnet aktiv, keine im Mainnet)
- Cross-VM-Interoperabilität — Cross-VM-Aufrufe und ihre aktuelle Verfügbarkeit
- Kontenabstraktion — Authenticators für verknüpfte Wallets und Ausgabenregeln (im Testnet aktiviert, im Mainnet deaktiviert)