Dezvoltare EVM
QoreChain rulează un mediu de execuție complet compatibil cu EVM pe QoreChain EVM Engine, permițându-vă să implementați și să interacționați cu contracte inteligente Solidity folosind uneltele obișnuite. Modulul EVM expune o interfață JSON-RPC pe portul 8545 (WebSocket pe 8546) care suportă fluxurile de lucru standard de dezvoltare Ethereum.
Exemplele de mai jos vizează rețeaua mainnet qorechain-vladi (chain ID EVM 9801), activă din 7 iunie 2026, care rulează versiunea de nod v3.2.7 la momentul scrierii (aplicată prin propunerea de guvernanță 16 la înălțimea 4.164.600, pe 12 noiembrie 2026; v3.2.6 fusese aplicată prin propunerea 15 la înălțimea 4.020.000, pe 4 noiembrie 2026; v3.2.5 fusese aplicată la înălțimea 3.906.833, pe 29 octombrie 2026, v3.2.4 fusese aplicată la înălțimea 3.742.566, pe 23 octombrie 2026, iar v3.2.3 la înălțimea 3.662.051, pe 20 octombrie 2026). Testnet-ul qorechain-diana rulează v3.2.8 din 12 noiembrie 2026 (v3.2.4 de la înălțimea 8.337.253, pe 19 octombrie 2026, v3.2.5 la înălțimea 8.890.800, pe 26 octombrie, v3.2.6 la înălțimea 8.970.638, pe 27 octombrie, v3.2.7 la înălțimea 9.594.600, pe 6 noiembrie, v3.2.8 la înălțimea 9.929.500, pe 12 noiembrie); folosiți acolo chain ID EVM 9800. Acolo unde această pagină descrie ceva care diferă între rețele (precompilatele testnet-ului, tokenurile de test Fest), spune acest lucru. Exemplele de cod folosesc http://localhost:8545 pentru un nod pe care îl rulați singuri; endpointul public de mainnet este https://evm.qore.host, iar cel de testnet este https://evm-testnet.qore.host.
Începând cu upgrade-ul v3.2.0 (înălțimea mainnet 2.981.742, înălțimea testnet 5.920.000), lane-ul EVM admite o tranzacție doar de la un cont care are (1) o cheie post-cuantică ML-DSA-87 înregistrată și (2) o fereastră de autorizare EVM deschisă care mai are loc pentru ea. Semnați cu unelte obișnuite (MetaMask, ethers.js, Hardhat, Foundry), dar fără o cheie înregistrată și o fereastră deschisă, eth_sendRawTransaction este respins (codespace pqc, codurile 26, 27 sau 28). Citirile, eth_call și estimarea de gas nu au nevoie de niciuna. Vedeți Fereastra de autorizare EVM mai jos și ghidul pas cu pas din Prima ta tranzacție.
Încă două reguli se aplică pe mainnet începând cu v3.2.2: tranzacțiile neprotejate (pre-EIP-155) sunt respinse, atât de mempool-ul nodului, cât și la execuția blocului, așa că semnați cu un chain id (orice portofel și bibliotecă actuală o face); iar conturile de modul nu pot fi revendicate prin EVM.
Endpoint JSON-RPC
| Proprietate | Valoare |
|---|---|
| URL implicit | http://localhost:8545 |
| URL WebSocket | ws://localhost:8546 |
| Spații de nume suportate | eth_, web3_, net_, txpool_ |
| Chain ID (mainnet) | 9801 (qorechain-vladi) |
| Chain ID (testnet) | 9800 (qorechain-diana) |
| Simbol monedă | QOR |
Citirile specifice QoreChain sunt servite prin REST (api.qore.host); spațiul de nume JSON-RPC qor_ descris mai jos nu este activat pe endpointurile publice și nici în configurația implicită a nodului. Lista implicită api a unui nod inițializat de curând (v3.2.3 și ulterior) este eth,net,web3; txpool este opțional (opt-in), deoarece publică tranzacțiile în așteptare ale nodului.
Începând cu versiunea de nod v3.2.4 (mainnet din 23 octombrie 2026, testnet din 19 octombrie 2026), un nod își limitează propriul server JSON-RPC: corpurile de cerere de peste 256 KiB sunt refuzate (HTTP 413), nu se servesc mai mult de 256 de cereri simultan (HTTP 503 peste această limită), iar un filtru eth_getLogs sau eth_newFilter cu mai mult de 4 poziții de topic, 1000 de alternative într-o singură poziție sau 1000 de adrese este refuzat. Limitele sunt setări locale ale nodului, în secțiunea [json-rpc] din app.toml; vezi Rularea unui nod.
Configurare portofel (MetaMask)
Adăugați QoreChain ca rețea personalizată în MetaMask:
| Câmp | Valoare Mainnet | Valoare Testnet |
|---|---|---|
| Nume rețea | QoreChain (qorechain-vladi) | QoreChain Diana |
| URL RPC | https://evm.qore.host | https://evm-testnet.qore.host |
| Chain ID | 9801 | 9800 |
| Simbol monedă | QOR | QOR |
| URL explorator blocuri | https://explore.qore.network | (opțional) |
Trimiterea din MetaMask necesită, în plus, o cheie PQC înregistrată și o fereastră de autorizare EVM deschisă pe cont.
Hardhat
Instalați Hardhat și configurați fișierul 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)
},
},
};
Implementați un contract (contul care face implementarea are nevoie de o cheie PQC înregistrată și de o fereastră de autorizare deschisă; o implementare contează ca o tranzacție EVM în fereastră):
npx hardhat run scripts/deploy.js --network qorechain
Rulați teste pe EVM-ul QoreChain:
npx hardhat test --network qorechain
Foundry
Creați și implementați un contract cu Foundry:
# 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();
Modelul de gas
QoreChain folosește un model de taxă de bază dinamică EIP-1559 pentru tranzacțiile EVM:
- Taxa de bază se ajustează per bloc, în funcție de gradul de utilizare
- Utilizatorii pot seta
maxFeePerGasșimaxPriorityFeePerGas - Taxele de prioritate merg către propunătorul blocului
Limite de gas
Începând cu release-ul v3.2.8 (doar pe testnet până la un upgrade ulterior de mainnet), o singură tranzacție EVM poate seta o limită de gas de cel mult 30.000.000, iar rulările EVM pornite de un singur mesaj Cosmos (un apel cross-VM, o conversie ERC-20, transferul unui pachet IBC primit) împart același buget. O tranzacție peste limită este refuzată înainte de a rula. Citiți valorile în vigoare din GET /qorechain/pqc/v1/evm_limits (gRPC EVMLimitsQuery/EVMLimits) și limitați gazul pe care îl trimit uneltele dumneavoastră, în special gazul pe care o dApp îl transmite necontrolat portofelului. O tranzacție Cosmos are propria limită de 50.000.000 de gas. Transferurile simple (21.000 de gas) și apelurile obișnuite de token sunt mult sub ambele.
Puntea de denominare
Tokenul nativ QOR are 6 zecimale (uqor), în timp ce EVM-ul așteaptă 18 zecimale. Modulul x/precisebank gestionează conversia fără probleme:
| Context | Denominare | Zecimale | Exemplu |
|---|---|---|---|
| Chain nativ | uqor | 6 | 1000000 uqor = 1 QOR |
| EVM | wei | 18 | 1e18 wei = 1 QOR |
Această conversie este transparentă — când verificați un sold prin eth_getBalance, răspunsul este denominat în wei cu 18 zecimale. Când același cont este interogat prin modulul nativ de bank, soldul apare în uqor cu 6 zecimale.
Perechi de tokenuri ERC-20
Modulul x/erc20 oferă perechi de tokenuri între denominările native Cosmos SDK și contractele ERC-20:
- Tokenurile native pot fi folosite în cadrul contractelor EVM ca ERC-20
- Tokenurile ERC-20 implementate pe EVM pot fi convertite în denominări native
- Conversia este bidirecțională și gestionată la nivel de protocol
# 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
Acestea sunt tranzacții din lane-ul Cosmos: pe rețelele live necesită și co-semnătura post-cuantică hibridă (construiți cu --generate-only, apoi qorechaind tx pqc cosign; vedeți Semnarea post-cuantică). Comanda simplă convert-erc20 de mai sus este refuzată în versiunea de nod v3.2.6, deoarece CLI-ul scrie un expeditor 0x; vedeți Conversia între cele două forme pentru forma care funcționează. Perechile de tokenuri se înregistrează sub o politică cu permisiuni (le înregistrează guvernanța). Pe mainnet nu există niciuna la momentul scrierii; testnet-ul are tokenurile de test Fest în secțiunea următoare.
Tokenuri de test Fest și conversia ERC20
Tokenurile din această secțiune există doar pe testnet-ul qorechain-diana (chain ID EVM 9800). Sunt tokenuri de test pentru builderi și nu au valoare. Mainnet-ul nu are nicio pereche de tokenuri ERC-20 (verificat la 27 octombrie 2026), deci niciuna dintre denominările de mai jos nu există acolo.
La 27 octombrie 2026, guvernanța testnet-ului (propunerea 26) a înregistrat trei contracte ERC-20 ca perechi de tokenuri. Ele oferă builderilor un al doilea token de asociat cu QOR într-un pool AMM:
| Token | Contract ERC-20 (EIP-55) | Zecimale | Denom bank |
|---|---|---|---|
| fUSD (FestUSD) | 0x97143B771D34ddb9130b807b135Ae675A5a963CA | 6 | erc20:0x97143B771D34ddb9130b807b135Ae675A5a963CA |
| fETH (FestETH) | 0x02292293c13880a26242690eb70a0e42B8E91c28 | 18 | erc20:0x02292293c13880a26242690eb70a0e42B8E91c28 |
| fBTC (FestBTC) | 0x4604e7E45b2ecdbfbDc157103f5B2b62cb16451A | 8 | erc20:0x4604e7E45b2ecdbfbDc157103f5B2b62cb16451A |
- Denom-ul bank este
erc20:<address>cu două puncte, iar adresa trebuie să fie în exact scrierea EIP-55 cu majuscule și minuscule mixte arătată. Denom-urile sunt sensibile la majuscule:erc20:0x97143b771d34...(cu minuscule) este un alt șir, iar o interogare pentru el răspunde404. Copiați denom-ul de laGET https://api-testnet.qore.host/cosmos/bank/v1beta1/denoms_metadata, care listează cele trei tokenuri cusymbol(fUSD,fETH,fBTC), numeledisplay(FestUSD,FestETH,FestBTC) și zecimalele. - Faucet-ul plătește în monede bank. Pentru a folosi un token Fest din EVM (MetaMask, Solidity), convertiți mai întâi moneda bank în forma ei ERC-20 cu
MsgConvertCoin; pentru a readuce un sold ERC-20 în forma bank (de exemplu pentru a-l asocia în AMM), folosițiMsgConvertERC20. Ambele sunt descrise mai jos. - Tokenurile există în două forme. Un sold ERC-20 se citește cu
balanceOfal contractului prin EVM JSON-RPC; soldul convertit este o monedă bank, citită cuGET /cosmos/bank/v1beta1/balances/{address}. Doar forma de monedă bank poate fi asociată în AMM. Conversia mută valoare între cele două forme; nu o creează. - Sumele folosesc zecimalele proprii ale tokenului (6, 18 și 8 pentru fUSD, fETH și fBTC), nu cele 6 zecimale ale
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"
Conversia între cele două forme
Ambele mesaje de conversie sunt tranzacții din lane-ul Cosmos: necesită cheia dumneavoastră post-cuantică înregistrată și co-semnătura hibridă, ca orice altă tranzacție nativă (construiți, apoi qorechaind tx pqc cosign; vedeți Semnarea post-cuantică). Taxele trebuie să fie de cel puțin gas × 0,1 uqor.
Citirile REST de pe această pagină (token_pairs, denoms_metadata) au fost rulate pe testnet la 27 octombrie 2026. Cele două comenzi de conversie de mai jos nu au fost rulate de la un capăt la altul pentru această pagină: formele mesajelor și regula expeditorului provin din sursa nodului v3.2.6 și din referința echipei lanțului. Tratați-le ca forma documentată și confirmați mai întâi cu o sumă mică.
Monedă bank în ERC-20: MsgConvertCoin. coin este denom-ul bank exact, sensibil la majuscule (erc20:<EIP-55 address>), sender este adresa dumneavoastră qor1... (semnatarul), iar receiver este o adresă 0x... care va deține ERC-20. Consumă aproximativ 432.000 de gas; setați o limită de gas de 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 în monedă bank: MsgConvertERC20. Câmpul său sender trebuie să fie, de asemenea, adresa bech32 qor1... a contului. Un expeditor 0x este refuzat cu decoding bech32 failed. În versiunea de nod v3.2.6 și anterioare, comanda CLI qorechaind tx erc20 convert-erc20 (exemplul simplu din Perechi de tokenuri ERC-20) scrie expeditorul în forma 0x, deci este refuzată din acest motiv: nu o folosiți acolo. Începând cu v3.2.7 (testnet din 6 noiembrie 2026, mainnet din 12 noiembrie 2026), comanda scrie expeditorul în forma qor1. Pe oricare dintre versiuni puteți construi mesajul singuri, cu adresa qor1 ca expeditor, în același mod ca mai sus:
# 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
Aici receiver este contul qor1... care primește moneda bank (modulul acceptă forma bech32 pentru destinatarul unei conversii în monedă bank). Suma este în unitățile de bază ale tokenului (6, 18 sau 8 zecimale). Copiați denom-ul pentru MsgConvertCoin doar din denoms_metadata; forma cu minuscule este refuzată cu token pair not found.
Compatibilitate PQC și EVM
Tranzacțiile EVM sunt semnate cu ECDSA clasic (secp256k1), așa că MetaMask, Hardhat, Foundry, ethers.js și alte unelte standard le construiesc și le semnează fără modificări. Ce s-a schimbat în v3.2.0 este admiterea: o tranzacție este acceptată doar dacă expeditorul ei deține o cheie post-cuantică înregistrată și o fereastră de autorizare activă (secțiunea următoare). Înregistrarea unei chei și deschiderea unei ferestre sunt tranzacții din lane-ul Cosmos și necesită semnătura hibridă (ML-DSA-87 + secp256k1).
Pentru securitate post-cuantică în cadrul contractelor:
- Precompilatul PQC Verify (
0x0000...0A01) verifică pe chain semnături ML-DSA-87 din Solidity. Este activ pe testnet (activat prin propunerea de guvernanță 21, aprobată la 27 octombrie 2026) și neactiv pe mainnet la momentul scrierii. Vedeți Precompilate EVM: starea rețelelor. - Mesajele cross-VM de la EVM către QoreChain Native sau SVM sunt tranzacții din lane-ul Cosmos și poartă semnătura hibridă ca oricare altele; vedeți Interoperabilitate Cross-VM pentru disponibilitatea lor curentă.
Începând cu versiunea de nod v3.2.7 (testnet din 6 noiembrie 2026, mainnet din 12 noiembrie 2026), eth_getBlockByNumber, eth_getBlockReceipts și eth_feeHistory sunt mai fiabile, inclusiv pentru blocurile care conțin o tranzacție EVM eșuată. Pe 7 noiembrie 2026, cele trei metode au răspuns normal pe endpoint-ul public al testnet-ului (nu au fost rulate din nou pe mainnet după upgrade-ul din 12 noiembrie 2026).
Fereastra de autorizare EVM
Tipul de cheie. Lane-ul EVM și fereastra funcționează doar cu o cheie eth_secp256k1, tipul de cheie Ethereum (coin type 60). O cheie Cosmos secp256k1 standard (coin type 118, contul implicit qor1… din QoreX) nu poate semna pentru adresa sa EVM, deci o fereastră deschisă pe un astfel de cont nu are niciun efect. În QoreX folosiți Add an Ethereum account (coin 60) din Your accounts; vedeți Restaurează o frază din MetaMask sau din Dashboard.
Începând cu v3.2.7 (testnet din 6 noiembrie 2026, mainnet din 12 noiembrie 2026), o tranzacție EVM care consumă fereastra emite evenimentul pqc_evm_window_used, cu un atribut source care spune ce cale a folosit-o.
O semnătură post-cuantică nu poate călători împreună cu o tranzacție Ethereum (portofele precum MetaMask nu pot atașa o a doua semnătură), așa că ea călătorește înaintea ei. Contul deschide o fereastră delimitată cu mesajul din lane-ul Cosmos MsgOpenEVMWindow; lane-ul EVM admite apoi doar tranzacțiile acoperite de o fereastră activă. O cheie clasică furată nu poate deschide singură o fereastră, deci pe banda EVM poate acționa doar în limitele unei ferestre deja deschise (fereastra nu plafonează sumele de tokenuri și nici aprobările existente).
| Limită | Interval | Semnificație |
|---|---|---|
blocks | 1 – 17.280 | Cât timp rămâne deschisă fereastra, numărat în blocuri începând cu blocul care o deschide |
max-txs | 1 – 1.000 | Câte tranzacții EVM admite |
max-value | peste 0, în uqor | Ieșirea totală pe care o admite: valoarea transferată plus taxa maximă pe care ar putea-o plăti fiecare tranzacție (limita de gas × taxa maximă per gas), convertită în uqor și rotunjită în sus |
Limita care se epuizează prima închide fereastra. Toate cele trei limite sunt obligatorii; deschiderea unei ferestre o înlocuiește pe cea existentă; o tranzacție care este admisă și apoi eșuează își consumă totuși slotul și bugetul de valoare; implementările de contracte contează ca orice altă tranzacție. blocks este un număr de blocuri, nu o durată: 17.280 de blocuri înseamnă aproximativ 15 ore pe mainnet (circa 3,1 s per bloc) și aproximativ 6 ore pe testnet (circa 1,3 s per bloc la 27 octombrie 2026; timpul de bloc al testnet-ului variază).
Limita de valoare numără doar QOR nativ. Un transfer de token, o aprobare sau orice alt apel de contract poartă valoarea zero, deci nu se socotește la max-value (se socotește doar taxa sa maximă). Domeniul de aplicare (scope) al ferestrei (mainnet v3.2.3 și ulterior) restrânge ce destinatari admite, dar nu plafonează sumele de tokenuri:
| Opțiune de domeniu (flag CLI) | Câmp de mesaj | Ce admite fereastra |
|---|---|---|
--native-only | native_only | Doar transferuri simple de QOR nativ: fără calldata, fără creare de contract, fără destinatar care poartă cod, fără autorizare EIP-7702 |
--allowed-targets 0xA,0xB | allowed_targets | Doar tranzacțiile al căror destinatar este una dintre adresele de 20 de octeți listate; crearea de contract este respinsă |
O fereastră deschisă fără domeniu de aplicare se comportă exact ca înainte. O tranzacție în afara domeniului este respinsă cu codul 27 (mesajul spune că fereastra „does not admit this transaction"). GET /qorechain/pqc/v1/evm_window/{address} și qorechaind query pqc evm-window raportează native_only și allowed_targets, iar evenimentul pqc_evm_window_opened le poartă atunci când sunt setate.
allowed_targets limitează ce contracte și tokenuri poate atinge o fereastră, nu cât. Un token listat admite orice sumă din acel token, inclusiv approve, iar un contract listat poate muta tot ce permit codul său și aprobările existente, așa că nu listați contracte generice de tip forwarder sau router. O fereastră limitează doar tranzacțiile de pe banda EVM (semnate clasic); mesajele Cosmos semnate cu semnătura hibridă PQC sunt în afara ei. Înainte de v3.2.8 aceasta includea apelurile cross-VM și authz; începând cu v3.2.8 (doar pe testnet până la un upgrade ulterior de mainnet), un apel cross-VM către EVM și o conversie ERC-20 trimise sub un grant authz folosesc fereastra acordantului, iar precompile-ul de punte 0x0901 are nevoie de o fereastră care îl listează.
Pași (ghidul complet este în Prima ta tranzacție):
-
Înregistrați o singură dată cheia ML-DSA-87 (
tx pqc register-key-v2sauregister-key, cu--gas 600000 --fees 60000uqor; această tranzacție este scutită de cerința hibridă, astfel încât un cont nou să poată face bootstrap). Vedeți Semnarea post-cuantică. -
Deschideți o fereastră. Este o tranzacție din lane-ul Cosmos, deci produceți-o nesemnată și co-semnați-o cu cheia ML-DSA (
max-valueacceptăuqorsauqor;1000qorînseamnă 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 -
Verificați ce a rămas:
qorechaind query pqc evm-window <address>sauGET /qorechain/pqc/v1/evm_window/{address}(răspundefound: falsecând nu există nicio fereastră). -
Trimiteți tranzacțiile EVM ca de obicei. Deschiderea unei ferestre este o tranzacție din lane-ul Cosmos și avansează secvența contului, care este totodată nonce-ul său EVM, așa că citiți nonce-ul după ce fereastra este deschisă și semnați abia atunci.
Opțiuni de fereastră adăugate în v3.2.8
Începând cu release-ul v3.2.8 (doar pe testnet până la un upgrade ulterior de mainnet), MsgOpenEVMWindow poartă trei liste opționale de cel mult 16 intrări fiecare. O fereastră fără ele se comportă ca înainte, cu excepția regulii deny-by-default de mai jos.
| Câmp mesaj | Flag CLI | Ce desemnează |
|---|---|---|
validators (7) | --validators | Contractele a căror verificare a semnăturii contului contează pentru acțiunile sale: un modul validator pe care îl apelează un contract de portofel sau entry point-ul ERC-4337 |
staking_validators (8) | --staking-validators | Adresele de operator ale validatorilor (qorvaloper…) către care contul poate delega sau redelega prin fereastră |
ibc_receivers (9) | --ibc-receivers | Perechi exacte <channel>/<receiver> către care poate merge un transfer IBC de QOR nativ; canalul și receptorul sunt comparate octet cu octet (channel-0, receptor bech32 cu litere mici) |
Precompile-urile standard sunt deny-by-default. Pentru un cont pe care îl autorizează o fereastră, o metodă a unui precompile standard (staking, distribution, ICS-20, gov, slashing, precompile-urile de token ERC-20) este refuzată dacă nu se află în tabelul de mai jos și fereastra nu listează precompile-ul în allowed_targets.
| Precompile | Metodă | Admisă când |
|---|---|---|
| distribution | claimRewards, withdrawDelegatorRewards | recompensele sunt plătite chiar contului |
| distribution | withdrawValidatorCommission | validatorul este al contului însuși și plătește chiar contul |
| distribution | depositValidatorRewardsPool | validatorul este în staking_validators și fiecare monedă este QOR nativ |
| staking | delegate, redelegate | validatorul destinație este în staking_validators |
| ICS-20 | transfer | QOR nativ, prin portul transfer, fără memo, către o pereche din ibc_receivers |
| precompile-uri de token ERC-20 | transfer, transferFrom, approve | QOR nativ; un alt token doar când fereastra listează adresa acelui token |
Precompilatele de staking (0x…0800) și de distribution (0x…0801), la fel ca celelalte precompilate standard din acest tabel, nu sunt active în prezent pe testnet și nici pe mainnet; guvernanța le poate activa. Un apel către adresa unui precompilat inactiv ajunge la o adresă fără cod: reușește, nu face nimic și plătește totuși gaz. Câmpurile ferestrei staking_validators, validators și ibc_receivers se aplică odată ce un precompilat este activ. Pentru staking și pentru revendicarea recompenselor, folosiți mesajele Cosmos native (QoreX sau comenzile qorechaind de staking și distribution). Când un precompilat este activ, sumele lui sunt în uqor (6 zecimale), nu în unități EVM cu 18 zecimale.
Orice altceva este refuzat printr-o fereastră: dezlegarea delegării (undelegate), votul și alte acțiuni de guvernanță, schimbarea adresei de retragere, crearea sau editarea unui validator, finanțarea community pool-ului. Trimiteți-le ca tranzacții Cosmos semnate post-cuantic.
Semnăturile verificate on-chain au nevoie de contractul verificator în fereastră. Un permit EIP-2612, un transfer Permit2, un ordin EIP-712 sau o meta-tranzacție este verificat de un contract cu ecrecover. Începând cu v3.2.8 (ambele rețele, odată ce o rețea îl aplică), această verificare reușește pentru un cont care deține o cheie post-cuantică utilizabilă doar cât timp fereastra live a contului admite contractul verificator, adică tokenul sau Permit2 însuși, nu routerul care transmite apelul. Listați-l în allowed_targets și deschideți fereastra înainte ca utilizatorul să semneze. Fără acea fereastră, semnătura este tratată ca invalidă, iar contractul o refuză. Un permit sau o aprobare acordată în interiorul unei ferestre rămâne după închiderea ferestrei, deci revizuiți și revocați aprobările când sesiunea se încheie.
Schimbările de cheie închid fereastra. Rotirea, migrarea sau reînregistrarea cheii post-cuantice a contului șterge fereastra sa deschisă și consimțământul său EIP-7702; deschideți din nou fereastra după aceea. Mesajele de fereastră și de consimțământ trebuie să fie mesajul de nivel superior al contului însuși, semnat post-cuantic: nu pot fi trimise prin authz și nu pot fi acordate altui cont.
Închideți o fereastră mai devreme cu qorechaind tx pqc close-evm-window (același tipar --generate-only și cosign), de exemplu dacă bănuiți că cheia clasică este expusă: tot ce mai admitea fereastra este respins începând cu blocul următor.
Delegări EIP-7702
O delegare EIP-7702 a contului vostru (o tranzacție de tip 4) intră în vigoare doar cu consimțământul post-cuantic propriu al contului, începând cu v3.2.2. Înregistrați mai întâi consimțământul cu mesajul din lane-ul Cosmos semnat hibrid MsgAuthorizeEVMDelegation (qorechaind tx pqc authorize-evm-delegation <delegate_0x> <blocks>); este de unică folosință, expiră după numărul de blocuri dat și este revocat de close-evm-window. Valoarea care părăsește un cont delegat este imputată ferestrei acelui cont, o tranzacție de tip 4 eșuată își păstrează autorizările pe care le-a aplicat, iar qorechaind tx pqc clear-evm-delegation elimină o delegare. O delegare respinsă răspunde cu codurile 60 până la 63. Citiți consimțământul cu GET /qorechain/pqc/v1/evm_delegation_consent/{address}.
Respingere (codespace pqc) | Semnificație |
|---|---|
| code 26 | Nu există nicio fereastră deschisă pentru expeditor sau expeditorul nu are o cheie PQC înregistrată |
| code 27 | Fereastra a expirat sau este epuizată (mesajul arată care limită) sau tranzacția este în afara domeniului ferestrei |
| code 28 | Limite invalide la deschiderea unei ferestre sau nicio cheie înregistrată în acel moment |
Cu SDK-ul TypeScript (0.8.2 și ulterior): openEvmWindowMsg, closeEvmWindowMsg, fetchEvmWindow({ rest, address }) și classifyEvmWindowRejection(err) ("no-pqc-key" | "no-window" | "exhausted" | "invalid"). SDK 0.9.0 și ulterior (0.13.0 este versiunea curentă) adaugă opțiunile de domeniu (nativeOnly, allowedTargets) la openEvmWindowMsg și constructorii de consimțământ EIP-7702 (authorizeEvmDelegationMsg, clearEvmDelegationMsg, fetchEvmDelegationConsent); versiunile anterioare lui 0.9.0 construiesc doar fereastra fără domeniu, așa că folosiți qorechaind pentru restul (vedeți ghidul SDK pentru EVM).
Spațiul de nume personalizat qor_
QoreChain extinde JSON-RPC cu un spațiu de nume qor_ pentru interogări specifice chain-ului. Metodele de mai jos sunt planificate:
Metodele din tabelul de mai jos sunt planificate și nu sunt servite: fiecare returnează -32601 (metodă negăsită). Singura metodă servită a spațiului de nume este qor_getKEMKey, și doar unde nodul listează qor în spațiile sale de nume: observat la 7 noiembrie 2026, testnet-ul listează qor și răspunde, în timp ce endpointul public de mainnet listează doar eth, net, rpc, txpool și web3 și răspunde -32601. Vedeți spațiul de nume qor_ pentru stare și pentru alternativele REST (de exemplu GET /qorechain/pqc/v1/account/{address} pentru starea cheii PQC).
| Metodă | Descriere |
|---|---|
qor_getPQCKeyStatus | Verifică dacă un cont are o cheie publică PQC înregistrată |
| Statistici AI (planificat) | Recuperează statistici ale motorului AI (număr de anomalii, distribuția riscului); numele metodei nu este final |
qor_getCrossVMMessage | Interoghează starea unui mesaj cross-VM după ID |
qor_getPoolClassification | Obține clasificarea pool-ului de validatori (RPoS/DPoS/PoS) |
qor_getReputationScore | Interoghează scorul de reputație al unui validator |
qor_getAbstractAccount | Recuperează configurația contului abstract |
Exemplu cu curl:
curl -X POST http://localhost:8545 \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "qor_getPQCKeyStatus",
"params": ["0xYourAddress"],
"id": 1
}'
Pașii următori
- Precompilate EVM — Referință pentru interfețele de precompilate QoreChain (trei active pe testnet, niciuna pe mainnet)
- Interoperabilitate Cross-VM — Apeluri cross-VM și disponibilitatea lor curentă
- Abstractizarea contului — Autentificatoare pentru portofele conectate și reguli de cheltuire (activat pe testnet, dezactivat pe mainnet)