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

ロールアップ概要

QoreChain の Rollup Development Kit (RDK) は、クライアントライブラリ(TypeScript、Python、Go、Rust、Java)、オペレーター向けコマンドラインツール、スターターテンプレートからなるセットで、オンチェーンの x/rdk モジュールを通じて QoreChain 上で決済されるアプリケーション固有のロールアップを構築するためのものです。これを使うと、ロールアップの設定、トランザクションの構築と署名、状態の読み取り、チャレンジウィンドウの追跡、決済レシートの発行と検証、クロス VM 呼び出しと出金証明の組み立てができます。各ロールアップは独自のブロックタイム、仮想マシン、手数料モデル、シーケンシングを持つ独立した実行環境でありながら、QoreChain のセキュリティ、ポスト量子暗号、データ可用性を継承します。このページは、ロールアップを起動または運用したい開発者、そして RDK が自分のアプリケーションに合うかどうかを検討している方向けです。

初期段階の機能

RDK は両方のネットワークにデプロイされていますが、どちらのネットワークでもまだロールアップは作成されていないため(2026年10月27日に確認)、このセクションで説明するフローは第三者によってまだ検証されていません。ZK 決済(defi プロファイル、defi-rollup テンプレート、すべての zk ロールアップ)は、どちらのネットワークでもまだ試されていません。 検証鍵メッセージは、メインネットではチェーン v3.2.7(2026年11月12日)から、テストネットでは 2026年11月6日から有効になっています(ZK / STARK と出金を参照)が、ZK ロールアップはまだ作成されていません。ZK ロールアップがエンドツーエンドで実行されるまでは optimistic 決済を使用してください。

メインネット(qorechain-vladi、EVM チェーン ID 9801、2026年6月7日から稼働)は、チェーンバージョン v3.2.7(ガバナンス提案 16 により 2026年11月12日に高さ 4,164,600 で適用。v3.2.6 は 2026年11月4日に高さ 4,020,000 で提案 15 により適用済み。v3.2.5 は 2026年10月29日に高さ 3,906,833 で提案 14 により、v3.2.4 は 2026年10月23日に高さ 3,742,566 で提案 13 により適用)で稼働しています。テストネット(qorechain-diana、EVM チェーン ID 9800)は 2026年11月12日から v3.2.8 で稼働しています(高さ 9,929,500。v3.2.4 は 2026年10月19日、v3.2.5 は 10月26日、v3.2.6 は 10月27日、v3.2.7 は 11月6日に到達)。メインネットはテストネットより 1 リリース遅れており、v3.2.8 は適用していません。v3.2.5 がロールアップに与える変更はチェーン v3.2.5 の挙動にまとめており、両方のネットワークに適用されます。v3.2.3 と v3.2.4 の間で挙動が変わった箇所では、このセクションでどちらのリリースが適用されるかを示します。すべてのデプロイはまずテストネットで検証し、各ページのステータスに関する注記を読んでください。いくつかの機能(ZK 検証、Celestia データ可用性、QCAI Copilot、クロス VM 呼び出し、決済レシート)は、現時点ではエンドツーエンドで利用できません。

