メインコンテンツまでスキップ

React キット(@qorechain/react)

@qorechain/react は @qorechain/sdk 上に構築された公式の React レイヤーです。1 つの プロバイダー、いくつかのフック、そして 2 つのすぐに使えるコンポーネント(1 行で使える PQC ステータスバッジを含む)を提供します。これにより、ハイブリッド ML-DSA-87 署名を備えた dApp の構築がデフォルトの道筋になります。

npm i @qorechain/react @qorechain/sdk react react-dom

react(>=18)はピア依存です。@qorechain/sdk は直接の依存です (キット 0.14.0 以降は ^0.14.0。0.x バージョンではキャレットは 0.14 の内側にとどまるため、SDK の パッチリリースで 2 つ目のコピーがインストールされることはありません)。@qorechain/react は 0.14.0 を使用してください(0.9.0 以降も同様に動作します)。0.8.0 は SDK 0.8.0 に 固定されており、これはメインネットで誤ったハイブリッド形式で署名します。また、それ以前の 0.8.x リリースでは、アドレス変更後に古い残高やステータスが表示されることがあります。

React キットのライブネットワークにおける制限(0.9.0 から 0.14.0)

useTx はウォレットの署名者で接続し、ポスト量子鍵ペアは持たないため、従来型署名のみで送信しますが、 ライブネットワークはこれを拒否します(Native パスはハイブリッド ML-DSA-87 拡張を必要とします)。そのため、 send / sendTokens ではメインネットでもテストネットでもトランザクションを確定できません。送信には SDK の ハイブリッド TxClient (client.connectTx(signer, { pqcKeypair })、 ハイブリッド署名を参照)を使用してください。usePqcStatus と <PqcStatusBadge/> は、 プロバイダーの合成クライアントとともに getPqcStatus を通じてステータスを読み取ります。これは SDK 0.9.0 以降 REST (/qorechain/pqc/v1/account/{address})経由で読み取るため、*.qore.host に対して動作します (キット 0.8.x は qor_getPQCKeyStatus を読み取っていましたが、公開エンドポイントはこれを提供しておらず、 そこで鍵を確認できませんでした)。残高の読み取り(useBalance)と ウォレット接続は動作します。

プロバイダー​

アプリを QoreChainProvider で一度ラップします。これは単一の createClient() インスタンスと、すべてのフックが参照するライブのウォレット接続状態を保持します。

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>
);
}

実行時にネットワークを切り替えるには、異なる React の key でプロバイダーを再マウントします。 テストでは、config の代わりに事前構築(またはモック)した client プロパティを渡します。

フック​

フック戻り値
useQoreClient()アドホックな読み取り用の合成済み QoreChainClient。
useAccount(){ addresses, address, isConnected, status, wallet } — ネイティブ / EVM / SVM アドレス。
useBalance(address?, options?){ data, isLoading, error, refetch }。refreshInterval で自動更新。
useConnect() / useWallet(){ connect, disconnect, status, isConnecting, error }。
useTx(){ send, sendTokens, status, data, error, isPending, reset }。
usePqcStatus(address?, options?){ data, isRegistered, isLoading, error, refetch }。

ウォレットの接続​

useConnect は既存の SDK アダプターをラップします:

const { connect } = useConnect();
await connect({ kind: "keplr" }); // or "leap" | "evm" | "svm"
  • keplr / leap — getCosmosWallet を介した Cosmos ウォレット。チェーンを提案して 有効化し、TxClient に組み込まれた署名者を返すため、useTx はすぐに署名できます。addresses.native を設定します。
  • evm — eth_requestAccounts を介した任意のインジェクト型 EIP-1193 プロバイダー (window.ethereum、例: MetaMask)。addresses.evm を設定します。
  • svm — connect() を介した任意のインジェクト型 Wallet-Standard プロバイダー (window.solana、例: Phantom)。addresses.svm を設定します。

EVM と SVM のパスはインジェクトされたプロバイダーの標準リクエスト API を直接使用するため、 viem も Solana SDK も取り込まれません。テスト用にウォレットをインジェクトするには、connect オプションで provider を渡します。VM ごとの完全なツールを利用するには @qorechain/evm / @qorechain/svm と組み合わせてください。

トランザクションの送信​

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) は、bank 送金以外のために msg.* コンポーザーから 生のメッセージを受け取ります。

コンポーネント​

<ConnectButton/>​

最小限でヘッドレス寄りの接続 / 切断コントロールです。ピッカーを表示するには wallets を、 テーマを設定するには className / style を、完全な制御には children の レンダープロップを渡します:

<ConnectButton wallets={["keplr", "leap", "evm"]} />

<PqcStatusBadge/>​

アドレスに登録済みのポスト量子鍵がある場合(usePqcStatus を介して)にステータス インジケーターを表示し、そうでない場合は控えめな「未登録」状態を表示します。 デフォルトでは接続中のアカウントを対象とします。既定のラベルは「PQC key registered」と「No PQC key」です (safeLabel / unsafeLabel で上書きできます)。ルート要素は data-pqc-status と data-quantum-safe を持ち、 値は同じです。

<PqcStatusBadge />
<PqcStatusBadge address="qor1…" hideWhenUnsafe />

PqcStatusBadge はキット 0.11.0 で登場しました。QuantumSafeBadge(QuantumSafeBadgeProps と QuantumSafeRenderState を含む)は、同じコンポーネントの非推奨エイリアスとして引き続きエクスポートされているため、 既存のコードはそのまま動作します。

まとめて使う​

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>
)}
</>
);
}

実行可能な react-dapp サンプル と、基盤となる SDK 呼び出しについてはハイブリッド署名ガイドを参照してください。