Cüzdan Kurulumu
QoreChain; native, EVM ve SVM yürütme ortamlarında birden fazla cüzdan türünü destekler. Kullanım senaryonuza uygun cüzdanı seçin.
Aşağıdaki değerler hem qorechain-vladi ana ağını (EVM zincir kimliği 9801, 7 Haziran 2026'dan beri yayında) hem de qorechain-diana test ağını (EVM zincir kimliği 9800) kapsar. Her iki ağın herkese açık uç noktaları Ağlar sayfasında listelenmiştir.
Keplr Cüzdanı
Keplr; native QoreChain işlemleri, stake etme ve yönetişim için önerilen cüzdandır.
QoreChain'i Özel Zincir Olarak Ekleyin
Keplr'ı açın ve Settings > Add Custom Chain bölümüne gidin, ardından şunları girin:
| Alan | Ana Ağ (Mainnet) | Test Ağı (Testnet) |
|---|---|---|
| Zincir Adı | QoreChain | QoreChain Diana Testnet |
| Zincir Kimliği | qorechain-vladi | qorechain-diana |
| RPC URL | https://rpc.qore.host | https://rpc-testnet.qore.host |
| REST URL | https://api.qore.host | https://api-testnet.qore.host |
| Bech32 Öneki | qor | qor |
| Coin Birimi | QOR | QOR |
| En Küçük Coin Birimi | uqor | uqor |
| Ondalık Basamak | 6 | 6 |
| Coin Türü (BIP-44) | 118 | 118 |
Zinciri ekledikten sonra Keplr, hesabınız için bir qor1... adresi oluşturur.
Ağın asgari gaz fiyatı 0.1uqor'dur. Keplr'ın gaz fiyatı kademelerini yapılandırıyorsanız (örn. suggestChain üzerinden), 0.1 veya üzeri değerler kullanın (önerilen düşük/ortalama/yüksek: 0.1 / 0.15 / 0.25) — alt sınırın altında imzalanan işlemler reddedilir.
MetaMask (EVM)
MetaMask, QoreChain'in EVM yürütme ortamıyla etkileşim kurmanızı sağlar — Solidity sözleşmeleri dağıtın, ERC-20 token'ları yönetin ve alışık olduğunuz Ethereum araçlarını kullanın.
QoreChain'i Özel Ağ Olarak Ekleyin
MetaMask'ı açın ve Settings > Networks > Add Network bölümüne gidin, ardından şunları girin:
| Alan | Ana Ağ (Mainnet) | Test Ağı (Testnet) |
|---|---|---|
| Ağ Adı | QoreChain | QoreChain Diana Testnet |
| RPC URL | https://evm.qore.host | https://evm-testnet.qore.host |
| Zincir Kimliği | 9801 | 9800 |
| Para Birimi Sembolü | QOR | QOR |
| Blok Gezgini URL'si | https://explore.qore.network | https://explore.qore.network |
Native QOR, EVM arayüzünde 18 ondalık basamağa sahiptir (wei tarzı). Bağlantı kurulduktan sonra MetaMask ile EVM işlemlerini imzalayabilir, dağıtılmış akıllı sözleşmelerle etkileşim kurabilir ve QoreChain üzerindeki ERC-20 token'ları yönetebilirsiniz.
Tek çağrıyla ağ kaydı
dApp'ler için, npm'de yayımlanan @qorechain/wallet-adapter ve @qorechain/connect paketleri QoreChain'i kullanıcının cüzdanına tek bir çağrıyla kaydeder — MetaMask'tan ağı EIP-3085 üzerinden eklemesini ister (EVM hattında doğru 18 ondalıklı native QOR ile) ve Keplr'ın gaz fiyatı kademesini yapılandırır:
npm install @qorechain/wallet-adapter @qorechain/connect
import { addQoreEvmToWallet } from "@qorechain/wallet-adapter";
await addQoreEvmToWallet(); // prompts MetaMask with QoreChain's EVM network params
Tek Hesap, Üç Adres (Birleşik Hesaplar)
Zincir sürümü v3.1.83 itibarıyla bir QoreChain hesabı, üç farklı kodlamaya sahip tek bir 20 baytlık kimliktir: qor1… (Native), 0x… (EVM) ve bir base58 biçimi (SVM). Hesap tek bir bakiye tutar ve — eth-native hesaplar için — Native yoldaki zorunlu kuantum sonrası hibrit imza dahil olmak üzere üç hattın tamamında tek bir anahtarla imzalar.
@qorechain/wallet-adapter ile kod içinde birleşik bir cüzdan oluşturun:
import { generateQoreWallet } from "@qorechain/wallet-adapter";
const w = await generateQoreWallet(); // or walletFromMnemonic(mnemonic)
console.log(w.addresses.cosmos); // qor1...
console.log(w.addresses.evm); // 0x... (same identity)
console.log(w.addresses.svm); // base58 (same identity)
// Native-lane sends use signHybridEth (classical eth_secp256k1 + ML-DSA-87 hybrid).
Üç biçimden herhangi birine gönderilen fonlar aynı bakiyeye ulaşır.
Bağlı Cüzdanlar: Harcama Anahtarı Olarak Phantom ve MetaMask
Zincir sürümü v3.1.85 itibarıyla, bir dApp içinde QoreChain hesabınızdan harcama yapmak için kök anahtarınızı açığa çıkarmanız gerekmez. Bir Phantom (ed25519) veya MetaMask (Ethereum adresiyle, personal_sign üzerinden) anahtarı hesabınıza kimlik doğrulayıcı (authenticator) olarak kaydedilebilir — kapsamlandırılmış izinler, harcama limitleri, geçerlilik süresi ve anında iptal ile — ve ardından dApp'in arka ucu tarafından iletilen transferleri yetkilendirebilir. Modelin tamamı ve kod için Bağlı Cüzdan Kimlik Doğrulayıcıları sayfasına, uçtan uca örnekler için SDK Authenticators kılavuzuna bakın.
Solana Cüzdanları (SVM)
QoreChain'in SVM yürütme ortamı standart Solana araçlarıyla uyumludur ve hesabın native QOR bakiyesi doğrudan SVM arayüzünde görünür (lamports cinsinden, 9 ondalık; 1 uqor = 1.000 lamports). Solana uyumlu herhangi bir cüzdanı veya kütüphaneyi bağlayabilirsiniz.
@solana/web3.js Kullanımı
import { Connection } from "@solana/web3.js";
// Public read-only endpoint (or http://localhost:8899 on your own node)
const connection = new Connection("https://svm.qore.host");
const slot = await connection.getSlot();
console.log("Current slot:", slot);
Herkese açık SVM uç noktaları salt okunurdur; işlem göndermek için kendi düğümünüz gerekir. Ayrıntılar için SVM Geliştirme sayfasına bakın.
PQC Destekli Cüzdanlar (Cosmos Yolunda Zorunlu)
QoreChain, cosmos işlem yolunda hibrit kuantum sonrası kriptografi (PQC) gerektirir. Güncel zincir sürümü (v3.1.82) itibarıyla ağ varsayılanı, allow_classical_fallback = false ile birlikte hybrid_signature_mode = required olarak ayarlıdır — yani cosmos yolundaki her işlem, standart secp256k1 (ECDSA) imzasının yanı sıra bir ML-DSA-87 (Dilithium-5) imzası taşımak zorundadır. Bir PQC hesabından gönderilen yalnızca klasik imzalı cosmos işlemleri reddedilir.
Cosmos yolunda düz bir klasik işlem göndermek reddedilecektir. Dilithium-5 imzasını bir PQCHybridSignature işlem uzantısı olarak eklemeniz gerekir. Standart CosmJS / Keplr araçları bu uzantıyı kendi başına üretmez — qorechaind tx pqc cosign CLI komutunu, QoreChain SDK'nın hibrit imzalamasını (aşağıya bakın) veya kendi kodunuzda oluşturmak için açık kaynaklı qorechain-pqc kütüphanesini (hybridSignBytes) kullanın. Tek istisnalar genesis gentx'leri ile PQC anahtar kaydı/taşıma işlemleridir.
Nasıl Çalışır
Cüzdanlar, standart secp256k1 (ECDSA) imzasının yanında bir ML-DSA-87 PQC imzasını işlem uzantısı olarak ekler. Klasik imza, uzantıyı hariç tutan imza baytları üzerinden hesaplanır; böylece klasik doğrulama için geçerli kalırken PQC imzası kuantum direnci sağlar.
Dilithium-5 Anahtarı Oluşturun
Hibrit imzalama için kuantum sonrası bir anahtar oluşturun:
qorechaind tx pqc gen-key
Otomatik Kayıt
İlk işleminize bir PQC açık anahtarı eklediğinizde, QoreChain bu anahtarı otomatik olarak zincir üzerinde kaydeder. Ayrı bir kayıt adımı gerekmez. (PQC anahtar kaydı/taşıma işlemleri hibrit gereksinimden muaftır; böylece bir hesap ilk anahtarını bu şekilde etkinleştirebilir.)
SDK ile Hibrit İmzalama
QoreChain SDK, includePqcPublicKey: true ile buildHybridTx üzerinden uyumlu cosmos işlemleri üretir; bu, Dilithium-5 uzantısını ekler ve otomatik kayıt için açık anahtarı gömer. Bkz. SDK Hesaplar ve PQC imzalama.
PQC Modları
Üç zorlama modu yönetişim kontrolünde kalmaya devam ediyor; güncel ağ varsayılanı Required'dır:
| Mod | Açıklama |
|---|---|
| Disabled | PQC doğrulaması kapalıdır. Yalnızca standart imzalar kullanılır. |
| Optional | İşlemler PQC imzası içerebilir. Varsa doğrulanır. |
| Required (varsayılan) | Cosmos yolundaki tüm işlemler geçerli bir PQC imzası içermelidir. |
Etkin mod zincir düzeyinde yapılandırılır ve yönetişim yoluyla güncellenebilir.
Yukarıdaki MetaMask (EVM) akışı hibrit gereksinimden etkilenmez. EVM işlemleri ayrı bir eth_secp256k1 ante yolu kullanır ve PQC uzantısına hiçbir zaman ihtiyaç duymaz.
CLI Cüzdanı
qorechaind ikili dosyası, komut satırı kullanımı için yerleşik bir anahtar yönetim sistemi içerir.
Yeni Bir Anahtar Oluşturun
qorechaind keys add mykey
Bu komut yeni bir anahtar çifti oluşturur ve anımsatıcı (mnemonic) ifadeyi görüntüler. Anımsatıcı ifadeyi güvenli bir şekilde saklayın — bu anahtarı kurtarmanın tek yolu budur.
Adresinizi Görüntüleyin
qorechaind keys show mykey -a
Bu komut qor1... bech32 adresinizi çıktı olarak verir.
Tüm Anahtarları Listeleyin
qorechaind keys list
Mevcut Bir Anahtarı İçe Aktarın
qorechaind keys add mykey --recover
Anımsatıcı ifadenizi girmeniz istenecektir.
Sonraki Adımlar
- İlk İşleminiz — Yeni cüzdanınızla QOR token gönderin
- Test Ağına Bağlanma — Yayındaki Diana test ağına katılın