Ana içeriğe geç

EVM Yetkilendirme Penceresi Başvurusu (v3.2.8)

Bir Ethereum işlemi yalnızca bir secp256k1 imzası taşır, başka hiçbir şey taşımaz; bu yüzden QoreChain'in diğer tüm işlemlerden istediği kuantum sonrası (ML-DSA-87) imzayı taşıyamaz. EVM yetkilendirme penceresi bu boşluğu kapatır. Hesap önce kuantum sonrası anahtarıyla imzalanmış olan bir QoreChain Native mesajıyla sınırlı bir pencere açar; EVM hattı da hesabın sıradan MetaMask, ethers.js, Hardhat veya Foundry işlemlerini yalnızca pencere onları kapsadığı sürece kabul eder. Bu sayfa, bir pencerenin v3.2.8 sürümünde nasıl davrandığının eksiksiz başvurusudur.

v3.2.8 nerede çalışır

qorechain-diana test ağı, 12 Kasım 2026'dan beri v3.2.8 çalıştırmaktadır. qorechain-vladi ana ağı bunu henüz uygulamadı; ana ağda pencere, aşağıda "v3.2.8" olarak işaretlenen seçenekler ve kurallar olmadan EVM Geliştirme sayfasında anlatıldığı gibi çalışır. v3.2.8'in altındaki bir düğüm, yeni listeleri ayarlayan bir pencere mesajını reddeder.

Neden önemli​

  • Çalınmış bir klasik anahtar, yalnızca açık bir pencerenin kabul ettiği kadar değerlidir. Pencere zamanı (blok), işlem sayısını, çıkabilecek QOR miktarını ve isteğe bağlı olarak hesabın hangi sözleşmelere dokunabileceğini sınırlar.
  • Kuantum sonrası anahtar yetkili kalır. Bir pencereyi açmak, daraltmak ve kapatmak hibrit imzalı Native mesajlardır. Klasik anahtar tek başına asla bir pencere açamaz.
  • v3.2.8 varsayılanları sıkılaştırır. Standart precompile yöntemleri varsayılan olarak reddedilir, diğer sözleşmelerin denetlediği imzalar pencerenin onayını gerektirir ve kuantum sonrası anahtarı değiştirmek pencereyi kapatır.

v3.2.8 eklerinin kısa özeti v3.2.8'de eklenen pencere seçenekleri bölümündedir; bu sayfa onu tam olarak tekrarlamaz ve örnekleri, alan başvurusunu ve hata tablosunu ekler. Adım adım ilk pencere için bkz. İlk İşleminiz.

Açma, kapatma ve okuma​

EylemMesajCLIREST
Açma (açık olan pencerenin yerine geçer)/qorechain.pqc.v1.MsgOpenEVMWindowqorechaind tx pqc open-evm-window [blocks] [max-txs] [max-value]yok (bir işlem)
Hemen kapatma/qorechain.pqc.v1.MsgCloseEVMWindowqorechaind tx pqc close-evm-windowyok (bir işlem)
Okumayokqorechaind q pqc evm-window <address>GET /qorechain/pqc/v1/evm_window/{address}

Açma ve kapatma Native hat işlemleridir ve hesabın hibrit (klasik artı ML-DSA-87) imzasını gerektirir; ayrıca hesabın pencere açabilmesi için kayıtlı bir kuantum sonrası anahtarı olmalıdır. Bir pencereyi kapatmak, bekleyen bir EIP-7702 onayını da geri çeker. Açmak hesabın nonce değerini ilerletir (Native sıra numarası EVM nonce değeridir); bu yüzden önce pencereyi açın, sonra EVM nonce değerini okuyun.

CLI​

İşlemi --generate-only ile oluşturun, ardından kuantum sonrası imzayı tx pqc cosign ile ekleyin. Sürüm qorechaind ikili dosyasında gen-key ve cosign vardır; topluluk derlemesinde yoktur.

export QNODE=https://rpc-testnet.qore.host:443
export QCHAIN=qorechain-diana

# Open: 7,200 blocks, 20 transactions, 100 QOR cap (value plus maximum fees)
qorechaind tx pqc open-evm-window 7200 20 100qor \
--from mykey --chain-id $QCHAIN --node $QNODE \
--gas 400000 --fees 80000uqor --generate-only > window.json

