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

QoreChain SDK

QoreChain SDK は、ハイブリッド ML-DSA-87(FIPS 204)署名を備えたトリプル VM の Layer 1 ネットワークである QoreChain 上で分散型アプリケーションを構築するための、 公式の多言語対応開発者キットです。

このドキュメントでは、SDK のインストール方法、ネットワークへの接続、 オンチェーン状態の読み取り、アカウントの導出、トランザクションの署名と送信、 そして QoreChain の各仮想マシンの扱い方を説明します。

QoreChain とは?​

QoreChain は、単一のチェーン上に 3 つのファーストクラスなスマートコントラクト ランタイムを備えた Layer 1 ブロックチェーンです。

  • QoreChain Native — Cosmos SDK による Wasm スマートコントラクト(CosmWasm ランタイム)。
  • QoreChain EVM Engine — Ethereum 互換の実行環境(Solidity、viem、 標準 JSON-RPC)。
  • SVM — Solana スタイルの JSON-RPC を備えた Solana 互換ランタイム。

アカウント、残高、トークンはランタイム間で共有され、チェーンにはクロスチェーン 相互運用性のための IBC モジュールが含まれています(メインネットでは IBC チャネルは 開かれていません。テストネットには、テスト用チェーンへの transfer チャネルが 1 本開かれています。2026年10月27日に確認)。

現在ライブネットワークで動作するもの(メインネットは v3.2.7、テストネットは v3.2.8)

動作するもの: すべてのレーンでの読み取り、ハイブリッド署名されたネイティブトランザクション、統合 アカウント、認可ウィンドウ内での EVM トランザクション、 SVM の読み取り。 まだ利用できないもの: メインネットの EVM プリコンパイル(メインネットではどれも有効ではありません。テストネットでは PQC 検証、PQC 鍵ステータス、コンセンサスパラメータの 3 つが有効で、AI の 2 つとクロス VM ブリッジは両方のネットワークで無効です)、qor_ JSON-RPC 名前空間、SVM トランザクション、メインネットでのクロス VM 呼び出し(MsgCrossVMCall は サーキットブレーカーによって停止されています)、通常のアカウントによる QoreChain Native のアップロードとインスタンス化(テストネットではインスタンス化は開放されていますが、アップロードは開放されていません)、 メインネットでのオーセンティケーター/抽象アカウントのフロー(メインネットではモジュールは停止中で、テストネットでは有効)、xQORE、 ガスアブストラクション。各ガイドでは、該当する箇所で改めて注意点を示しています。 2026年10月27日にライブエンドポイントに対して確認しました。2026年11月7日の時点で、メインネットの有効なプリコンパイルのリストは依然として空で、テストネットのリストにはクロス VM ブリッジ 0x…0901 も含まれていました(許可リスト付きで有効。読み取り専用の eth_call を 2026年11月7日にテストしました)。

公開されている SDK(0.14.0、2026年11月12日)は、両ネットワークが検証する形式 (チェーンの状態から解決される v2 ハイブリッド sign-bytes)で署名します。署名形式、 アドレス、小数桁数、メモ、手数料は v3.2.3、v3.2.4、v3.2.5、v3.2.6 のいずれでも変わっていません(メインネットは 2026年11月12日から v3.2.7 を実行しており(高さ 4,164,600、ガバナンス提案 16。その前は 11月4日の v3.2.6)、 テストネットは 10月27日から、そして 11月6日からは v3.2.7 を、11月12日からは v3.2.8 を実行しており、これらは SDK 0.14.0 にビルダーのあるメッセージを追加します。テストネットの新しいルールは v3.2.8 から適用され、メインネットはまだ適用していません。v3.2.7 のメッセージは 2026年11月12日からメインネットにあります)。 後続のポスト量子ルールに対するクライアント側(鍵登録時の所有証明、スコープ付き EVM ウィンドウ、 EIP-7702 の同意メッセージ)と、v3.2.4 に対するクライアント側(ステーキングティア、 オーセンティケーターのノンス、プロトコル機能スイッチ)と v3.2.5(ハイブリッドトランザクションの厳密なガス、ML-KEM 鍵レジストリ)に対応していますが、0.9.0 より前のバージョンは 前者のグループに対応していません。0.9.0 より前のバージョン、 0.12.0 の新機能、0.13.0 の変更点、および0.14.0 の変更点を参照してください。

ウォレットとバックエンドの署名については、QoreSignを参照してください。

ハイブリッド ML-DSA-87 署名​

QoreChain は、ML-DSA-87(Dilithium-5、FIPS 204)に基づくポスト量子暗号 (PQC)プリミティブを提供します。従来の secp256k1 署名に加えて、チェーンは 1 つのトランザクションが従来型署名とポスト量子署名の両方を持つ ハイブリッド署名方式をサポートしており、現時点では従来型の検証で有効性を 保ちながら、ポスト量子的な保護も同時に得られます。

