Sari la conținutul principal

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

Limitele kit-ului React pe rețelele live (0.9.0 până la 0.14.0)

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​

HookReturnează
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-un TxClient, astfel încât useTx poate semna imediat. Setează addresses.native.
  • evm — orice provider EIP-1193 injectat (window.ethereum, de ex. MetaMask) prin eth_requestAccounts. Setează addresses.evm.
  • svm — orice provider Wallet-Standard injectat (window.solana, de ex. Phantom) prin connect(). 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.