qorechaind tx pqc cosign window.json --from mykey --pqc-key mykey-mldsa \
--chain-id $QCHAIN --node $QNODE

Argüman verilmezse CLI, bir dağıtım oturumu için boyutlandırılmış varsayılanları kullanır: 3,600 blok, 10 işlem ve 25 QOR. Tek bir token sözleşmesine kapsamı daraltılmış bir pencere (adresi kendinizinkiyle değiştirin):

qorechaind tx pqc open-evm-window 600 5 100qor \
--allowed-targets 0x1111111111111111111111111111111111111111 \
--from mykey --chain-id $QCHAIN --node $QNODE \
--gas 400000 --fees 80000uqor --generate-only > window.json

Bir pencereyi erken kapatın, örneğin klasik anahtarın açığa çıktığını düşünüyorsanız. Pencerenin hâlâ kabul edeceği her şey bir sonraki bloktan itibaren reddedilir:

qorechaind tx pqc close-evm-window \
--from mykey --chain-id $QCHAIN --node $QNODE \
--gas 400000 --fees 40000uqor --generate-only > close.json

qorechaind tx pqc cosign close.json --from mykey --pqc-key mykey-mldsa \
--chain-id $QCHAIN --node $QNODE

Pencereyi okuyun:

qorechaind q pqc evm-window <qor1-address> --node $QNODE

Görmek istediğiniz şey, live: true ile birlikte remaining_blocks, remaining_txs ve remaining_value (uqor) değerleridir. Komut başvurusu İşlem Komutları sayfasındadır.

REST​

curl -s https://api-testnet.qore.host/qorechain/pqc/v1/evm_window/<qor1-address>

Penceresi olmayan bir hesap, found: false ile HTTP 200 yanıtı verir; bu yüzden rotayı yoklamak güvenlidir. Her sayı bir JSON dizesidir. Saklanmış bir pencere süresi dolmuş veya tükenmiş olabilir: live, pencerenin geçerli yükseklikte hâlâ en az bir sıfır değerli işlem daha kabul edip etmeyeceğini söyler.

TypeScript​

Pencere yardımcıları @qorechain/sdk içindedir (imzalama kurulumu için SDK EVM kılavuzuna bakın). openEvmWindowMsg aşağıdaki her alanı alır, closeEvmWindowMsg kapatma mesajını oluşturur, fetchEvmWindow pencereyi okur ve classifyEvmWindowRejection bir reddi açıklar.

import {
createClient,
deriveNativeAccount,
directSignerFromPrivateKey,
derivePqcCanonical,
openEvmWindowMsg,
closeEvmWindowMsg,
fetchEvmWindow,
} from "@qorechain/sdk";

const REST = "https://api-testnet.qore.host";
const client = createClient({
network: "testnet",
endpoints: { rest: REST, rpc: "https://rpc-testnet.qore.host", evmRpc: "https://evm-testnet.qore.host" },
});
const account = await deriveNativeAccount(mnemonic);
const signer = await directSignerFromPrivateKey(account.privateKey, "qor");
const pqcKeypair = derivePqcCanonical(account.address, mnemonic); // already registered on chain
const tx = await client.connectTx(signer, { pqcKeypair }); // signs hybrid

// Open a window that may call one token contract (replace the address with your own).
await tx.signAndBroadcast(
[
openEvmWindowMsg({
sender: account.address,
blocks: 7200,
maxTxs: 20,
maxValue: "100000000", // uqor: value PLUS the maximum fee of each transaction
allowedTargets: ["0x1111111111111111111111111111111111111111"], // your token contract
}),
],
"auto",
);

// Read it back (opens first, then read the nonce).
const w = await fetchEvmWindow({ rest: REST, address: account.address });
console.log(w.live, w.remainingBlocks, w.remainingTxs, w.remainingValue);

// Close it early.
await tx.signAndBroadcast([closeEvmWindowMsg(account.address)], "auto");

