Ana içeriğe geç

Kurulum

Dilinize uygun SDK'yı kurun. TypeScript çekirdeği (@qorechain/sdk), EVM ve SVM adaptörleri (@qorechain/evm, @qorechain/svm), React kiti (@qorechain/react) ile Python, Go, Rust ve Java istemcilerinin tümü, yerel zincirle tam eşdeğerlik sağlayacak şekilde (tipli mesajlar, sorgular, işlem yaşam döngüsü, hibrit PQC işlemleri ve WebSocket abonelikleri) kendi kayıt depolarında yayımlanmıştır. Güncel sürüm 0.14.0'dır ve 12 Kasım 2026'da yayımlanmıştır (12 Kasım 2026'da kayıt depolarına karşı kontrol edildi):

Kayıt deposuPaketSürüm
npm@qorechain/sdk, @qorechain/react, @qorechain/evm, @qorechain/svm, create-qorechain-dapp0.14.0 (create-qorechain-dapp da; 0.13.1 şablon düzeltmelerini de taşır)
PyPIqorechain-sdk (import qorsdk)0.14.0
crates.ioqorechain-sdk (import qorechain)0.14.0
Go modül proxy'sigithub.com/qorechain/qorechain-sdk/packages/gov0.14.0
Maven Centralio.github.qorechain:qorechain-sdk0.14.0 (JDK 17 veya üzeri)

Python, Rust, Go veya Java için 0.11.0 yoktur: npm paketlerinin 29 Ekim 2026'da bir 0.11.0 sürümü vardı (zincir geliştirici kiti, aşağıya bakın) ve her dil 0.10.0'dan 0.12.0'a birlikte geçti. 0.13.0, 11 Kasım 2026'da ve 0.14.0, 12 Kasım 2026'da her dilde onu izledi.

Aşağıdan dilinizi seçin.

Yükseltme notları​

Canlı ağlarda SDK 0.8.1 veya sonrasını kullanın

Her iki genel ağ da v2 hibrit sign-bytes biçimini (alan etiketli ve zincir kimliğine bağlı) doğrular ve eski biçimi pqc kod 21 ile reddeder. 0.8.0'dan önceki her SDK sürümü eski biçimi imzalar; 0.8.0 ise geçişi, ağların kullandığı iki yükseltme adından yalnızca birinin altında arar (mainnet bunu v3.2.0 olarak, testnet ise v3.1.98 ve ardından v3.2.0 olarak kaydetti), dolayısıyla mainnet üzerinde yanlış biçimi imzalar. Her dilde 0.14.0 (veya en azından 0.8.1) kullanın; bir EVM yetkilendirme penceresi açmak için 0.8.2 veya sonrası gerekir. Hibrit oluşturucular bir signBytesVersion seçeneği alır ("auto" | "v1" | "v2"); "auto" ağa sorar ve bu nedenle qorechain-vladi / qorechain-diana üzerinde REST uç noktasına (rest) ihtiyaç duyar: tahmin etmek yerine hata fırlatır. Bkz. Hangi sign-bytes biçimi?. Biçim, zincir v3.2.3 veya v3.2.4 ile değişmedi (v3.2.4 test ağında 19 Ekim 2026'dan beri, mainnet'te 23 Ekim 2026'dan beri çalışır; v3.2.5 ve v3.2.6 burada hiçbir şeyi değiştirmedi; mainnet 12 Kasım 2026'dan beri v3.2.7 çalıştırır): "auto" her iki ağda da v2'ye çözümlenir, çünkü ikisi de v2'ye geçiren yükseltmeyi uyguladı.

0.14.0 neyi değiştiriyor​

SDK 0.14.0 (12 Kasım 2026), tüm diller için tek bir sürümdür: TypeScript, Python, Go, Rust ve Java; @qorechain/react, @qorechain/evm, @qorechain/svm ve create-qorechain-dapp ile birlikte (0.13.1 şablon düzeltmelerini de taşır). Zincir v3.2.8 için istemci desteği ekler. Yeni kurallar, bir ağ v3.2.8 çalıştırdığında geçerli olur: test ağı qorechain-diana 12 Kasım 2026'dan beri onu çalıştırır; ana ağ henüz uygulamadı. Önceki ağlarda yeni alanlar isteğe bağlı kalır.

Alan0.14.0'da
Bir anahtarı bağlamaSahiplik kanıtı gerekir. ed25519, secp256k1 ve EIP-191 (personal_sign) için oluşturucular ve imzalayıcılar, zinciri, hesabı, şemayı ve anahtarı adlandıran düz metin bir bağlantı mesajını imzalar. Kayıt oluşturucuları boş bir kanıtı reddeder
Değer taşıyan anahtarlarsend, evm, deploy, svm veya all iznine sahip bir anahtar için hesabın ilk etkin harcama kuralının her denom'u sınırlaması gerekir. Bir yardımcı, harcama kuralı güncellemesini ve bağlantıyı sahibin imzaladığı tek bir işlemde bir çift olarak oluşturur ve kuralı denetler
Yönetişim parametrelericrossvm, svm ve rdk MsgUpdateParams oluşturucuları her alanı gerektirir (zincir parametreleri bütünüyle değiştirir). Yeni yardımcılar, güncellemeyi ağdan okunan geçerli parametrelerden oluşturur. svm oluşturucusu, sert saklama tavanı 0 iken enabled değerini reddeder
VM'ler arası bekleyen çağrı sorgusuSayfalı sorgu artık her sayfayı döndürür
Yürütme sonuçlarıMsgExecuteEVM ve MsgExecuteCosmos, kod 0 bir işlemin içinde success=false ile başarısız olabilir (nonce tüketilir). Yeni yardımcılar yanıtları ve başarısızlık nedenini çözer ve başarısız bir yürütmede hata fırlatır
VM'ler arası eşzamansız çağrılarasync_gas_limit ve async_max_factor alanlarını alır
EVM pencere kapsamıYeni alanlar: validators, staking_validators ve ibc_receivers
Gas30.000.000'un üzerindeki EVM işlemleri (evm_limits içinden okunur) ve 50.000.000'un üzerindeki Cosmos işlemleri imzalamadan önce reddedilir. CosmWasm ve VM'ler arası işlemler simüle edilen gazın en az 1,3 katını alır ve asla sabit bir yedek değer almaz
Asgari gas fiyatıİsteğe bağlı yardımcılar ağın asgari gas fiyatını okur; varsayılan gas fiyatı değişmemiştir
ProtolarBeş dilin hepsinde üretilen kod v3.2.8'i izler