革新点​

  • ポスト量子決済レシート。 バッチの状態アンカーは、ロールアップ作成者の登録済み鍵によって ML-DSA-87 で署名されます。verifySettlementReceipt は、レシートのすべてのフィールド(ロールアップ、レイヤー、バッチルート、そしてアンカー: 状態ルート、レイヤーの高さ、メインチェーンの高さ、アンカー時刻、バリデータセットのハッシュ、トランザクション数、証明、署名)をチェーンから読み直します。検証鍵はチェーンから取得され、レシートからは決して取得されません。レシートは、クエリするネットワークを指定していなければなりません。未知のレシートバージョンや ML-DSA-87 以外のアルゴリズムは、読み取りの前に拒否されます。署名のみのチェックが有効と報告されることはありません。アンカーのメッセージには、チェーン v3.2.2 の高さより下で使われる第一の形式と、それ以降で使われる(チェーン ID も束縛する)第二の形式があり、どちらを使うかはアンカーの高さによって決まります。決済レシートを参照してください。
  • 2 種類の鍵導出によるハイブリッド署名。 トランザクションは secp256k1 と ML-DSA-87 で署名されます。ポスト量子鍵は、ニーモニックから正規の方法(qorechain:pqc:v1|、アドレス、ニーモニックに対する SHAKE-256)とレガシーな方法の両方で導出され、クライアントはチェーンがそのアカウントに登録している鍵を使用します。Python、Go、Rust、Java のクライアントは 0.8.0 から、CLI は 0.7.1 からハイブリッド署名を行います。それ以前は TypeScript クライアントだけが対応していました。
  • 正規のトランジションルート。 batchTransitionRoot は、チェーンがオプティミスティックバッチを判定する際の正確な状態ルートを計算します(メインネットが現在適用している形式は、前の状態ルート、データハッシュ、トランザクション数に対する SHAKE-256 コミットメントです。transitionRootVersionFor は接続先ネットワークが適用する形式を選択します)。fraudProof はそこから 64 バイトの証明を構築します。どちらも、チェーン自身のコードが生成したベクターに対してテストされています。
  • チェーンが構築するとおりに構築される出金証明。 withdrawalsTree(0.7.0、5 言語すべて)は、バッチの出金ルートとすべての証明をチェーンとまったく同じように構築します。リーフの位置は出金インデックスで、ノードは SHAKE-256 でハッシュされ、チェーン v3.2.5 のバッチはチェーン ID も含む第二の形式のリーフを使います。チェーン自身のコードが生成したベクターに対してテストされており、そのベクターのすべての証明がチェーンの検証器に受理されています。qorollup withdraw は、その結果がバッチのオンチェーンの withdrawals_root と一致しない場合、手数料を支払う前に拒否します。
  • チェーンと同一のチャレンジウィンドウ。 batchChallengeWindow は、チェーンと同じ方法でバッチのウィンドウを計算し(時間ベース: ブロックタイムが提出時刻にウィンドウを加えた値を下回る間は開いています。古いバッチでは、提出高さからのブロック数でウィンドウを 6 で割った値)、ローカルの時計ではなく RPC /status から読み取ったチェーンの先頭に対して判定します。ウォッチタワーとヘルスモニターがこれを使用します。0.7.0 以降、getRollupHealth は、チェーンの順序どおりのファイナリティ(v3.2.5、両ネットワーク、チェーン v3.2.5 の挙動を参照)がバッチを保留している場合に heldBackBy も報告し、qorollup watchtower --canonical は、チャレンジが成功するバッチを報告します。
  • 手数料を支払う前のチェック。 キットは、^[a-z0-9][a-z0-9._-]{2,63}$ に合致しないロールアップ ID、uqor 以外の出金、金額がゼロの出金、32 バイトの 64 階層を超える証明を持つ出金、無効な bech32 アドレスを指定する出金、空でも正確に 32 バイトでもない出金ルート、チェーンが拒否するロールアップの停止(v3.2.5 以降)を拒否します。また、ロールアップを読み取れる場合は、データ可用性が native または both のロールアップでデータハッシュを指定するバッチも拒否します。これらはいずれも、そのままでは手数料が消費された後にチェーンによって拒否されます。
  • クロス VM のコールデータとライブチェック。 encodeCrossVmCalldata は executeCrossVMCall(uint8,string,bytes)(セレクタ 0x3c11078c、プリコンパイル 0x...0901)のコールデータを構築し、isCrossVmPrecompileActive はそのプリコンパイルがネットワーク上で有効かどうかを読み取ります。0.7.0 以降、getCrossVmParams、crossVmTargetReady、decodeCrossVmResult、decodeRevertReason が、チェーン v3.2.5 の許可リストと応答形式(両ネットワーク)に対応します。マルチ VMを参照してください。
  • 5 つの言語に共通する 1 組のテストベクター。 TypeScript、Python、Go、Rust、Java のパッケージは、同じゴールデンフィクスチャに対してチェックされています(Go パッケージには 100 件、Rust には 77 件、Java には 75 件のユニットテストがあります)。

使い方​

読み取りには鍵も資金も不要です。以下のスニペットは、公開テストネット(qorechain-diana)の稼働中の rdk モジュールパラメータとロールアップ一覧を読み取るもので、2026年10月27日に公開済みパッケージから実行しました(これらの実行は 0.7.0 を使用しました。現在のバージョンは 0.9.0 です。0.8.0 は Python、Go、Rust、Java のクライアントにハイブリッド署名を追加しましたが、ここに示した読み取り呼び出しは変わりません。ただし、スニペットは 0.8.0 以降では再実行していません)。いずれもテストネットのパラメータ(ロールアップ最大数 200、最小ステーク 10,000 QOR、作成時バーン率 0.01、デフォルトのチャレンジウィンドウ 3,600 秒、DA ブロブの最大サイズ 2,097,152 バイト、ブロブ保持期間 432,000 ブロック、1 ブロックあたり最大 10 バッチ)と 0 rollups を出力しました。

TypeScript(検証済み)​

npm install @qorechain/rdk
import { createRdkClient } from "@qorechain/rdk";

// Public testnet (chain id qorechain-diana).
const rdk = createRdkClient({
network: "testnet",
endpoints: { rest: "https://api-testnet.qore.host" },
});

// Read the live rdk module parameters and the registered rollups.
const params = await rdk.params();
const rollups = await rdk.rest.listRollups();
console.log(rdk.network.chainId, params, `${rollups.length} rollups`);

mainnet と testnet のプリセットには公開の qore.host エンドポイントがすでに組み込まれているため、createRdkClient({ network: "testnet" }) は endpoints フィールドなしでも動作します。上記では、検証したスニペットがそれを渡していたため記載しています。Node 20 以降で実行してください(検証には Node 26 を使用しました)。

Python(検証済み)​

pip install qorechain-rdk
from qorrdk import create_rdk_client

# Public testnet (chain id qorechain-diana).
rdk = create_rdk_client(network="testnet", endpoints={"rest": "https://api-testnet.qore.host"})

# Read the live rdk module parameters and the registered rollups.
params = rdk.params()
rollups = rdk.rest.list_rollups()
print(rdk.network.chain_id, params, f"{len(rollups)} rollups")