openEvmWindowMsg, herhangi bir şey imzalanmadan önce sınırları ve liste biçimlerini denetler; bu yüzden bir hata, reddedilmiş bir işleme mal olmak yerine yerelde başarısız olur. MAX_EVM_WINDOW_BLOCKS ve MAX_EVM_WINDOW_TXS sınırları dışa aktarır. Geri okuma (fetchEvmWindow) sınırları, sayaçları ve v3.2.3 kapsamını (nativeOnly, allowedTargets) döndürür; validators (sözleşme adresleri), stakingValidators (qorvaloper1...) ve ibcReceivers ("<channel>/<receiver>") v3.2.8 listelerini taşıyan SDK 0.14.0'dan itibaren oluşturucu tarafından kabul edilir; geri okuma bunları döndürmez, v3.2.8'deki REST pencere rotası da döndürmez, bu yüzden pencereyi açtığınız değerleri saklayın. Üç listeyi yalnızca v3.2.8 çalıştıran bir ağ için ayarlayın: bunun altındaki bir düğüm, onları ayarlayan bir pencere mesajını reddeder. Hibrit imzalı bir connectTx ile kuantum sonrası anahtar önceden kayıtlı olmalıdır.

Test ağında denendi​

12 Kasım 2026'da qorechain-diana üzerinde (v3.2.8 sürümü), kuantum sonrası anahtarını kaydetmiş bir eth-native hesapla, SDK 0.13.0 (openEvmWindowMsg, closeEvmWindowMsg, fetchEvmWindow) ve hibrit imzalama kullanılarak çalıştırıldı. validators, staking_validators ve ibc_receivers pencere alanları SDK 0.13.0 oluşturucularında yoktu; SDK 0.14.0 bunları openEvmWindowMsg içine ekler ve bu çalıştırma onları kullanmadı (SDK 0.13.0 ile bunlar için komut satırını kullanın).

AdımSonuç
Açmadan önce GET /qorechain/pqc/v1/evm_window/{address}found: false, live: false
Açma: 300 blok, 5 işlem, 1,000,000 uqorkod 0, 187,282 gaz kullanıldı. Geri okuma: found: true, live: true, opened_height 9942089, expiry_height 9942389, max_txs 5, max_value 1000000, remaining_blocks 297, native_only: false, allowed_targets: []
nativeOnly: true ile yeniden açmakod 0, 187,803 gaz kullanıldı. Yeni pencere eskisinin yerini aldı: native_only: true, yeni bir opened_height
Kapatmakod 0, 170,468 gaz kullanıldı. Geri okuma: found: false

Aynı gün SDK 0.14.0 ile, allowedTargets (izin verilen bir hedef adresi), stakingValidators (bir doğrulayıcı operatör adresi) ve ibcReceivers (bir channel-0/... çifti) ile açılan bir pencere kod 0 ve 195,233 gaz kullanımıyla başarılı oldu. REST geri okuması allowed_targets değerini listeledi ve found: true, live: true döndürdü; validators, staking_validators veya ibc_receivers listelerini döndürmez, bu yüzden pencereyi açtığınız değerleri saklayın.

fetchEvmWindow aynı alanları camel case biçiminde döndürdü (openedHeight, remainingBlocks, nativeOnly, allowedTargets). Açma ve kapatma hibrit imzalı Cosmos işlemleridir; bu yüzden bir hesabın gönderdiği ilk işlem için önce anahtarının kaydedilmesi gerekir.

Python, Go, Rust ve Java​

Her SDK'nın mesaj için bir oluşturucusu ve bir REST okuması vardır. Hepsi zincirin sınırlarını yerelde denetler. v3.2.8 listelerini ayarlayan bir dil oluşturucusu, SDK 0.14.0 veya sonrasını gerektirir (Java: Maven Central'da 0.14.0); önceki sürümler yalnızca eski alanları oluşturur.

DilAçma (her liste ile)KapatmaOkumaEVM limitleri
Pythonmsg.pqc.open_evm_window(sender=, blocks=, max_txs=, max_value=, native_only=, allowed_targets=, validators=, staking_validators=, ibc_receivers=)msg.pqc.close_evm_window(sender=)get_evm_window(rest, address)fetch_evm_limits(rest)
Gomessages.NewOpenEVMWindowWithScope(sender, blocks, maxTxs, maxValue, scope) ve bir messages.EVMWindowScopemessages.NewCloseEVMWindow(sender)rest.GetEVMWindowStatus(address)rest.GetEVMLimits()
Rustmsg::pqc::open_evm_window_with_scope_any(sender, blocks, max_txs, max_value, &scope) ve EvmWindowScopemsg::pqc::close_evm_window_any(sender)get_evm_window(&rest, address)henüz yardımcı yok; REST rotasını okuyun
JavaEvmWindow.openWithPolicy(sender, blocks, maxTxs, maxValue, nativeOnly, allowedTargets, validators, stakingValidators, ibcReceivers)EvmWindow.close(sender)rest.evmWindow(address)rest.evmLimits()

