React-Kit (@qorechain/react)
@qorechain/react ist die offizielle React-Schicht über @qorechain/sdk: ein
Provider, eine Handvoll Hooks und zwei Drop-in-Komponenten — einschließlich eines einzeiligen
PQC-Status-Badges. Es macht das Erstellen einer dApp mit hybrider ML-DSA-87-Signierung zum Standardweg.
npm i @qorechain/react @qorechain/sdk react react-dom
react (>=18) ist eine Peer-Abhängigkeit; @qorechain/sdk ist eine direkte Abhängigkeit
(^0.14.0 seit Kit 0.14.0; bei einer 0.x-Version bleibt das Caret innerhalb von 0.14, sodass ein SDK-
Patch keine zweite Kopie installiert). Verwenden Sie @qorechain/react 0.14.0 (0.9.0 und neuer funktionieren genauso): 0.8.0 legt
SDK 0.8.0 fest, das im Mainnet die falsche Hybridform signiert, und frühere 0.8.x-Versionen
können nach einem Adresswechsel ein veraltetes Guthaben oder einen veralteten Status anzeigen.
useTx verbindet sich mit dem Signierer der Wallet und ohne Post-Quanten-Schlüsselpaar, sodass es
nur mit der klassischen Signatur sendet, die die Live-Netzwerke ablehnen (der native Pfad
erfordert die hybride ML-DSA-87-Erweiterung): send / sendTokens können im
Mainnet oder Testnet keine Transaktion platzieren. Senden Sie mit dem hybriden TxClient des SDK
(client.connectTx(signer, { pqcKeypair }), siehe
Hybrides Signieren). usePqcStatus und <PqcStatusBadge/> lesen den Status über
getPqcStatus mit dem zusammengesetzten Client des Providers, der seit SDK 0.9.0 über
REST liest (/qorechain/pqc/v1/account/{address}), sodass sie gegen *.qore.host funktionieren
(Kit 0.8.x las qor_getPQCKeyStatus, das die öffentlichen Endpunkte nicht bereitstellen, und
konnte dort einen Schlüssel nicht bestätigen). Guthabenabfragen (useBalance) und die Wallet-Verbindung
funktionieren.
Provider
Umschließen Sie Ihre App einmal mit QoreChainProvider. Er hält eine einzelne createClient()-
Instanz sowie den Live-Status der Wallet-Verbindung, aus dem jeder Hook liest.
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>
);
}
Um Netzwerke zur Laufzeit zu wechseln, mounten Sie den Provider mit einem anderen React-key neu.
Für Tests übergeben Sie statt config eine vorgefertigte (oder gemockte) client-Prop.
Hooks
| Hook | Rückgabe |
|---|---|
useQoreClient() | Der zusammengesetzte QoreChainClient für Ad-hoc-Lesezugriffe. |
useAccount() | { addresses, address, isConnected, status, wallet } — native / EVM / SVM Adressen. |
useBalance(address?, options?) | { data, isLoading, error, refetch }; automatische Aktualisierung über refreshInterval. |
useConnect() / useWallet() | { connect, disconnect, status, isConnecting, error }. |
useTx() | { send, sendTokens, status, data, error, isPending, reset }. |
usePqcStatus(address?, options?) | { data, isRegistered, isLoading, error, refetch }. |
Wallets verbinden
useConnect kapselt die vorhandenen SDK-Adapter:
const { connect } = useConnect();
await connect({ kind: "keplr" }); // or "leap" | "evm" | "svm"
- keplr / leap — Cosmos-Wallets über
getCosmosWallet. Schlägt die Chain vor und aktiviert sie, gibt einen Signierer zurück, der in einenTxClienteingebunden wird, sodassuseTxsofort signieren kann. Setztaddresses.native. - evm — jeder injizierte EIP-1193-Provider (
window.ethereum, z. B. MetaMask) übereth_requestAccounts. Setztaddresses.evm. - svm — jeder injizierte Wallet-Standard-Provider (
window.solana, z. B. Phantom) überconnect(). Setztaddresses.svm.
Die EVM- und SVM-Pfade nutzen die Standard-Request-API des injizierten Providers direkt,
sodass weder viem noch ein Solana-SDK eingebunden wird. Übergeben Sie provider in den Connect-
Optionen, um für Tests eine Wallet zu injizieren. Kombinieren Sie es mit @qorechain/evm /
@qorechain/svm für vollständiges Tooling pro VM.
Transaktionen senden
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) nimmt rohe Nachrichten aus den msg.*-Composern
für alles, was über eine Bank-Überweisung hinausgeht.
Komponenten
<ConnectButton/>
Ein minimales, weitgehend headless gehaltenes Connect-/Disconnect-Steuerelement. Übergeben Sie
wallets, um eine Auswahl anzubieten, className / style zum Stylen oder eine children-
Render-Prop für volle Kontrolle:
<ConnectButton wallets={["keplr", "leap", "evm"]} />
<PqcStatusBadge/>
Zeigt einen Statusindikator, wenn die Adresse einen registrierten Post-Quanten-
Schlüssel besitzt (über usePqcStatus), andernfalls einen gedämpften Status "not registered".
Standardmäßig wird das verbundene Konto verwendet. Die Standardbeschriftungen sind „PQC key registered" und „No PQC key"
(überschreiben Sie sie mit safeLabel / unsafeLabel); das Wurzelelement trägt
data-pqc-status und data-quantum-safe mit denselben Werten.
<PqcStatusBadge />
<PqcStatusBadge address="qor1…" hideWhenUnsafe />
PqcStatusBadge kam mit Kit 0.11.0. QuantumSafeBadge (mit QuantumSafeBadgeProps
und QuantumSafeRenderState) wird weiterhin als veralteter Alias derselben
Komponente exportiert, sodass bestehender Code weiter funktioniert.
Alles zusammenfügen
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>
)}
</>
);
}
Sehen Sie sich das lauffähige react-dapp-Beispiel
und den Leitfaden zum hybriden Signieren für die zugrunde liegenden SDK-Aufrufe an.