Sari la conținutul principal

Dezvoltare EVM

QoreChain rulează un mediu de execuție pe deplin compatibil EVM pe QoreChain EVM Engine, permițându-vă să implementați și să interacționați cu contracte inteligente Solidity folosind instrumentele cunoscute. Modulul EVM expune o interfață JSON-RPC pe portul 8545 (WebSocket pe 8546) care acceptă fluxurile standard de dezvoltare Ethereum.

notă

Exemplele de mai jos vizează rețeaua principală (mainnet) qorechain-vladi (EVM chain ID 9801), activă din 7 iunie 2026 rulând versiunea de lanț v3.1.85. Pentru rețeaua de test (testnet) qorechain-diana, folosiți EVM chain ID 9800.

Endpoint JSON-RPC​

ProprietateValoare
URL implicithttp://localhost:8545
URL WebSocketws://localhost:8546
Namespace-uri acceptateeth_, web3_, net_, txpool_, qor_
Chain ID (mainnet)9801 (qorechain-vladi)
Chain ID (testnet)9800 (qorechain-diana)
Simbol monedăQOR

Namespace-ul qor_ oferă metode specifice QoreChain. Vedeți Namespace personalizat mai jos.

Configurarea portofelului (MetaMask)​

Adăugați QoreChain ca rețea personalizată în MetaMask:

CâmpValoare mainnetValoare testnet
Nume rețeaQoreChain (qorechain-vladi)QoreChain Diana
URL RPChttp://localhost:8545http://localhost:8545
Chain ID98019800
Simbol monedăQORQOR
URL explorator de blocuri(folosiți exploratorul oficial mainnet)(lăsați necompletat pentru testnet local)

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:

npx hardhat run scripts/deploy.js --network qorechain

Rulați teste împotriva QoreChain EVM:

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 gaz​

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 utilizare
  • Utilizatorii pot seta maxFeePerGas și maxPriorityFeePerGas
  • Taxele de prioritate ajung la proponentul blocului

Puntea de denominare​

Tokenul nativ QOR are 6 zecimale (uqor), în timp ce EVM se așteaptă la 18 zecimale. Modulul x/precisebank gestionează conversia transparentă:

ContextDenominareZecimaleExemplu
Lanț nativuqor61000000 uqor = 1 QOR
EVMwei181e18 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 bancar nativ, soldul apare în uqor cu 6 zecimale.

Perechi de tokenuri ERC-20​

Modulul x/erc20 oferă înregistrarea automată a perechilor de tokenuri între denominările native Cosmos SDK și contractele ERC-20:

  • Tokenurile native pot fi folosite în contractele 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 new token pair (governance proposal)
qorechaind tx erc20 register-coin <denom> --from mykey

# Convert native tokens to ERC-20
qorechaind tx erc20 convert-coin 1000000uqor --from mykey

# Convert ERC-20 back to native
qorechaind tx erc20 convert-erc20 <contract-addr> 1000000000000000000 --from mykey

Compatibilitate PQC și EVM​

Tranzacțiile EVM folosesc semnături ECDSA clasice (secp256k1) pentru compatibilitate deplină cu instrumentele, portofelele și bibliotecile Ethereum existente. Acest lucru asigură că MetaMask, Hardhat, Foundry, ethers.js și toate instrumentele EVM standard funcționează fără modificări.

Pentru securitate post-cuantică în cadrul EVM:

  • Folosiți precompilatul PQC Verify (0x0000...0A01) pentru a verifica semnături ML-DSA-87 on-chain din Solidity. Vedeți Precompilate EVM.
  • Mesajele cross-VM de la EVM la CosmWasm sau SVM pot fi semnate PQC la nivelul tranzacției Cosmos SDK.
  • Conturile pot înregistra opțional chei publice PQC prin x/pqc pentru securitate hibridă.

Namespace personalizat qor_​

QoreChain extinde JSON-RPC cu un namespace qor_ pentru interogări specifice lanțului:

MetodăDescriere
qor_getPQCKeyStatusVerifică dacă un cont are o cheie publică PQC înregistrată
qor_getAIStatsObține statistici ale motorului AI (numărări de anomalii, distribuția riscului)
qor_getCrossVMMessageInteroghează starea unui mesaj cross-VM după ID
qor_getPoolClassificationObține clasificarea grupului de validatori (RPoS/DPoS/PoS)
qor_getReputationScoreInteroghează scorul de reputație al unui validator
qor_getAbstractAccountObține 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​