Python:

from qorsdk import RestClient, get_network, get_evm_window, msg

sender = "qor1..."
open_msg = msg.pqc.open_evm_window(
sender=sender,
blocks=7200,
max_txs=20,
max_value="100000000", # uqor, integer string
allowed_targets=["0x1111111111111111111111111111111111111111"], # your token contract
)
# broadcast it through the usual hybrid path, then:
rest = RestClient(get_network("testnet").endpoints.rest)
status = get_evm_window(rest, sender)
print(status.live, status.remaining_blocks, status.remaining_txs, status.remaining_value)
close_msg = msg.pqc.close_evm_window(sender=sender)

Go:

open, err := messages.NewOpenEVMWindowWithScope(sender, 7200, 20, "100000000",
messages.EVMWindowScope{
AllowedTargets: []string{"0x1111111111111111111111111111111111111111"}, // your token contract
})
status, err := rest.GetEVMWindowStatus(sender)
closeMsg, err := messages.NewCloseEVMWindow(sender)

Rust:

use qorechain::evm_window::{get_evm_window, EvmWindowScope};
use qorechain::msg;

let scope = EvmWindowScope {
allowed_targets: vec!["0x1111111111111111111111111111111111111111".into()], // your token contract
..Default::default()
};
let open = msg::pqc::open_evm_window_with_scope_any("qor1...", 7200, 20, "100000000", &scope)?;
let status = get_evm_window(&rest, "qor1...").await?;
let close = msg::pqc::close_evm_window_any("qor1...");

Java:

TypedMessage open = EvmWindow.openWithPolicy(sender, 7200, 20, "100000000",
false,
List.of("0x1111111111111111111111111111111111111111"), // allowedTargets: your token contract
null, // validators
null, // stakingValidators
null); // ibcReceivers
EvmWindowStatus status = rest.evmWindow(sender);
TypedMessage close = EvmWindow.close(sender);

SDK sizin yerinize asla bir pencere açmaz. Bir pencere harcamayı yetkilendirir; bu yüzden adım açık ve kullanıcı tarafından görülebilir kalır.

Alanlar​

Alan (CLI bayrağı)LimitAnlamı
blocks (ilk argüman)1 ile 17,280 arasıPencere, açılış yüksekliği artı blocks değerinden sonra hiçbir şeyi kabul etmez. Bu bir süre değil, blok sayısıdır: bugünkü blok sürelerinde test ağında yaklaşık 5 saat, ana ağda yaklaşık 15 saat
max_txs (ikinci argüman)1 ile 1,000 arasıKaç EVM işlemi kabul ettiği
max_value (üçüncü argüman)pozitifPencerenin hesaptan çıkmasına izin verdiği toplam uqor: aktarılan değer artı kabul edilen her işlemin azami ücreti (gaz limiti çarpı ücret tavanı)
native_only (--native-only)true veya falseYalnızca düz QOR transferlerini kabul eder: calldata yok, sözleşme oluşturma yok, kod taşıyan alıcı yok, EIP-7702 yetkilendirmesi yok
allowed_targets (--allowed-targets)en fazla 16 0x adresi, tekrar yokYalnızca bu adreslere yapılan işlemleri kabul eder; sözleşme oluşturma reddedilir
validators (--validators)en fazla 16 0x adresi, tekrar yokHesabın imzası için yaptıkları denetimin hesabın kendi eylemleri için sayıldığı sözleşmeler: bir cüzdan sözleşmesinin çağırdığı bir doğrulayıcı modül veya ERC-4337 giriş noktası. v3.2.8
staking_validators (--staking-validators)en fazla 16 qorvaloper... adresi, tekrar yokHesabın pencere üzerinden delege edebileceği veya yeniden delege edebileceği doğrulayıcılar. v3.2.8
ibc_receivers (--ibc-receivers)en fazla 16 girdi, biçimi <channel>/<receiver>, her biri en fazla 256 karakter, boşluk veya virgül yokYerel bir QOR IBC transferinin gidebileceği kesin hedefler. Bayt bayt karşılaştırılır; bu yüzden channel-0 ve küçük harfli bech32 alıcıyı transferin taşıdığı şekilde aynen yazın. v3.2.8