Python 3.10 以降。qorechain-rdk は qorechain-pqc に依存し、これが liboqs-python を取り込むため liboqs ライブラリが必要です。インストールされていないマシンでは、最初のインポート時にビルドされます(git、CMake、C コンパイラが必要です)。新規の仮想環境で Python 3.12 を使って検証しました。

Go(検証済み)​

go get github.com/qorechain/qorechain-rdk/packages/go@v0.9.0
package main

import (
"context"
"fmt"

rdk "github.com/qorechain/qorechain-rdk/packages/go"
)

func main() {
// Public testnet (chain id qorechain-diana).
client := rdk.NewRdkClient(rdk.RdkClientOptions{
Network: "testnet",
Endpoints: &rdk.Endpoints{Rest: "https://api-testnet.qore.host"},
})
ctx := context.Background()
// Read the live rdk module parameters and the registered rollups.
params, err := client.Params(ctx)
if err != nil {
panic(err)
}
rollups, _ := client.Rest.ListRollups(ctx)
fmt.Printf("%s %+v %d rollups\n", client.Network.ChainID, params, len(rollups))
}

Go 1.26 で検証し、モジュールは Go プロキシから取得しました。

Rust(検証済み)​

cargo add qorechain-rdk
use qorechain_rdk::client::{RdkClient, RdkClientOptions};

fn main() -> Result<(), Box<dyn std::error::Error>> {
// Public testnet (chain id qorechain-diana).
let rdk = RdkClient::new(RdkClientOptions {
rest_url: Some("https://api-testnet.qore.host".into()),
..Default::default()
});

// Read the live rdk module parameters and the registered rollups.
let params = rdk.params()?;
let rollups = rdk.rest.list_rollups()?;
println!("{} {:?} {} rollups", rdk.network.chain_id, params, rollups.len());
Ok(())
}

ライブラリ名は qorechain_rdk です。Rust 1.95 で検証し、crates.io に対してビルドしました。

Java(検証済み)​

// build.gradle.kts
implementation("io.github.qorechain:qorechain-rdk:0.9.0")
import io.github.qorechain.rdk.client.RdkClient;
import io.github.qorechain.rdk.client.Views.ParamsView;
import io.github.qorechain.rdk.config.Networks;

public class RdkQuickstart {
public static void main(String[] args) {
// Public testnet (chain id qorechain-diana).
RdkClient.Options options = new RdkClient.Options();
options.network = "testnet";
options.endpoints = new Networks.Endpoints();
options.endpoints.rest = "https://api-testnet.qore.host";
RdkClient rdk = new RdkClient(options);

// Read the live rdk module parameters and the registered rollups.
ParamsView params = rdk.params();
int rollups = rdk.rest.listRollups().size();
System.out.println(rdk.network.chainId + " maxRollups=" + params.maxRollups
+ " minStakeForRollup=" + params.minStakeForRollup + " " + rollups + " rollups");
}
}

Java 21 以降(0.8.0 から。0.7.1 以前は JDK 17 で動作しました)。JDK 21 と、Maven Central から解決する Gradle 9.6 で検証しました。ファイル名は RdkQuickstart.java にする必要があります。Maven Central は 0.7.0、0.7.1、0.8.0 を提供しています(2026年10月31日に確認)。

コマンドライン(検証済み)​

npm install -g @qorechain/rdk-cli
qorollup --version
qorollup params --network testnet

qorollup --version はインストールされているバージョンを出力し(テスト実行では 0.7.0)、qorollup params --network testnet は稼働中のモジュールパラメータを出力します。これは 0.6.2 から動作します。 0.6.1 以前のリリースは、npm からインストールすると終了コード 0 で何も出力しませんでした。検証では、空のプロジェクトに @qorechain/rdk-cli@0.7.0 をインストールし、node_modules/.bin/qorollup 経由で実行しました。グローバルインストールと npx も同じ bin リンクを使用します。Node 20 以降が必要です。

プロジェクトのスキャフォールド(検証済み)​

npx create-qorechain-rollup my-rollup --template nft-rollup --network testnet --yes
cd my-rollup && npm run doctor

テンプレートは defi-rollup、gaming-rollup、nft-rollup、enterprise-rollup、custom-rollup、multivm-rollup です。スキャフォールドされたプロジェクトは @qorechain/rdk ^0.9.0 に依存します(0.8.0 では ^0.8.0、それより前は ^0.7.0)。0.6.1 のスキャフォルダーで nft-rollup をスキャフォールドして生成されたプロジェクトの npm run doctor は、テストネットに対して成功しました(REST に到達可能、パラメータを読み取り可能、ネットワークは qorechain-diana。Celestia データ可用性と署名者の欠如について警告が出ます)。defi-rollup をスキャフォールドして npm run typecheck を実行した場合も、2026年10月27日に現行リリースで再び成功しました。まだ defi-rollup を使ってロールアップを起動しないでください(制限を参照)。ロールアップを作成してバッチを提出するには、ロールアップのデプロイに従ってください。トランザクションには登録済みのポスト量子鍵が必要で、RDK では TypeScript クライアントに pqcKeypair を渡す必要があります。

