ロールアップのデプロイ
アプリケーション専用ロールアップは3通りの方法でセットアップできます。ダッシュボード(リクエストフォーム。オンチェーントランザクションではありません)、チェーンのCLI(qorechaind、オンチェーントランザクションを完全に制御)、またはTypeScript RDK(@qorechain/rdk と create-qorechain-rollup スキャフォルダー)を使う方法です。TypeScript RDKは設定、読み取り、そしてポスト量子鍵を渡した場合のハイブリッド署名付きトランザクションを対象としています(RDK 0.8.0:変更点と制限事項を参照)。このページではこの3つすべてに加えて、オペレーターのライフサイクルとバッチコマンドについても解説します。
メインネットではロールアップはまだ1つも作成されていません(GET /qorechain/rdk/v1/rollups は2026年11月12日に空のリストを返しました)。テストネットは2026年10月30日に確認した時点で1つもありませんでした。以下のコマンドは qorechain-diana テストネット(EVMチェーンID 9800、チェーンバージョン v3.2.8。v3.2.4 は2026年10月19日、v3.2.5 は10月26日に高さ8,890,800で、v3.2.6 は10月27日に高さ8,970,638で、v3.2.7 は11月6日に高さ9,594,600で、v3.2.8 は11月12日に高さ9,929,500で適用。v3.2.8 はメインネットにはありません)を使用しています。メインネット(qorechain-vladi、EVMチェーンID 9801、2026年6月7日から稼働)は、2026年11月12日からチェーンバージョン v3.2.7 で稼働しています(ガバナンス提案16により高さ4,164,600で適用。v3.2.6 は2026年11月4日に提案15により高さ4,020,000で、v3.2.5 は2026年10月29日に提案14により高さ3,906,833で、v3.2.4 は2026年10月23日に提案13により高さ3,742,566で適用)。そのため、v3.2.5がロールアップに何を変えるかは「v3.2.5から」と明記しており、両方のネットワークに適用されます(まとめの表はロールアップ概要にあります)。以前のリリースにはいくつかの細部に違いがあり、このページでは「v3.2.4から」と記しています。テストネットは独自のモジュールパラメータを持つステージングネットワークです(たとえば、デフォルトのチャレンジウィンドウはメインネットの604,800秒に対して3,600秒、ロールアップは最大100に対して200)。対象とするネットワークで GET /qorechain/rdk/v1/params を読み取ってください。すべてのデプロイはまずテストネットで検証してください。
ネットワークは最低ガス価格 0.1uqor を強制するため、--fees 500uqor だけでは拒否されます。また、ネイティブレーンのトランザクションにはすべてハイブリッドのポスト量子共同署名が必要です。そのため、このページのCLIサンプルでは --generate-only でトランザクションを構築し、qorechaind tx pqc cosign で共同署名します(これが署名とブロードキャストを行います)。鍵は qorechaind tx pqc gen-key で一度作成し、qorechaind tx pqc register-key で一度オンチェーンに登録してください(QoreXやSDKを使えば自動で行われます)。手数料は未署名ファイルの生成時に固定されるため、ガスリミットと手数料は一緒に設定してください。手数料はガスリミット × 0.1 uqor 以上である必要があります。以下のガスリミットは目安です — 頼る前にシミュレーションしてください。最初のトランザクションとポスト量子署名を参照してください。
要件
| 要件 | 詳細 |
|---|---|
| 最低ステーク額 | 最低10,000 QOR(min_stake_for_rollup)。ステークはロールアップ作成時にエスクローされます |
| 作成時バーン | 提供したステークの1 %が作成時に永久にバーンされます(バーンを適用できない作成は拒否されます)。残りはエスクローに保持され、ロールアップが停止された際に返還されます |
| レイヤー登録ステーク | 作成時にロールアップのレイヤーがマルチレイヤーモジュールにも登録され、作成者からさらに 1,000 QOR(min_sidechain_stake)がロックされます。これはレイヤーが停止時に廃止される際に返還されます。レイヤーを登録できない場合(残高不足、またはマルチレイヤーのサイドチェーン上限10に到達)でもロールアップは作成されますが、レイヤーを持たないため、そのバッチをアンカーできません |
| ロールアップID | 3〜64文字を使用します。小文字の英字、数字、.、_、- が使え、先頭は英字または数字にします。チェーンはv3.2.2以降、両ネットワークでこのルールを強制しており(CLIはトランザクションを構築する前にチェックします)、規則に合わないIDは拒否されます |
| アカウント | ポスト量子鍵が登録済みで、ステーク額、レイヤーステーク、トランザクション手数料をまかなうのに十分な残高を持つ、資金の入ったQoreChainアカウント |
デプロイ前に、現在の最低ステーク額とバーン率のライブなモジュールパラメータを照会してください。
qorechaind query rdk config
ダッシュボード経由でのデプロイ(Tools → Rollups)
ダッシュボードは Tools → Rollups の下にロールアップをデプロイフォームを提供します。これはリクエストフォームです。送信すると、あなたのアカウント向けのプロビジョニングリクエストが記録され、The Qore Trustがレビューします。新しいリクエストはprovisioning(準備中)ステータスで表示されます。オンチェーンの create-rollup トランザクションをブロードキャストすることはありません — ロールアップをオンチェーンに登録するには、以下のCLIを使用してください。
手順
- サインインする。 リクエストの送信や既存のリクエスト一覧の表示には認証済みセッションが必要です。
- ロールアップに名前を付ける。 ロールアップ名を入力します(2〜41文字:英字、数字、スペース、ハイフン、アンダースコア)。
- 仮想マシンを選ぶ。 オンチェーンのレコードにはVMのラベルが保存されます。ロールアップは独自のランタイムでオフチェーンで実行されます。この選択はQoreChain自身のEVM、QoreChain Native、SVMレーン上では実行されません。
- EVM — Hardhat、Foundry、MetaMaskなどフルのEthereumツールチェーンを使えるSolidity / Vyperコントラクト
- QoreChain Native — Cosmos SDKランタイム上のRustスマートコントラクト(CosmWasmランタイム)、ネイティブIBC対応
- SVM — 並列実行・高スループットなアプリ向けのSolana Virtual Machine
- データ可用性(DA)レイヤーを選ぶ。 誰でも状態を再構築できるよう、ロールアップがトランザクションデータを公開する先です:QoreChain DA、Celestia、EigenDAのいずれか。EigenDAはダッシュボードレベルのオプションであり、オンチェーンの
x/rdkのDAバックエンドはネイティブ、Celestia、またはその両方である点に注意してください — 詳細はデータ可用性を参照してください。 - ガストークンを設定する。 ロールアップ上での実行手数料の支払いに使うトークンです。デフォルトはQORです。独自のネイティブトークンを使う場合はカスタムシンボルを入力してください。
- シーケンサーを選ぶ。 トランザクションを決済前にどう並べるかを決める主体です:Shared sequencer(QoreChainの共有セット)、Dedicated (single)(自前の単一シーケンサーを運用)、Decentralized(パーミッションレスなシーケンサーセット)のいずれかです。
- 決済先を選ぶ。 ロールアップが状態ルートと妥当性証明をアンカーする先です:QoreChainメインネットまたはEthereum。
- リクエストを送信する。 プロビジョニングはThe Qore Trustによるレビューを経るため、送信直後のリクエストはレビュー完了までは**provisioning(準備中)**ステータスで表示されます。
送信したリクエストはYour rollups一覧に、VM、DAレイヤー、ガストークン、シーケンサー、決済先、現在のステータスとともに表示されます。
フォームのオプション(仮想マシン、データ可用性レイヤー、ガストークン、シーケンサー、決済先)は、あなたが依頼する内容を表すものであり、オンチェーンの x/rdk モジュールが現在サポートしている範囲よりも広くなっています。オンチェーンでは、データ可用性は native であり(Celestiaは有効ではありません)、シーケンシングはロールアップ作成者または設定済みのシーケンサーアドレスが行います。データ可用性を参照してください。
CLI経由でのデプロイ
CLIはロールアップをオンチェーン上に直接作成します。create-rollup は3つの位置引数 — ロールアップID、プロファイル、ステーク額(uqor 単位)— に加えて、任意の --vm フラグを取ります。
チェーンバージョン v3.1.74 以降、create-rollup は選択したプロファイルのプリセットを自動的に適用します — 決済モード、シーケンサー、DA、ガスモデル、VMはすべてプリセットから取得されます。これらを手動で設定する必要はもうありません(以前はメッセージがソブリン構成をハードコードしていました)。--vm フラグは現在デフォルトで空になっており、明示的に上書きしない限りプロファイルのVMが適用されます。
qorechaind tx rdk create-rollup [rollup-id] [profile] [stake-amount] \
--from mykey \
--chain-id qorechain-diana \
--gas 600000 --fees 60000uqor \
--generate-only > create-rollup.json
例 — defi プリセットからロールアップを作成する(決済、シーケンサー、DA、VMはすべてプリセットから取得されます。defi はEVM上のzk決済に解決されます)。未署名のトランザクションを構築し、ポスト量子共同署名を付けてブロードキャストします。
# 1. Build the unsigned transaction (10,000 QOR stake)
qorechaind tx rdk create-rollup my-defi-rollup defi 10000000000 \
--from mykey \
--chain-id qorechain-diana \
--gas 600000 --fees 60000uqor \
--generate-only > create-rollup.json
# 2. Cosign with your post-quantum key and broadcast
qorechaind tx pqc cosign create-rollup.json \
--from mykey --pqc-key mypqckey --chain-id qorechain-diana
メインネットではまだ defi(ZK)ロールアップを作成しないでください。 チェーンは作成を受け付けてステークをエスクローします。検証鍵メッセージはチェーン v3.2.7(2026年11月12日)からメインネットで有効になっており、テストネットでも受け付けられましたが、RDK 0.8.0 にはそのビルダーがなく、どちらのネットワークでもZKロールアップは試されていません。当面は、nft や custom のような optimistic プロファイルを選んでください(ZK / STARKと出金を参照)。
フラグ:
| フラグ | デフォルト | 説明 |
|---|---|---|
--vm | (空 — プロファイルのVMを使用) | ロールアップのVMタイプを上書きします:evm、cosmwasm、svm、または custom。プリセットのVMを適用するには未設定のままにします。(RDKクライアントでは、WasmランタイムはVMタイプ native — QoreChain Native — で、cosmwasm はレガシーエイリアスとして残されています。cosmwasm はワイヤー上の値であり、このチェーンレベルのフラグが受け付ける値です。) |
--vm はロールアップがどのランタイムを使うかを記録します。ホストチェーンはロールアップを決済するだけで、そのコントラクトを実行することはありません。ホストチェーン自体のQoreChain Nativeアップロードは現在閉じられており、SVMトランザクションレーンはネットワーク全体で無効化されています。これはオフチェーンロールアップの決済には影響しませんが、ロールアップ用のコントラクトをそれらのホストチェーンレーンにデプロイすることはできない、という意味です。
[profile] 引数は自動的に適用されるプリセット構成を選択します — プリセットプロファイル を参照してください。[stake-amount] は uqor 単位の保証金で、作成時バーンはその1 %です。
デプロイ結果を確認する
# Query a specific rollup by ID
qorechaind query rdk rollup my-defi-rollup
# List all registered rollups
qorechaind query rdk list-rollups
TypeScript RDK(@qorechain/rdk)でのデプロイ
Rollup Development Kitは、CLIと同じオンチェーンの x/rdk モジュール向けに、2つの公開npmパッケージとして提供されています。どちらのネットワークにもまだロールアップは存在しないため、このキットのトランザクション経路はいずれも実際のロールアップでは試されていません。トランザクション送信にこれを頼る前に、RDK 0.8.0:変更点と制限事項を確認してください。
@qorechain/rdk(v0.9.0)— TypeScript SDK:プリセットプロファイル付きのコンフィグビルダー、ロールアップおよび決済バッチのライフサイクル向けトランザクションヘルパー、ネイティブDA、型付き読み取りクライアント、ML-DSA-87署名付きの決済レシート、QCAI Rollup Copilot、クロスVMのcalldataヘルパー、ウォッチタワー。@qorechain/sdk^0.10.0(0.7.0から。0.6.xは^0.9.0を使用)と@qorechain/evm^0.8.0に依存します。create-qorechain-rollup(v0.9.0)— プロファイルごとに実行可能なスターターテンプレートを1つクローンするスキャフォルダー(multivm-rollupテンプレートを含む)。
これらはnpmで公開されています。リポジトリには公開済みのオペレーターCLI @qorechain/rdk-cli(qorollup、v0.9.0)も含まれており、doctor、create、status、watch、params、suggest、ライフサイクル(pause/resume/stop)、keygen、manifest、withdraw、faucet の各コマンドと、receipt、advise、watchtower コマンドが利用できます。0.7.1 以降、そのトランザクションコマンドはハイブリッドで署名します(下記の制限事項を参照)。
リリースごとのハイライト:
- v0.4.2 — ライブネットワークでそのまま動作。
mainnetとtestnetのプリセットに公開qore.hostエンドポイント(RESTはapi.qore.host/api-testnet.qore.host)が組み込まれたため、createRdkClient({ network })は手動でendpointsを設定しなくてもチェーンに到達できます — 自分のノードを対象にする場合のみ上書きしてください。同じリリースでWasmロールアップのVM識別子がnative(QoreChain Native)に改名されました。cosmwasmは受け付けられるレガシーエイリアスとして残り、どちらもワイヤー上ではcosmwasmにマッピングされます — チェーン、エクスプローラー、ダッシュボードは変わりません。 - v0.4.3 — SDKのハイブリッド署名エンコーディング修正のための依存関係更新。 RDKのトランザクションクライアント自体は引き続きクラシック署名のみでした。
- v0.4.4 —
@qorechain/sdk^0.7.0に追従。チェーン v3.1.85 のオーセンティケーターレーン向けのSDKリリースです。RDKのAPI変更はありません。 - v0.5.0(2026年10月18日) — 決済レシートの検証はチェーンの状態に対して照合し、レシート自身のフィールドだけで有効と報告することはありません。TypeScriptのトランザクションクライアントは
pqcKeypairを渡されるとハイブリッドで署名します。@qorechain/sdk^0.8.0に依存します。 - v0.6.0(2026年10月20日のGitHubリリース) — チェーン v3.2.2 から v3.2.4 向けの互換性リリースです。アンカー付きバッチ、検証可能な決済レシート、チェーンと同じ方法で計測されるチャレンジウィンドウ、チェーンのクロスVMレイアウトに一致するエンコーダー、ハイブリッドで署名するテンプレート、そして
@qorechain/sdk^0.9.0です。詳細は以下のとおりです。 - v0.6.1(2026年10月25日のGitHubリリース) — チェーン v3.2.3 以降向けのセキュリティおよびテンプレート修正リリースで、5言語すべてが対象です。決済レシートの検証はレシートが記載するすべてのフィールドをチェーンのアンカーと比較し、6つのスターターテンプレートはチェーンが拒否するバッチを送信しなくなり(
dataHashを空のままにします)、オプティミスティックテンプレートはプレースホルダーの代わりにチェーンの正準ステートルートを公開します。@qorechain/sdk^0.9.0と@qorechain/evm^0.8.0の範囲は維持されます。詳細は以下のとおりです。 - v0.6.2(2026年10月27日のGitHubリリース):ライブラリの変更がないCLIのホットフィックスです。npmからインストールした(ローカル、グローバル、または
npx)qorollupが再び動作し、qorollup --versionとcreate-qorechain-rollup --versionが実際のバージョンを表示します。他のパッケージも、すべてのレジストリを同じバージョンに保つために0.6.2として再リリースされました。 - v0.7.0(2026年10月27日のGitHubリリース):5言語すべてでチェーン v3.2.5 に対応しました(両ネットワークで稼働中で、v3.2.6 と v3.2.7 も同様です。メインネットは v3.2.5 を2026年10月29日に、v3.2.6 を11月4日に、v3.2.7 を11月12日に適用し、テストネットは v3.2.5 を10月26日に、v3.2.6 を10月27日に適用しました。テストネットはその後 v3.2.7、続いて v3.2.8 に移行しています)。また、出金とデータ可用性blobのハッシュ方法を修正しています。0.6.xのデフォルトで構築した出金証明はチェーン上で一度も検証を通りませんでしたが、0.7.0はチェーンとまったく同じツリーを構築します。
@qorechain/sdk^0.10.0に移行し、テンプレートは@qorechain/rdk^0.7.0に固定されます(0.8.0 以降は^0.8.0)。詳細は以下のとおりです。 - v0.7.1(2026年10月30日のGitHubリリース):
qorollupオペレーター CLI のホットフィックスです。そのトランザクションコマンドは、両ネットワークが要求するとおり、ハイブリッドで署名するようになりました。 - v0.8.0(2026年10月30日のGitHubリリース):Python、Go、Rust、Java のクライアントもハイブリッドで署名するため、すべての RDK クライアントがメインネットとテストネットでトランザクションを送信できます。Java 21 が必要です。
- v0.9.0(2026年11月12日のGitHubリリース。現行):チェーン v3.2.8 に対応します(テストネットは2026年11月12日から v3.2.8 で稼働しています)。ロールアップのデータ投稿、ベースドシーケンシング、不正証明付きの qledger-v1 オプティミスティックロールアップ、プライベートロールアップ、正準な ZK 入力に対応し、STARK 決済は一時停止されています。GitHub のリリースノートを参照してください。新しいアカウントは、ほかの何よりも先に、専用のトランザクションでポスト量子鍵を登録する必要があります。RDK クライアント 0.9.0 はこの登録を代わりに行います。
公開バージョン(2026年11月12日にすべてのレジストリで確認)。 npm の @qorechain/rdk、@qorechain/rdk-cli、create-qorechain-rollup:0.9.0(latest)。PyPI qorechain-rdk:0.9.0。crates.io qorechain-rdk:0.9.0。Maven Central io.github.qorechain:qorechain-rdk:0.9.0(以前のバージョンも引き続き利用できます)。Goモジュール github.com/qorechain/qorechain-rdk/packages/go:v0.9.0(モジュールプロキシの @latest は新しいタグに遅れることがあるため、@v0.9.0 を明示的に指定してください)。GitHubリリースは v0.9.0 です。
RDK 0.8.0:変更点と制限事項
このセクションでは、公開されている0.8.0パッケージが何をするか(およびそれ以前に0.7.1、0.7.0、0.6.2、0.6.1、0.6.0が変更した内容。パッケージの内容とGitHubのリリースノートで確認済み)と、まだできないことを説明します。これらの項目はいずれもチェーンの挙動ではありません。「ライブでは未検証」とある箇所は、どちらのネットワークにもロールアップが存在しないため、その経路はコードに対する確認とオフラインでの確認しか行われていないことを意味します。
0.8.0 と 0.7.1 での変更点(全リストは 0.8.0 と 0.7.1 のリリースノートにあります)。両ネットワークとも、ネイティブレーンのトランザクションにはハイブリッド(ML-DSA-87 + secp256k1)署名が必要です。
- 0.7.1:
qorollupのトランザクションが受け付けられます。create、pause、resume、stop、withdrawは 0.7.0 以前ではクラシック署名のみで署名していたため、ネットワークはそのすべてを拒否していました。CLI は現在ハイブリッドで署名します。ポスト量子鍵はテンプレートと同じ方法で解決されます。--mnemonicまたはQORE_MNEMONICから導出してチェーンに登録済みの鍵と照合するか、--keyと併せて--pqc-seedまたはQORE_PQC_SEED_HEXで指定します。鍵がない場合は、拒否されるトランザクションに手数料を払う代わりに、送信を拒否します。 - 0.7.1:Python の整合性修正。
transition_root_version_for_batch、RestClient.get_applied_plan_height、BatchView.withdrawals_boundが Python クライアントにも追加されました(0.6.1 のノートでは最初のものを 5 言語すべてにあると数えていましたが、実際には 4 言語でした)。 - 0.8.0:Python、Go、Rust、Java がハイブリッドで署名します。 以前は、メインネットとテストネットで動作したのはそれらの読み取りだけでした。現在はそれぞれ、ポスト量子キーペアを渡すと、各言語で公開されている QoreChain SDK(0.10.x)を通じてハイブリッドで署名し、sign-bytes の形式(v1 または v2)はチェーンから解決されます。リリースノートには、すべてのクライアントが同じ入力に対して TypeScript クライアントとバイト単位で同一のトランザクションを生成すると記載されています(共有フィクスチャに 4 件のハイブリッドトランザクションがあり、各言語がそれを正確に再現します)。
- 0.8.0:すべての言語での鍵の解決。TypeScript と同じです。ニーモニックから、チェーンに登録されている方の標準または旧来の導出で、あるいは
QORE_PQC_SEED_HEXの 32 バイトのシードを、登録済みの鍵と照合して解決します。Pythonresolve_pqc_keypair/pqc_keypair_from_env、GoResolvePqcKeypair/PqcKeypairFromEnv、Rustresolve_pqc_keypair/pqc_keypair_from_env、JavaAccounts.resolvePqcKeypair/pqcKeypairFromEnv。 - 0.8.0:Java 21 が必要です(従来は 17)。依存している QoreChain Java SDK が必要とするためです。
- 0.8.0:新しい依存関係。 PyPI の
qorechain-sdk0.10.x、Go モジュールgithub.com/qorechain/qorechain-sdk/packages/gov0.10.0、crates.io のqorechain-sdk0.10(Rust はcosmrs0.22 に移行)、Maven のio.github.qorechain:qorechain-sdk[0.10.0,0.11)。テンプレートは@qorechain/rdk^0.8.0に固定されます。 - 0.8.0:Go の
RdkTxClient.Signは([]byte, error)を返します。ハイブリッド署名は失敗することがあるためです。これは、従来の単一の戻り値を使っていた Go コードを壊します。 - ライブでは未検証。 どちらのネットワークにもロールアップが存在しないため、どのクライアントからのハイブリッドトランザクションも、稼働中のロールアップを通じて送信されたことはありません。
0.7.0での変更点(行に別途記載がない限り5言語すべて。全リストはリリースノートにあります)。チェーン v3.2.5 に属する挙動には、対象ネットワークを明記しています。両ネットワークとも v3.2.5 以降で稼働しています(メインネットは2026年11月12日から v3.2.7、テストネットは11月12日から v3.2.8)。
- 出金証明がチェーン上で検証されます。 MerkleおよびWithdrawalヘルパーはデフォルトでSHA-256を使い、各リーフを再ハッシュしていましたが、チェーンはノードをSHAKE-256でハッシュし、リーフを出金そのものから構築するため、0.6.xのデフォルトで構築した証明は一度も検証を通りませんでした。
withdrawalsTreeは、バッチの出金ルートとすべての証明を、チェーンとまったく同じ方法で構築するようになりました(リーフの位置は出金インデックス)。第1形式のリーフを使う場合と、チェーンIDも含む第2形式のリーフを使う場合があり、後者はチェーンが v3.2.5 以降のバッチに使用します(両ネットワーク)。withdrawalLeafV1とwithdrawalLeafV2は1つのリーフを構築し、assembleWithdrawalProofはデフォルトでチェーンのツリーを構築し、汎用のMerkleヘルパーはデフォルトでSHAKE-256を使います。SHA-256のデフォルトに依存していたコードには破壊的変更です(従来の動作を維持するにはhashを明示的に渡してください)。新しいバイト形式は、チェーン自身のコードが生成したベクターに対してテストされており、それらのベクターに含まれるすべての出金証明がチェーンの検証器に受理されます。リーフとノードのエンコーディングを参照してください。 qorollup withdrawは支払う前に確認します。 バッチの出金を受け取り(qorollup withdraw --file withdrawal.json [--dry-run])、バッチ自身のバインディングで証明を構築し、結果がバッチのオンチェーンのwithdrawals_rootと一致しない場合は、手数料を支払う前に拒否します。buildDaBlobはチェーンと同じ方法でコミットします。 そのコミットメントはSHA-256ではなくSHAKE-256です(blobを投稿するトランザクションはないため、dataHashは引き続き空のままにします)。- ウォッチタワー。 ウォッチタワーはバッチをインデックスだけで区別していたため、拒否されたインデックスで再提出されたバッチを見逃していました。チェーン v3.2.5 以降(両ネットワーク)では、不正が認められるとそのバッチとそれ以降のファイナライズされていないすべてのバッチが拒否され、シーケンサーは同じインデックスで再提出します。ウォッチタワーはバッチをインデックスと状態ルートで区別するようになり、拒否されたバッチを有効とは決して判定しません。新しいヘルパー
transitionRootValidator(チェーンの不正ルールを適用するvalidate述語)とfraudProofForBatch(勝てる証明。正直なバッチでは証明なし)、そしてqorollup watchtower --canonicalが追加され、後者はチャレンジが勝つバッチを報告します。 - チェーン v3.2.5 の決済ヘルパー(両ネットワーク):
getRollupHealthは、最新のバッチが自身のウィンドウでファイナライズできるのに、それより前のバッチがまだ submitted または challenged である場合(バッチは順番にファイナライズされます)にheldBackByを報告し、qorollup statusがそれを表示します。最新のバッチが submitted または challenged のロールアップは停止できないため、stopRollupErrorとstopRollup内の事前チェック(TypeScriptとRust)が追加されました。さらにMAX_PENDING_OPTIMISTIC_BATCHES(4,096)とwithdrawalsRootError(出金ルートは空か、ちょうど32バイト)があり、後者は5言語すべてで、すべてのバッチ提出の前に確認されます。 - チェーン v3.2.5 向けのクロスVMヘルパー(両ネットワーク):
getCrossVmParams(許可リスト。/qorechain/crossvm/v1/params)、crossVmTargetReady(プリコンパイルが有効で、ブリッジが有効で、ターゲットが許可リストに含まれているか。ブロックしている理由も返します)、decodeCrossVmResult(応答はabi.encode(bytes))、decodeRevertReason(拒否はError(string))。Solidityが生成したエンコーディングに対して確認済みです。マルチVMを参照してください。 - エラーのデコードと小さな追加。
decodeRdkTxErrorとRDK_ERRORSは、rdkモジュールのエラーコード(2〜36)と、オペレーターが遭遇するものへの対処を示します。qorehash(SHAKE-256、32バイト)は5言語すべてでエクスポートされます。FEATURE_RDK_CHALLENGE_SETTLEMENTはチェーンのフィーチャーフラグを表します。 defiテンプレートは手数料を無駄にする前に停止します。 v3.2.6 までのどのチェーンリリースもZK検証鍵を登録できないため、そこではすべてのZKバッチは拒否されていました。テンプレートは送信前に停止するようになり、RollupView.hasVerificationKeyは、チェーン v3.2.7(テストネットでは11月6日から、メインネットでは2026年11月12日から)向けのフィールドを読み取ります。ロールアップが存在しないため、稼働中のロールアップに対しては確認できませんでした。- 依存関係。
@qorechain/sdk^0.10.0(従来は^0.9.0)となり、SDK 0.10.0 を使うアプリケーションはキットとSDKのコピーを1つ共有します。テンプレートは@qorechain/rdk^0.7.0に固定されます(0.8.0 以降は^0.8.0)。
0.6.2での変更点(CLIとスキャフォルダーのみ。ライブラリパッケージは変更されていません):
qorollupがnpmからのインストールで動作します。 CLIはprocess.argv[1]が自身のファイルパスと等しい場合にのみ起動していましたが、npmはパッケージのbinをnode_modules/.binのシンボリックリンク経由で起動するため、0.6.1以前では、ローカル、グローバル、またはnpxで実行すると、コード0で終了して何も出力されませんでした。動作したのはnode .../dist/index.jsだけです。0.6.2は実パスを比較します。npm i -g @qorechain/rdk-cliの後は、qorollup ...が動作します。- バージョンが正しく表示されます。 以前のリリースでは
qorollup --versionは0.4.1、create-qorechain-rollup --versionは0.2.0を表示していました。現在はどちらも自身のpackage.jsonを読み取ります(2026年10月27日確認:qorollup --versionは0.6.2を表示します)。
0.6.1での変更点(行に別途記載がない限り5言語すべて。全リストはリリースノートにあります):
- レシート検証がすべてのフィールドを比較します。
verifySettlementReceiptは、レシートが記載するすべてのアンカーフィールドがチェーンのアンカーと等しいことを要求し(不一致の場合はそのフィールド名が示されます)、batchStateRootがチェーンのバッチルートと等しいことを要求し、未知のversionのレシートやML-DSA-87以外のalgorithmのレシートは、チェーンから何かを読み取る前に拒否します。結果には、チェーンと一致したanchorが含まれ、有効な場合はチェーンの状態から再構築したverifiedReceiptが含まれます。qorollup receipt verify --jsonは、そのチェーンから読み取ったレシートをreceiptとして返します。決済レシートを参照してください。 - ネイティブデータ可用性:
dataHashは空のままにします。 すべてのロールアッププロファイルはnativeデータ可用性を使用しており、チェーンは一致するblobがオンチェーンに保存されている場合にのみ空でないdata_hashを受け入れますが、blobを保存できるトランザクションはありません(データ可用性を参照)。0.6.0以前では、6つのスターターテンプレートがバッチにデータハッシュを付けていたため、手数料が支払われた後にチェーンがテンプレートのすべてのバッチを拒否していました。現在は空のままにします。SubmitBatchInput.dataHashはTypeScriptでは任意です(省略は空を意味します)。dataHashError(data_hash_error、DataHashError、Rules.dataHashError)がそのルールを公開しており、RdkTxClient.submitBatchは、ロールアップを読み取れる場合(RESTエンドポイントを持つハイブリッドクライアント)、そのようなバッチをブロードキャストの前に拒否します。 - オプティミスティックテンプレートは正準ステートルートを公開します。 チェーンはオプティミスティックバッチを、その正準遷移ルート(バッチの直前のステートルート、データハッシュ、トランザクション数のSHAKE-256コミットメント)で判定します(RDKでは
batchTransitionRoot。接続先ネットワークが適用するバインディングはtransitionRootVersionForが選びます)。custom、multivm、nftテンプレートは以前、固定のプレースホルダールートを送信していました。これはチェーンが確認する正準ルートと一致しません。現在は正準ルートを公開し、プレースホルダーの証明は送信しません。nftテンプレートのchallenge.tsはチェーンからバッチを読み取り、ルートが明らかに誤っているバッチにのみチャレンジします。式を自作しないでください。送信先のネットワークとバインディングが一致するようbatchTransitionRootを使用してください。チェーン自身のチェックはどのクライアントでも同じであるため、ステートルートが正準ルートでないオプティミスティックバッチは、どのクライアントが送信したものでもチャレンジに成功する可能性があります。 - 新しいヘルパー。
fraudProof、transitionRootVersionForBatch、SUPPORTED_RECEIPT_VERSIONSを伴うreceiptSchemaError、RestClient.getProtocolFeatures/isProtocolFeatureEnabled(ルートのないチェーンは「無効」と読み取られます)、getAppliedPlanHeight。@qorechain/rdkは@noble/hashesに直接依存するようになりました(遷移ルートのSHAKE-256用。すでに@qorechain/sdk経由でインストールされていました)。テンプレートは@qorechain/rdk^0.6.1に固定されています。
0.6.0での変更点(行に別途記載がない限りTypeScript):
- 署名。
RdkClient.connectTx(signer, { pqcKeypair, rest })は、キーペアを渡すとハイブリッド(secp256k1 + ML-DSA-87)で署名します。渡さない場合はクラシック署名のみで署名し、ネットワークはそのトランザクションを拒否します。signerはOfflineDirectSignerである必要があり、手数料は明示的に指定する必要があります(fee、または接続時のgasPrice)。新しいヘルパーresolvePqcKeypairとpqcKeypairFromEnvは、ニーモニックから正規のML-DSA-87鍵とレガシーのML-DSA-87鍵の両方を導出し、アカウントがオンチェーンに登録しているほうを使用します。アカウントが別の鍵を保持している場合は、推測せずに拒否します。QORE_PQC_SEED_HEXは、生の秘密鍵で署名するオペレーターにシードを提供します。このキットは@qorechain/sdk^0.9.0に依存するようになったため、新規インストールではSDKのコピーが1つ(0.9.0)になります。0.5.0では、npmはキットの下にネストしてSDK 0.8.3をインストールしていました。 - アンカー付きバッチ。
MsgSubmitBatchはanchor_signatureとvalidator_set_hashを持ちます。RdkTxClient.submitBatchがアンカーに自分で署名するのは、クライアントがハイブリッドで署名し、RESTエンドポイントを持ち、かつロールアップの作成者である場合に限られます(チェーンはアンカーを作成者の登録済みの鍵に対して確認します)。それ以外の場合は、これまでどおりアンカーなしで送信します。アンカーなしでの送信を拒否させるにはanchor: "require"、署名しないようにするにはanchor: "off"、自分で取得した署名を送るにはanchorSignatureを渡します。anchorSignBytesForBatchは、帯域外で署名する作成者のためにv2のバイト列を構築します。これは、シーケンサーが別にあるロールアップで必要になります。ライブでは未検証です。 - 決済レシート。 PQCアカウントの照会は単数形のルート
/qorechain/pqc/v1/account/{address}を使用します(0.5.0は、ネットワークが提供していない複数形のパスを使用していました)。検証は両方のアンカー署名バイト列の形式に対応し、両方を試すのではなく、アンカーの高さによって一方を選びます。v3.2.2の切り替え前はv1、それ以降はv2です。レシートスキーマv2はchainIdを記録します。検証は、別のチェーンのノードに対して確認されたレシートを拒否し、signBytesVersionとchainBindingのチェックを報告します。バージョン1のレシートも引き続き検証できます。決済レシートを参照してください。 - 読み取り。
getLatestBatchは/qorechain/rdk/v1/latest_batch/{rollup_id}を呼び出し(0.5.0は、チェーンが提供していない形式を呼び出していました)、listBatchesはすべてのページをたどります(listBatchesPageは1ページを読み取ります)。RollupViewはescrowBalanceを持ち、ノードが報告する場合はchallengeWindowSec、challengeBond、proofSystemも持ちます。BatchViewはsubmittedTimeを持ちます。 - チャレンジウィンドウ。
batchChallengeWindowは、バッチのウィンドウをチェーンと同じ方法で計算し、ローカルの時計ではなくチェーンの先頭(getChainTip)に対して判定します。提出時刻が記録されているバッチではブロック時間の秒数(v3.2.4のルール:テストネットでは高さ8,337,253から、メインネットでは高さ3,742,566から)、それ以外では提出高から数えてwindow / 6ブロック(アップグレード高より前に提出されたバッチのルール)です。qorollup statusの背後にあるヘルスチェックとウォッチタワーはこれを使用します(ウォッチタワーを参照)。 - クロスVM。
encodeCrossVmCalldataは、ノードがデコードするレイアウトであるexecuteCrossVMCall(uint8,string,bytes)をエンコードするようになり、targetVmを受け取ります。isCrossVmPrecompileActiveは、有効なプリコンパイルのライブな一覧を読み取ります(マルチVMを参照)。 - 手数料の支払い前に確認されるルール。
rollupIdErrorは、構成を検証するときとcreateRollupがブロードキャストする前に、IDの文法を確認します。withdrawalErrorsは、executeWithdrawalがブロードキャストする前に出金を確認します。 - テンプレート。 スキャフォールドされたテンプレートは
pqcKeypairFromEnvを通じて接続するため、そのcreateとsubmit-batchのスクリプトはハイブリッドで署名し、@qorechain/rdk^0.6.0に依存していました(0.6.1のスキャフォルダー以降は^0.6.1)。multivm-rollupテンプレートは、プリコンパイルが有効であることを確認し、ターゲットからの空でない応答を必須とします。 - Python、Go、Rust、Java。 上記の読み取り側の修正(単数形のPQCルート、
latest_batch、アンカー署名バイト列v2、チャレンジウィンドウのルール、IDと出金のチェック)は、他の4言語の公開パッケージにも含まれています。 - 破壊的変更。
encodeCrossVmCalldataはtargetVmを受け取り、CROSS_VM_DEFAULT_SIGNATUREが変更されました。RollupHealthとBatchDeadlineは、従来の秒ベースの期限の代わりにchallengeWindowを持ちます。
0.8.0で残る制限事項:
-
ZK決済は、どちらのネットワークでも試されていません。
defiプロファイル、defi-rollupテンプレート、そしてzk決済で作成されたすべてのロールアップが影響を受けます。検証鍵メッセージはチェーン v3.2.7 以降、メインネットでは2026年11月12日から、テストネットでは2026年11月6日から有効になっていますが、ZKロールアップは作成されておらず、RDK 0.8.0 にはそのメッセージのビルダーがありません。当面はoptimistic決済を使用してください(ZK / STARKと出金を参照)。 -
defiテンプレートのデモ回路は検証できません。 これはsnarkjsの乗算器回路ですが、チェーンが確認するのはBLS12-381上のGroth16で、公開入力は3つ(直前のステートルート、新しいステートルート、データハッシュ)です。鍵の登録が可能になった後でも、デモ回路の証明は通りません。回路は独自のステート遷移回路に置き換えてください。 -
0.7.0で修正:出金のMerkleヘルパー。 0.6.2以前では、ヘルパーはデフォルトでSHA-256を使い、デフォルトで構築した証明はチェーン上で一度も検証を通りませんでした。0.7.0以降は
withdrawalsTree/assembleWithdrawalProofを使用してください(リーフとノードのエンコーディングを参照)。 -
ハイブリッド署名にはポスト量子鍵が必要です。 すべてのクライアント(TypeScript、0.7.1 以降の
qorollupCLI、0.8.0 以降の Python、Go、Rust、Java)は、ポスト量子キーペアを持っている場合にのみハイブリッドで署名します。持っていない場合、トランザクションはクラシック署名のみとなり、両ネットワークはこれを拒否します。それ以前のバージョンはクラシック署名のみで署名するため、0.7.1 より前の CLI と、0.8.0 より前の Python、Go、Rust、Java のクライアントは、ネットワークが受け付けるトランザクションを送信できません。Python のメッセージビルダーにはanchor_signatureやvalidator_set_hashのフィールドがありません(0.8.0 のソースで確認済み。他の 3 言語は未確認)。そのため、アンカー付きのバッチは Python からではなく、チェーンのCLI(--generate-only、続いてqorechaind tx pqc cosign)で構築・署名するか、pqcKeypair付きのTypeScriptクライアントを使用してください。 -
ハイブリッドでのロールアップ作成は、ライブでは試されていません。 どちらのネットワークにもロールアップが存在しないためです。アンカー付きバッチ、出金、レシートのフロー全体についても同様です。
-
アンカーには作成者が必要です。 バッチが同じトランザクション内でアンカーされるのは、作成者の署名がそこに含まれている場合に限られます。シーケンサーが別のアドレスである場合は、作成者がv2のバイト列を帯域外で署名し、シーケンサーがその結果を送信する必要があります。
-
0x…0901のクロスVMプリコンパイルはメインネットでは有効ではないため、そこではコントラクトからの呼び出しは何も行いません。テストネットでは許可リスト付きで有効で、2026年11月7日にeth_callで呼び出しをテストしました(マルチVMを参照)。 -
チャレンジウィンドウの長さ。 このキットがロールアップ独自のウィンドウを読み取るのは、ノードがそれを報告する場合に限られます(パッケージはこれをv3.2.4以降としており、両ネットワークがそれを実行しています)。そうでない場合は、モジュールのデフォルトのウィンドウを使用します。独自のウィンドウを設定したロールアップには
challengeWindowSecsを渡してください。古いヘルパーchallengeWindowDeadlineとisChallengeWindowClosedは引き続きエクスポートされており、引き続き秒を受け取るため、ブロック高を渡さないでください。 -
データ可用性。 blobを投稿するトランザクションはないため、
nativeまたはbothのロールアップのバッチはdataHashを空のままにする必要があります(データ可用性を参照)。buildDaBlobは0.6.2以前ではSHA-256でハッシュ化していましたが、0.7.0以降そのコミットメントはチェーンのSHAKE-256です。
0.8.0より前のバージョン。 0.7.0以前は、ネットワークが受け付ける qorollup のトランザクションを送信できず(0.7.1で修正)、0.8.0より前は Python、Go、Rust、Java のクライアントはトランザクションを一切送信できませんでした。0.6.2以前は、チェーン上で一度も検証を通らない出金証明を構築し、buildDaBlob をSHA-256でハッシュ化します。0.8.0を使用してください。0.6.1以前では、npmからインストールした qorollup CLIが何も出力せずコード0で終了する状態でした(0.6.2で修正)。0.6.0はレシート検証で比較するフィールドが0.6.1より少なく、チェーンが拒否するバッチを送信するテンプレート(ネイティブDAのロールアップにデータハッシュ、オプティミスティックのものにプレースホルダーのステートルート)を同梱しています。0.5.0以前は、決済レシート、ウォッチタワー、クロスVMのcalldataには使用しないでください。0.5.0は、ネットワークが提供していないルートで作成者の鍵を照会し(そのため、レシート検証は本物のレシートすべてでフェイルクローズしました)、v1のアンカーメッセージしか再構築せず、ブロック高をタイムスタンプとして読み取り(すべてのバッチの経過時間とチャレンジ期限が誤っており、ウォッチタワーはすべてのバッチについて期限アラートを即座に発しました)、チェーンが提供していないlatest-batchルートを呼び出し、最初の50件のバッチしか読み取らず、プリコンパイルがデコードしない関数をエンコードし、クラシック署名のみで署名するテンプレートを同梱していました。0.4.xのトランザクションクライアントにはハイブリッド署名がありませんでした。
Python、Go、Rust、Javaクライアント
TypeScriptパッケージに加えて、RDKはTypeScriptの機能面をそのまま反映した、Python、Go、Rust、Java の完全なクライアントを提供します:検証付きのコンフィグビルダー、5つのプリセットプロファイル、denom/economics/bech32ユーティリティ、バイナリMerkleと出金証明のヘルパー、ロールアップマニフェスト、RESTおよび qor_ JSON-RPC読み取りクライアント、プリフライト/ヘルスチェック、アカウント(ニーモニック → qor アドレス)、そして、0.8.0 以降はハイブリッドのトランザクション署名とブロードキャスト(ML-DSA-87 + secp256k1。両ネットワークが要求するとおりです。0.8.0 より前はクラシック署名のみで署名し、読み取りだけが動作しました — RDK 0.8.0:変更点と制限事項を参照)。すべて言語間で共有されるゴールデンベクターで検証されており、各レジストリで公開されています。
# Python — installs as qorechain-rdk, imports as qorrdk
pip install qorechain-rdk
# Rust
cargo add qorechain-rdk
# Go (pin the version)
go get github.com/qorechain/qorechain-rdk/packages/go@v0.9.0
# Java (Maven / Gradle)
# io.github.qorechain:qorechain-rdk:0.9.0 (needs Java 21)
import qorrdk
現在公開されているバージョンはすべて 0.9.0 です(2026年11月12日確認):Python qorechain-rdk(PyPI、インポート名 qorrdk)、Goモジュール github.com/qorechain/qorechain-rdk/packages/go(v0.9.0)、Rust qorechain-rdk(crates.io)、Java io.github.qorechain:qorechain-rdk(Maven Central。0.8.0 から Java 21 以降)。これらのクライアントはチェーンの状態を読み取り、0.8.0 以降は、ポスト量子キーペアを渡すとハイブリッドで署名したトランザクションを送信します(RDK 0.8.0:変更点と制限事項を参照)。
TypeScript RDKとそのテンプレートはデフォルトで qorechain-diana テストネットを対象としており、プリセットは公開ライブエンドポイントにそのまま到達します。バージョンを固定し、メインネットの前にテストネットで検証してください。
create-qorechain-rollup でプロジェクトをスキャフォールドする
各プロファイルには対応するスターターテンプレート(defi-rollup、gaming-rollup、nft-rollup、enterprise-rollup、custom-rollup)があります。どちらかの形式でスキャフォールドしてください。
npm create qorechain-rollup my-rollup
# or
npx create-qorechain-rollup my-rollup
非対話式 / CIで使う場合は、テンプレートとネットワークを明示的に渡します。
npx create-qorechain-rollup my-rollup --template defi-rollup --network testnet --yes
スキャフォルダーは、ドキュメント化されたステーク額と作成時バーンのコスト、およびロールアップを作成してそのステータスを読み取るための次のステップを表示します。
create-qorechain-rollup 0.9.0 のテンプレートは @qorechain/rdk ^0.9.0 に依存しています。その create と submit-batch のスクリプトは src/signer.ts の connectOperator() を通じて接続します。これは QORE_MNEMONIC(または QORE_OPERATOR_PRIVATE_KEY_HEX で署名する場合は QORE_PQC_SEED_HEX)からポスト量子鍵を解決し、チェーンに対して確認して、ハイブリッドで署名します。どちらも設定されていない場合、スクリプトは警告を出してクラシック署名のみで署名しますが、両ネットワークはこれを拒否します。テンプレートを通じてライブネットワーク上でロールアップが作成されたことはないため、この経路はライブでは未検証です。スターターの submit-batch スクリプトは参照用のフローにすぎません。0.6.1以降は dataHash を空のままにし(チェーンはネイティブDAのロールアップのデータハッシュを拒否します)、オプティミスティックテンプレートはプレースホルダーの代わりに正準ステートルートを公開します。それ以外には引き続き例示的な値を使用しており、ライブネットワーク上でバッチをファイナライズすることは想定されていません。defi-rollup テンプレート(ZK)は、チェーンが拒否するため、0.7.0からバッチを送信する前に停止します(ZK / STARKと出金を参照)。
コードからロールアップ構成を構築する
プリセットから構成を構築し、チェーンからライブのステーク額とバーン率を読み取って、作成メッセージを生成します。コンフィグビルダーは validate() / build() で決済 → 証明の互換性マトリクスを強制します。得られた値は、上記のCLI、または pqcKeypair を渡したTypeScriptクライアントで送信してください — RDK 0.8.0:変更点と制限事項を参照してください。
import { createRdkClient, presets, estimateCreationCost, uqorToQor } from "@qorechain/rdk";
// A config builder pre-filled with the defi preset's defaults; override via .set({ ... }).
const config = presets.defi({ rollupId: "my-defi-rollup" }).validate();
// The public qore.host endpoints are baked into the presets (RDK ≥ 0.4.2).
// `params()` is a REST read of /qorechain/rdk/v1/params, served on both networks.
const rdk = createRdkClient({ network: "testnet" });
// Read the live module parameters — never hardcode the stake or burn rate.
const params = await rdk.params();
const cost = estimateCreationCost({
stakeUqor: params.minStakeForRollup,
burnRate: params.rollupCreationBurnRate,
});
console.log(`Stake: ${uqorToQor(cost.stakeUqor)} QOR — burned: ${uqorToQor(cost.burnUqor)} QOR`);
// The values to pass to `qorechaind tx rdk create-rollup`.
const msg = config.toCreateMsg("<your qor address>", { stakeAmount: params.minStakeForRollup });
console.log(msg.rollupId, msg.profile, msg.vmType, msg.stakeAmount);
どのプロファイルが合うかわからない場合は?rdk.suggestProfile(...) はQCAI支援の推奨を返すことを意図したものですが、現在の公開エンドポイントでは常に defi のフォールバック(source: "fallback")を返します。そのため、プロファイル表から選んでください。
コードから状態を読み取る
型付きRESTクライアントは署名者を必要とせず、両方のネットワークを読み取れます。
const rollup = await rdk.rest.getRollup("my-defi-rollup");
console.log(rollup.status, rollup.settlementMode, rollup.daBackend, rollup.vmType);
バッチについては、rdk.rest.getBatch(rollupId, index) または qorechaind query rdk batch [rollup-id](後述)を使用してください。getLatestBatch と listBatches は、0.6.0以降、チェーンの latest_batch ルートとバッチ一覧のすべてのページを読み取ります(RDK 0.8.0:変更点と制限事項を参照)。
ライフサイクル管理
ロールアップは pending、active、paused、stopped の各状態を遷移します。新しいロールアップはすぐに active で開始されます。一時停止、再開、停止ができるのは作成者のみです(チェーンバージョン v3.2.0 以降で強制)。以下の各コマンドは、作成時と同じ2ステップのパターンに従います。未署名のトランザクションを生成し、続いて共同署名します。
一時停止(Pause)
ロールアップを一時的に停止します。状態は保持され、ロールアップは再開できます。理由の文字列が必須です。
qorechaind tx rdk pause-rollup [rollup-id] [reason] \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > pause.json
qorechaind tx pqc cosign pause.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana
再開(Resume)
以前に一時停止したロールアップを再開します。
qorechaind tx rdk resume-rollup [rollup-id] \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > resume.json
qorechaind tx pqc cosign resume.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana
停止(Stop)
ロールアップを永久に廃止し、そのステークを解放します。ステークされたQOR — 1回限りの作成時バーン、および出金や不正証明の報酬としてすでにロールアップのエスクローから支払われた分を差し引いた額 — が作成者に返還されます。v3.2.3以降、ロールアップごとのエスクロー台帳が各ロールアップの保有残高を記録しており、stop-rollup はまさにその残高を返還します。停止したロールアップは、以降の出金を支払いません。1,000 QORのレイヤー登録ステークは、ロールアップのレイヤーが廃止される際に別途返還されます。
チェーン v3.2.5 から(両ネットワーク): 最新のバッチが submitted または challenged のロールアップは停止できません。先にそのバッチを決済またはファイナライズしてください。停止したロールアップは、モジュールのロールアップ上限の枠を解放します。v3.2.5 より前は、どちらのルールも適用されていませんでした。TypeScriptからは、stopRollupError と stopRollup の事前チェックが、手数料を支払う前に教えてくれます。
qorechaind tx rdk stop-rollup [rollup-id] \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > stop.json
qorechaind tx pqc cosign stop.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana
ロールアップの停止は永久的です。停止したロールアップを再起動することはできません。
オペレーターコマンド:バッチとチャレンジ
ロールアップのオペレーターは決済バッチを提出し、チャレンジャーはオプティミスティックなバッチに異議を申し立てることができます。これらのコマンドは、ロールアップ概要 と ZK / STARKと出金 で説明されている決済レイヤーの基盤となるものです。
誰がどの順序で提出できるか
- バッチを提出できるのは、ロールアップに設定されたシーケンサーアドレスのみです。設定されていない場合(すべてのプリセットが該当)は、その作成者が提出します。 ベースドおよびシェアードのシーケンシングは、まだプロポーザーセットやロスターを受け付けません。現時点ではラベルにすぎず、提出するのは作成者です。
- バッチはチェーンを形成します。最初のバッチのインデックスは
0で、以降の各バッチは次のインデックスを使用し、直前のバッチの状態ルートをprev_state_rootとして持つ必要があります。 nativeまたはbothのロールアップで、データハッシュを持つバッチは、一致するブロブがすでに保存されていない限り拒否されます(データ可用性を参照)。データハッシュのないバッチはチェックされません。zkロールアップは証明を添付する必要があり、その証明は検証を通過しなければなりません。現時点ではZKバッチを受け付けることはできません(ZK / STARKと出金を参照)。- チェーン v3.2.5 から(両ネットワーク): バッチの
withdrawals_rootは空か、ちょうど32バイトでなければならず、ロールアップが保持できる保留中のオプティミスティックバッチは最大4,096件です(RDKのMAX_PENDING_OPTIMISTIC_BATCHES)。また、バッチはインデックス順にファイナライズされるため、後のバッチは、まだsubmittedまたはchallengedの前のバッチを待ちます。RDKはすべての提出の前にルートの長さを確認します。v3.2.5 より前は、この3つのルールはいずれも適用されていませんでした。
バッチを提出する
ロールアップの決済バッチを提出します。ロールアップID、バッチインデックス、16進エンコードされた状態ルートを取ります。最初のバッチ以降のすべてのバッチでは、直前のバッチの状態ルートを --prev-state-root として渡してください。
qorechaind tx rdk submit-batch [rollup-id] [batch-index] [state-root-hex] \
--prev-state-root <previous-state-root-hex> --tx-count 120 \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > batch.json
qorechaind tx pqc cosign batch.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana
| フラグ | 説明 |
|---|---|
--prev-state-root | バッチの開始点となる16進の状態ルート(インデックス 0 より後のすべてのバッチで必須) |
--tx-count | バッチに含まれるロールアップのトランザクション数 |
--data-hash | DA blobとして投稿されたバッチデータの16進ハッシュ(現時点では空のままにしてください。blobを投稿する手段がありません。データ可用性を参照) |
--withdrawals-root | バッチのL2 → L1出金の16進Merkleルート(ZK / STARKと出金を参照) |
--anchor-signature | v2アンカー署名バイト列に対する、ロールアップ作成者によるML-DSA-87の16進署名(v3.2.2以降)。バッチはその後、同じトランザクション内で x/multilayer にアンカーされ、アンカーが拒否されるとバッチも拒否されます |
--validator-set-hash | アンカーに含まれ、署名の対象となる16進のバリデーターセットのコミットメント |
--anchor-signature がない場合、バッチはアンカーされずに決済されます。バッチをアンカーするには、署名対象のバイト列を出力し、作成者の登録済みポスト量子鍵で署名して、その署名を渡してください(--tx-count と --validator-set-hash の値は、提出するものと一致している必要があります)。
qorechaind query rdk anchor-sign-bytes [layer-id] [batch-index] [state-root-hex] \
--chain-id qorechain-diana --tx-count 120
layer-id はロールアップのレイヤーIDです(RDKで作成されたロールアップでは、ロールアップIDと同じです)。TypeScriptからは、@qorechain/rdk 0.6.0 以降の RdkTxClient.submitBatch が、クライアントがハイブリッドで署名し、かつロールアップの作成者である場合にアンカーへ自動的に署名し、anchorSignBytesForBatch は作成者に帯域外で署名するためのバイト列を提供します(RDK 0.8.0:変更点と制限事項を参照)。zk ロールアップ用のZK --proof には現在CLIフラグがなく、resolve-challengeメッセージもCLIコマンドではありません。クライアントを使用してください。アンカーが何を証明し、何を証明しないかについては、決済レシートを参照してください。どちらのネットワークにも、ロールアップ、レイヤー、アンカーはまだ存在しません。
バッチにチャレンジする(オプティミスティックロールアップ)
どのアカウントでも、チャレンジ期間内(メインネットで高さ3,742,566より前に提出されたバッチではデフォルトで100,800ブロック。v3.2.4以降の新しいバッチでは、ブロック時間の秒数で表されるウィンドウで、テストネットでは高さ8,337,253から、メインネットでは高さ3,742,566から)であれば、保証金(ロールアップの challenge_bond。nft と custom プリセットでは1,000 QOR)と不正証明を提出することで、submitted 状態のバッチにチャレンジできます。オプティミスティックバッチは、そのステートルートが正準遷移ルートであるかどうかで判定されるため、提出者はまさにそのルートを公開する必要があります(RDKのテンプレートは0.6.1以降そうします。RDK 0.8.0:変更点と制限事項を参照)。ロールアップIDとバッチインデックスを取り、不正証明は --proof で渡します。
qorechaind tx rdk challenge-batch [rollup-id] [batch-index] \
--proof <hex-encoded-fraud-proof> \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > challenge.json
qorechaind tx pqc cosign challenge.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana
| フラグ | 説明 |
|---|---|
--proof | 16進エンコードされた不正証明 |
チャレンジはバッチを凍結(challenged)し、ファイナライズできなくなります。v3.2.5 より前は、ロールアップの作成者のみがこれを解決できました。v3.2.5 から(両ネットワーク)は、後述のとおりどのアカウントでも解決できます。解決はresolve-challengeメッセージで提出します(CLIコマンドとしては公開されていません。クライアントを使用してください)。結果はチェーン自身が、保存された証明を検証して決定します。不正が認められた場合、バッチは rejected となり、保証金は返還され、チャレンジャーにはロールアップのステークから保証金と同額が追加で支払われます。却下された場合は、保証金は作成者に渡り、バッチは submitted に戻ります。
チェーン v3.2.5 から(両ネットワーク): チャレンジの解決は作成者だけでなく、どのアカウントでも行えます。不正が認められると、そのバッチと、まだファイナライズされていないそれ以降のすべてのバッチが拒否され、シーケンサーは最後の正常なステートルートから、同じインデックスでそれらのバッチを再提出します。ロールアップはそこから続行されます。ウォッチタワーは、そのようなバッチをインデックスと状態ルートで区別します(ウォッチタワーを参照)。
バッチを確認する
# Latest batch for a rollup
qorechaind query rdk batch [rollup-id]
# A specific batch by index
qorechaind query rdk batch [rollup-id] --index 42
# A page of batches in index order (--limit up to 100, default 50)
qorechaind query rdk batches [rollup-id] --start 0 --limit 50
照会
| コマンド | 目的 |
|---|---|
qorechaind query rdk rollup [rollup-id] | 特定のロールアップの詳細 |
qorechaind query rdk list-rollups | 登録済みのすべてのロールアップ |
qorechaind query rdk batch [rollup-id] | 最新の決済バッチ(または --index) |
qorechaind query rdk batches [rollup-id] | インデックス順のバッチのページ(--start、--limit) |
qorechaind query rdk anchor-sign-bytes [layer-id] [batch-index] [state-root-hex] | バッチのv2アンカー署名バイト列(オフライン) |
qorechaind query rdk config | RDKモジュールのパラメータ |
qorechaind query rdk suggest-profile [use-case] | qor_suggestRollupProfile RPCへの案内を表示します。公開エンドポイントはこれを提供していないため、プリセットプロファイルの表からプロファイルを選んでください |
次のステップ
- データ可用性 — ネイティブ、Celestia、冗長DAバックエンド。
- ZK / STARKと出金 — 証明検証と、
execute-withdrawalによるL2 → L1の出金フロー。