Her sınır verilmelidir: zincir, eksik bir sınırı varsayılana çevirmek yerine reddeder (CLI dağıtım oturumu varsayılanlarını kendisi doldurur). Herhangi bir sınırın tükenmesi, pratikte pencereyi sonlandırır. Bir pencere yalnızca hesabın kuantum sonrası anahtarı kullanılabilir olduğu sürece çalışır; yani boş, yalnızca klasik değil ve yönetişim tarafından devre dışı bırakılmamış olmalıdır.

Bir pencerenin neleri saydığı​

Kabul sırasında, işlem çalışmadan önce, her EVM işlemi max_txs içinden birini kullanır ve kullanılan değere aktarılan değerini artı azami ücretini ekler; bunlar 18 ondalıklı EVM biriminden uqor'a çevrilir ve yukarı yuvarlanır. Kabul edilip sonra geri alınan (revert) bir işlem de payını kullanmış olur. Yürütmeden sonra, bir precompile'ın hesap adına taşıdığı yerel QOR (bir delegasyon, bir yatırma, bir IBC transferi) de pencereye yazılır; bu nedenle işlem değeri sıfır olsa bile max_value hesabına girer.

Sayılmayanlar: eth_call, eth_estimateGas ve simülasyonlar. Token'lar hiç fiyatlandırılmaz: bir ERC-20 transferi veya onayı sıfır değer taşır; bu yüzden onları bir kapsamla (allowed_targets) sınırlayın. Her ücretlendirme, address, evm_address, window_open_height, used_txs, used_value, tx_value ve source (kabul için ante, yürütme sonrası ücretlendirme için settlement) niteliklerini taşıyan bir pqc_evm_window_used olayı yayar; böylece bir cüzdan bir işlemin ne aldığını gösterebilir. Açma ve kapatma pqc_evm_window_opened ve pqc_evm_window_closed yayar.

Bir pencere üzerinden standart precompile'lar​

Bir pencerenin yetkilendirdiği bir hesap için, standart bir precompile'ın (staking, distribution, ICS-20, gov, slashing, ERC-20 token precompile'ları) bir yöntemi, tabloda olmadıkça ve pencere o precompile'ı allowed_targets içinde listelemedikçe reddedilir. Precompile adresleri EVM Precompile'ları sayfasındadır; staking, distribution, ICS-20 ve gov olanlar 0x...0800, 0x...0801, 0x...0802 ve 0x...0805'tir.

PrecompileYöntemNe zaman kabul edilir
distributionclaimRewards, withdrawDelegatorRewardsödüller hesabın kendisine ödenirse (çekim adresi hesabın kendi adresiyse)
distributionwithdrawValidatorCommissiondoğrulayıcı hesabın kendisine aitse ve hesabın kendisine ödeme yapıyorsa
distributiondepositValidatorRewardsPooldoğrulayıcı staking_validators içindeyse ve her coin yerel QOR ise
stakingdelegate, redelegatehedef doğrulayıcı staking_validators içindeyse
ICS-20transferyerel QOR, transfer portu üzerinden, memo olmadan, ibc_receivers içindeki bir çifte
ERC-20 token precompile'larıtransfer, transferFrom, approveyerel QOR; başka bir token yalnızca pencere o token'ın adresini listeliyorsa

Bu tablodaki diğer standart precompile'lar gibi staking (0x…0800) ve distribution (0x…0801) precompile'ları da şu anda ne test ağında ne de ana ağda etkindir; yönetişim bunları etkinleştirebilir. Etkin olmayan bir precompile adresine yapılan çağrı, kodu olmayan bir adrese ulaşır: başarılı olur, hiçbir şey yapmaz ve yine de gas öder. staking_validators, validators ve ibc_receivers pencere alanları, bir precompile etkinleştirildiğinde geçerli olur. Staking ve ödül talep etme için yerel Cosmos mesajlarını kullanın (QoreX veya qorechaind staking ve distribution komutları). Bir precompile etkin olduğunda tutarları uqor cinsindendir (6 ondalık), 18 ondalıklı EVM birimleri cinsinden değil.

