Ana içeriğe geç

EVM Ön Derlemeleri

QoreChain, QoreChain EVM Engine'i protokol düzeyindeki özellikleri doğrudan Solidity'ye sunan altı özel ön derlenmiş contract ile genişletir. Bu ön derlemeler; kuantum sonrası kriptografiye, AI risk puanlamasına, VM'ler arası mesajlaşmaya ve PRISM konsensüs parametrelerine zincir üzerinde erişim sağlar.

Ana ağda etkin değil; test ağında dördü etkin

Aşağıdaki altı QoreChain ön derlemesi düğüme derlenmiştir, ancak EVM yalnızca active_static_precompiles parametresinde listelenen adresleri çalıştırır. qorechain-vladi ana ağında (EVM zincir kimliği 9801) bu liste yazım sırasında boştur, dolayısıyla orada hiçbiri etkin değildir. qorechain-diana test ağında (EVM zincir kimliği 9800) PQC Verify, PQC Key Status ve PRISM Consensus Params etkindir; bunlar test ağı yönetişim önerisi 21 ile etkinleştirildi (27 Ekim 2026'da geçti) ve CrossVM Bridge (0x…0901) de listededir (7 Kasım 2026'da okundu; gözden geçirilmiş sözleşmelerden oluşan bir izin listesiyle çalışır, bkz. Ağ durumu). İki AI ön derlemesi her iki ağda da etkin değildir. Listede olmayan bir adrese yapılan çağrı başarılı olur ve boş veri (0x) döndürür; geri alınmaz (revert) ve hata döndürmez. Herhangi birine güvenmeden önce Ağ durumu bölümüne bakın.

Ağ durumu​