SDK は現在、ML-DSA-87 の鍵生成、署名、検証に加え、ハイブリッドトランザク ションの構成要素を提供しています。ライブネットワークでは、ネイティブパスの トランザクションはハイブリッド署名されていなければならず、アカウントの ML-DSA-87 鍵を事前に登録しておく必要があります。詳細は アカウントと PQC 署名 を参照してください。 ここにマーケティング上の誇張はありません — SDK はチェーンが実装している プリミティブをそのまま公開しています。

この SDK が他と違う点​

完全なマルチチェーン同等性に加えて、3 つの機能は QoreChain でのみ実現可能 です。これらは、他のどの Layer 1 にも存在しないプロトコル機能の上に構築されて いるためです。

  • AI プリフライトリスクスコアリング — ブロードキャストの前に、オンチェーン AI でトランザクションをスキャンします。simulateWithRiskScore は、決定論的な EVM プリコンパイルによるリスク/異常判定とガスの両方を返すため、ウォレットや dApp は署名の前に警告(またはブロック)できます。AI プリコンパイルはメインネットでも テストネットでもまだ有効ではありません。 AI プリフライト を参照してください。
  • 統合クロス VM 呼び出し — 1 つのアカウント、3 つの VM、1 つのトランザク ション。createCrossVMClient は任意の VM 上のコントラクトを呼び出し、 callAtomic は複数のクロス VM 呼び出しを一度の署名で 1 つのアトミックな トランザクションにまとめます。 クロス VM 呼び出し を参照してください。
  • ハイブリッド署名の開発者体験(DX) — 冪等な 1 回の呼び出し (ensurePqcRegistered / migrateToHybrid)でサイナーの ML-DSA-87 鍵を 登録でき、そのまま使える React バッジも付属します。 ハイブリッド署名 を参照してください。

さらに、0.6.0 と 0.7.0 では 2 つのチェーンレベルの機能が追加されました (後者はライブネットワークではまだ使用できません。以下を参照)。

  • 統合 eth ネイティブアカウント — 1 つの eth_secp256k1 鍵が 1 つの 20 バイトのアイデンティティとなり、qor1…、0x…、SVM の base58 アドレス として表現され、すべてが 1 つの残高を共有します。 統合アカウント を参照して ください。
  • オーセンティケーターレーン — Phantom または MetaMask の鍵を、PQC 必須の 正規アカウントにリンクし、最小権限・支出制限付き・取り消し可能な条件のもと、 リレイヤー経由で支出できるようにします。その背後にある abstractaccount モジュールは、メインネットでは停止されており、テストネットでは有効です。 オーセンティケーターと委任支出 を参照して ください。

新しい @qorechain/react キット(プロバイダー、フック、ConnectButton、 PqcStatusBadge)により、ハイブリッド ML-DSA-87 署名を備えた dApp の構築が標準の開発パスになります — React キットガイド を参照してください。全体像については QoreChain SDK を選ぶ理由 をお読みください。

SDK ファミリー​

SDK は、好みの言語で開発できるようにパッケージファミリーとして提供されます。 これらは同じネットワークプリセット、導出スキーム、デノミネーション計算、 読み取りインターフェースを共有しています。

パッケージ言語インストールステータス
@qorechain/sdkTypeScriptnpm i @qorechain/sdk公開済み(npm、v0.14.0)
qorechain-sdkPythonpip install qorechain-sdk(インポートは qorsdk)公開済み(PyPI、v0.14.0)
qorechain-sdk(Go モジュール)Gogo get github.com/qorechain/qorechain-sdk/packages/go/...公開済み(Go proxy、タグ packages/go/v0.14.0)
qorechain-sdkRustcargo add qorechain-sdk(インポートは qorechain)公開済み(crates.io、v0.14.0)
io.github.qorechain:qorechain-sdkJavaio.github.qorechain:qorechain-sdk:0.14.0公開済み(Maven Central、v0.14.0。JDK 17 以降)
@qorechain/evmTypeScript(EVM アダプター)npm i @qorechain/evm viem公開済み(npm、v0.14.0)
@qorechain/svmTypeScript(SVM アダプター)npm i @qorechain/svm @solana/web3.js公開済み(npm、v0.14.0)
@qorechain/reactTypeScript(React キット)npm i @qorechain/react公開済み(npm、v0.14.0)
create-qorechain-dappCLInpm create qorechain-dapp公開済み(npm、v0.14.0)

Python ディストリビューションは qorechain-sdk としてインストールされますが、 インポート名は qorsdk です。すべてのクライアントは各レジストリに公開 されています — 言語ごとのコマンドは インストール を参照して ください。

