SSS ve sorun giderme
Mainnet yayında mı?
Evet. Mainnet yayında (zincir kimliği qorechain-vladi, 7 Haziran 2026'dan beri
canlı) zincir sürümü v3.2.7'yi çalıştırıyor (12 Kasım 2026'da 4.164.600 yüksekliğinde uygulandı, yönetişim önerisi 16; v3.2.6, 4 Kasım 2026'da 4.020.000 yüksekliğinde uygulanmıştı, öneri 15; v3.2.5, 29 Ekim 2026'da 3.906.833 yüksekliğinde ve v3.2.4 23 Ekim 2026'da 3.742.566 yüksekliğinde uygulanmıştı); testnet 27 Ekim 2026'dan beri v3.2.6'yı 6 Kasım'dan itibaren v3.2.7'yi ve 12 Kasım 2026'dan beri v3.2.8'i çalıştırıyor (9.929.500 yüksekliği; mainnet uygulamadı). Testnet hazır
ayarı (qorechain-diana) da kullanılabilir durumda kalmaya devam eder. SDK 0.12.0'dan itibaren her iki hazır
ayar da herkese açık uç noktaları varsayılan alır; ağı
createClient({ network: "mainnet" }) ile seçin ve endpoints'i yalnızca kendi düğümünüz için
geçersiz kılın.
Ağ ve uç noktalar bölümüne bakın.
Neden çağrılarım localhost'a gidiyor?
0.12.0 öncesi bir SDK kullanıyorsunuz; hazır ayarları varsayılan olarak localhost uç noktalarını kullanır:
yükseltin veya bir endpoints nesnesi geçirin. 0.12.0'dan itibaren createClient() ve
createClient({ network: "mainnet" }) herkese açık uç noktaları kullanır; localhost
kullanan ise localnet hazır ayarıdır.
const client = createClient({
endpoints: {
rest: "https://api-testnet.qore.host",
rpc: "https://rpc-testnet.qore.host",
evmRpc: "https://evm-testnet.qore.host",
},
});
Bunun yerine "endpoint ... is not configured for the mainnet preset" hatasını alırsanız, çağrı
herkese açık hazır ayarların tanımlamadığı bir uç noktaya (gRPC, bir SVM RPC, mainnet EVM
WebSocket) ihtiyaç duyuyordur; onu endpoints içinde geçirin.
İmzalama yolu (connectTx) konsensüs rpc uç noktasına ihtiyaç duyar;
QoreChain Native okumaları da onu kullanır. REST okumaları rest kullanır; EVM çağrıları
evmRpc kullanır (bu ad alanını sunan bir düğümde qor_ çağrıları da). Mainnet
URL'leri ağ referansında yer alır.
"Cannot find module 'viem'" / "'@solana/web3.js'"
Bunlar sırasıyla @qorechain/evm ve @qorechain/svm paketlerinin eş
bağımlılıklarıdır (peer dependency). Bunları projenize kurun:
npm i @qorechain/evm viem
npm i @qorechain/svm @solana/web3.js
Bir precompile çağrısı "returned no data" / "feature not present" hatası veriyor
QoreChain EVM precompile'ları düğüme derlenmiştir ancak mainnet'te etkin
değildir ve testnet'te yalnızca üçü etkindir: yalnızca adresleri EVM modülünün
active_static_precompiles parametresinde listelenmiş olduğu yerlerde yanıt
verirler. Bu liste mainnet'te boştur; testnet'te PQC doğrulama (0x…0A01), PQC
anahtar durumu (0x…0A02) ve konsensüs parametreleri (0x…0C01) precompile'larını
içerir (27 Ekim 2026'da kontrol edildi; testnet listesi 4 Kasım'dan itibaren ve 7 Kasım 2026'da da VM'ler arası köprü 0x…0901 adresini içeriyordu, bir izin listesiyle etkin (eth_call ile test edildi) ve mainnet'in listesi hâlâ boştu); dolayısıyla AI çifti
orada hâlâ hiçbir şey yanıtlamaz. Bir precompile etkin olmadığında çağrı boş veri
döndürür; bu yüzden viem returned no data ("0x") bildirir ve yardımcı fonksiyon
hata fırlatır (bkz.
EVM Precompile'ları: Ağ durumu).
Düz bir EVM düğümünde çağrılar aynı şekilde başarısız olur.
GET /cosmos/evm/vm/v1/params adresini kontrol edin ve hatanın çağrı bazında ele
alınması için her precompile çağrısını sarmalayın.
client.qor çağrım -32601 ile başarısız oluyor
client.qor, yayımlanmış hiçbir düğüm sürümünün sunmadığı qor_ JSON-RPC ad
alanını çağırır; genel EVM uç noktalarındaki rpc_modules yalnızca eth, net,
rpc, txpool ve web3 listeler. Bunun yerine bir REST rotası kullanın; örneğin
client.rest.get(...) üzerinden GET /qorechain/pqc/v1/account/{address} (PQC
anahtar durumu) veya GET /qorechain/burn/v1/stats. Bkz.
qor_ ad alanı.
Tutarlarım bir milyon kat sapıyor
QOR'un temel birimi 10^6 uqor'dur. toBase / fromBase kullanın ve tüm
hesaplamaları temel birimlerde yapın:
toBase("1.5"); // "1500000"
fromBase("1500000"); // "1.5"
EVM çalışma zamanının QOR'u 18 ondalık basamakla temsil ettiğini unutmayın
(EVM geleneği); bu, Native tarafındaki 10^6'lık uqor tabanından farklıdır.
Hangi paketler yayımlandı ve nerede?
Hepsi (12 Kasım 2026'da kontrol edildi). TypeScript çekirdeği (@qorechain/sdk, 0.14.0),
React kiti (@qorechain/react, 0.14.0), create-qorechain-dapp iskele aracı
(0.14.0, 0.13.1 şablon düzeltmelerini de taşır) ve EVM/SVM adaptörleri (@qorechain/evm, @qorechain/svm, 0.14.0) npm'de;
Python istemcisi PyPI'da (pip install qorechain-sdk, sürüm 0.14.0, import
qorsdk); Go istemcisi modül proxy'sinde
(go get github.com/qorechain/qorechain-sdk/packages/go@v0.14.0); Rust istemcisi
crates.io'da (cargo add qorechain-sdk, 0.14.0); Java istemcisi ise Maven
Central'da (io.github.qorechain:qorechain-sdk, 0.14.0, JDK 17 veya üzeri). Dil başına tüm komutlar için
Kurulum bölümüne bakın.
Anımsatıcı ifadem (mnemonic) reddediliyor
SDK, herhangi bir anahtar türetmeden önce hem BIP-39 kelime listesini hem
de sağlama toplamını doğrular; böylece yazım hatası içeren bir ifade sessizce
yanlış hesabı üretmek yerine hata fırlatır. Kelimeleri yeniden kontrol edin;
bir ifadeyi test etmek için validateMnemonic kullanın.
Hibrit (PQC) işlemler
Hibrit (klasik + ML-DSA-87) gönderim Native yolunda yayında ve zorunludur —
yalnızca klasik imzalı Native işlemler zincir üzerinde reddedilir (zincir
v3.2.0). Bir hibrit işlemin PQC doğrulamasından geçebilmesi için imzalayanın
PQC açık anahtarının MsgRegisterPQCKeyV2 ile (klasik imzalı, hibritten muaf bir
işlem) açıkça kaydedilmiş olması gerekir; açık anahtarı uzantıya gömmek
(includePqcPublicKey: true) anahtarı kaydetmez ve zincir ilk kullanımda bir
anahtarı kaydetmez. TypeScript'te istemciye anahtar çiftini verin
(client.connectTx(signer, { pqcKeypair }), SDK 0.9.0 veya sonrası); gönderdiği her işlem
hibrit olarak imzalanır.
Zincir, hedged veya deterministik, FIPS-204'e uygun her geçerli ML-DSA-87
imzasını kabul eder. SDK, bir işlemin her zaman aynı imzaya ve tx hash'ine sahip
olması için (0.5.1 sürümünden beri) varsayılan olarak deterministik imzalar.
Hibrit bir tx pqc kodu 21 (hybrid_verify_failed) ile başarısız olursa neden
sign-bytes sürümü, chain-id, eski bir PQC kütüphanesi veya kayıtlı olmayan ya da
farklı bir anahtardır; hedged imzalama asla neden değildir.
Her iki ağ da v2 sign-bytes biçimini doğrular; bu yüzden SDK 0.8.1 veya daha
yenisini kullanın (güncel sürüm 0.14.0) ve rest (veya signBytesVersion) geçirin:
bunlardan biri yoksa oluşturucular qorechain-vladi / qorechain-diana üzerinde
hata fırlatır.
Kod 21 sorun giderme ve
Hesaplar ve PQC imzalama bölümlerine bakın.
EVM işlemim "no open EVM authorisation window" ile reddediliyor
Zincir v3.2.0'dan beri EVM şeridi, bir işlemi yalnızca kayıtlı bir PQC anahtarı
ve açık bir yetkilendirme penceresi olan hesaptan kabul eder. Bir anahtar
kaydedin, bir pencere açın, ardından gönderin. Bkz.
EVM yetkilendirme penceresi. SDK ile
classifyEvmWindowRejection(err) "no-pqc-key", "no-window",
"exhausted" veya "invalid" döndürür.
Hibrit işlemlerim CheckTx aşamasında tx ayrıştırma hatasıyla başarısız oluyor
SDK'yı yükseltin. 0.6.0 ve önceki sürümler
/qorechain.pqc.v1.PQCHybridSignature tx gövdesi uzantısını JSON olarak
serileştiriyordu ve zincirin tx kod çözücüsü bunu CheckTx aşamasında reddeder.
0.6.1 sürümünden itibaren uzantı beş dilin tümünde protobuf ile kodlanır
(değer 0x08 ile başlar) — eski sürümlerle oluşturulan hibrit işlemler, her
şeritte (eth-native dahil) zincir üzerinde reddedilir.
SDK hangi zincir sürümleriyle çalışır?
SDK 0.12.0, zincir v3.2.5 için istemci sürümüdür (mainnet'te 29 Ekim
2026'dan beri, 3.906.833 yüksekliğinde; testnet'te 26 Ekim'den beri). Mainnet v3.2.7
çalıştırır (12 Kasım'dan beri), testnet ise v3.2.8 (12 Kasım'dan beri; 6 Kasım'dan beri v3.2.7, 27 Ekim'den beri v3.2.6); imzalama biçimi
v3.2.7'ye kadar değişmedi, bu yüzden 0.12.0 mainnet'te çalışır. 0.12.0'ın v3.2.7 eklemeleri (PQC çoklu imza kaydı, textual imza modu, APR, küme kimliği ve doğrulama anahtarı mesajları) için oluşturucuları yoktur (bunlar mainnet'te 12 Kasım 2026'dan beri vardır) ve imzalama yolu v3.2.7'ye karşı yeniden kontrol edilmedi; bunlar için CLI'yı kullanın. Hibrit işlemler için kesin gas kuralını,
ML-KEM anahtar kayıt defteri oluşturucularını ve okumasını, soyut hesap okumalarını ve
denetlenmiş yönetişim parametresi oluşturucularını ekler (0.12.0'ın ekledikleri bölümüne bakın);
bunlar, 0.10.0'ın v3.2.4 için eklediklerinin (staking katmanı oluşturucuları ve okumaları,
fetchAuthNonce ve protokol özelliği okumaları, bkz.
0.10.0'ın eklediği) ve 0.9.0'ın v3.2.2 ile v3.2.3 için eklediklerinin üzerine gelir: kayıt sırasında isteğe bağlı sahiplik
kanıtı (proof of possession; ağ v3.2.3'ü uyguladıktan sonra ensurePqcRegistered
tarafından otomatik eklenir) için oluşturucular, kapsamlı EVM pencereleri ve EIP-7702 onay mesajları.
SDK 0.8.1 veya daha yenisi de her iki ağda işlem
yapar (v2 hibrit sign-bytes biçimi, kayıt, hibrit gönderimler ve EVM penceresi
değişmeden çalışır), ancak bu oluşturucuların hiçbirine sahip değildir: bunlar için
CLI'yı kullanın (bkz. 0.9.0 öncesi sürümler). İmzalama biçimi
v3.2.4, v3.2.5 veya v3.2.6'da değişmedi. Mainnet v3.2.7, testnet v3.2.8 çalıştırır (testnet v3.2.5'i 26 Ekim 2026'da, v3.2.6'yı
27 Ekim'de, v3.2.7'yi 6 Kasım'da ve v3.2.8'i 12 Kasım'da uyguladı; mainnet v3.2.5'i 29 Ekim'de, v3.2.6'yı 4 Kasım'da ve v3.2.7'yi 12 Kasım'da uyguladı); SDK 0.10.0 ve 0.9.0 bunlarda çalışmaya devam eder ancak
v3.2.5 eklerinin (ML-KEM anahtar kayıt defteri, kesin gas kuralı) oluşturucularına sahip değildir; bu sürümlerle CLI'yı kullanın veya 0.14.0'a yükseltin. 0.12.0, v3.2.5'e karşı oluşturuldu ve denetlendi.
PQC anahtar kaydım reddedildi ama ücret alındı
Zaten bir anahtara sahip olan bir hesap için yapılan kayıt, ücret düşüldükten sonra
zincir tarafından reddedilir. 0.9.0 ve sonrasındaki ensurePqcRegistered önce
GET /qorechain/pqc/v1/account/{address} adresini okur (rest geçirin), bu anahtar
çiftinin anahtarı kayıtlıysa kaydı atlar ve farklı bir anahtar kayıtlıysa
PqcKeyMismatchError fırlatır. Önceki sürümler, siz kendiniz
status: { registered: found } geçirmedikçe önce bakmazdı; burada found o rotadan
gelir. v3.2.3'ten beri zincir ayrıca zayıf, dejenere ve yeniden kullanılmış
anahtarları da reddeder; derivePqcCanonical veya tx pqc gen-key ile elde edilen
anahtarlar sorunsuzdur.
create-qorechain-dapp imzalayamayan bir SDK kuruyor
Yalnızca iskele aracının 0.8.0 sürümü böyleydi: @qorechain/sdk ve
@qorechain/evm için ^0.3.0 aralıkları yazıyordu ve 0.x bir sürümde şapka işaretli
aralık 0.3 içinde kalır. 0.9.0 ve sonraki sürümler güncel SDK üzerinde iskeleler; 0.8.0'ı
kullandıysanız iskelelemeden sonra npm i @qorechain/sdk@latest (ve
@qorechain/evm@latest) komutunu çalıştırın.
VERSION 0.8.0 diyor ama ben 0.8.3'ü kurdum
0.8.3'ün dışa aktarılan VERSION sabiti güncellenmemişti ve 0.8.0 bildiriyor;
0.9.0'dan itibaren paketle eşleşir. Daha önceki sürümlerde kurulu sürümü
package.json dosyasından okuyun.
Authenticator harcamam authenticator_replay ile reddediliyor
(abstractaccount modülü mainnet'te kapalıdır; orada bir harcama, herhangi
bir nonce kontrol edilmeden önce abstract account module is disabled ile
reddedilir. Testnet'te etkindir. Bkz. Authenticator'lar ve yetkilendirilmiş harcama.
Aşağıdaki yönergeler modülün etkin olduğu her yerde geçerlidir.)
Nonce yanlış. Hem MsgExecuteEVM.nonce hem de MsgExecuteCosmos.nonce, (account, pubkey)
için bağlı anahtarın authenticator sıra numarasıdır: zincirin bağlı anahtar başına
tuttuğu, 0'dan başlayan ve her başarılı yürütmede artan bir sayaç. Bu, hesabın EVM
nonce'u değildir. Onu fetchAuthNonce ile okuyun (SDK 0.10.0 veya sonrası, zincir v3.2.4 veya
sonrası) ya da eski sürümlerde bağlı anahtar başına kendiniz takip edin. v3.2.3'ten beri EVM şeridi ayrıca çağrının gas sınırını
bağlayan evmAuthSignBytesV2'yi imzalar (resolveEvmAuthDigestVersion biçimi
seçer). O anahtar için okuduğunuz (veya takip ettiğiniz) sayacı kullanın ve yeniden imzalayın.
Diğer authenticator hataları decodeTxError ile çözümlenir: abstractaccount
kodları 5 (spending_limit_exceeded), 6 (session_key_expired) ve
10 (permission_denied). Bkz.
Authenticator'lar ve yetkilendirilmiş harcama.