Aynı değişikliğin cüzdan tarafı @qorechain/wallet-adapter 0.6.0 sayfasındadır.

0.13.0 neyi değiştiriyor​

SDK 0.13.0 (11 Kasım 2026), tüm diller için tek bir sürümdür: TypeScript, Python, Go, Rust ve Java; @qorechain/react, @qorechain/evm, @qorechain/svm ve create-qorechain-dapp ile birlikte. Seed yolu hesap yardımcısında tek bir uyumsuz değişiklik vardır. Mnemonic'ten türetilen hesaplar değişmemiştir; hibrit imzalama biçimi ve zincir davranışı da öyle: 0.12.0 ile oluşturulmuş bir işlem geçerli kalır.

Uyumsuz değişiklik. Seed yolu yardımcıları unifiedAccountFromSeed (TypeScript), unified_account_from_seed (Python, Rust), unified.UnifiedAccountFromSeed (Go) ve UnifiedAccounts.unifiedAccountFromSeed (Java) artık iki girdiden tam olarak birini gerektirir: bir QRC1 kurtarma kodu veya bağımsız 32 baytlık bir PQC sırrı. ML-DSA-87 anahtarı bu ikinci sırdan türetilir. Yardımcıyı seçenek vermeden ya da birden fazla seçenekle çağırmak hata verir.

legacySeedDerivation seçeneği (Python legacy_seed_derivation=True, Go LegacySeedDerivation, Rust SeedPqcOptions::legacy_seed_derivation(), Java SeedPqcOptions.legacy()) isteğe bağlıdır. Onu yalnızca 0.13.0 öncesinde oluşturulmuş bir hesabın PQC anahtarını kurtarmak için kullanın; böylece anahtarı MsgRotatePQCKey ile rotasyona sokabilirsiniz; yeni hesaplar için değildir.

Alan0.13.0'da
Seed yolu yardımcılarıBir QRC1 kurtarma kodu veya bağımsız 32 baytlık bir PQC sırrı gerekir (tam olarak biri); seçenek yoksa ya da birden fazlası varsa hata verir. Mnemonic hesapları değişmemiştir
legacySeedDerivationİsteğe bağlıdır, yalnızca 0.13.0 öncesinde oluşturulmuş bir hesabın PQC anahtarını MsgRotatePQCKey ile rotasyona sokmak üzere kurtarmak içindir
QRC1 kurtarma kodlarıHer dile eklendi: generatePqcRecoveryCode, isValidRecoveryCode, normalizeRecoveryCode, pqcKeyFromRecoveryCode, pqcRecoveryCodeFromSecret (Python ve Rust'ta snake_case; Go'da GeneratePQCRecoveryCode, IsValidRecoveryCode, PQCKeyFromRecoveryCode, PQCRecoveryCodeFromSecret)
migrateToHybridkeyVerified bildirir
Şablonlarpnpm window recovery-code yeni bir kod yazdırır. PRIVATE_KEY ile pnpm window, QORE_PQC_RECOVERY_CODE değerini okur ve eksikse bir mesajla durur; QORE_MNEMONIC ile hiçbir şey değişmez. Foundry ve Hardhat şablonları ^0.13.0 sürümüne bağımlıdır
Sign-bytes sürümü "auto"Önce /qorechain/pqc/v1/protocol_features üzerinden pqc-sign-bytes-v2 protokol özelliğini okur ve yalnızca bu okuma başarısız olursa uygulanmış yükseltme planlarına döner
getPqcStatus / get_pqc_statusDüğümün yanıtında kayıt bayrağı yoksa "kayıtlı değil" bildirmek yerine hata verir
Pythonİşlem sonucu kodlarını ve EVM penceresi found ile live alanlarını katı biçimde ayrıştırır; wait_for_tx, tx_response veya txhash içermeyen bir yanıtı hâlâ bekleyen sayar

Her dilde seed yolu seçenekleri. Üçünden tam olarak birini verin:

DilÇağrıKurtarma koduBağımsız 32 baytlık sırEski anahtar, yalnızca kurtarma için
TypeScriptunifiedAccountFromSeed(seed32, opts){ recoveryCode } (bir "QRC1-..." dizesi){ pqcSecret } (seed32'den bağımsız, 32 baytlık bir Uint8Array){ legacySeedDerivation: true }
Pythonunified_account_from_seed(seed32, ...)recovery_code=...pqc_secret=...legacy_seed_derivation=True
Gounified.UnifiedAccountFromSeed(seed32, opts)unified.SeedPQCOptions{RecoveryCode: ...}unified.SeedPQCOptions{PQCSecret: ...}unified.SeedPQCOptions{LegacySeedDerivation: true}
Rustunified_account_from_seed(seed32, opts)SeedPqcOptions::recovery_code(code)SeedPqcOptions::pqc_secret(secret32)SeedPqcOptions::legacy_seed_derivation()
JavaUnifiedAccounts.unifiedAccountFromSeed(seed32, opts)SeedPqcOptions.withRecoveryCode(code)SeedPqcOptions.withPqcSecret(secret32)SeedPqcOptions.legacy()

Python seçenekleri yalnızca anahtar sözcükle verilir. Bir pqcSecret, ondan pqcRecoveryCodeFromSecret(secret32) ile üretilen kurtarma koduyla aynı anahtarı verir. TypeScript'te ayrıca pqcKeyFromRecoveryCode(code, qor1) vardır.

Geçiş (TypeScript). Bir kurtarma kodunu bir kez oluşturun ve tohumdan ayrı saklayın:

import { generatePqcRecoveryCode, unifiedAccountFromSeed } from "@qorechain/sdk";

const recoveryCode = generatePqcRecoveryCode(); // once; store it apart from the seed
const account = unifiedAccountFromSeed(seed32, { recoveryCode });

PQC anahtarını 0.12 veya öncesiyle kaydetmiş bir hesap, eski anahtarı { legacySeedDerivation: true } ile yükler ve rotatePqcKeyMsg ile rotasyona sokar:

const old = unifiedAccountFromSeed(seed32, { legacySeedDerivation: true });
// rotate it with rotatePqcKeyMsg, then use { recoveryCode } from then on

Kurtarma kodunu saklayın: farklı bir kod farklı bir anahtar verir.

0.12.0 neler ekliyor​

SDK 0.12.0, mainnet'in 29 Ekim 2026'da 3.906.833 yüksekliğinde uyguladığı (testnet bunu 26 Ekim'de uyguladı) zincir v3.2.5 için istemci sürümüdür. Mainnet 4 Kasım'dan beri v3.2.6 ve 12 Kasım'dan beri v3.2.7 çalıştırır; testnet 27 Ekim'den v3.2.6, 6 ile 12 Kasım arasında v3.2.7, 12 Kasım'dan beri v3.2.8 çalıştırır; hibrit imzalama biçimi, adresler, ondalık basamaklar ve memo'lar değişmedi, dolayısıyla 0.10.0 ile oluşturulmuş bir işlem geçerli kalır. TypeScript, Python, Go, Rust ve Java tümü @qorechain/react, @qorechain/evm, @qorechain/svm ve create-qorechain-dapp ile birlikte 0.12.0'a geçer. Sürüm, her dilde testnet üzerinde bir hibrit bank gönderimiyle ve orada kaydedilen, geri okunan ve kaldırılan bir KEM anahtarıyla, ayrıca mainnet üzerinde okumalarla kontrol edildi.

Alan0.12.0'da
Varsayılan olarak herkese açık uç noktalarmainnet ve testnet hazır ayarları artık localhost yerine herkese açık uç noktaları gösterir (her ikisinde REST, konsensüs RPC ve EVM JSON-RPC, ayrıca testnet'te EVM WebSocket). Bu yüzden çıplak bir createClient() herkese açık testnet ile konuşur. Bkz. Ağ ve uç noktalar
localnet hazır ayarı0.12.0 öncesinde her hazır ayarın kullandığı localhost portları, zincir kimliği qorechain-devnet. Eski davranışı korumak için createClient({ network: "localnet" }) ile seçin
Hibrit işlemler için kesin gasv3.2.5'i uygulamış bir ağda, bir hibrit native işlemin "auto" ücreti ceil(simulated x 1.02) + 2000 değeridir, çünkü simülasyon artık post-kuantum doğrulamasının kendisini ücretlendirir. Bir hibrit bank gönderimi yaklaşık 289.000 yerine yaklaşık 171.600 gas ister ve ücret de onunla birlikte düşer. Daha eski ağlar, klasik işlemler ve başarısız bir plan sorgusu önceki kuralı korur; geçirdiğiniz bir çarpan her iki kuralın yerine geçer. exactHybridGas (ve her dildeki karşılıkları) ve TypeScript'te estimateGasDetails (simülasyonu, gas limitini ve hangi kuralın belirlediğini bildirir). Java otomatik gas yolunu kazandı
ML-KEM-1024 anahtar kayıt defteriBir hesap, herkesin ona şifreleyebilmesi için bir ML-KEM-1024 kapsülleme anahtarı (algoritma 2, 1.568 bayt) yayımlar: msg.pqc.registerKemKey ve msg.pqc.removeKemKey (anahtar önce denetlenir: boyut, her katsayı 3329'un altında, tamamı sıfır değil), validateKemPublicKey ve /qorechain/pqc/v1/kem/{address} (bech32 veya 0x) rotasının fetchKemKey okuması. Her iki mesaj da hibrit imza gerektirir. Rota mainnet'te ve testnet'te yanıt verir. SDK şifrelemez: mühürlü yükler için bkz. QoreSeal
Abstract account'larBir hesabın saklanan harcama kurallarının ve bağlı anahtarlarının (iptal edilenler dahil) okumaları, MsgUpdateConfig (modülü açıp kapatan yönetişim mesajı) ve hesap görünümünde authenticators_count
Harcama kuralı denetimleriKurallar zincirin denetlediği gibi denetlenir: bir erc20/, erc721/ veya erc1155/ denom'u bir 0x sözleşme adresi belirtmelidir. abstractaccount 8 (geçersiz harcama kuralı) ve 9 (modül devre dışı) kodları adlandırılır
Yönetişim parametreleriCross-VM MsgUpdateParams (EVM köprü ön derlemesinin çağırabileceği CosmWasm sözleşmeleri dahil) ve rollup MsgUpdateParams; her biri imzalamadan önce zincirin sınırlarına karşı denetlenir. Cross-VM parametre okuması bridge_allowed_targets taşır
Yükseltme sabiti ve protobuf'larCHAIN_UPGRADE_V3_2_5; zincir v3.2.5 ile eşitlenmiş protobuf tanımları
Zincir geliştirici kitiYalnızca npm'e çıkan 0.11.0'dan itibaren ve 0.12.0'a dahil: @qorechain/evm, qorechain (9801) ve qorechainTestnet (9800) viem zincirlerini ve EVM yetkilendirme penceresi yardımcılarını (evmWindowStatus, openEvmWindowMessage, ayrıca viem olmadan @qorechain/evm/window olarak) dışa aktarır. create-qorechain-dapp içinde foundry, hardhat, viem-wagmi ve cosmwasm şablonları vardır. @qorechain/react içinde PqcStatusBadge vardır (eski QuantumSafeBadge adları kullanımdan kaldırılmış takma adlar olarak korunur)
DüzeltmelersvmRpc olmadan uç nokta verilen @qorechain/svm localhost kullanıyordu; artık uç noktanın yapılandırılmadığını söyler. Python kod üretimi, QoreChain protobuf'ları arasındaki import'ları pakete yönlendirir

Yükseltirken denetlemeniz gereken davranış değişikliği. Kodunuz localhost varsayılanına dayanıyorsa, localnet seçin veya endpoints geçirin. Herkese açık testnet uç noktaları IP başına hız sınırlıdır; bu yüzden üretim trafiği kendi düğümünü çalıştırmalı veya kullanmalıdır. Hiçbir hazır ayar herkese açık ağlarda bir gRPC veya SVM uç noktası belirlemez (SVM işlemleri açık değildir) ve mainnet'in herkese açık bir EVM WebSocket'i yoktur: bunlardan birine ihtiyaç duyan kod, localhost'a geri dönmek yerine geçirilecek uç noktayı adlandıran bir hatayla başarısız olur. Rust'ta isteğe bağlı uç noktalar artık Option<String>'dir; Python, Go ve Java'da ayarlanmamış bir uç nokta sırasıyla None, boş bir dize ve null'dır.

Düğümler ikili sürümlerini bildirmez. Bir özelliği algılamak için, onu getiren her yükseltme adı için isUpgradeApplied işlevine sorun veya .version değerini https://download.qore.host/<net>/latest.json adresinden okuyun.

0.10.0 neler ekledi​

SDK 0.10.0, mainnet'in 23 Ekim 2026'da 3.742.566 yüksekliğinde uyguladığı (testnet bunu 19 Ekim'de 8.337.253 yüksekliğinde uyguladı) zincir v3.2.4 için istemci sürümüdür. İmzalama biçimi, adresler, ondalık basamaklar, memo'lar ve ücretler değişmedi ve 0.9.0 ile oluşturulmuş bir işlem geçerli kalır. Sürüm, her dilde testnet üzerinde gerçek işlemlerle kontrol edildi. v3.2.4'ten sonra getirilen hiçbir şey için oluşturucuları yoktu; v3.2.5 ekleri 0.12.0 ile geldi. Mainnet 12 Kasım 2026'dan beri v3.2.7 çalıştırır (yükseklik 4.164.600, yönetişim önerisi 16; v3.2.6, 4 Kasım'dan beri, yükseklik 4.020.000; öncesinde v3.2.5, 29 Ekim'den beri, yükseklik 3.906.833) ve imzalama biçimi değişmediği için 0.10.0 orada çalışmaya devam eder. Testnet v3.2.5 ve v3.2.6'yı 26 ve 27 Ekim 2026'da, v3.2.7'yi 6 Kasım'da ve v3.2.8'i 12 Kasım'da uyguladı (hiçbir SDK sürümünde v3.2.7 mesajları için oluşturucu yoktur; bunlar mainnet'te 12 Kasım 2026'dan beri vardır). 0.10.0'ın getirdikleri (hepsi hâlâ 0.14.0'da):

Alan0.10.0'da
Stake katmanları (x/stakingtier)lockDelegation (zincirin kendi denetimleri: 3, 6 veya 12 aylık bir süre ve pozitif bir tam miktar), unlockEarly, claimBonus ve updateParams oluşturucuları; modül parametreleri, bir sahibin kilitleri ve bonus havuzu için okumalar (fetchStakingTierParams, fetchStakingLocks, fetchStakingTierPool); modülün hata kodları. Modülün ne yaptığı Staking ve Delegasyon sayfasında anlatılır
Authenticator nonce değerifetchAuthNonce({ rest, address, pubkey }), bağlı bir anahtarın MsgExecuteEVM / MsgExecuteCosmos için sıradaki imzalaması gereken sırayı elle takip etmek yerine /qorechain/abstractaccount/v1/auth_nonce/{address}/{pubkey_hex} rotasından okur. Her iki ağ da rotayı sunar; abstractaccount modülünün kendisi mainnet'te kapalıdır (testnet'te etkindir), bu nedenle bir mainnet harcaması herhangi bir nonce denetlenmeden önce reddedilir
Protokol özellik anahtarlarıfetchProtocolFeatures ve isProtocolFeatureEnabled, bir ağın hangi konsensüs kurallarını uyguladığını adıyla /qorechain/pqc/v1/protocol_features rotasından okur (her iki ağ da sunar). v3.2.4'ün altındaki bir ağ rotayı sunmaz; orada isUpgradeApplied kullanın
possessionProvenPQC durumu, hesabın anahtarının bir sahiplik kanıtıyla kaydedilip kaydedilmediğini söyler
ibcTimeoutTimestamp(seconds)MsgTransfer'ın aldığı birimde (Unix nanosaniye) mutlak bir IBC zaman aşımı. IBC zaman aşımları mutlak zamanlardır; IBC v2 paketleri mutlak Unix saniyesi alır ve orada göreli bir değer ücret alındıktan sonra reddedilir. Mainnet'te hiçbir IBC kanalı açık değildir (27 Ekim 2026'da kontrol edildi)
Yükseltme sabiti ve protobuf'larCHAIN_UPGRADE_V3_2_4; zincir v3.2.4 ile eşitlenmiş protobuf tanımları (köprü doğrulayıcı kaydında, hafif düğümde ve rollup sorgularında yeni alanlar)
ensurePqcRegisteredAçık anahtarı olmayan bir durumu eşleşme sayıyordu; artık anahtarı rest üzerinden okur ve karşılaştırır. Okunacak bir şey yoksa sonuç, anahtarın çağıranın olduğunu iddia etmek yerine keyVerified: false bildirir
Ücret simülasyonu sırasında retYalnızca metin olarak gelen bir zincir reddi (örneğin "no bonus to claim"), artık her dilde zincirin kayıtlı hata açıklamalarından adlandırılır: decodeTxError (TypeScript), SimulationRefusedError (Python), tx.DecodeRefusalText (Go), tx::decode_refusal_text (Rust), TxError.decode (Java)

@qorechain/react ve create-qorechain-dapp onunla birlikte 0.10.0'a geçti; ikisi de artık 0.14.0'dadır.

0.9.0 neler ekledi​

SDK 0.9.0, zincir v3.2.2 ve v3.2.3 için istemci sürümüydü (mainnet bunları 3.556.788 ve 3.662.051 yüksekliklerinde uyguladı; mainnet v3.2.4'ü 23 Ekim 2026'dan itibaren (yükseklik 3.742.566) çalıştırdı, 29 Ekim'den itibaren v3.2.5'i çalıştırdı, 4 Kasım'dan beri v3.2.6 çalıştırdı ve 12 Kasım 2026'dan beri v3.2.7 çalıştırır, testnet ise 19 Ekim 2026'dan beri v3.2.4 veya üstünü çalıştırır). İmzalama biçimi, adresler, ondalık basamaklar, memo'lar ve ücretler değişmedi; dolayısıyla 0.8.1 ve sonrasının imzaladığı v2 hibrit sign-bytes biçimi hâlâ doğru olandır. Yenilikler:

Alan0.9.0'da (ve sonrasında)
Hibrit TxClient (TypeScript)Hesabın anahtar çiftini verin: client.connectTx(signer, { pqcKeypair }) veya TxClient.connect({ …, pqcKeypair, rest }). Böylece her işlem hibrit imzalanır ve fee: "auto" hibrit işlemin kendisini simüle eder; çıplak bir anahtar kaydı klasik kalır (zincirin önyükleme yolu). bankSend ile SDK'nın rollup, multilayer ve cross-VM istemcileri bunu kullanır. Anahtar çifti verilmezse hiçbir şey değişmez
Kurtarılabilir PQC anahtarıderivePqcCanonical(address, mnemonic) ve her dildeki karşılıkları (bkz. Hibrit imzalama)
ensurePqcRegisteredÖnce anahtar durumunu REST üzerinden okur (rest), ayırt edemediğinde kaydetmeyi reddeder, hesap zaten farklı bir anahtar tutuyorsa PqcKeyMismatchError fırlatır ve zincirin "already registered" reddini başarı sayar. Zincir v3.2.3'ten itibaren sahiplik kanıtını kendiliğinden imzalar ve ekler; v3.2.3 öncesinde alanı boş bırakır
Kapsamlı EVM pencereleriopenEvmWindowMsg, nativeOnly ve allowedTargets alır (en fazla 16, tekrar yok); fetchEvmWindow ikisini de geri okur (bkz. EVM kılavuzu)
EIP-7702 onayıauthorizeEvmDelegationMsg, clearEvmDelegationMsg, fetchEvmDelegationConsent, evmDelegationTupleNonce, classifyEvmDelegationRejection
Anahtar bütünlüğüKayıt oluşturucuları classical_only'yi, boş bir anahtarı ve dejenere bir ML-DSA-87 anahtarını reddeder; zincir bunları v3.2.3'ten itibaren reddeder. signProofOfPossession / verifyProofOfPossession dışa aktarılır; migratePqcKeyHybrid, anahtarı olan hesapların v3.2.3'ten itibaren ihtiyaç duyduğu hibrit imzalı MsgMigratePQCKey mesajını gönderir
Abstract-account özeti v2evmAuthSignBytesV2 (çağrının gas limitini bağlar) ve resolveEvmAuthDigestVersion. abstractaccount modülü mainnet'te kapalıdır (testnet'te etkindir); bu nedenle mainnet'te bu yalnızca başvuru içindir
Yükseltme algılamaisUpgradeApplied, requireUpgradeApplied: yeni isteğe bağlı alanlar yalnızca applied_plan sürümü bildirdikten sonra ayarlanır, çünkü bir sürümü uygulamamış bir düğüm, o sürümün yeni alanlarından biri ayarlandığında işlemin tamamını reddeder
Hata çözümlemeBir blok içindeki başarısızlık codespace'ini korur (örneğin sdk_231 değil pqc 231); rate_limited ve delegasyon kodları çözülür; decodeTxError fırlatılan bir hatanın günlüğünü veya mesajını okur
Harcama kurallarıvalidateSpendingRules, MsgUpdateSpendingRules oluşturucularında çalışır ve hiçbir şeyi sınırlamayan bir kuralı reddeder
DüzeltmelerPQC hesap rotası her SDK'da tekil /qorechain/pqc/v1/account/{address} biçimindedir (ve birleşik istemci verildiğinde client.rest.getPqcAccount, isPqcRegistered ve getPqcStatus içinde de); dışa aktarılan VERSION paketle eşleşir; SDK'nın oluşturduğu Go ve Rust istemcileri takılı kalmak yerine zaman aşımına uğrar; create-qorechain-dapp şablonları birlikte geldikleri sürüme bağımlıdır

Yeni anahtarlar için eski PQC türetmesi (derivePqcLegacy, "bridge") kullanımdan kaldırılmıştır: hesaba bağlı değildir; bu nedenle bir mnemonic her hesaba tek bir anahtar verirdi. Rotasyon yardımcıları onu yeni anahtar olarak reddeder; mevcut bir eski anahtarı kurtarmak veya ondan rotasyonla uzaklaşmak hâlâ çalışır.

0.9.0 öncesi sürümler​

0.8.x kullanıyorsanız, her iki ağın da doğruladığı biçimi imzalamaya devam eder ve mainnet ve testnet üzerinde çalışır. Bunlar, 0.9.0'ın kaldırdığı sınırlardır ve bazıları bilmediğinizde ücrete mal olur:

0.9.0 öncesi sürümGeçici çözüm
Sahiplik kanıtı, kapsamlı pencere veya EIP-7702 onayı oluşturucuları yokqorechaind tx pqc register-key-v2 … --pqc-key <name>, open-evm-window --native-only / --allowed-targets ve authorize-evm-delegation / clear-evm-delegation komutlarını kullanın (bkz. EVM yetkilendirme penceresi, EIP-7702 delegasyonları)
status verilmeden ensurePqcRegistered kaydı denetlemeden yayınlıyordu ve farklı bir anahtar kayıtlıyken başarı bildiriyorduZaten anahtarı olan bir hesap için ikinci bir kayıt ücret alındıktan sonra reddedilir. Önce GET /qorechain/pqc/v1/account/{address} adresini okuyun ve status: { registered: found } geçin
client.rest.getPqcAccount, isPqcRegistered, getPqcStatusÇoğul bir /accounts/ yolunu veya herkese açık uç noktaların sunmadığı qor_ ad alanını çağırıyorlardı (HTTP 501, -32601). Yukarıdaki tekil REST rotasını okuyun
TxClient / bankSend ile rollup, multilayer ve cross-VM istemcileri yalnızca klasik imzalıyorduAğlar bunu anahtarı olan her hesap için reddeder. signAndBroadcastHybrid üzerinden gönderin
Blok içinde başarısız olan işlemler codespace'ini yitiriyorduİşlemi GET /cosmos/tx/v1beta1/txs/{hash} adresinden okuyun
0.8.3'ün dışa aktarılan VERSION sabiti 0.8.0 bildiriyorduKurulu sürümü package.json içinden okuyun
create-qorechain-dapp 0.8.0, @qorechain/sdk / @qorechain/evm paketlerini ^0.3.0 sürümüne sabitliyordu (0.x sürümünde caret, 0.3 içinde kalır)İskeleti oluşturduktan sonra npm i @qorechain/sdk@latest çalıştırın
@qorechain/react 0.8.x, kayıtlı anahtar durumunu herkese açık uç noktalarda okunamaz bırakıyordu@qorechain/react 0.9.0 veya üstünü kullanın
Eski düzeltmeler

SDK 0.6.1, konsensüs açısından kritik bir hatayı düzeltti: /qorechain.pqc.v1.PQCHybridSignature tx-body uzantısı Any.value içine JSON olarak serileştiriliyor ve zincir tarafından CheckTx aşamasında reddediliyordu. SDK ≤ 0.6.0 ile oluşturulan hibrit (PQC + klasik) işlemler zincir üzerinde reddedilir. 0.8.0, cüzdan imzalı hesap yardımcılarını kaldırdı (bkz. Hesaplar ve PQC imzalama).

TypeScript​

Çekirdek paket:

npm i @qorechain/sdk

Node.js 20+ hedefler; ESM, CommonJS ve tip tanımlarıyla birlikte gelir. Bu belgelerdeki hibrit işlem örnekleri ayrıca @cosmjs/stargate içinden StargateClient içe aktarır (npm i @cosmjs/stargate).

EVM adaptörü​

@qorechain/evm, viem üzerine kurulu ince ve tip güvenli bir adaptördür. viem bir peer dependency'dir — birlikte kurun:

npm i @qorechain/evm viem

npm'de 0.14.0 sürümüyle yayımlanmıştır. qorechain (zincir kimliği 9801) ve qorechainTestnet (9800) viem zincirlerini ve EVM yetkilendirme penceresi yardımcılarını dışa aktarır.

SVM adaptörü​

@qorechain/svm, @solana/web3.js üzerine kurulu ince bir adaptördür; @solana/web3.js bir peer dependency'dir:

npm i @qorechain/svm @solana/web3.js

npm'de 0.14.0 sürümüyle yayımlanmıştır.

React kiti​

@qorechain/react, @qorechain/sdk üzerindeki resmi React katmanıdır — bir provider, hook'lar ve ConnectButton / PqcStatusBadge bileşenlerini içerir. react (>=18) bir peer dependency'dir:

npm i @qorechain/react

npm'de 0.14.0 sürümüyle yayımlanmıştır; @qorechain/sdk ^0.14.0 sürümüne bağımlıdır. Bkz. React kiti kılavuzu.

İskelet oluşturucu​

create-qorechain-dapp (npm, 0.14.0), çalışmaya hazır bir dApp iskeleti oluşturur:

npm create qorechain-dapp@latest my-dapp

Oluşturulan package.json dosyaları, iskelet oluşturucunun birlikte geldiği SDK sürümüne bağımlıdır (@qorechain/sdk ^0.14.0; EVM şablonları @qorechain/evm ^0.14.0 kullanır). Sürüm 0.13.1 yalnızca şablonları değiştirdi ve 0.14.0 bu düzeltmeleri taşır; bkz. İskele araçları ve CLI. Sözleşme çalışmaları için ayrıca foundry, hardhat, viem-wagmi ve cosmwasm şablonları vardır. İskelet oluşturucunun 0.8.0 sürümü ^0.3.0 aralıkları yazıyordu; bir 0.x sürümünde bunlar 0.3 içinde kalır ve canlı ağlar için imzalayamaz; 0.8.0 ile iskelet oluşturduysanız npm i @qorechain/sdk@latest çalıştırın. Bkz. CLI başvurusu.

Python​

pip install qorechain-sdk

Python 3.10+ gerektirir. Paket, tip ipuçları ve bir py.typed işaretçisiyle birlikte gelir.

Dağıtım qorechain-sdk adıyla kurulur (PyPI'da 0.14.0 sürümüyle yayımlanmıştır) ancak qorsdk adıyla içe aktarılır:

import qorsdk

Go​

go get github.com/qorechain/qorechain-sdk/packages/go/...

Go 1.23+ gerektirir. İhtiyaç duyduğunuz alt paketleri içe aktarın, örneğin:

import (
"github.com/qorechain/qorechain-sdk/packages/go/qorechain/client"
"github.com/qorechain/qorechain-sdk/packages/go/qorechain/accounts"
)

Kendi kendine yeten bir Go modülü olarak yayımlanmıştır (packages/go/v0.14.0 etiketiyle). Sürümü açıkça sabitleyin: go get github.com/qorechain/qorechain-sdk/packages/go@v0.14.0.

Rust​

cargo add qorechain-sdk

Ya da depo başını takip etmek için:

[dependencies]
qorechain-sdk = { git = "https://github.com/qorechain/qorechain-sdk" }
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

Rust 1.74+ gerektirir. Okuma istemcileri asenkrondur (Tokio). Crate, qorechain adıyla içe aktarılır (use qorechain;).

crates.io'da qorechain-sdk (0.14.0) adıyla yayımlanmıştır; cargo add qorechain-sdk en son sürümü kurar.

Java​

Maven (pom.xml):

<dependency>
<groupId>io.github.qorechain</groupId>
<artifactId>qorechain-sdk</artifactId>
<version>0.14.0</version>
</dependency>

Ya da Gradle:

implementation 'io.github.qorechain:qorechain-sdk:0.14.0'

Maven Central'da io.github.qorechain:qorechain-sdk adıyla yayımlanmıştır (güncel sürüm 0.14.0). JDK 17 veya üzeri gerekir. Central'da 0.8.0 veya 0.8.1 derlemesi yoktur; bu nedenle canlı ağlarda 0.8.2 veya sonrasını kullanın. 0.9.1, Bouncy Castle'ı 1.80'den 1.85'e API değişikliği olmadan taşıyan yalnızca Java'ya özel bir sürümdü.

PaketAmaçSürüm
@qorechain/wallet-adapterCüzdan tarafı yardımcıları: cüzdan oluşturma (generateQoreWallet), eth_secp256k1 hibrit imzalama (signHybridEth, QoreChainSigner), MetaMask ağ kaydı (addQoreEvmToWallet), authenticator ve EVM penceresi mesaj oluşturucuları (openEvmWindowMsg yalnızca kapsamsız biçimi oluşturur), v2 abstract-account özeti. Sahiplik kanıtı eklemez. Peer dependency'ler: @cosmjs/proto-signing ve @cosmjs/stargate ^0.32 (SDK cosmjs 0.39 kullanır; bu nedenle ikisini aynı projeye kurmak npm'in bir peer çakışması, ERESOLVE, bildirmesine yol açar; onları ayrı projelerde tutun veya --legacy-peer-deps geçin)0.5.0
@qorechain/chain-bridgeArka uçlar için sunucu tarafı worker: PQC anahtarını türetir, hibrit imzalar ve yayınlar (sendTokens, registerPqc ve daha fazlası). cosmosRest geçin: bununla, ağ v3.2.3'ü uyguladıktan sonra bir kayıt sahiplik kanıtını taşır ve PQC'ye benzeyen bir ret, herhangi bir yeniden kayıttan önce zincire karşı kontrol edilir (farklı bir kayıtlı anahtar, ikinci bir kayıt için ücret ödetmek yerine pqc_key_mismatch hatası verir)0.2.3
@qorechain/pqcYalnızca standartlara uygun ML-DSA / ML-KEM / SHAKE-256 ilkelleri ve hybridSignBytes (bkz. Post-Kuantum İmzalama); ayrıca aynı sürümde PyPI, crates.io, Maven Central ve Go proxy'sinde (Go v0.2.3)0.2.3
@qorechain/handlesDoğrulanmış @handle çözümlemesi (HandleClient): kayıt defterinin açık anahtarını ve bir sabitleme deposunu siz sağlarsınız ve kullanıcı adresi gördükten sonra siz sabitlersiniz; paket kendiliğinden hiçbir zaman sabitlemez. Bkz. Chain bridge ve handle'lar0.1.0
@qorechain/connectnpm'de kullanımdan kaldırılmıştır ve artık bakımı yapılmamaktadır; yeni işlerde kullanmayın. Bunun yerine @qorechain/wallet-adapter kullanın (QoreX bağlantısı için yedekler geliştirici araçlarına genel bakışta yer alır). EVM, Cosmos ve SVM cüzdanları için, cüzdan adaptörü üzerine kurulu tek bir bağlayıcı (peer aralığı @qorechain/wallet-adapter ^0.2.1'dir ve 0.5.0'ı içermez). Bir EVM yetkilendirme penceresi açmaz; bu nedenle hesabın kayıtlı bir anahtarı ve açık bir penceresi olana kadar onun üzerinden yapılan bir EVM gönderimi reddedilir0.2.1
@qorechain/rdkRollup Development Kit istemcisi (bkz. Rollup'lar). 0.7.0'dan itibaren @qorechain/sdk ^0.10.0 ve @qorechain/evm ^0.8.0 sürümlerine bağımlıdır (4 Kasım 2026'da npm'de kontrol edildi). 0.x sürümündeki bir caret o minor içinde kalır; bu yüzden SDK 0.13.0 kullanan bir uygulama, kit için ikinci, iç içe bir SDK 0.10.x kopyası alır; bir kit sürümü 0.13'e geçene kadar ikisini birbirinden ayrı tutun (bir kopyadan diğerine istemci geçirmeyin). Yalnızca bir pqcKeypair verdiğinizde hibrit imzalar; okumalar onsuz çalışır. Ayrıca PyPI, crates.io ve Maven Central'da qorechain-rdk olarak ve bir Go modülü olarak yayımlanmıştır (@v0.8.0 sabitleyin); 0.8.0'dan itibaren bu dört istemci de hibrit imzalar (önceki sürümler yalnızca klasik imzalıyordu; Java için Java 21 gerekir). Bkz. RDK 0.8.0: değişiklikler ve sınırlar0.9.0
@qorechain/rdk-cliRDK için qorollup operatör CLI'ı. 0.7.1'den beri işlem komutları (create, pause, resume, stop, withdraw) hibrit imzalar (0.7.0 ve öncesi yalnızca klasik imzalıyordu ve ağlar tarafından reddediliyordu); npm'den kurulduğunda çalışır ve --version kurulu sürümü yazdırır (0.6.1 ve öncesi hiçbir şey yazdırmıyordu)0.9.0
@qorechain/qoresealQoreSeal: bir yükü, hesapların KEM kayıt defterinde yayımladığı ML-KEM-1024 anahtarlarına şifreler (SDK 0.12.0 ve sonrası anahtarları kaydeder ve okur; şifrelemeyi QoreSeal yapar). Ayrıca PyPI (qorechain-qoreseal; macOS ve Linux wheel'leri, Windows wheel'i sonraki sürümde), crates.io, Maven Central (io.github.qorechain:qoreseal ve qoreseal-android; Kotlin kullanıcıları Kotlin 2.3 veya üstüne ihtiyaç duyar), Go modül proxy'si (github.com/qorechain/qoreseal/go, Go v0.1.0) ve bir Swift paketi olarak da bulunur. Bkz. QoreSeal0.1.0
@qorechain/asset-kitAsset Kit: EVM Engine üzerinde izinli gerçek dünya varlığı token'ları için araçlar; TypeScript, Python, Java ve Go istemcileri ve Solidity sözleşmeleriyle (forge install qorechain/qorechain-asset-kit@v0.1.0). Apache-2.0; ERC-3643 betikleri ve testleri hariç (GPL-3.0-or-later). Tanımladığı native modüller bir önerisidir, yapılmamıştır. Ayrıca PyPI'da qorechain-asset-kit ve Maven Central'da io.github.qorechain:asset-kit. Bkz. Asset Kit0.1.0
@qorechain/qoresignQoreSign: cüzdan ve arka uç imzalama ve işlenmiş (committed) bir işlemin post-kuantum katmanını denetlemek için inspectTransaction. Ayrıca PyPI, crates.io ve Maven Central'da. Bkz. QoreSign0.2.0
create-qorechain-rollupRollup başlangıç iskelet oluşturucusu; şablonları @qorechain/rdk ^0.9.0 sürümüne bağımlıdır ve post-kuantum anahtarınızı QORE_MNEMONIC veya QORE_PQC_SEED_HEX içinden çözümleyebildiklerinde hibrit imzalar0.9.0

Sıradaki adım​

Bağlanmak ve zincir üzerindeki durumu okumak için Hızlı Başlangıç sayfasına geçin.