Ana içeriğe geç

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).

Canlı ağlarda bugün çalışanlar (mainnet v3.2.7, testnet v3.2.8 çalıştırır)

Ç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. createCrossVMClient herhangi bir VM üzerindeki bir sözleşmeyi çağırır ve callAtomic, 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_secp256k1 anahtarı; 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 abstractaccount modü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.

PaketDilKurulumDurum
@qorechain/sdkTypeScriptnpm i @qorechain/sdkYayında (npm, v0.14.0)
qorechain-sdkPythonpip install qorechain-sdk (import qorsdk)Yayında (PyPI, v0.14.0)
qorechain-sdk (Go modülü)Gogo get github.com/qorechain/qorechain-sdk/packages/go/...Yayında (Go proxy, etiket packages/go/v0.14.0)
qorechain-sdkRustcargo add qorechain-sdk (import qorechain)Yayında (crates.io, v0.14.0)
io.github.qorechain:qorechain-sdkJavaio.github.qorechain:qorechain-sdk:0.14.0Yayımlandı (Maven Central, v0.14.0; JDK 17+)
@qorechain/evmTypeScript (EVM adaptörü)npm i @qorechain/evm viemYayında (npm, v0.14.0)
@qorechain/svmTypeScript (SVM adaptörü)npm i @qorechain/svm @solana/web3.jsYayında (npm, v0.14.0)
@qorechain/reactTypeScript (React kiti)npm i @qorechain/reactYayında (npm, v0.14.0)
create-qorechain-dappCLInpm create qorechain-dappYayında (npm, v0.14.0)

Python dağıtımı qorechain-sdk olarak kurulur ancak qorsdk olarak 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​