Diğer her şey, pencere ne listelerse listelesin, bir pencere üzerinden reddedilir: delegasyonu geri çekme (undelegate), bir unbonding'i iptal etme, oy verme ve diğer yönetişim eylemleri, çekim adresini değiştirme, bir doğrulayıcı oluşturma veya düzenleme, hapisten çıkarma (unjail), topluluk havuzunu fonlama. Bunları kuantum sonrası imzalı Native işlemler olarak gönderin. ibc_receivers olmadan ICS-20'yi listelemek hiçbir transferi kabul etmez ve staking_validators olmadan staking precompile'ını listelemek hiçbir delegasyonu kabul etmez.

Ne listeleyeceğinize dair örnekler:

HedefPencere
Stake etme, ödül talep etme, delegasyonu geri çekme, oy vermeYerel Cosmos mesajlarını kullanın (QoreX Stake ve Claim veya qorechaind tx staking / distribution komutları); bunlar için EVM penceresini kullanmayın
QOR'u köprüyle dışarı göndermeICS-20 precompile'ını içeren allowed_targets artı channel-0/<receiver> gibi ibc_receivers
Bir ERC-20 precompile'ı olarak tutulan bir IBC token'ını taşımao token'ın adresini içeren allowed_targets

Bir sözleşmeyi listelemek, o sözleşmenin hesabın varlıklarıyla yapabileceği her şeye hesabın onay vermesi demektir: hesabın token'larını tutan bir kasa, yönlendirici veya token için pencere hangi token'ların nereye taşınacağını sınırlamaz.

Sözleşme oluşturma​

Bir sözleşme dağıtmak, kapsamı daraltılmamış bir pencere gerektirir. native_only veya allowed_targets içeren bir pencere sözleşme oluşturmayı reddeder. Bir dağıtım oturumu için düz bir pencere açın (CLI varsayılanları bunun için boyutlandırılmıştır), dağıtın, sonra kapatın. Sonraki oturumlar için, dağıttığınız sözleşmeye yapılan çağrılarla sınırlamak üzere --allowed-targets <contract-address> ile bir pencere açın. Hardhat ve Foundry ile dağıtım anlatımı EVM Geliştirme sayfasındadır.

Permit'ler, EIP-712 emirleri ve Permit2​

Bir EIP-2612 permit'i, bir Permit2 transferi, imzalı bir emir veya bir meta-işlem, bir sözleşme tarafından ecrecover precompile'ı ile denetlenir. v3.2.8'den itibaren (her iki ağda, bir ağ uyguladığında), kullanılabilir bir kuantum sonrası anahtarı olan bir hesap için bu denetim yalnızca hesabın kendi canlı penceresi doğrulayan sözleşmeyi kabul ettiği sürece başarılı olur; bu, çağrıyı ileten yönlendirici değil, token'ın veya Permit2'nin kendisidir.

  1. Pencerenin kapsamı daraltılmışsa, doğrulayan sözleşmeyi allowed_targets içinde listeleyin (native_only böyle bir imzayı kabul etmez).
  2. Pencereyi kullanıcı imzalamadan önce açın. Canlı bir pencere olmadan imza geçersiz sayılır ve sözleşme onu reddeder.
  3. İmzanın kendisi pencereye asla yazılmaz, çünkü bir imza kullanıldığında herkese açık hale gelir.
  4. Bir pencere içinde verilen bir permit veya onay, pencere kapandıktan sonra da kalır. Oturum bittiğinde onayları gözden geçirin ve iptal edin.

Kuantum sonrası kaydı olmayan hesaplar, kendi imzasını denetleyen delege edilmiş bir cüzdan ve kapsamı daraltılmamış bir pencerede göndericinin kendi imzası eskisi gibi kurtarılır. Sorgular ve gaz tahminleri etkilenmez.