アクセス方法​

ネットワークとエンドポイント。 RDK は 2 つのネットワークの公開エンドポイントと通信します。mainnet と testnet のプリセットにはそれらがすでに組み込まれています。

ネットワークチェーン IDEVM チェーン IDREST エンドポイントチェーンバージョン
メインネットqorechain-vladi9801https://api.qore.hostv3.2.7
テストネットqorechain-diana9800https://api-testnet.qore.hostv3.2.8

どちらのネットワークも RDK クエリ(/qorechain/rdk/v1/...)を REST、gRPC、CLI で提供しているため、rdk.params() のような読み取りはどちらに対しても機能します。テストネットは独自のパラメータを持つステージングネットワークです。デフォルトのチャレンジウィンドウはテストネットで 3,600 秒、メインネットで 604,800 秒、存在できるロールアップはテストネットで最大 200、メインネットで 100、マルチレイヤーモジュールが許可するサイドチェーンレイヤーはテストネットで 64、メインネットで 10 です(2026年10月27日に確認)。対象とするネットワークの GET /qorechain/rdk/v1/params を読み取ってください。

ロールアップを作成するための前提条件。

要件詳細
資金のあるアカウントステーク、レイヤーステーク、手数料に十分な QOR を持つアカウント。
エスクローされるステークロールアップの作成により、min_stake_for_rollup、つまり両ネットワークで 10,000 QOR がエスクローされます。作成時にステークの 1 %(100 QOR)がバーンされ、残りはエスクローに留まり、ロールアップが停止されたときに返還されます。
レイヤーステーク作成時には、ロールアップのレイヤーもマルチレイヤーモジュールに登録されます(最小ステーク 1,000 QOR)。レイヤーを登録できない場合でもロールアップは作成されますが、実際のレイヤーを持たないため、そのバッチはアンカーできず、レシートも発行できません。
登録済みのポスト量子鍵アカウントに登録された ML-DSA-87 鍵。従来型の鍵のみで署名されたネイティブレーンのトランザクションは拒否されます。新しいアカウントは、ほかの何よりも先に、専用のトランザクションでポスト量子鍵を登録する必要があります。RDK クライアント 0.9.0 はこの登録を代わりに行います。
手数料手数料の下限はガス 1 単位あたり 0.1 uqor です。ガスリミットと手数料は一緒に設定してください。
ツールCLI とスキャフォールダーには Node 20 以降。Python クライアントには Python 3.10 以降(liboqs 付き、上記参照)。Java(RDK 0.8.0 から)には Java 21 以降。Go モジュールは github.com/qorechain/qorechain-rdk/packages/go。

状態の読み取りには、これらは一切不要です。ダッシュボードからロールアップをリクエストする(リクエストフォームであり、オンチェーントランザクションではありません)か、チェーン CLI で作成することもできます。完全なフロー、CLI コマンド、TypeScript の署名パスについてはロールアップのデプロイを参照してください。

チェーン v3.2.5 の挙動: 両ネットワークで稼働中​

チェーン v3.2.5 は、メインネット(2026年10月29日に高さ 3,906,833 で適用、ガバナンス提案 14)とテストネット(2026年10月26日から)で稼働しています。メインネットは v3.2.7、テストネットは v3.2.8 で稼働しており、どちらにも v3.2.5 が含まれます。RDK 0.7.0 以降は両方に対応しています。これらのルールは両方のネットワークに適用されます。メインネットではまだロールアップが作成されていない(GET /qorechain/rdk/v1/rollups は空のリストを返しました。2026年11月4日)ため、以下のルールはこのリリースのルールであり、メインネットの稼働中のロールアップではまだ実際に試されていません。ロールアップ開発者向けの内容は次のとおりです。

挙動両ネットワーク(v3.2.5 以降)
チャレンジを解決できる主体任意のアカウント
不正が認められた後そのバッチと、それ以降の未確定のバッチはすべて拒否される。シーケンサーは、最後の正常なルートから同じインデックスで再提出する
ファイナリティの順序バッチはインデックス順に確定する
保留中のオプティミスティックバッチロールアップあたり最大 4,096
ロールアップの停止最新のバッチが submitted または challenged の間は拒否される。停止したロールアップはスロットを解放する
withdrawals_root空か、ちょうど 32 バイト。第二の形式の出金リーフはチェーン ID を含む
クロス VM ブリッジGET /qorechain/crossvm/v1/params が許可リスト(bridge_allowed_targets: メインネットでは空で、2026年11月4日に再確認。テストネットでは10月30日の時点で空で、11月4日には 3 つの CosmWasm ターゲットがありました)を返す。プリコンパイルは abi.encode(bytes) を返し、Error(string) で拒否する
クロス VM プリコンパイル 0x...0901テストネットでは、レビュー済みの CosmWasm コントラクトの許可リスト付きで有効(2026年11月7日に eth_call で呼び出しをテスト)。メインネットでは有効ではない

