React kiti (@qorechain/react)
@qorechain/react, @qorechain/sdk üzerine kurulu resmi React katmanıdır: tek bir
sağlayıcı, bir avuç kanca ve iki yerleştirilebilir bileşen — tek satırlık bir
PQC durum rozeti dahil. Hibrit ML-DSA-87 imzalamalı bir dApp oluşturmayı varsayılan yol haline getirir.
npm i @qorechain/react @qorechain/sdk react react-dom
react (>=18) bir eş bağımlılıktır; @qorechain/sdk doğrudan bir bağımlılıktır
(kit 0.14.0'dan beri ^0.14.0; 0.x bir sürümde şapka işareti 0.14 içinde kalır, dolayısıyla bir SDK
yaması ikinci bir kopya kurmaz). @qorechain/react 0.14.0 sürümünü kullanın (0.9.0 ve sonrası aynı şekilde çalışır): 0.8.0,
mainnet'te yanlış hibrit biçimiyle imzalayan SDK 0.8.0'a sabitlenir; daha eski 0.8.x
sürümleri ise adres değişikliğinden sonra eski bir bakiye veya durum gösterebilir.
useTx, cüzdanın imzalayanıyla ve post-kuantum anahtar çifti olmadan bağlanır; bu yüzden
yalnızca klasik imzayla gönderir ve canlı ağlar bunu reddeder (Native yolu hibrit ML-DSA-87
uzantısını gerektirir): send / sendTokens mainnet veya testnet üzerinde bir işlemi
işleyemez. Gönderimler için SDK'nin hibrit TxClient'ını kullanın
(client.connectTx(signer, { pqcKeypair }), bkz.
Hibrit imzalama). usePqcStatus ve <PqcStatusBadge/>,
durumu sağlayıcının oluşturulmuş istemcisiyle getPqcStatus üzerinden okur; bu çağrı SDK 0.9.0'dan
itibaren REST üzerinden okur (/qorechain/pqc/v1/account/{address}), bu nedenle
*.qore.host karşısında çalışırlar (kit 0.8.x, genel uç noktaların sunmadığı
qor_getPQCKeyStatus'ı okuyordu ve orada bir anahtarı doğrulayamıyordu). Bakiye okumaları
(useBalance) ve cüzdan bağlantısı çalışır.
Sağlayıcı
Uygulamanızı bir kez QoreChainProvider içine sarın. Her kancanın okuduğu tek bir
createClient() örneği artı canlı cüzdan bağlantı durumunu tutar.
import { QoreChainProvider } from "@qorechain/react";
function Root() {
return (
<QoreChainProvider
config={{
network: "testnet",
endpoints: {
rpc: "https://rpc-testnet.qore.host",
rest: "https://api-testnet.qore.host",
evmRpc: "https://evm-testnet.qore.host",
},
}}
>
<App />
</QoreChainProvider>
);
}
Çalışma zamanında ağ değiştirmek için, sağlayıcıyı farklı bir React key ile yeniden bağlayın.
Testler için, config yerine önceden oluşturulmuş (veya taklit edilmiş) bir client prop'u geçin.
Kancalar
| Kanca | Döndürür |
|---|---|
useQoreClient() | Anlık okumalar için oluşturulmuş QoreChainClient. |
useAccount() | { addresses, address, isConnected, status, wallet } — yerel / EVM / SVM adresleri. |
useBalance(address?, options?) | { data, isLoading, error, refetch }; refreshInterval aracılığıyla otomatik yenileme. |
useConnect() / useWallet() | { connect, disconnect, status, isConnecting, error }. |
useTx() | { send, sendTokens, status, data, error, isPending, reset }. |
usePqcStatus(address?, options?) | { data, isRegistered, isLoading, error, refetch }. |
Cüzdanları bağlama
useConnect, mevcut SDK adaptörlerini sarar:
const { connect } = useConnect();
await connect({ kind: "keplr" }); // or "leap" | "evm" | "svm"
- keplr / leap —
getCosmosWalletaracılığıyla Cosmos cüzdanları. Zinciri önerir ve etkinleştirir, birTxClient'a bağlanan bir imzalayan döndürür; böyleceuseTxhemen imzalayabilir.addresses.native'i ayarlar. - evm —
eth_requestAccountsaracılığıyla herhangi bir enjekte edilmiş EIP-1193 sağlayıcısı (window.ethereum, örn. MetaMask).addresses.evm'i ayarlar. - svm —
connect()aracılığıyla herhangi bir enjekte edilmiş Wallet-Standard sağlayıcısı (window.solana, örn. Phantom).addresses.svm'i ayarlar.
EVM ve SVM yolları, enjekte edilen sağlayıcının standart istek API'sini doğrudan kullanır;
bu nedenle ne viem ne de bir Solana SDK'si dahil edilir. Testler için bir cüzdan enjekte etmek üzere
connect seçeneklerinde provider'ı geçin. VM başına tam araçlar için @qorechain/evm /
@qorechain/svm ile eşleştirin.
İşlem gönderme
import { msg } from "@qorechain/sdk";
import { useTx } from "@qorechain/react";
function Send() {
const { sendTokens, isPending } = useTx();
return (
<button
disabled={isPending}
onClick={() =>
sendTokens("qor1recipient…", [{ denom: "uqor", amount: "1000000" }])
}
>
Send 1 QOR
</button>
);
}
send([{ typeUrl, value }], opts), bir banka transferinin ötesindeki her şey için msg.*
oluşturucularından ham mesajlar alır.
Bileşenler
<ConnectButton/>
Minimal, headless'a yakın bir bağlanma / bağlantı kesme denetimi. Bir seçici sunmak için
wallets, temalandırmak için className / style veya tam denetim için bir children
render-prop'u geçin:
<ConnectButton wallets={["keplr", "leap", "evm"]} />
<PqcStatusBadge/>
Adresin kayıtlı bir post-kuantum anahtarı olduğunda (usePqcStatus aracılığıyla) bir
durum göstergesi gösterir; aksi takdirde sönük bir "kayıtlı değil"
durumu gösterir. Varsayılan olarak bağlı hesabı kullanır. Varsayılan etiketler "PQC key registered" ve "No PQC key"
metinleridir (safeLabel / unsafeLabel ile geçersiz kılın); kök öğe data-pqc-status ve data-quantum-safe
özniteliklerini aynı değerlerle taşır.
<PqcStatusBadge />
<PqcStatusBadge address="qor1…" hideWhenUnsafe />
PqcStatusBadge kit 0.11.0 ile geldi. QuantumSafeBadge (QuantumSafeBadgeProps ve QuantumSafeRenderState
ile birlikte) aynı bileşenin kullanımdan kaldırılmış bir takma adı olarak hâlâ dışa aktarılır;
bu yüzden mevcut kod çalışmaya devam eder.
Bir araya getirme
import {
ConnectButton,
PqcStatusBadge,
useAccount,
useBalance,
} from "@qorechain/react";
function Dashboard() {
const { address, isConnected } = useAccount();
const { data: balance } = useBalance(undefined, { refreshInterval: 10_000 });
return (
<>
<ConnectButton wallets={["keplr", "leap", "evm"]} />
{isConnected && (
<p>
{balance?.amount ?? "…"} {balance?.denom} <PqcStatusBadge />
</p>
)}
</>
);
}
Altta yatan SDK çağrıları için çalıştırılabilir react-dapp örneğine
ve hibrit imzalama kılavuzuna bakın.