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

FAQ とトラブルシューティング

メインネットは稼働していますか?​

はい。メインネットは稼働中です(チェーン ID qorechain-vladi、2026年6月7日から稼働)。 チェーンバージョンは v3.2.7 です(2026年11月12日に高さ 4,164,600 で適用、ガバナンス提案 16。v3.2.6 は2026年11月4日に高さ 4,020,000 で適用、提案 15。v3.2.5 は2026年10月29日に高さ 3,906,833 で、v3.2.4 は2026年10月23日に高さ 3,742,566 で適用)。テストネットは 2026年10月27日から v3.2.6、2026年11月6日から v3.2.7、2026年11月12日から v3.2.8 を実行しています(高さ 9,929,500。メインネットはまだ適用していません)。テストネットのプリセット (qorechain-diana)も引き続き利用できます。SDK 0.12.0 以降、どちらのプリセットも既定で 公開エンドポイントが設定されています。createClient({ network: "mainnet" }) でネットワークを 選択し、自分のノードを使う場合にのみ endpoints を上書きしてください。詳細は ネットワークとエンドポイント を参照してください。

呼び出しが localhost に向かってしまうのはなぜですか?​

0.12.0 より前の SDK を使用しています。その SDK のプリセットは既定で localhost のエンドポイントを使います。 アップグレードするか、endpoints オブジェクトを渡してください。0.12.0 以降では、createClient() と createClient({ network: "mainnet" }) は公開エンドポイントを使い、localhost を使うのは localnet プリセットです。

const client = createClient({
endpoints: {
rest: "https://api-testnet.qore.host",
rpc: "https://rpc-testnet.qore.host",
evmRpc: "https://evm-testnet.qore.host",
},
});

もし代わりに「endpoint ... is not configured for the mainnet preset」と表示される場合、その呼び出しには、公開プリセットが設定していない エンドポイント(gRPC、SVM RPC、メインネットの EVM WebSocket)が必要です。endpoints で渡してください。

署名経路(connectTx)にはコンセンサスの rpc エンドポイントが必要で、QoreChain Native の 読み取りもこれを使用します。REST の読み取りは rest を、EVM の呼び出しは evmRpc を使用します(qor_ 系の呼び出しも、その名前空間を提供するノードでは同様です)。 メインネットの URL は ネットワークリファレンス にあります。

"Cannot find module 'viem'" / "'@solana/web3.js'"​

これらはそれぞれ @qorechain/evm と @qorechain/svm の**ピア依存関係(peer dependencies)**です。 プロジェクトにインストールしてください。

npm i @qorechain/evm viem
npm i @qorechain/svm @solana/web3.js

プリコンパイル呼び出しが "returned no data" / "feature not present" を投げる​

QoreChain の EVM プリコンパイルはノードにコンパイルされていますが、メインネットでは有効化されておらず、 テストネットで有効なのは 3 つだけです。EVM モジュールの active_static_precompiles パラメータに アドレスが列挙されている場合にのみ応答します。そのリストはメインネットでは空で、テストネットでは PQC 検証(0x…0A01)、PQC 鍵ステータス(0x…0A02)、コンセンサスパラメータ(0x…0C01)の プリコンパイルが列挙されています(2026年10月27日に確認。テストネットのリストには 11月4日以降、および 2026年11月7日にも、クロス VM ブリッジ 0x…0901 が含まれており、許可リスト付きで有効です(eth_call でテスト済み)。メインネットのリストは依然として空でした)。そのため AI ペアは そこでも何も応答しません。プリコンパイルが無効な場所では、呼び出しは空のデータを返すため、 viem は returned no data ("0x") を報告し、ヘルパーは例外を投げます( EVM プリコンパイル: ネットワークの状況 を参照)。素の EVM ノードでも、呼び出しは同じように失敗します。 GET /cosmos/evm/vm/v1/params を確認し、各プリコンパイル呼び出しをラップして、 呼び出しごとにエラーを処理してください。

client.qor の呼び出しが -32601 で失敗します​

client.qor は qor_ JSON-RPC 名前空間を呼び出しますが、リリース済みのどのノードビルドも これを提供していません。公開 EVM エンドポイントの rpc_modules には eth、net、rpc、 txpool、web3 のみが列挙されます。代わりに REST ルートを使用してください。例えば GET /qorechain/pqc/v1/account/{address}(PQC 鍵のステータス)や GET /qorechain/burn/v1/stats を、client.rest.get(...) 経由で呼び出します。詳細は qor_ 名前空間 を参照してください。

金額が 100 万倍ずれています​

QOR の基本単位 uqor は 10^6 です。toBase / fromBase を使い、計算はすべて 基本単位で行ってください。

toBase("1.5"); // "1500000"
fromBase("1500000"); // "1.5"

なお、EVM ランタイムは QOR を 18 桁の小数(EVM の慣例)で表現します。これは Native の uqor 基本単位 10^6 とは別物です。

どのパッケージがどこで公開されていますか?​