Anahtar değişiklikleri ve EIP-7702 onayı​

  • Kuantum sonrası anahtarı döndürmek, taşımak veya yeniden kaydetmek pencereyi kapatır ve her EIP-7702 onayını siler. Sonrasında pencereyi yeniden açın. Bunu sıcak cüzdanlarda ve borsa entegrasyonlarında hesaba katın.
  • Pencere, EIP-7702 onayı (MsgAuthorizeEVMDelegation, MsgClearEVMDelegation) ve soyut hesap yönetimi mesajları, hesabın kendi üst düzey, hibrit imzalı mesajı olmalıdır. authz (MsgExec) üzerinden gönderilemez veya başka bir hesaba verilemez ve bu mesaj türlerinin bir yetkisi reddedilir. Bu türden mevcut onay yetkileri yükseltmede kaldırıldı.
  • Başka birinin işlemi içinde hareket eden EIP-7702 ile delege edilmiş bir hesap, kodunun hareket ettiği anda kendi canlı penceresine ihtiyaç duyar. Pencere yoksa yalnızca o çağrı başarısız olur ve çağıran sözleşme başarısızlığı görür; bu nedenle delege edilmiş bir hesaba ödeme yapmak artık ödeyenin tüm işleminin geri alınmasına yol açmaz.

Bir delegasyon için onay qorechaind tx pqc authorize-evm-delegation <delegate_0x> <blocks> ile kaydedilir ve GET /qorechain/pqc/v1/evm_delegation_consent/{address} ile okunur; bkz. EIP-7702 delegasyonları.

Yürürlükteki limitler​

curl -s https://api-testnet.qore.host/qorechain/pqc/v1/evm_limits

Test ağı 12 Kasım 2026'da tx_max_gas 30000000 ve precompile_input_max_bytes 16384 ile yanıt verdi:

LimitDeğerAnlamı
tx_max_gas30,000,000Bir EVM işleminin isteyebileceği en fazla gaz; bunun üzerinde işlem çalışmadan önce reddedilir. Bir Native mesajın başlattığı EVM çalıştırmaları aynı bütçeyi paylaşır
precompile_input_max_bytes16,384Korumalı durumlu bir precompile'ın kabul ettiği en büyük girdi
Pencere blocks17,280En uzun pencere
Pencere max_txs1,000Bir penceredeki en fazla işlem
Liste girdileriliste başına 16allowed_targets, validators, staking_validators, ibc_receivers

Yanıt ayrıca yönetişimin belirlediği değerleri içeren bir limits nesnesi taşır; yürürlükteki değerler olan üst düzey tx_max_gas ve precompile_input_max_bytes değerlerini okuyun. Rota v3.2.8'den itibaren sunulur; bu yüzden herkese açık ana ağ, v3.2.8'i uygulayana kadar 501 Not Implemented yanıtı verir (ana ağ v3.2.7'ye geçtikten sonra, 12 Kasım 2026'da kontrol edildi).

Normal bir gaz fiyatında açılan bir pencere de azami ücreti sayar: 100 gwei ücret tavanında 30,000,000 gaz limiti, bir işlem için max_value hesabına 3 QOR sayar.

Hatalar​

Redler pqc codespace'i ile gelir. EVM JSON-RPC üzerinden bir ret, mesajı taşıyan ve codespace içermeyen bir yayın hatası olarak gelir; bu yüzden metinle de eşleştirin (SDK sınıflandırıcıları bunu yapar).

KodMesajNedenNe yapmalı
26no open EVM authorisation windowPencere yok, kayıtlı kuantum sonrası anahtar yok veya pencerenin süresi dolduAnahtar yoksa önce kaydedin, sonra bir pencere açın
27EVM authorisation window exhaustedBir sınır tükendi veya işlem pencerenin kapsamı dışında (pencerenin listelemediği standart bir precompile veya kapsamı daraltılmış bir pencerede sözleşme oluşturma dahil)Daha büyük sınırlarla veya ihtiyacınız olan kapsamla yeni bir pencere açın
28invalid EVM authorisation windowLimitlerin dışında bir açma isteği veya o noktada kullanılabilir anahtar yokblocks, max_txs, max_value ve listeleri kontrol edin; anahtarı kaydedin veya onarın
62delegated account has no window covering this actionDelege edilmiş bir hesap eylemde bulundu veya gönderen, penceresinin kapsadığından fazlasını taşıdı ve kapsayan bir pencere yoktu. v3.2.8'den itibaren aynı kural yalnızca ihlal eden çağrıyı başarısız kılarO hesap için eylemi kabul eden bir pencere açın
revert<method> is disabled: the circuit breaker has tripped ...Native mesajı kapatılmış standart bir precompile yöntemiBekleyin; pencerede değiştirilecek bir şey yok
revert<method>: account ... has no open EVM authorisation window that lists 0x...Pencereleri onu listelemeyen bir hesap için kod üzerinden erişilen, değer taşıyan bir precompilePrecompile'ı allowed_targets içine ekleyin
noncenonce too lowEVM işlemi pencere açılmadan önce imzalandı (açmak nonce değerini ilerletir)Nonce değerini yeniden okuyun ve yeniden imzalayın
chain idonly replay-protected (EIP-155) Ethereum transactions are acceptedZincir kimliği olmadan imzalanmış bir işlemAracın ağ yapılandırmasında zincir kimliğini ayarlayın