チェーン v3.2.6 は両ネットワークで稼働しています(メインネットは2026年11月4日から、高さ 4,020,000、提案 15)。ロールアップ向けには、このリリースはバッチビューに withdrawals_bound(バッチの出金がそのバッチに結び付けられているかどうか)を追加します。また、ロールアップの決済方法を変えない IBC と可観測性の変更も加わります。新しいフィールドを示せるメインネットのロールアップは存在しないため、これはリリースノートに基づく記述であり、観測したものではありません。

チェーン v3.2.7:両ネットワーク​

テストネットは、2026年11月6日からチェーン v3.2.7(高さ 9,594,600、ガバナンスにより適用)で稼働し、11月12日に v3.2.8 に移行しました。メインネットは 2026年11月12日から v3.2.7(高さ 4,164,600、ガバナンス提案 16)で稼働しています。以下の確認は 2026年11月7日にテストネットで行ったもので、メインネットでは繰り返しておらず、メインネットについてはリリースのスイッチのみが分かっています。ロールアップについては次のとおりです。

  • ZK 検証鍵メッセージ。 テストネットは MsgSetVerificationKey と MsgUpdateVerificationKey を受け付けました(空のメッセージでシミュレートしたトランザクションは、メッセージタイプの解決を通過し、空のアドレスフィールドで失敗しました。メインネットは、v3.2.7 を適用する前の 11 月 7 日には、同じメッセージに対して「unable to resolve type URL」と答えていました)。検証鍵メッセージは 2026年11月12日からメインネットで有効です。リリースノートには、登録された鍵のない ZK バッチは手数料が支払われる前に拒否されると書かれています。テストネットにはロールアップが存在せず(GET /qorechain/rdk/v1/rollups は空のリストを返しました)、メインネットでも 2026年11月12日に GET /qorechain/rdk/v1/rollups は空のリストを返したため、鍵は登録されておらず、ZK バッチも検証されていません。RDK 0.8.0 にはこれらのメッセージのビルダーがありません。
  • クロス VM プリコンパイル 0x...0901。 テストネットでは、レビュー済みの 3 つの CosmWasm コントラクトの許可リスト付きで有効です。読み取り専用の eth_call は許可リストにあるコントラクトに到達し、それ以外のターゲットには拒否されました(詳細はマルチ VM)。メインネットでは、v3.2.7 の後も、プリコンパイルとクロス VM 呼び出しはオフのままです(クロス VM 呼び出しメッセージは停止されています)。

現在存在するもの​

ステータス
登録済みのロールアップ(メインネットおよびテストネット)なし
x/rdk モジュールとそのパラメータ両方のネットワークにデプロイ済み。qorechaind query rdk config で確認できます
RDK クエリ両方のネットワークで CLI、gRPC、REST(/qorechain/rdk/v1/...)経由で提供されているため、TypeScript の rdk.params() のような REST ベースの読み取りはメインネットに対しても機能します
RDK が書き込む決済アンカーなし。v3.2.2 以降、バッチは anchor_signature を持つことができ、その場合は同じトランザクション内で x/multilayer にアンカーされます。持たない場合、バッチはアンカーされないまま決済されます。ロールアップ、レイヤー、アンカーはまだ存在しません。TypeScript の RDK(0.6.0 以降)は、クライアントがハイブリッド署名を行い、かつロールアップの作成者である場合にこのフィールドを送信します(ライブでは未検証)。Python、Go、Rust、Java のクライアントは 0.8.0 からハイブリッド署名を行いますが、送信しません(Python で確認済み)
x/multilayer に登録されたロールアップレイヤーなし
ZK 決済検証鍵メッセージはメインネット(v3.2.7、2026年11月12日)で有効で、テストネットでも受け付けられています。どちらでも ZK ロールアップはまだ試されていません
出金v3.2.3 以降、ロールアップごとのエスクロー台帳から支払われます(ZK / STARK と出金を参照)。ロールアップが存在しないため、まだ行われていません

より低レベルなモジュールリファレンス(モジュールパラメータ、ライフサイクルの内部仕様、バーン統合、マルチレイヤーアンカリング)については、アーキテクチャセクションの Rollup Development Kit ページを参照してください。本ロールアップセクションは開発者向けのハウツーです。

公開場所​

レジストリのバージョンは 2026年11月12日に確認しました。すべてのパッケージは Apache-2.0 です。

RDK 0.9.0(2026年11月12日)はチェーン v3.2.8 に対応します(テストネットは2026年11月12日から v3.2.8 で稼働しています)。ロールアップのデータ投稿、ベースドシーケンシング、不正証明付きの qledger-v1 オプティミスティックロールアップ、プライベートロールアップ、正準な ZK 入力に対応し、STARK 決済は一時停止されています。GitHub のリリースノートを参照してください。

レジストリパッケージ現在のバージョンリンク
npm@qorechain/rdk(TypeScript クライアント)0.9.0npmjs.com
npm@qorechain/rdk-cli(qorollup)0.9.0npmjs.com
npmcreate-qorechain-rollup(スキャフォールダー)0.9.0npmjs.com
PyPIqorechain-rdk(インポート名 qorrdk)0.9.0pypi.org
crates.ioqorechain-rdk(ライブラリ qorechain_rdk)0.9.0crates.io
Go モジュールプロキシgithub.com/qorechain/qorechain-rdk/packages/gov0.9.0pkg.go.dev
Maven Centralio.github.qorechain:qorechain-rdk0.9.0central.sonatype.com