このドキュメントの例は TypeScript コア(@qorechain/sdk)を基準にしています。 Python、Go、Rust、Java の各クライアントは、TypeScript との完全なネイティブ チェーン同等性を実現しています。すなわち、ネットワークプリセット、denom/ アドレスユーティリティ、HD アカウント導出(native/EVM/SVM)、PQC(ML-DSA-87) 署名、すべてのカスタムモジュールおよび標準 Cosmos モジュールに対応した型付き メッセージコンポーザー、型付きクエリクライアント、完全なトランザクション ライフサイクル(自動ガス、エラーデコード、tx 追跡、ブロック/tx 検索)、 ハイブリッドポスト量子トランザクション、そして WebSocket サブスクリプション です。これらのクライアントはすべて公開済みです。TypeScript は npm (@qorechain/sdk 0.14.0)、Python は PyPI(qorechain-sdk 0.14.0、インポート は qorsdk)、Go はモジュールプロキシ(タグ packages/go/v0.14.0)、Rust は crates.io(qorechain-sdk 0.14.0)、Java は Maven Central(io.github.qorechain:qorechain-sdk 0.14.0)に公開されています。 EVM/SVM 実行アダプター(@qorechain/evm、@qorechain/svm、いずれも 0.14.0)、 @qorechain/react キット(0.14.0)、および create-qorechain-dapp スキャフォールディング CLI(0.14.0。0.13.1 のテンプレート修正も含みます)は TypeScript 専用で、同様に npm に公開 されています。関連パッケージについては インストール を参照してください。

0.6 から 0.14 の新機能​

0.6.0 — 統合 eth ネイティブアカウント(チェーン v3.1.83)。 1 つの eth_secp256k1 鍵が 1 つの 20 バイトのアイデンティティとなり、3 つすべての アドレスエンコーディングとして表現され、すべてのレーンで 1 つの利用可能残高を 共有します。

import { deriveUnifiedAccount } from "@qorechain/sdk";

const account = await deriveUnifiedAccount(mnemonic);
account.cosmos; // "qor1…" (bech32, Native lane)
account.evm; // "0x…" (EIP-55, EVM lane)
account.svm; // base58 (20 bytes + 12 zero bytes)

同じ鍵によるネイティブレーンの署名は signClassicalEth / signHybridEth で、 Phantom や MetaMask の鍵はオーセンティケーターとしてアカウントにリンクします (Phantom 署名からの導出は 0.8.0 で削除されました)。従来のコインタイプ 118 の deriveNativeAccount は 変更ありません。 統合アカウント を参照して ください。

0.6.1 — コンセンサスに関わる重要な修正。 PQCHybridSignature tx-body 拡張は protobuf エンコードになりました(以前は JSON エンコードで、CheckTx で 拒否されていました)。SDK 0.6.0 以前で構築されたハイブリッドトランザクションは オンチェーンで拒否されます — アップグレードしてください。

0.7.0 — オーセンティケーターレーン(チェーン v3.1.85)。 その背後にある abstractaccount モジュールは、現在メインネットでは停止されており、テストネットでは有効です (オーセンティケーターガイド を参照)。リンクされた Phantom(ed25519)または MetaMask(secp256k1、20 バイトアドレス指定)の鍵が、 最小権限・支出制限付き・取り消し可能な条件のもと、リレイヤーを通じて PQC 必須 の正規アカウントから支出できます。すなわち、MsgExecuteEVM / MsgExecuteCosmos / MsgRotatePQCKey コンポーザー、バイト単位で正確な evmAuthSignBytes / cosmosAuthSignBytes / rotationSignBytes ヘルパー、 permissionSchema クエリ、デコード済みエラーコード、そして TypeScript ウォレットビルダー(buildPhantomExecuteCosmos、buildMetaMaskExecuteEvm など)が提供されます。コピー&ペースト可能な例を含む完全なウォークスルーは、 オーセンティケーターと委任支出 を参照して ください。

0.8.0 – 0.8.3 — v2 ハイブリッド sign-bytes と EVM 認可ウィンドウ(チェーン v3.2.0)。 ハイブリッドトランザクションのポスト量子側の署名は、対象ネットワークが 検証する形式(v1 または v2、signBytesVersion: "auto" | "v1" | "v2")で署名される ようになりました。両方の公開ネットワークは v2 であるため、メインネットで トランザクションを実行するには SDK 0.8.1 以降が必要です(現行リリースを使用してください)。0.8.2 は、EVM レーンの 認可ウィンドウ向けに openEvmWindowMsg、closeEvmWindowMsg、 fetchEvmWindow、classifyEvmWindowRejection を追加します。 0.8.0 は、ウォレット署名によるアカウントヘルパー(connectPhantomUnified と unifiedAccountFromPhantomSignature、0.8.0 で削除)を削除し、すべての言語で厳格な ML-DSA-87 サイズチェックを適用し、クロス VM 呼び出しに async フラグと呼び出し先データの返却を追加します。 0.8.3 は、tx 検索、React フックの競合状態、Python の migrate_to_hybrid のシーケンス処理、およびアドレス形式に依存しない正規の PQC 導出(derivePqcCanonical、canonicalAccount)を修正します。 アップグレードノート を参照してください。