TypeScript SDK'sındaki classifyEvmWindowRejection(err), "no-pqc-key", "no-window", "exhausted" veya "invalid" döndürür; diğer SDK'ların eşdeğer bir sınıflandırıcısı vardır (Python'da describe_evm_window_error, Go'da tx.ClassifyEVMWindowError, Rust'ta classify_evm_window_error, Java'da EvmWindowIssue.classify).

Pencerenin yönetmedikleri​

Pencere EVM hattını, yani yalnızca klasik anahtarla imzalanan işlemleri yönetir. Aşağıdakiler ona yazılmaz, çünkü her biri kendi kuantum sonrası imzasını taşır veya imzalamış bir hesap için bir modül tarafından başlatılır:

  • Hesabın kendisinin imzaladığı Native hat mesajları: bank gönderimleri, staking, yönetişim ve imzalayanın kendi 0x adresi olarak çalışan, EVM'ye yapılan bir MsgCrossVMCall.
  • Hesabın kimlik doğrulayıcıları tarafından yetkilendirilen soyut hesap yürütmeleri.
  • Modüllerin çalıştırdığı ERC-20 dönüşümleri ve IBC geri çağrıları.

Göndericinin kendisinin göndermediği EVM'ye yapılan bir cross-VM çağrısı (örneğin bir authz yetkisi altında) göndericinin penceresi altında çalışır ve hedefi kabul etmesini gerektirir. 0x0901 cross-VM köprüsü, onu listeleyen bir pencere gerektirir. Bkz. Cross-VM Birlikte Çalışabilirlik.

MetaMask ve QoreX akışı​

MetaMask bir Ethereum anahtarıyla imzalar; bu, Ethereum tarzı (coin 60) bir hesabın anahtarıdır ve MetaMask bir Native mesaj üretemez. Böyle bir hesabın penceresini QoreX'te açar; QoreX'in kendi gönderimleri Native hattı kullanır ve hiçbir zaman pencere gerektirmez.

  1. QoreX'te, MetaMask ifadeniz için coin-60 hesabını ekleyin veya geri yükleyin (bkz. MetaMask veya Dashboard'dan bir ifadeyi geri yükleme). Hesabın kayıtlı bir ML-DSA-87 anahtarı olmalıdır; ilk QoreX transferiniz bunu kaydeder.
  2. EVM erişim penceresi kartını açın (uygulama: Ayarlar, Güvenlik, EVM erişim penceresi; uzantı: açılır pencerede EVM erişim penceresi düğmesi) ve kaç blok (17,280'e kadar), kaç işlem (1,000'e kadar) ve QOR cinsinden harcama tavanını seçin. Tavan her tutarı ve azami ücretini kapsar. Varsayılanlar 300 blok, 5 işlem ve 1 QOR'dur.
  3. Hibrit imzalı mesajı onaylayın. Yeni bir pencere açık olanın yerine geçer ve açmak nonce değerinizi ilerletir; bu yüzden MetaMask'ten yalnızca sonrasında gönderin; daha önce hazırlanmış bir işlem "nonce too low" ile reddedilir.
  4. MetaMask'ten 9800 (test ağı) veya 9801 (ana ağ) zincir kimliğine karşı gönderin. İşiniz bittiğinde, yalnızca bir pencere canlıyken sunulan Pencereyi kapat seçeneğini kullanın.

QoreX kartı üç sınırı ayarlar. Kapsam listeleri (allowed_targets, validators, staking_validators, ibc_receivers, native_only) için bir ekran sunmaz; bu yüzden kapsamı daraltılmış bir pencere qorechaind veya bir SDK'dan gelir. Kart ve dört durumu için bkz. EVM erişim penceresi.