QoreChain SDK
QoreChain SDK, hibrit ML-DSA-87 (FIPS 204) imzalarına sahip, üçlü sanal makineli (triple-VM) bir Katman 1 ağı olan QoreChain üzerinde merkeziyetsiz uygulamalar geliştirmek için sunulan resmi çok dilli geliştirici kitidir.
Bu dokümantasyon; SDK'nın nasıl kurulacağını, ağa nasıl bağlanılacağını, zincir üzerindeki durumun nasıl okunacağını, hesapların nasıl türetileceğini, işlemlerin nasıl imzalanıp gönderileceğini ve QoreChain'in her bir sanal makinesiyle nasıl çalışılacağını kapsar.
QoreChain nedir?
QoreChain, tek bir zincir üzerinde üç birinci sınıf akıllı sözleşme çalışma ortamına sahip bir Katman 1 blokzinciridir:
- QoreChain Native — Cosmos SDK aracılığıyla Wasm akıllı sözleşmeleri (CosmWasm çalışma zamanı).
- QoreChain EVM Engine — Ethereum uyumlu yürütme (Solidity, viem, standart JSON-RPC).
- SVM — Solana tarzı JSON-RPC'ye sahip, Solana uyumlu bir çalışma ortamı.
Hesaplar, bakiyeler ve token'lar çalışma ortamları arasında paylaşılır ve
zincir, zincirler arası birlikte çalışabilirlik için IBC modülünü içerir
(mainnet üzerinde açık bir IBC kanalı yoktur; testnet'te test zincirine giden açık bir transfer kanalı vardır, 27 Ekim 2026'da kontrol edildi).
Çalışır: her şeritte okumalar, hibrit imzalı Native işlemler, birleşik
hesaplar, bir yetkilendirme penceresi içindeki EVM
işlemleri ve SVM okumaları.
Henüz kullanılamaz: mainnet'te EVM ön derlemeleri (hiçbiri etkin değil; testnet'te
üçü etkindir: PQC verify, PQC key status ve consensus parametreleri; AI çifti ve
cross-VM köprüsü her iki ağda da etkin değildir), qor_ JSON-RPC ad
alanı, SVM işlemleri, mainnet'te VM'ler arası çağrılar (MsgCrossVMCall
devre kesici tarafından kapatılmıştır), sıradan hesaplar için QoreChain Native yükleme ve
örnekleme (testnet'te instantiate açıktır, yükleme değildir), mainnet'te authenticator /
soyut hesap akışları (modül orada kapalı, testnet'te açık), xQORE ve gaz
soyutlaması. Her kılavuz, geçerli olduğu yerde bu uyarıyı yineler. 27 Ekim 2026'da canlı uç noktalara karşı kontrol edildi; 7 Kasım 2026'da mainnet'in etkin ön derleme listesi hâlâ boştu, testnet'in listesi ise ayrıca VM'ler arası köprü 0x…0901 adresini de içeriyordu (bir izin listesiyle etkin; 7 Kasım 2026'da salt okunur bir eth_call test edildi).
Yayımlanan SDK (0.14.0, 12 Kasım 2026), her iki ağın doğruladığı biçimde imzalar (v2 hibrit sign-bytes, zincir durumundan çözümlenir); imzalama biçimi, adresler, ondalık basamaklar, memo'lar ve ücretler v3.2.3, v3.2.4, v3.2.5 veya v3.2.6'da değişmedi (mainnet 12 Kasım 2026'dan beri v3.2.7 çalıştırır, yükseklik 4.164.600, yönetişim önerisi 16, 4 Kasım'daki v3.2.6'dan sonra; testnet 27 Ekim'den beri; testnet 6 Kasım'dan beri v3.2.7, 12 Kasım'dan beri v3.2.8 çalıştırır ve bu sürümler, SDK 0.14.0'ın oluşturucularına sahip olduğu mesajlar ekler; test ağının yeni kuralları v3.2.8'den itibaren geçerlidir ve ana ağ onu henüz uygulamadı; v3.2.7 mesajları mainnet'te 12 Kasım 2026'dan beri vardır). Sonraki kuantum sonrası kuralların istemci tarafını (anahtar kaydında sahiplik kanıtı, kapsamlı EVM pencereleri, EIP-7702 onay mesajları) ve v3.2.4'ün istemci tarafını (staking katmanları, authenticator nonce'u, protokol özelliği anahtarları) ve v3.2.5'in (hibrit işlemler için kesin gas, ML-KEM anahtar kayıt defteri) istemci tarafını taşır; 0.9.0 öncesi sürümler ilk grubu taşımaz, bkz. 0.9.0 öncesi sürümler, 0.12.0 neler ekliyor, 0.13.0 neyi değiştiriyor ve 0.14.0 neyi değiştiriyor.
Cüzdan ve arka uç imzalama: bkz. QoreSign.
Hibrit ML-DSA-87 imzalama
QoreChain, ML-DSA-87 (Dilithium-5, FIPS 204) tabanlı post-kuantum kriptografi (PQC) ilkelerini sunar. Klasik secp256k1 imzalamanın yanı sıra zincir, bir işlemin hem klasik bir imza hem de post-kuantum bir imza taşıdığı hibrit bir imzalama duruşunu destekler; böylece işlem bugün klasik doğrulama altında geçerli kalırken post-kuantum koruması da kazanır.
SDK bugün ML-DSA-87 anahtar üretimini, imzalamayı ve doğrulamayı, ayrıca hibrit işlemler için yapı taşlarını sunar. Canlı ağlarda bir Native yol işlemi hibrit imzalı olmak zorundadır ve hesabın ML-DSA-87 anahtarı önce kaydedilmiş olmalıdır. Ayrıntılar için Hesaplar ve PQC imzalama sayfasına bakın. Burada pazarlama iddiası yoktur — SDK, tam olarak zincirin uyguladığı ilkeleri sunar.
Bu SDK'yı farklı kılan nedir
Tam çoklu zincir eşitliğinin ötesinde, üç yetenek yalnızca QoreChain üzerinde mümkündür; çünkü bunlar başka hiçbir Katman 1'de bulunmayan protokol özellikleri üzerine inşa edilmiştir:
- AI ile ön kontrol risk puanlaması — bir işlemi yayınlamadan önce
zincir üzerindeki AI ile tarayın.
simulateWithRiskScore, deterministik EVM precompile'larından gelen gaz artı bir risk/anomali kararı döndürür; böylece bir cüzdan veya dApp, imzalamadan önce uyarabilir (veya engelleyebilir). AI precompile'ları mainnet veya testnet üzerinde henüz etkin değildir. Bkz. AI ön kontrolü. - Birleşik VM'ler arası çağrılar — tek hesap, üç VM, tek işlem.
createCrossVMClientherhangi bir VM üzerindeki bir sözleşmeyi çağırır vecallAtomic, birden fazla VM'ler arası çağrıyı tek seferde imzalanan tek bir atomik işlemde paketler. Bkz. VM'ler arası çağrılar. - Hibrit imzalama geliştirici deneyimi (DX) — bir imzalayıcının ML-DSA-87
anahtarını tek bir idempotent çağrıyla (
ensurePqcRegistered/migrateToHybrid) kaydedin; hazır bir React rozetiyle birlikte. Bkz. Hibrit imzalama.
0.6.0 ve 0.7.0 ile zincir düzeyinde iki yetenek daha geldi (ikincisi, aşağıda belirtildiği gibi canlı ağlarda henüz kullanılamaz):
- Birleşik eth-native hesaplar — tek bir
eth_secp256k1anahtarı;qor1…,0x…ve bir SVM base58 adresi olarak gösterilen, hepsi tek bir bakiyeyi paylaşan 20 baytlık tek bir kimliktir. Bkz. Birleşik hesaplar. - Authenticator şeritleri — bir Phantom veya MetaMask anahtarını
PQC gerektiren kanonik hesaba bağlayın ve en az yetki ilkesine dayalı,
harcama limitli, iptal edilebilir koşullar altında bir relayer üzerinden
harcama yapmasına izin verin. Arkasındaki
abstractaccountmodülü mainnet'te kapalı, testnet'te açıktır. Bkz. Authenticator'lar ve yetkilendirilmiş harcama.
Yeni @qorechain/react kiti (provider, hook'lar, ConnectButton,
PqcStatusBadge), hibrit ML-DSA-87 imzalamalı bir dApp geliştirmeyi varsayılan
yol haline getirir — bkz. React kiti rehberi. Konunun
tamamı için Neden QoreChain SDK sayfasını okuyun.
SDK ailesi
SDK, tercih ettiğiniz dilde geliştirme yapabilmeniz için bir paket ailesi olarak sunulur. Bu paketler aynı ağ ön ayarlarını, türetme şemalarını, birim (denominasyon) matematiğini ve okuma yüzeylerini paylaşır.
| Paket | Dil | Kurulum | Durum |
|---|---|---|---|
@qorechain/sdk | TypeScript | npm i @qorechain/sdk | Yayında (npm, v0.14.0) |
qorechain-sdk | Python | pip install qorechain-sdk (import qorsdk) | Yayında (PyPI, v0.14.0) |
qorechain-sdk (Go modülü) | Go | go get github.com/qorechain/qorechain-sdk/packages/go/... | Yayında (Go proxy, etiket packages/go/v0.14.0) |
qorechain-sdk | Rust | cargo add qorechain-sdk (import qorechain) | Yayında (crates.io, v0.14.0) |
io.github.qorechain:qorechain-sdk | Java | io.github.qorechain:qorechain-sdk:0.14.0 | Yayımlandı (Maven Central, v0.14.0; JDK 17+) |
@qorechain/evm | TypeScript (EVM adaptörü) | npm i @qorechain/evm viem | Yayında (npm, v0.14.0) |
@qorechain/svm | TypeScript (SVM adaptörü) | npm i @qorechain/svm @solana/web3.js | Yayında (npm, v0.14.0) |
@qorechain/react | TypeScript (React kiti) | npm i @qorechain/react | Yayında (npm, v0.14.0) |
create-qorechain-dapp | CLI | npm create qorechain-dapp | Yayında (npm, v0.14.0) |
Python dağıtımı
qorechain-sdkolarak kurulur ancakqorsdkolarak import edilir. Tüm istemciler kendi kayıt defterlerinde yayınlanmıştır — dillere göre komutlar için Kurulum sayfasına bakın.
TypeScript çekirdeği (@qorechain/sdk), bu dokümantasyondaki örneklerin
temelidir. Python, Go, Rust ve Java istemcileri TypeScript ile tam yerel
zincir eşitliğine ulaşır: ağ ön ayarları, denom/adres yardımcı araçları,
HD hesap türetme (native/EVM/SVM), PQC (ML-DSA-87) imzalama, her özel modül
ve standart Cosmos modülleri için tipli mesaj oluşturucular, tipli sorgu
istemcileri, eksiksiz işlem yaşam döngüsü (otomatik gaz, hata çözümleme,
işlem takibi, blok/işlem arama), hibrit post-kuantum işlemler ve WebSocket
abonelikleri. Bu istemcilerin tümü yayınlanmıştır: TypeScript npm'de
(@qorechain/sdk 0.14.0), Python PyPI'da (qorechain-sdk 0.14.0, import
qorsdk), Go modül proxy'sinde (etiket packages/go/v0.14.0), Rust
crates.io'da (qorechain-sdk 0.14.0) ve Java Maven
Central'da (io.github.qorechain:qorechain-sdk 0.14.0). EVM/SVM yürütme
adaptörleri (@qorechain/evm, @qorechain/svm, ikisi de 0.14.0),
@qorechain/react kiti (0.14.0) ve create-qorechain-dapp iskele oluşturma
CLI'si (0.14.0, 0.13.1 şablon düzeltmelerini de taşır) yalnızca TypeScript içindir ve aynı şekilde npm'de
yayınlanmıştır. Yardımcı paketler için
Kurulum sayfasına bakın.
0.6'dan 0.14'e yenilikler
0.6.0 — birleşik eth-native hesaplar (zincir v3.1.83). Tek bir
eth_secp256k1 anahtarı, üç adres kodlamasının tümü olarak gösterilen ve
her şeritte tek bir harcanabilir bakiyeyi paylaşan 20 baytlık tek bir
kimliktir:
import { deriveUnifiedAccount } from "@qorechain/sdk";
const account = await deriveUnifiedAccount(mnemonic);
account.cosmos; // "qor1…" (bech32, Native lane)
account.evm; // "0x…" (EIP-55, EVM lane)
account.svm; // base58 (20 bytes + 12 zero bytes)
Aynı anahtarla yerel şerit (Native lane) imzalaması signClassicalEth /
signHybridEth ile yapılır ve bir Phantom veya MetaMask anahtarı hesaba authenticator olarak bağlanır
(Phantom imzasından türetme 0.8.0'da kaldırıldı).
Eski coin-type-118 deriveNativeAccount değişmemiştir. Bkz.
Birleşik hesaplar.
0.6.1 — mutabakat açısından kritik düzeltme. PQCHybridSignature
işlem gövdesi uzantısı artık protobuf ile kodlanıyor (daha önce JSON ile
kodlanıyordu ve CheckTx aşamasında reddediliyordu). SDK ≤ 0.6.0 ile
oluşturulan hibrit işlemler zincir üzerinde reddedilir — yükseltme
yapın.
0.7.0 — authenticator şeritleri (zincir v3.1.85). Arkasındaki
abstractaccount modülü şu anda mainnet'te kapalı, testnet'te açıktır (bkz.
Authenticator kılavuzu). Bağlanmış bir Phantom
(ed25519) veya MetaMask (secp256k1, 20 baytlık adresle) anahtarı, en az
yetki ilkesine dayalı, harcama limitli, iptal edilebilir koşullar altında
bir relayer üzerinden PQC gerektiren kanonik hesaptan harcama yapabilir:
MsgExecuteEVM / MsgExecuteCosmos / MsgRotatePQCKey oluşturucular,
bayt düzeyinde birebir evmAuthSignBytes / cosmosAuthSignBytes /
rotationSignBytes yardımcıları, permissionSchema sorgusu, çözümlenmiş
hata kodları ve TypeScript cüzdan oluşturucuları
(buildPhantomExecuteCosmos, buildMetaMaskExecuteEvm, …).
Kopyala-yapıştır örneklerle eksiksiz anlatım:
Authenticator'lar ve yetkilendirilmiş harcama.
0.8.0 – 0.8.3 — v2 hibrit sign-bytes ve EVM yetkilendirme penceresi (zincir
v3.2.0). Hibrit bir işlemin kuantum sonrası yarısı artık hedef ağın doğruladığı
biçimde imzalanır (v1 veya v2, signBytesVersion: "auto" | "v1" | "v2").
Her iki herkese açık ağ da v2 üzerindedir; bu yüzden mainnet'te işlem yapmak için
SDK 0.8.1 veya daha yenisi gereklidir (güncel sürümü kullanın). 0.8.2, EVM şeridinin
yetkilendirme penceresi için openEvmWindowMsg,
closeEvmWindowMsg, fetchEvmWindow ve classifyEvmWindowRejection ekler.
0.8.0, cüzdan imzasına dayalı hesap yardımcılarını (connectPhantomUnified ve
unifiedAccountFromPhantomSignature, 0.8.0'da kaldırıldı) kaldırdı, her dilde
katı ML-DSA-87 boyut denetimleri uygular ve VM'ler arası çağrılara async
bayrağını ve döndürülen callee verisini ekler. 0.8.3, işlem aramasını, React
hook yarış durumlarını, Python migrate_to_hybrid sıralamasını ve adres biçiminden
bağımsız kanonik PQC türetmesini (derivePqcCanonical, canonicalAccount) düzeltir.
Bkz. Yükseltme notları.
0.9.0 — zincir v3.2.2 ve v3.2.3 için istemci desteği. TypeScript TxClient,
hesabın anahtar çiftini verdiğinizde hibrit imzalar
(client.connectTx(signer, { pqcKeypair })); böylece bankSend ile SDK'nın
rollup, multilayer ve cross-VM istemcileri herkese açık ağlarda çalışır.
ensurePqcRegistered, kayıtlı anahtarı önce REST üzerinden kontrol eder, ikinci,
farklı bir anahtarı kaydetmeyi reddeder ve ağ v3.2.3'ü uyguladıktan sonra
sahiplik kanıtını kendiliğinden ekler. Yeni oluşturucular kapsamlı EVM
pencerelerini (nativeOnly, allowedTargets) ve EIP-7702 onay mesajlarını
kapsar; derivePqcCanonical(address, mnemonic) ise her dilde mnemonic'ten
kurtarabileceğiniz bir anahtar verir. PQC hesap rotası tekil
/qorechain/pqc/v1/account/{address} biçimindedir, bir blok içindeki başarısızlıklar
codespace'lerini korur ve create-qorechain-dapp güncel SDK üzerinde iskelet
oluşturur. Bkz. 0.9.0'ın eklediği.
0.10.0 — zincir v3.2.4 için istemci desteği. Staking katmanı oluşturucuları ve okumaları
(lockDelegation, unlockEarly, claimBonus, fetchStakingTierParams,
fetchStakingLocks), bağlı bir anahtarın sonraki sırası için fetchAuthNonce, bir
ağın adıyla uyguladığı konsensüs kuralları için
fetchProtocolFeatures / isProtocolFeatureEnabled, PQC durumunda possessionProven ve
ibcTimeoutTimestamp. ensurePqcRegistered artık kayıtlı anahtarı karşılaştırır;
anahtarı olmayan bir duruma güvenmez ve ücret simülasyonu sırasında metin olarak gelen bir zincir
reddi her dilde adlandırılır. Bkz.
0.10.0'ın eklediği.
0.12.0, zincir v3.2.5 için istemci desteği. mainnet ve testnet hazır ayarları
artık varsayılan olarak herkese açık uç noktaları kullanır (zincir kimliği
qorechain-devnet olan bir localnet hazır ayarı eski localhost portlarını korur). Bir hibrit işlemin
"auto" ücreti, v3.2.5'i uygulamış ağlarda kesin gas kuralını kullanır
(ceil(simulated x 1.02) + 2000; bir hibrit bank gönderimi için yaklaşık 289.000 yerine yaklaşık 171.600 gas).
ML-KEM-1024 anahtar kayıt defterinin oluşturucuları (msg.pqc.registerKemKey,
msg.pqc.removeKemKey) ve mainnet'te yanıt veren bir okuması (fetchKemKey) vardır. Abstract account
harcama kuralları ve bağlı anahtarlar için okumalar ile cross-VM ve rollup parametre önerileri için
denetlenmiş oluşturucular bulunur. Zincir geliştirici kiti
(EVM ve QoreChain Native şablonları, her iki ağ için viem zincirleri) bunun bir parçasıdır.
npm dışında 0.11.0 yoktu; diğer diller 0.10.0'dan 0.12.0'a geçti. Bkz.
0.12.0 neler ekliyor.
0.13.0, seed yolu hesap yardımcısında tek bir değişiklik. unifiedAccountFromSeed ve diğer dillerdeki karşılıkları artık bir QRC1 kurtarma kodu veya bağımsız 32 baytlık bir PQC sırrı gerektirir; mnemonic'ten türetilen hesaplar, imzalama biçimi ve zincir davranışı değişmemiştir. Kurtarma kodu yardımcıları her dile eklendi ve migrateToHybrid keyVerified bildirir. Bkz.
0.13.0 neyi değiştiriyor.
0.14.0, zincir v3.2.8 için istemci desteği. Bir anahtarı bağlamak sahiplik kanıtı gerektirir, değer taşıyan anahtarlar bir harcama kuralı gerektirir (bir yardımcı çifti oluşturur), yönetişim parametresi güncellemeleri her alanı gerektirir, başarısız yetkilendirilmiş yürütmeler okunabilir ve EVM penceresi üç liste daha alır. Yeni kurallar, bir ağ v3.2.8 çalıştırdığında geçerli olur: test ağı 12 Kasım 2026'dan beri; ana ağ henüz uygulamadı. Bkz. 0.14.0 neyi değiştiriyor.
Sonraki adımlar
- Neden QoreChain SDK — QoreChain'e özgü beş yetenek.
- Kurulum — dillere göre kurulum talimatları.
- Hızlı başlangıç — bağlanın, bir bakiye okuyun, bir transfer gönderin.
- Kavramlar: Mimari — üçlü VM modeli.
- Kavramlar: Hesaplar ve PQC imzalama — anahtarlar ve post-kuantum imzalama.
- Rehberler — VM'lere göre nasıl yapılır kılavuzları.
- Authenticator'lar ve yetkilendirilmiş harcama — bir relayer üzerinden harcama yapan bağlı Phantom/MetaMask anahtarları.
- Ağ ve uç noktalar referansı — zincir kimliği, portlar, token.
- Örnekler — çalıştırılabilir, kopyala-yapıştır kod parçacıkları.
- Ağ ve uç noktalar referansı ayrıca Ağlar sayfasında da yer alır.