すべて公開されています(2026年11月12日確認)。TypeScript コア(@qorechain/sdk、0.14.0)、 React キット(@qorechain/react、0.14.0)、create-qorechain-dapp スキャフォルダ (0.14.0。0.13.1 のテンプレート修正も含みます)、および EVM/SVM アダプタ(@qorechain/evm、@qorechain/svm、0.14.0)は npm で公開されています。Python クライアントは PyPI にあります(pip install qorechain-sdk、 バージョン 0.14.0、インポート名は qorsdk)。Go クライアントはモジュールプロキシにあります (go get github.com/qorechain/qorechain-sdk/packages/go@v0.14.0)。Rust クライアントは crates.io にあります(cargo add qorechain-sdk、0.14.0)。Java クライアントは Maven Central にあります(io.github.qorechain:qorechain-sdk、0.14.0、JDK 17 以降)。 言語ごとの完全なコマンドは インストール を参照してください。

ニーモニックが拒否されます​

SDK は鍵を導出する前に BIP-39 のワードリストとチェックサムの両方を検証するため、 タイプミスのあるフレーズは、誤ったアカウントを黙って生成する代わりに例外を送出します。 単語を再確認してください。フレーズのテストには validateMnemonic を使用できます。

ハイブリッド(PQC)トランザクション​

ハイブリッド(古典暗号 + ML-DSA-87)での送信は、Native 経路では稼働中かつ必須です — 古典暗号のみの Native トランザクションはオンチェーンで拒否されます(チェーン v3.2.0)。 ハイブリッド tx が PQC 検証を通過するには、署名者の PQC 公開鍵が事前に MsgRegisterPQCKeyV2(古典署名で行う、ハイブリッド署名が免除されたトランザクション)で 明示的に登録されている必要があります。公開鍵を拡張に埋め込んでも (includePqcPublicKey: true)登録されません。チェーンは初回利用時に鍵を登録することはありません。 TypeScript では、クライアントに鍵ペアを渡すと (client.connectTx(signer, { pqcKeypair })、SDK 0.9.0 以降)、そのクライアントが送信する すべてのトランザクションがハイブリッドで署名されます。 チェーンは hedged か決定的かにかかわらず、有効な FIPS-204 ML-DSA-87 署名をすべて受け入れます。 SDK は(0.5.1 以降)既定で決定的に署名するため、トランザクションの署名と tx ハッシュは常に同じになります。 ハイブリッド tx が pqc コード 21(hybrid_verify_failed)で失敗する原因は、sign-bytes のバージョン、 チェーン ID、古い PQC ライブラリ、または未登録もしくは別の鍵であり、hedged 署名が原因になることはありません。 両ネットワークとも v2 形式の sign-bytes を検証するため、SDK 0.8.1 以降(現行は 0.14.0)を使用し、 rest(または signBytesVersion)を渡してください。どちらも指定しない場合、ビルダーは qorechain-vladi / qorechain-diana で例外を送出します。詳細は コード 21 のトラブルシューティング と アカウントと PQC 署名 を参照してください。

EVM トランザクションが "no open EVM authorisation window" で拒否されます​

チェーン v3.2.0 以降、EVM レーンは、登録済みの PQC 鍵と開いている認可ウィンドウを持つ アカウントからのトランザクションのみを受け付けます。鍵を登録し、ウィンドウを開いてから 送信してください。詳細は EVM 認可ウィンドウ を参照してください。 SDK では、classifyEvmWindowRejection(err) が "no-pqc-key"、"no-window"、 "exhausted"、"invalid" のいずれかを返します。

ハイブリッドトランザクションが CheckTx で tx parse エラーになります​

SDK をアップグレードしてください。0.6.0 以前のバージョンは /qorechain.pqc.v1.PQCHybridSignature tx-body 拡張を JSON でシリアライズしており、 チェーンの tx デコーダは CheckTx でこれを拒否します。0.6.1 以降は、5 言語すべてで この拡張が protobuf エンコードされます(値は 0x08 で始まります)— 古いバージョンで 構築されたハイブリッドトランザクションは、すべてのレーン(eth-native を含む)で オンチェーンで拒否されます。

SDK はどのチェーンバージョンで動作しますか?​