0.9.0 — チェーン v3.2.2 および v3.2.3 に対するクライアントサポート。 アカウントの鍵ペアを渡すと、 TypeScript の TxClient はハイブリッド署名を行うため (client.connectTx(signer, { pqcKeypair }))、bankSend や SDK のロールアップ、 マルチレイヤー、クロス VM の各クライアントが公開ネットワークで動作します。ensurePqcRegistered は、 まず REST で登録済みの鍵を確認し、別の鍵を 2 つ目として登録することを拒否し、 ネットワークが v3.2.3 を適用した後は所有証明を自動的に添付します。新しいビルダーが、スコープ付き EVM ウィンドウ(nativeOnly、allowedTargets)と EIP-7702 の同意メッセージに対応し、derivePqcCanonical(address, mnemonic) は、 すべての言語でニーモニックから復元できる鍵を提供します。PQC アカウントのルートは 単数形の /qorechain/pqc/v1/account/{address} で、ブロック内での失敗はコードスペースを保持し、 create-qorechain-dapp は現行の SDK でスキャフォールドします。 0.9.0 で追加された内容を参照してください。

0.10.0 — チェーン v3.2.4 に対するクライアントサポート。 ステーキングティアのコンポーザーと読み取り (lockDelegation、unlockEarly、claimBonus、fetchStakingTierParams、 fetchStakingLocks)、リンクされた鍵の次のシーケンスを取得する fetchAuthNonce、 ネットワークが名前で強制するコンセンサスルールを調べる fetchProtocolFeatures / isProtocolFeatureEnabled、PQC ステータスの possessionProven、 そして ibcTimeoutTimestamp です。ensurePqcRegistered は、鍵のないステータスを 信用する代わりに、登録済みの鍵を比較するようになり、手数料シミュレーション中に テキストとして届くチェーンの拒否は、すべての言語で名前が付けられます。 0.10.0 で追加された内容を参照してください。

0.12.0 — チェーン v3.2.5 に対するクライアントサポート。 mainnet と testnet のプリセットは 既定で公開エンドポイントを使うようになりました(チェーン ID qorechain-devnet の localnet プリセットが 従来の localhost のポートを維持します)。ハイブリッドトランザクションの "auto" 手数料は、 v3.2.5 を適用したネットワークでは厳密なガスルール(ceil(simulated x 1.02) + 2000。 ハイブリッドの bank 送信で約 289,000 ではなく約 171,600 のガス)を使います。ML-KEM-1024 鍵レジストリには コンポーザー(msg.pqc.registerKemKey、msg.pqc.removeKemKey)と読み取り(fetchKemKey)があり、 メインネットで応答します。アブストラクトアカウントの支出ルールとリンク済みキーの読み取りに加え、 クロス VM とロールアップのパラメータ提案向けの検証付きビルダーもあります。 チェーン開発者キット(EVM と QoreChain Native のテンプレート、両ネットワーク向けの viem チェーン)も含まれます。 npm 以外には 0.11.0 はなく、他の言語は 0.10.0 から 0.12.0 に移行しました。 0.12.0 の新機能を参照してください。

0.13.0 — シードパスのアカウントヘルパーの変更が 1 つ。 unifiedAccountFromSeed と他の言語での 同等のヘルパーには、QRC1 のリカバリーコードまたは独立した 32 バイトの PQC シークレットが必要に なりました。ニーモニックから導出したアカウント、署名形式、チェーンの動作は変わりません。 リカバリーコードのヘルパーがすべての言語に追加され、migrateToHybrid は keyVerified を報告します。 0.13.0 の変更点を参照してください。

0.14.0 — チェーン v3.2.8 のクライアントサポート。 鍵のリンクには所有証明が必要になり、価値を動かす鍵には支出ルールが必要になり(ヘルパーがその組を構築します)、ガバナンスのパラメーター更新にはすべてのフィールドが必要になり、失敗した認可済みの実行を読み取れるようになり、EVM ウィンドウにはリストが 3 つ追加されました。新しいルールは、ネットワークが v3.2.8 を実行した時点から適用されます。テストネットは 2026年11月12日から実行しており、メインネットはまだ適用していません。 0.14.0 の変更点を参照してください。

次に読むもの​