Maven Central は、以前のバージョンに加えて 0.7.0、0.7.1、0.8.0、0.9.0 を提供しています。Go プロキシの @latest は新しいタグに遅れることがあるため、Go のバージョンは固定してください。ソースは github.com/qorechain/qorechain-rdk で公開されており、リリースノートは v0.9.0(および v0.8.0、v0.7.1)、キット自身のドキュメントは qorechain.github.io/qorechain-rdk にあります。TypeScript パッケージは @qorechain/sdk ^0.10.0(0.7.0 から。0.6.x は ^0.9.0 を使用。Python、Go、Rust、Java のパッケージは 0.8.0 から対応する QoreChain SDK 0.10.x を使用)と @qorechain/evm ^0.8.0 に依存し、Python パッケージは qorechain-pqc 0.2.x に依存します。チェーンの x/rdk モジュールのロジック自体は、公開キットには含まれません。

制限と既知の問題​

  • ZK 決済は、どちらのネットワークでもまだ試されていません。 これには defi プロファイル、defi-rollup テンプレート、zk 決済で作成されたすべてのロールアップが含まれます。検証鍵メッセージはチェーン v3.2.7 以降、メインネットでは 2026年11月12日から、テストネットでは 2026年11月6日から有効になっていますが、ZK ロールアップは作成されておらず、RDK 0.8.0 にはそのメッセージのビルダーがなく、登録された鍵のない ZK バッチは拒否されます。当面は optimistic 決済を使用してください(ZK / STARK と出金を参照)。
  • どちらのネットワークでもロールアップはまだ作成されていません。 作成、バッチ、チャレンジ、レシート、出金の各パスはユニットテストと共有ベクターでカバーされていますが、オンチェーンではまだ検証されていません。
  • ハイブリッド署名にはポスト量子鍵が必要です。 RDK 0.8.0 からは、5 つのクライアントすべてがポスト量子キーペアを渡した場合にハイブリッドで署名し、qorollup のトランザクションコマンド(create、pause、resume、stop、withdraw)は 0.7.1 から同様です。鍵がない場合や以前のバージョンでは、トランザクションは従来型のみとなり、どちらのネットワークも拒否します。どのクライアントのハイブリッドトランザクションも、稼働中のロールアップでは送信されたことがありません。アンカー付きのバッチを送信できるのは TypeScript クライアントだけです。
  • (a) qorollup CLI は、0.6.1 以前では npm からインストールすると何も出力しませんでした。 これは 0.6.2 で修正されています。npm i -g @qorechain/rdk-cli の後、qorollup ... は動作し、qorollup --version は 0.6.2 を出力します。
  • (b) 出金の Merkle ヘルパーは、0.6.2 以前ではデフォルトで SHA-256 を使用していましたが、チェーンは SHAKE-256 を使用します。 それらのデフォルトで構築した証明は、オンチェーンで一度も検証に通りませんでした。0.7.0 で修正されています。 withdrawalsTree はチェーンとまったく同じツリーを構築し、チェーン自身の検証器と照合して確認されています(リーフとノードのエンコーディングを参照)。アップグレードしてください。SHA-256 のデフォルトに依存していたコードは、今後は hash を明示的に渡す必要があります。
  • (c) buildDaBlob は、0.6.2 以前では SHA-256 でハッシュしていましたが、チェーンのブロブコミットメントは SHAKE-256 です。 0.7.0 で修正され、そのコミットメントはチェーンのものになりました。ブロブを投稿するトランザクションがないため、実用上の影響は一度もありませんでした。native と both のデータ可用性では dataHash を空のままにしてください(データ可用性を参照)。
  • (d) defi テンプレートのデモ回路は検証できません。 これは snarkjs の乗算器であり、チェーンは前の状態ルート、状態ルート、データハッシュを公開入力とする BLS12-381 上の Groth16 を検査しますが、その回路はそれらを公開していません。鍵の登録が提供された後でも、独自の回路が必要です。
  • 任意のアカウントがチャレンジを解決できます(v3.2.5 以降、両ネットワーク)。 チェーンは不正証明自体を検証します。v3.2.5 より前は、解決を提出できるのはロールアップの作成者だけでした(チェーン v3.2.5 の挙動と Optimisticを参照)。
  • ライブネットワークでは使用できないもの: Celestia データ可用性(未実装)、QCAI ロールアップ・コパイロット(そのアドバイザリサービスは公開エンドポイントにありません)、クロス VM 呼び出し(0x...0901 のプリコンパイルはメインネットでは有効ではありません。テストネットでは許可リスト付きで有効で、2026年11月7日に eth_call でテストしました)、共有シーケンサーとベースドシーケンサー(チェーンが認めるのは設定されたシーケンサー、設定がない場合は作成者のみです)、suggest-profile(固定のフォールバックとして defi を返します)。
  • バージョンに関する注記。 すべてに 0.9.0 を使用してください(0.7.0 以前は、ネットワークが受け付ける qorollup のトランザクションを送信できず、0.8.0 より前は Python、Go、Rust、Java のクライアントがトランザクションを一切送信できません)。0.6.2 以前は、オンチェーンで一度も検証に通らない出金証明を構築し、0.6.1 以前は npm からインストールすると qorollup が何も出力しません。0.5.0 以前は、レシート、ウォッチタワー、クロス VM コールデータに使用すべきではありません。各リリースの変更点の全一覧は RDK 0.8.0:変更点と制限にあります。