SDK 0.12.0 は、チェーン v3.2.5(メインネットは2026年10月29日に高さ 3,906,833 で適用、 テストネットは 10月26日から)向けのクライアントリリースです。メインネットは v3.2.7 (11月12日から)、テストネットは v3.2.8(11月12日から。v3.2.7 は 11月6日から、v3.2.6 は 10月27日から)を実行しています。署名形式は v3.2.7 まで変わっていないため、0.12.0 はメインネットで動作します。0.12.0 には v3.2.7 の追加分(PQC マルチシグの登録、テキスト署名モード、APR、クラスター ID、検証鍵メッセージ)のビルダーはなく(これらは 2026年11月12日からメインネットにあります)、その署名経路は v3.2.7 に対して再確認していません。それらには CLI を使ってください。 ハイブリッドトランザクションの厳密なガスルール、ML-KEM 鍵レジストリのビルダーと読み取り、アカウント抽象化の読み取り、 検証付きのガバナンスパラメータビルダーが加わります(0.12.0 の追加内容 を参照)。 これは、0.10.0 が v3.2.4 向けに追加したもの(Staking Tier のビルダーと読み取り、fetchAuthNonce、 プロトコル機能の読み取り。0.10.0 の追加内容 を参照)、および 0.9.0 が v3.2.2 と v3.2.3 向けに追加したもの、すなわち登録時の任意の所有証明 (ネットワークが v3.2.3 を適用すると ensurePqcRegistered が自動的に付加します)、 スコープ付き EVM ウィンドウ、EIP-7702 同意メッセージ向けのビルダーに上乗せされています。 SDK 0.8.1 以降も両ネットワークでトランザクションを送信できます(v2 ハイブリッド sign-bytes 形式、登録、ハイブリッド送信、EVM ウィンドウは変更なしで動作します)が、それらのビルダーは ありません。それらには CLI を使用してください( 0.9.0 より前のバージョン を参照)。署名形式は v3.2.4、v3.2.5、v3.2.6 では変わっていません。メインネットは v3.2.7、テストネットは v3.2.8 を実行しています(テストネットは v3.2.5 を 2026年10月26日、 v3.2.6 を 10月27日、v3.2.7 を 11月6日、v3.2.8 を 11月12日に適用し、メインネットは v3.2.5 を 10月29日、v3.2.6 を 11月4日、v3.2.7 を 11月12日に適用)。SDK 0.10.0 と 0.9.0 はそれらでも引き続き動作しますが、 v3.2.5 の追加分(ML-KEM 鍵レジストリ、厳密なガスルール)のビルダーはありません。それらのリリースでは CLI を使うか、0.14.0 にアップグレードしてください。0.12.0 は v3.2.5 に対してビルドおよび検証されています。

PQC 鍵の登録が拒否されたのに手数料が引かれました​

すでに鍵を保持しているアカウントの登録は、手数料が差し引かれた後にチェーンによって拒否されます。 0.9.0 以降の ensurePqcRegistered は、まず GET /qorechain/pqc/v1/account/{address} を読み取り(rest を渡してください)、この鍵ペアの鍵が 登録済みであれば登録をスキップし、別の鍵が登録されている場合は PqcKeyMismatchError を投げます。 以前のリリースでは、自分で status: { registered: found }(found はそのルートから得た値)を 渡さない限り、最初に確認することはありませんでした。v3.2.3 以降、チェーンは弱い鍵、縮退した鍵、 再利用された鍵も拒否します。derivePqcCanonical または tx pqc gen-key で作成した鍵は問題ありません。

create-qorechain-dapp が署名できない SDK をインストールします​

スキャフォルダのバージョン 0.8.0 だけがそうでした。@qorechain/sdk と @qorechain/evm に ^0.3.0 の範囲を書き込み、0.x バージョンに対するキャレット範囲は 0.3 の内側にとどまります。 バージョン 0.9.0 以降は現行の SDK でスキャフォールドします。0.8.0 を使った場合は、スキャフォールド後に npm i @qorechain/sdk@latest(および @qorechain/evm@latest)を実行してください。

VERSION が 0.8.0 と表示されますが、0.8.3 をインストールしました​

0.8.3 のエクスポートされた VERSION 定数は更新されておらず、0.8.0 と報告します。0.9.0 以降は パッケージと一致します。それ以前のリリースでは、インストール済みのバージョンを package.json から 読み取ってください。

authenticator による支出が authenticator_replay で拒否されます​

(abstractaccount モジュールはメインネットでは無効化されています。そこでの支出は、 nonce が確認される前に abstract account module is disabled で拒否されます。 テストネットでは有効です。 Authenticator と委任支出 を参照してください。 以下の説明は、モジュールが有効化されている場所で適用されます。)

nonce が誤っています。MsgExecuteEVM.nonce と MsgExecuteCosmos.nonce はどちらも、 (account, pubkey) に対するリンク済みキーの authenticator シーケンスです。これはチェーンが リンク済みキーごとに保持するカウンターで、0 から始まり、実行が成功するたびに加算されます。 これはアカウントの EVM nonce ではありません。fetchAuthNonce(SDK 0.10.0 以降、チェーン v3.2.4 以降)で取得するか、古いバージョンではリンク済みキーごとに自分で追跡してください。v3.2.3 以降、EVM レーンは evmAuthSignBytesV2 にも署名します。これは呼び出しのガスリミットを束縛します (resolveEvmAuthDigestVersion が形式を選びます)。そのキーについて取得した(または追跡している)カウンターを使って、 署名し直してください。

その他の authenticator 失敗は decodeTxError でデコードできます: abstractaccount コード 5(spending_limit_exceeded)、6(session_key_expired)、 10(permission_denied)。詳細は Authenticator と委任支出 を参照してください。