Ön derlemeAdresqorechain-vladi (ana ağ)qorechain-diana (test ağı)
CrossVM Bridge0x…0901Etkin değilİzin listesiyle etkin (liste 7 Kasım 2026'da okundu; v3.2.7 yükseltmesinden sonra bir eth_call izin listesindeki bir sözleşmeye ulaştı ve listenin dışındaki biri için reddedildi; bkz. Multi-VM)
PQC Verify0x…0A01Etkin değilEtkin (27 Ekim 2026'dan beri)
PQC Key Status0x…0A02Etkin değilEtkin (27 Ekim 2026'dan beri)
AI Risk Score0x…0B01Etkin değilEtkin değil
AI Anomaly Check0x…0B02Etkin değilEtkin değil
PRISM Consensus Params0x…0C01Etkin değilEtkin (27 Ekim 2026'dan beri)

Durum, 27 Ekim 2026'da canlı active_static_precompiles parametresinden okunduğu gibidir (ana ağ, v3.2.6 sonrasında 4 Kasım 2026'da yeniden okundu: hâlâ boş; her iki ağ 7 Kasım 2026'da yeniden okundu: ana ağ boş, test ağı 0x…0901, 0x…0A01, 0x…0A02 ve 0x…0C01 adreslerini listeliyor). Bu, yönetişimle değiştirilen bir zincir parametresidir; dolayısıyla her ağın listesi yalnızca bir yönetişim önerisi geçtiğinde değişir: test ağı listesi öneri 21 ile belirlendi ve yazım sırasında hiçbir ana ağ önerisi onu değiştirmiyor. v3.2.3 sürümü (ana ağ, 20 Ekim 2026), CrossVM köprüsünün ve AI anomali ön derlemesinin güçlendirilmiş sürümlerini bir protokol özelliğinin arkasında ikili dosyaya koydu, ancak hiçbir ön derlemeyi etkinleştirmedi ve ne v3.2.4 (ana ağda 23 Ekim 2026'dan beri, test ağında 19 Ekim 2026'dan beri) ne v3.2.6 (ana ağda 4 Kasım 2026'dan beri) ne de v3.2.7 (test ağında 6 Kasım 2026'dan beri, ana ağda 12 Kasım 2026'dan beri) bunu değiştirir: ana ağ listesi 12 Kasım 2026'da yeniden okundu ve hâlâ boş. Önce salt okunur PQC ve konsensüs ön derlemeleri gelir, salt okunur sabit noktalı yolları hazır olduğunda AI çifti ve en son CrossVM köprüsü. Bu tablo yalnızca uygulanmış olanı listeler: hâlâ oylama döneminde olan bir öneri bir durum değildir.

Güncel listeyi kendiniz kontrol edin (boşsa hiçbiri etkin değildir):

curl -s https://api.qore.host/cosmos/evm/vm/v1/params | jq .params.active_static_precompiles
curl -s https://api-testnet.qore.host/cosmos/evm/vm/v1/params | jq .params.active_static_precompiles

Boş dönüş verisine karşı koruma​

Etkin olmayan (veya QoreChain'e ait olmayan) bir adres veri olmadan başarı döndürdüğü için, düşük seviyeli bir çağrının ham dönüş baytlarını uzunluklarını kontrol etmeden asla okumayın. abi.decode ve tipli arayüz çağrıları boş veride revert eder, bu da güvenli sonuçtur; elle yazılmış düşük seviyeli bir çağrı bunu açıkça kontrol etmelidir:

(bool ok, bytes memory ret) = address(0x0000000000000000000000000000000000000a02)
.staticcall(abi.encodeWithSignature("pqcKeyStatus(address)", account));
require(ok && ret.length >= 96, "precompile not active");
(bool registered, uint8 algorithmId, bytes memory pubkey) = abi.decode(ret, (bool, uint8, bytes));

Bu adreslere değer göndermeyin. Bunlar payable değildir ve etkin olmayan bir ön derleme adresine gönderilen değer orada kalır ve geri alınmasının bir yolu yoktur.

Test ağında, etkin üç ön derlemenin yanıt verdiğini hızlıca denetlemek için (Foundry'nin cast aracıyla; ana ağda bu adresler bunun yerine boş veri döndürür):

RPC=https://evm-testnet.qore.host
cast call 0x0000000000000000000000000000000000000c01 "rlConsensusParams()(uint256,uint256,uint256,uint256)" --rpc-url $RPC
cast call 0x0000000000000000000000000000000000000a02 "pqcKeyStatus(address)(bool,uint8,bytes,bool)" 0x0000000000000000000000000000000000000001 --rpc-url $RPC

Standart ön derlemeler​

Altı QoreChain ön derlemesinin yanı sıra düğüm, standart cosmos/evm ön derlemelerini de taşır. Bunlar aynı kurala tabidir: yalnızca yönetişimin adreslerini active_static_precompiles içinde listelediği yerde çalışırlar ve düğümün topluluk derlemesi bunları içermez.

AdresÖn derleme
0x…0100P-256 (durumsuz)
0x…0400Bech32 (durumsuz)
0x…0800Staking
0x…0801Distribution
0x…0802IBC transferi (ICS-20)
0x…0804Bank (salt okunur)
0x…0805Governance
0x…0806Slashing

0x…0803 (vesting) yukarı akışta (upstream) ayrılmıştır ve uygulanmamıştır: bu adreste hiçbir şey yoktur. QoreChain'de staking, delegasyon ve doğrulayıcı işlemleri yalnızca yerel şeritte yapılır (bkz. Stake ve Doğrulayıcılar); bu yüzden staking ön derlemesi üzerine staking akışları kurmayın. Kaynak: genel çekirdek deposunda v3.2.6 etiketindeki docs/EVM_PRECOMPILES.md.


Ön Derleme Adres Haritası​

Gaz rakamları, bir ön derleme etkin olduktan sonra düğümün tahsil ettiği değerlerdir (bayt başına, çağrı girişinin bayt başına anlamına gelir).

Ön DerlemeAdresTemel GazAçıklama
CrossVM Bridge0x000000000000000000000000000000000000090150,000 + 4/byteSenkron VM'ler arası çağrılar (EVM'den QoreChain Native'a)
PQC Verify0x0000000000000000000000000000000000000a0125,000 + 8/byteML-DSA-87 kuantum sonrası imzalarını doğrular
PQC Key Status0x0000000000000000000000000000000000000a022,500Bir hesabın kayıtlı bir PQC anahtarı olup olmadığını kontrol eder
AI Risk Score0x0000000000000000000000000000000000000b0150,000İşlem verileri için AI tarafından oluşturulan risk puanını alır
AI Anomaly Check0x0000000000000000000000000000000000000b0240,000Bir transferin anormal olarak işaretlenip işaretlenmediğini kontrol eder
PRISM Consensus Params0x0000000000000000000000000000000000000c011,500Mevcut PRISM ile ayarlanmış konsensüs parametrelerini okur

Solidity Arayüzleri​

IQorePQC.sol​

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

interface IQorePQC {
/// @notice Verify an ML-DSA-87 (Dilithium-5) signature
/// @param pubkey The 2592-byte ML-DSA-87 public key
/// @param signature The 4627-byte ML-DSA-87 signature
/// @param message The original message bytes
/// @return valid True if the signature is valid
function pqcVerify(
bytes calldata pubkey,
bytes calldata signature,
bytes calldata message
) external view returns (bool valid);

/// @notice Check if an account has a registered PQC public key
/// @param account The Ethereum-style address to check
/// @return registered True if a PQC key is registered
/// @return algorithmId The PQC algorithm identifier (1 = ML-DSA-87)
/// @return pubkey The registered public key bytes (empty if not registered)
/// @return possessionProven True only if the key was registered with a verified proof of possession
function pqcKeyStatus(address account)
external
view
returns (bool registered, uint8 algorithmId, bytes memory pubkey, bool possessionProven);
}

v3.2.4'ten itibaren (ana ağda 23 Ekim 2026'dan beri, test ağında 19 Ekim 2026'dan beri), pqcKeyStatus çıktısı pubkey değerinden sonra dördüncü bir değer taşır, bool possessionProven: hesabın geçerli anahtarının doğrulanmış bir sahiplik kanıtıyla kanıtlanıp kanıtlanmadığı (bkz. Kuantum Sonrası İmzalama). Ön derlemenin etkin olduğu her yerde döndürülür: test ağında canlıdır (anahtarı olmayan bir hesap için yapılan çağrı false, 0, 0x, false döndürür), ana ağda ise bir yükseltme ön derlemeyi etkinleştirdiğinde. Yukarıdaki arayüz dört çıktıyı da listeler. Anahtara güvenmesi gereken bir sözleşme dördüncüyü kontrol etmelidir: sahiplik kanıtı kayıtta isteğe bağlıdır, bu yüzden tek başına registered yeterli değildir.

IQoreAI.sol​

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

interface IQoreAI {
/// @notice Get the AI-generated risk score for transaction data
/// @param txData The transaction data to evaluate
/// @return score Risk score in basis points (0-10000)
/// @return level Risk level: 0=SAFE, 1=LOW, 2=MEDIUM, 3=HIGH, 4=CRITICAL
function aiRiskScore(bytes calldata txData)
external
view
returns (uint256 score, uint8 level);

/// @notice Check if a transfer is flagged as anomalous
/// @param sender The sender address
/// @param amount The transfer amount in wei
/// @return anomalyScore The anomaly score (higher = more anomalous)
/// @return flagged True if the transfer exceeds the anomaly threshold
function aiAnomalyCheck(address sender, uint256 amount)
external
view
returns (uint256 anomalyScore, bool flagged);
}

IQoreConsensus.sol​

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

interface IQoreConsensus {
/// @notice Get current PRISM-tuned consensus parameters
/// @return blockTime Current target block time in milliseconds
/// @return baseGasPrice Current base gas price in wei
/// @return validatorSetSize Current active validator set size
/// @return epoch Current PRISM epoch number
function rlConsensusParams()
external
view
returns (
uint256 blockTime,
uint256 baseGasPrice,
uint256 validatorSetSize,
uint256 epoch
);
}

Kullanım Örnekleri​

PQC Verify — Kuantum Sonrası Bir İmzayı Doğrulama​

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

import "./interfaces/IQorePQC.sol";

contract PQCVerifier {
IQorePQC constant PQC = IQorePQC(0x0000000000000000000000000000000000000a01);

/// @notice Verify a PQC signature and revert if invalid
function verifyOrRevert(
bytes calldata pubkey,
bytes calldata signature,
bytes calldata message
) external view {
bool valid = PQC.pqcVerify(pubkey, signature, message);
require(valid, "PQC signature verification failed");
}
}

Gaz maliyeti: 25,000 temel + giriş verisinin baytı başına 8 gaz. Giriş, ABI ile kodlanmış çağrıdır (2592 baytlık açık anahtar, 4627 baytlık imza, mesaj, artı ABI ofsetleri ve dolgu), bu nedenle tipik bir ML-DSA-87 doğrulaması yaklaşık 85,000-90,000 gaza mal olur.

PQC Key Status — Hesap Kaydını Kontrol Etme​

contract PQCChecker {
IQorePQC constant PQC_STATUS = IQorePQC(0x0000000000000000000000000000000000000a02);

function requirePQCKey(address account) external view {
(bool registered, , , bool possessionProven) = PQC_STATUS.pqcKeyStatus(account);
require(registered, "Account must have a registered PQC key");
require(possessionProven, "The key was registered without a proof of possession");
}
}
possessionProven değerini kontrol edin

Sahiplik kanıtı kayıtta isteğe bağlıdır, bu yüzden tek başına registered, hesabın anahtarı kontrol ettiğini göstermez. Kayıtlı bir kuantum-sonrası anahtara dayanan bir sözleşme ayrıca possessionProven değerinin true olmasını da şart koşmalıdır.

Gaz maliyeti: 2,500 sabit.

AI Risk Score — İşlem Riskini Değerlendirme​

import "./interfaces/IQoreAI.sol";

contract RiskGate {
IQoreAI constant AI = IQoreAI(0x0000000000000000000000000000000000000b01);

uint8 constant MAX_ALLOWED_RISK = 2; // Allow up to MEDIUM

function executeIfSafe(bytes calldata txData) external {
(uint256 score, uint8 level) = AI.aiRiskScore(txData);
require(level <= MAX_ALLOWED_RISK, "Risk level too high");

// Proceed with execution...
}
}

Risk seviyeleri:

SeviyeDeğer
SAFE0
LOW1
MEDIUM2
HIGH3
CRITICAL4

Seviye, AI motorunun işlem için verdiği önem derecesi etiketinden gelir; puan baz puan (basis points) cinsinden döndürülür (0 - 10000). Puan aralıklarından seviyelere sabit bir eşleme yoktur, bu yüzden puan eşikleri yerine level üzerinden kapı koyun.

Gaz maliyeti: 50,000 sabit.

AI Anomaly Check — Şüpheli Transferleri İşaretleme​

contract AnomalyGuard {
IQoreAI constant AI = IQoreAI(0x0000000000000000000000000000000000000b02);

function safeTransfer(address sender, uint256 amount) external view {
(uint256 anomalyScore, bool flagged) = AI.aiAnomalyCheck(sender, amount);

if (flagged) {
revert("Transfer flagged as anomalous");
}
}
}

Gaz maliyeti: 40,000 sabit.

PRISM Consensus Params — Konsensüs Durumunu Okuma​

contract ConsensusReader {
IQoreConsensus constant RL = IQoreConsensus(
0x0000000000000000000000000000000000000c01
);

function getBlockTime() external view returns (uint256) {
(uint256 blockTime, , , ) = RL.rlConsensusParams();
return blockTime;
}

function getCurrentEpoch() external view returns (uint256) {
(, , , uint256 epoch) = RL.rlConsensusParams();
return epoch;
}
}

Gaz maliyeti: 1,500 sabit, artı çağrının yaptığı durum okumaları standart maliyetle.

Dört değerin anlamı

v3.2.6'dan itibaren (her iki ağ da onu veya daha yeni bir sürümü çalıştırır; ön derlemenin kendisi yalnızca test ağında etkindir) rlConsensusParams, sabit yer tutucular yerine rlconsensus modülünün tuttuğu değerleri döndürür: uygulanan blok süresi hedefi (milisaniye), uygulanan gaz fiyatı tabanı, modülün default_validator_set_size değeri ve ajanın geçerli epoch'u. Test ağında 27 Ekim 2026'da 5000, 100, 100, 1 döndürdü (GET /qorechain/rlconsensus/v1/applied_params ile aynı uygulanan değerler, bkz. REST / gRPC Uç Noktaları). Bunlar modülün kendi ayarlarıdır, ölçülen blok süresi değildir (ana ağda yaklaşık 3,1 sn, test ağında yaklaşık 1,3 sn) ve ajan test ağında gölge modunda çalışır, dolayısıyla hiçbir şey uygulamaz. Ana ağda adres etkin listede değildir: ona yapılan bir eth_call 4 Kasım 2026'da boş veri (0x) döndürdü, v3.2.6 kodu ikili dosyada olmasına rağmen (rl-params-precompile-live etkindir). v3.2.6'dan eski bir düğümde aynı çağrı sabit yer tutucu varsayılanlar döndürür.

CrossVM Bridge — EVM'den QoreChain Native Çağırma​

uyarı

CrossVM köprü ön derlemesi ana ağda etkin değildir ve test ağında etkindir (7 Kasım 2026'da okundu); orada 7 Kasım 2026'da v3.2.7 yükseltmesinden sonra üzerinden salt okunur bir eth_call çalıştırıldı: izin listesindeki bir hedef sözleşmeye ulaşır, listenin dışındaki bir hedef is not allowlisted ile reddedilir (ayrıntılar VM'ler Arası Birlikte Çalışabilirlik sayfasındadır). Ana ağda, v3.2.7 yükseltmesinden sonra bile, ayrı bir yönetişim kararına kadar VM'ler arası çağrılarla birlikte kapalı kalır. v3.2.3'ten beri ikili dosya, onun güçlendirilmiş bir sürümünü taşır: STATICCALL çağrısını reddeder; iç içe çağrıyı, çağıran çerçevede kalan gazla sınırlı bir gaz sayacında çalıştırır ve günlüğe kaydeder, böylece çağıran sözleşmedeki bir revert QoreChain Native tarafını da geri alır; yalnızca izin listesindeki QoreChain Native hedeflerine ulaşır (EVM hedefleri reddedilir); ve VM'ler arası devre kesiciye uyar. Bir yönetişim önerisi onu ana ağda etkinleştirene kadar orada senkron bir EVM'den QoreChain Native'a yol yoktur; bugün ana ağda kendisi de kapalı olan MsgCrossVMCall mesaj yolu için VM'ler Arası Birlikte Çalışabilirlik bölümüne bakın.

Düğüm, calldata'yı executeCrossVMCall(uint8 targetVM, string targetContract, bytes payload) olarak çözümler (4 baytlık seçici, ardından ABI ile kodlanmış argümanlar). Desteklenen tek kullanım EVM'den QoreChain Native'adır (targetVM = 1); ABI etkinleştirmeden önce yine de değişebilir. @qorechain/rdk yardımcısı encodeCrossVmCalldata bu düzeni 0.6.0'dan itibaren kodlar (önceki sürümler farklı bir fonksiyonu kodluyordu) ve isCrossVmPrecompileActive canlı active_static_precompiles listesini okur; bkz. Multi-VM.

Gaz maliyeti: 50,000 temel + giriş baytı başına 4 gaz, artı hedef sözleşme yürütme maliyeti. Ayrıntılar için VM'ler Arası Birlikte Çalışabilirlik bölümüne bakın.


Arayüz Dosyası Konumları​

Solidity arayüz dosyaları, doğrudan içe aktarma için depoda mevcuttur:

contracts/
interfaces/
IQorePQC.sol
IQoreAI.sol
IQoreConsensus.sol

Bunları Hardhat veya Foundry projenize kurun:

# Copy interfaces to your project
cp -r contracts/interfaces/ my-project/contracts/interfaces/

Veya bunlara Solidity dosyalarınızda içe aktarma yolu aracılığıyla başvurun:

import "./interfaces/IQorePQC.sol";
import "./interfaces/IQoreAI.sol";
import "./interfaces/IQoreConsensus.sol";

Sonraki Adımlar​