リファレンス: ロールアップの構成要素​

RDK が提供するもの​

RDK を通じて作成されたロールアップは、4 つの設定可能な要素をまとめています。

要素制御する内容選択肢
決済モードロールアップの状態遷移が QoreChain 上でどのように検証・確定されるかoptimistic、zk、based、sovereign
証明システム決済を裏付ける暗号学的または経済的メカニズムfraud、snark、stark、none
シーケンサーモード決済前にトランザクションを並べる主体dedicated、shared、based
データ可用性誰もが状態を再構築できるようトランザクションデータを公開する場所native、celestia、both

各ロールアップは一意の rollup-id で登録され、QOR によるステークボンドに裏付けられ、ライフサイクルステータス(pending、active、paused、stopped)が割り当てられます。作成とライフサイクルの完全なフローについては ロールアップのデプロイ を参照してください。

QoreChain 固有の機能とそのステータス​

どのロールアップキットにも共通する基本機能に加えて、RDK は QoreChain のレイヤー1を軸に構築された 3 つの機能と、ウォッチタワーの自動チャレンジャーを備えています。ステータスはそれぞれ異なり、現在動作するものは表に記載しています。

機能内容
決済レシート決済アンカーを、ポスト量子(ML-DSA-87 / Dilithium-5)署名を持つ持ち運び可能なレシートにまとめます。初期段階: アンカーはまだ存在しないため、実際のアンカーに対する検証はまだ行われていません。レシートはチェーンの状態と照合して確認する必要がある主張であり、0.7.0 の検証機能は、フィールドごとにその確認を行います。
QCAI ロールアップ・コパイロット単一ロールアップ向けの読み取り専用アドバイザリヘルパー(手数料見積もり、レコメンデーション、不正調査)。参照するアドバイザリサービスは、まだ公開エンドポイントでは提供されていません。
マルチ VM のクロス VM 呼び出しクロス VM プリコンパイル(0x...0901)を通じて EVM から QoreChain Native への呼び出しをエンコードするためのツール。このプリコンパイルはメインネットでは有効ではなく(そこでは呼び出しは何も行いません)、テストネットでは許可リスト付きで有効です(2026年11月7日に eth_call でテスト)。0.6.0 以降のエンコーダーは、チェーンがデコードするレイアウトと一致します。
ウォッチタワーオプティミスティックロールアップ向けの自動チャレンジャーフレームワークで、新しいバッチとチャレンジウィンドウの締め切りを検出し、あなたの正当性述語に反する無効なバッチにチャレンジします。両方のネットワークが提供する REST 経由で読み取ります。0.6.0 以降は、各バッチのウィンドウをチェーンと同じ方法で判定します(以降のリリースでもそれは維持されます)。

詳細な根拠とコードサンプルについては Why QoreChain RDK を参照してください。

4 つの決済パラダイム​

QoreChain RDK は、信頼の前提、ファイナリティの特性、証明要件がそれぞれ異なる 4 つの決済モードをサポートします。決済モードと証明システムの組み合わせはオンチェーンで検証され、互換性のない組み合わせは作成時に拒否されます。以下の図は各決済モードとその有効な証明システムの対応を示しています。

Optimistic(オプティミスティック)​

オプティミスティックロールアップは、提出されたバッチをデフォルトで有効とみなし、紛争解決には**不正証明(fraud proof)**を利用します。

  • 証明システム: fraud(インタラクティブな不正証明)。
  • シーケンサー: dedicated または shared。
  • ファイナリティ: 設定可能なチャレンジウィンドウが成功したチャレンジなしに終了するまで遅延します。
  • 紛争: 誰でもウィンドウ内に、ボンドと不正証明を提出して、提出されたバッチにチャレンジできます。チャレンジによりバッチは凍結され、v3.2.5 以降(両ネットワーク)は任意のアカウントが解決できます(v3.2.5 より前はロールアップの作成者のみでした)。チェーン自体が証明を検証します。不正が認められるとバッチは拒否されてチャレンジャーに報酬が支払われ、チャレンジが却下されるとバッチは submitted に戻ります。v3.2.5 以降、不正が認められると、それ以降の未確定のバッチもすべて拒否され、シーケンサーは最後の正常なルートから同じインデックスで再提出します(チェーン v3.2.5 の挙動を参照)。ロールアップのデプロイを参照してください。
  • ウィンドウの長さ: デフォルトのウィンドウはメインネットで 604,800「秒」です(モジュールの default_challenge_window。テストネットのデフォルトは 3,600 秒で、2026年10月27日に読み取ったものです。ロールアップは独自の値を設定できます)。v3.2.4 より前(メインネットでは高さ 3,742,566 より前) では、チェーンはこれを 1 ブロックあたり固定 6 秒でブロック数に換算します。つまり 100,800 ブロックです。実際の経過時間は実際のブロックタイムに従います(メインネットの現在の約 3.1 秒のブロックでは約 3.7 日)。したがって、日数ではなくブロック数で計画してください。v3.2.4 以降では、アップグレード高さ以降に提出されたバッチは、ブロックタイムの秒数で測定されるウィンドウ(丸 7 日)になります。それ以前のバッチはブロック数のルールのままです。アップグレード高さは、テストネットでは 8,337,253(2026年10月19日以降)、メインネットでは 3,742,566(2026年10月23日)です。

