Kit React (@qorechain/react)
@qorechain/react este stratul React oficial peste @qorechain/sdk: un
provider, câteva hook-uri și două componente drop-in — inclusiv un badge de
stare PQC de o singură linie. Face din construirea unei dApp cu semnare hibridă ML-DSA-87 calea implicită.
npm i @qorechain/react @qorechain/sdk react react-dom
react (>=18) este o dependență peer; @qorechain/sdk este o dependență directă
(^0.14.0 începând cu kit-ul 0.14.0; pe o versiune 0.x, caret-ul rămâne în interiorul
lui 0.14, deci un patch al SDK-ului nu instalează o a doua copie). Folosește
@qorechain/react 0.14.0 (0.9.0 și versiunile ulterioare funcționează la fel): 0.8.0 fixează SDK 0.8.0, care semnează forma hibridă
greșită pe mainnet, iar versiunile 0.8.x anterioare pot afișa un sold sau o stare
învechită după o schimbare de adresă.
useTx se conectează cu semnatarul portofelului și fără o pereche de chei
post-cuantice, deci trimite doar cu semnătura clasică, pe care rețelele live o resping
(calea Native cere extensia hibridă ML-DSA-87): send / sendTokens nu pot înscrie o
tranzacție pe mainnet sau testnet. Pentru trimiteri folosește TxClient-ul hibrid al
SDK-ului (client.connectTx(signer, { pqcKeypair }), vezi
Semnare hibridă). usePqcStatus și
<PqcStatusBadge/> citesc starea prin getPqcStatus cu clientul compus al
provider-ului, care începând cu SDK 0.9.0 citește prin REST
(/qorechain/pqc/v1/account/{address}), deci funcționează față de *.qore.host
(kit-ul 0.8.x citea qor_getPQCKeyStatus, pe care endpoint-urile publice nu îl
servesc, și nu putea confirma acolo o cheie). Citirile de sold (useBalance) și
conectarea portofelului funcționează.
Provider
Învelește aplicația o singură dată în QoreChainProvider. Acesta deține o singură instanță
createClient() plus starea live a conexiunii portofelului din care citește fiecare hook.
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>
);
}
Pentru a schimba rețelele în timpul rulării, remontează provider-ul cu un alt key React.
Pentru teste, transmite o prop client pre-construită (sau simulată) în loc de config.
Hook-uri
| Hook | Returnează |
|---|---|
useQoreClient() | QoreChainClient-ul compus pentru citiri ad-hoc. |
useAccount() | { addresses, address, isConnected, status, wallet } — adrese native / EVM / SVM. |
useBalance(address?, options?) | { data, isLoading, error, refetch }; reîmprospătare automată prin refreshInterval. |
useConnect() / useWallet() | { connect, disconnect, status, isConnecting, error }. |
useTx() | { send, sendTokens, status, data, error, isPending, reset }. |
usePqcStatus(address?, options?) | { data, isRegistered, isLoading, error, refetch }. |
Conectarea portofelelor
useConnect împachetează adaptoarele SDK existente:
const { connect } = useConnect();
await connect({ kind: "keplr" }); // or "leap" | "evm" | "svm"
- keplr / leap — portofele Cosmos prin
getCosmosWallet. Sugerează și activează lanțul, returnează un semnatar care este conectat într-unTxClient, astfel încâtuseTxpoate semna imediat. Seteazăaddresses.native. - evm — orice provider EIP-1193 injectat (
window.ethereum, de ex. MetaMask) prineth_requestAccounts. Seteazăaddresses.evm. - svm — orice provider Wallet-Standard injectat (
window.solana, de ex. Phantom) princonnect(). Seteazăaddresses.svm.
Căile EVM și SVM folosesc direct API-ul standard de cerere al provider-ului injectat,
așa că nu se importă nici viem, nici un SDK Solana. Transmite provider în opțiunile
de conectare pentru a injecta un portofel pentru teste. Asociază cu @qorechain/evm /
@qorechain/svm pentru unelte complete per VM.
Trimiterea tranzacțiilor
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) preia mesaje brute de la compozitorii msg.*
pentru orice depășește un transfer bancar.
Componente
<ConnectButton/>
Un control minimal, aproape headless, de conectare / deconectare. Transmite wallets pentru a oferi un
selector, className / style pentru a-l tematiza, sau o render-prop children pentru control
total:
<ConnectButton wallets={["keplr", "leap", "evm"]} />
<PqcStatusBadge/>
Afișează un indicator de stare atunci când adresa are o cheie post-cuantică
înregistrată (prin usePqcStatus), altfel o stare estompată „not registered”. Implicit la
contul conectat. Etichetele implicite sunt „PQC key registered” și „No PQC key”
(suprascrieți-le cu safeLabel / unsafeLabel); elementul rădăcină poartă
data-pqc-status și data-quantum-safe, cu aceleași valori.
<PqcStatusBadge />
<PqcStatusBadge address="qor1…" hideWhenUnsafe />
PqcStatusBadge a apărut în kit 0.11.0. QuantumSafeBadge (împreună cu QuantumSafeBadgeProps
și QuantumSafeRenderState) este în continuare exportat ca alias depreciat al aceleiași
componente, astfel încât codul existent continuă să funcționeze.
Punând totul cap la cap
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>
)}
</>
);
}
Vezi exemplul react-dapp executabil
și ghidul de semnare hibridă pentru apelurile SDK subiacente.