Passa al contenuto principale

Sviluppo EVM

QoreChain esegue un ambiente di esecuzione completamente compatibile con EVM sul QoreChain EVM Engine, che consente di distribuire e interagire con smart contract Solidity utilizzando strumenti familiari. Il modulo EVM espone un'interfaccia JSON-RPC sulla porta 8545 (WebSocket sulla 8546) che supporta i flussi di lavoro di sviluppo Ethereum standard.

nota

Gli esempi seguenti fanno riferimento alla mainnet qorechain-vladi (Chain ID EVM 9801), attiva dal 7 giugno 2026 con versione della chain v3.1.95. Per la testnet qorechain-diana, usa il Chain ID EVM 9800.

Endpoint JSON-RPC​

ProprietàValore
URL predefinitohttp://localhost:8545
URL WebSocketws://localhost:8546
Namespace supportatieth_, web3_, net_, txpool_, qor_
Chain ID (mainnet)9801 (qorechain-vladi)
Chain ID (testnet)9800 (qorechain-diana)
Simbolo della valutaQOR

Il namespace qor_ fornisce metodi specifici di QoreChain. Vedi Namespace personalizzato qui sotto.

Configurazione del wallet (MetaMask)​

Aggiungi QoreChain come rete personalizzata in MetaMask:

CampoValore MainnetValore Testnet
Nome reteQoreChain (qorechain-vladi)QoreChain Diana
URL RPChttp://localhost:8545http://localhost:8545
Chain ID98019800
Simbolo valutaQORQOR
URL Block Explorer(usa l'explorer ufficiale della mainnet)(lascia vuoto per la testnet locale)

Hardhat​

Installa Hardhat e configura il tuo 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)
    },
  },
};

Distribuisci un contratto:

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

Esegui i test sull'EVM di QoreChain:

npx hardhat test --network qorechain

Foundry​

Crea e distribuisci un contratto con 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();

Modello del gas​

QoreChain utilizza un modello a base fee dinamica EIP-1559 per le transazioni EVM:

  • La base fee si adegua per ogni blocco in base all'utilizzo
  • Gli utenti possono impostare maxFeePerGas e maxPriorityFeePerGas
  • Le priority fee vanno al proponente del blocco

Ponte tra denominazioni​

Il token nativo QOR ha 6 cifre decimali (uqor), mentre l'EVM prevede 18 cifre decimali. Il modulo x/precisebank gestisce la conversione in modo trasparente:

ContestoDenominazioneDecimaliEsempio
Chain nativauqor61000000 uqor = 1 QOR
EVMwei181e18 wei = 1 QOR

Questa conversione è trasparente: quando controlli un saldo tramite eth_getBalance, la risposta è denominata in wei a 18 decimali. Quando lo stesso account viene interrogato tramite il modulo bank nativo, il saldo appare in uqor a 6 decimali.

Coppie di token ERC-20​

Il modulo x/erc20 fornisce la registrazione automatica di coppie di token tra le denominazioni native Cosmos SDK e i contratti ERC-20:

  • I token nativi possono essere usati all'interno dei contratti EVM come ERC-20
  • I token ERC-20 distribuiti sull'EVM possono essere convertiti in denominazioni native
  • La conversione è bidirezionale e viene gestita a livello di protocollo
# 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

Compatibilità PQC ed EVM​

Le transazioni EVM utilizzano firme ECDSA classiche (secp256k1) per garantire la piena compatibilità con gli strumenti, i wallet e le librerie Ethereum esistenti. Questo assicura che MetaMask, Hardhat, Foundry, ethers.js e tutti gli strumenti EVM standard funzionino senza modifiche.

Per la sicurezza post-quantistica all'interno dell'EVM:

  • Usa il precompile PQC Verify (0x0000...0A01) per verificare on-chain le firme ML-DSA-87 da Solidity. Vedi Precompile EVM.
  • I messaggi cross-VM dall'EVM verso CosmWasm o SVM possono essere firmati con PQC a livello di transazione Cosmos SDK.
  • Gli account possono opzionalmente registrare chiavi pubbliche PQC tramite x/pqc per la sicurezza ibrida.

Namespace personalizzato qor_​

QoreChain estende il JSON-RPC con un namespace qor_ per le query specifiche della chain:

MetodoDescrizione
qor_getPQCKeyStatusVerifica se un account ha una chiave pubblica PQC registrata
qor_getAIStatsRecupera le statistiche del motore AI (conteggio anomalie, distribuzione del rischio)
qor_getCrossVMMessageInterroga lo stato di un messaggio cross-VM tramite ID
qor_getPoolClassificationOttiene la classificazione del pool del validatore (RPoS/DPoS/PoS)
qor_getReputationScoreInterroga il punteggio di reputazione di un validatore
qor_getAbstractAccountRecupera la configurazione dell'account astratto

Esempio con curl:

curl -X POST http://localhost:8545 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "qor_getPQCKeyStatus",
    "params": ["0xYourAddress"],
    "id": 1
  }'

Prossimi passi​