ZK(ゼロ知識)​

ZK ロールアップは各バッチに暗号学的な正当性証明を付与し、再実行なしに状態遷移の正しさを証明します。

  • 証明システム: snark(簡潔な証明)または stark(トラステッドセットアップ不要の透明な証明)。
  • シーケンサー: dedicated または shared。
  • ファイナリティ: 有効な証明の検証時。チャレンジウィンドウは不要です。
  • 成熟度: ZK 決済は、どちらのネットワークでもまだ試されていません。 SNARK バッチは、ロールアップとともに保存された検証鍵に対してオンチェーンで検証される(BLS12-381 上の Groth16)ことになっています。検証鍵メッセージは、チェーン v3.2.7 以降、メインネットでは 2026年11月12日から、テストネットでは 2026年11月6日から有効になっていますが、ZK ロールアップはまだ試されていません。STARK 検証は実験的です。オプトインであり、あなたのロールアップ自身の状態遷移ではなくデモンストレーション用の回路を検証します。ZK / STARK と出金 を参照してください。

Based(ベースド)​

ベースドロールアップはトランザクションのシーケンシングを QoreChain(L1)のプロポーザーに委任し、ホストチェーンのライブネスと検閲耐性を継承します。

  • 証明システム: none(L1 プロポーザーが順序の真実の源)。
  • シーケンサー: based(必須、オンチェーン検証によって強制される)。
  • ファイナリティ: ホストチェーンの確定に追従します。
  • トレードオフ: QoreChain のバリデータがシーケンシングを担うため運用モデルは最もシンプルですが、専用シーケンサーによるレイテンシ制御は失われます。
  • 現在のステータス: based はロールアップ設定に記録されますが、QoreChain はまだ L1 プロポーザーをバッチ提出者として認めていません。提出するのはロールアップの作成者です(シーケンサーモードを参照)。

Sovereign(ソブリン)​

ソブリンロールアップは独自のコンセンサスを運用し、自己シーケンシングを行います。検証可能性のために状態を QoreChain にアンカーしますが、ファイナリティについてはホストチェーンに依存しません。

  • 証明システム: none。
  • シーケンサー: ロールアップによる自己管理。
  • ファイナリティ: 独立。ロールアップ自身のコンセンサスによって決定されます。
  • 状態アンカリング: 状態ルートは透明性のために QoreChain に投稿されますが、ホストチェーンはそれを強制しません。

証明システムの互換性​

決済モードは、どの証明システムが有効かを制約します。これらの組み合わせはロールアップ作成時に強制されます。

決済モードfraudsnarkstarknone
optimistic必須---
zk-対応対応-
based---必須
sovereign---必須

シーケンサーモード​

シーケンサーは、決済前にロールアップブロック内でトランザクションを並べる主体を決定します。

モード誰がシーケンシングするか備考
dedicated単一の指定されたオペレーターアドレスレイテンシが最も低いが、ライブネスと公正な順序付けについてオペレーターへの信頼が必要
shared共有シーケンサーセット順序付けがセット全体に分散し、調整オーバーヘッドがやや高い
basedQoreChain L1 プロポーザーホストチェーンのバリデータのセキュリティと検閲耐性を継承する。based 決済には必須
現在強制されているもの

オンチェーンでは、バッチを提出できるのはロールアップに設定されたシーケンサーアドレスのみで、設定されていない場合(すべてのプリセットが該当)はその作成者のみです。shared と based のモードはロールアップ設定に記録されますが、QoreChain はまだ共有シーケンサーの名簿や L1 プロポーザーをバッチ提出者として認めていません。これらのモードは意図された設計を示すものです。

パラダイムの選び方​

こんな場合には...検討すべきもの
QoreChain バリデータがシーケンシングを行う、最もシンプルな運用構成を望むbased
暗号学的な保証による高速なファイナリティを望む(まだ使用不可)zk(snark / stark)
経済的な紛争解決を伴う、実績のあるモデルを望むoptimistic(fraud)
独自のコンセンサスによる完全な独立性を望みつつ、検証可能性のためにアンカーしたいsovereign

どこから始めればよいか分からない場合は、RDK が一般的なアプリケーションカテゴリ向けにこれらの選択をまとめたプリセットプロファイルを提供しています。プリセットプロファイル を参照してください。suggest-profile ヘルパーもありますが、現在は固定の defi フォールバックを返します(そして defi はまだ使用できません)ので、プロファイルの表から選んでください。

関連ページ​