ZK / STARK と出金
このページでは、関連する 2 つのトピックを取り上げます。ZK 決済ロールアップが使用する ZK 証明システム(snark と stark)と、バッチが確定した後にロールアップから QoreChain へ資金を戻す L2 → L1 出金フロー です。
どちらのネットワークにも、まだロールアップは作成されていません(2026年10月27日時点で確認)。そのため、ここで説明する証明検証も出金フローも、稼働中のロールアップでは一度も実行されていません。メインネットで出金が成功し得るのは v3.2.3(高さ 3,662,051、2026年10月20日)以降のみで、この時点でロールアップごとのエスクロー台帳が稼働を開始しました(資金の出どころを参照)。それ以前は、すべての出金が失敗していました。ZK 決済は、どちらのネットワークでもまだ試されていません(defi プロファイルとすべての zk ロールアップ)。検証鍵メッセージはチェーン v3.2.7 で加わりました(テストネットでは 2026年11月6日から、メインネットでは 2026年11月12日から)。鍵が登録されていない ZK バッチは拒否されます。STARK の検証は実験的です。qorechain-diana テストネットで検証してください。また、メインネットでの本番強化された保証は前提にしないでください。
ZK 証明システム
ZK 決済ロールアップ(zk 決済モード)は、各決済バッチに有効性証明を添付し、ロールアップのトランザクションを再実行することなく、ステート遷移が正しいことを証明します。ZK 決済は 2 つの証明システムをサポートします。
| 証明システム | 特性 |
|---|---|
snark | 簡潔な証明(BLS12-381 上の Groth16)。ロールアップの検証鍵に対してオンチェーンで検証されます |
stark | 透明な証明、トラステッドセットアップ不要 — 実験的。オプトインで、デモンストレーション用回路に紐づきます |
zk 決済モードは snark または stark のいずれかを必要とします。このペアリングは、ロールアップ作成時にオンチェーンで強制されます。対照的に、optimistic 決済は fraud 証明システムを使用し、based と sovereign 決済は none を使用します。完全な互換性マトリックスについては ロールアップ概要 を参照してください。
ファイナリティ
不正証明のチャレンジウィンドウを待つオプティミスティックロールアップとは異なり、ZK バッチは 有効な証明検証 によって確定でき、紛争ウィンドウを必要としません。これが ZK 決済の核心的なトレードオフです。証明生成のコストと複雑さと引き換えに、より強力で高速なファイナリティが得られます。
成熟度
ZK 決済は、どちらのネットワークでもエンドツーエンドでは試されていません。 SNARK バッチは、ロールアップとともに保存された検証鍵に対して、オンチェーンで検証されることになっています(BLS12-381 上の Groth16。3 つの公開入力: 直前のステートルート、新しいステートルート、データハッシュ)。チェーン v3.2.7 より前は、その鍵を登録する手段がなく、zk 決済で作成されたロールアップは鍵を持たず、それが提出するすべての ZK バッチは手数料が支払われた後に拒否されていました。チェーン v3.2.7 で登録メッセージが加わり、メインネットでは 2026年11月12日から有効です。テストネット(v3.2.7 は 2026年11月6日に適用)では、ZK ロールアップが検証鍵を登録できます。テストネットは MsgSetVerificationKey と、その後の MsgUpdateVerificationKey を受け付けます(2026年11月7日に、それぞれを空の本文でシミュレートして確認しました。メッセージタイプの解決を通過し、空のアドレスフィールドでのみ失敗しました)。リリースノートには、鍵のない ZK バッチは手数料が支払われる前に拒否されると書かれています。同じ確認は、メインネットが v3.2.7 を適用した後には繰り返しておらず、メインネットにはロールアップが存在しません(GET /qorechain/rdk/v1/rollups は 2026年11月12日に空のリストを返しました)。RDK 0.8.0 にはこれらのメッセージのビルダーがなく、テストネットにはロールアップが存在しないため、ZK バッチがエンドツーエンドで検証されたことはありません。defi テンプレートのデモ回路(snarkjs の乗算器)は、チェーンが確認する公開入力を持たないため、依然として検証できません。独自の回路が必要になります。RDK 0.7.0 以降、defi-rollup テンプレートはバッチの送信の前で停止するため、チェーンが必ず拒否するバッチに手数料を使うことはなくなりました。STARK の検証は実験的です。オプトインであり、ロールアップ自身のステート遷移ではなく、デモンストレーション用回路を検証します。現在使用できる決済としては、optimistic(nft および custom プロファイル)を選択してください。
バッチが出金をどのように運ぶか
ロールアップがバッチを決済するとき、そのバッチはロールアップのアウトバウンドなクロスレイヤーメッセージ — その L2 → L1 出金 — もコミットできます。概念的には次のとおりです。
- 確定したバッチは、その出金の集合へのコミットメント(バッチの出金メッセージに対する Merkle ルート)を運ぶことができます。
- 個々の出金は、そのルートの下にあるリーフであり、バッチインデックスと出金インデックスによって識別されます。
- バッチが確定すると、任意の当事者が、特定の出金リーフがコミットされたルートの下に含まれていることを証明し、支払いをトリガーできます。
これが、出金が決済に依存する理由です。出金は 確定した バッチに対してのみ実行できます。なぜなら、コミットされた出金ルートを正規のものにするのは確定だからです。
バッチがどのように提出され確定されるか — オプティミスティックロールアップ向けの submit-batch と challenge-batch 紛争パスを含む — については、ロールアップのデプロイ を参照してください。
出金の実行: execute-withdrawal
execute-withdrawal コマンドは、確定したバッチの出金ルートに対して L2 → L1 出金を確定します。出金リーフがそのルートにコミットされていることを証明し、rdk モジュールのエスクローから受取人に支払います。このアクションは パーミッションレス です — 誰でも有効な証明を提出できます。ネイティブレーンのすべてのトランザクションと同様に、ハイブリッドのポスト量子共同署名が必要です。そのため --generate-only で作成し、cosign してください(ロールアップのデプロイ を参照)。出金はまだ稼働中のロールアップで実行されたことがないため、このフローは未検証として扱ってください。手数料を支払う前に次の点を確認してください。そうでない場合、チェーンはトランザクションを拒否します。通貨単位はちょうど uqor であること、金額が正であること、証明は最大 64 レベルで、すべての兄弟がちょうど 32 バイトであること、提出者と受取人が有効な qor1… アドレスであること、バッチが確定済みで withdrawals_root をコミットしていること、ロールアップが停止していないこと、そしてその出金リーフがまだ支払われていないことです。TypeScript の @qorechain/rdk(0.6.0 以降)は、これらのうち最初のグループのチェックを代わりに実行し(withdrawalErrors: アドレス、通貨単位、金額、証明の深さ、兄弟の長さ)、いずれかが失敗すると executeWithdrawal はブロードキャストの前にスローします。0.7.0 以降は、qorollup withdraw --file withdrawal.json [--dry-run] も、バッチの出金から証明を構築し、その結果がバッチのオンチェーンの withdrawals_root と一致しない場合は、手数料を支払う前に拒否します。バッチ、ロールアップ、台帳に関する条件はチェーンの状態に依存しますが、このチェックはそれを読み取りません。
qorechaind tx rdk execute-withdrawal \
[rollup-id] [batch-index] [withdrawal-index] [recipient] [denom] [amount] \
--proof <sibling-hash-1>,<sibling-hash-2>,... \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > withdrawal.json
qorechaind tx pqc cosign withdrawal.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana
位置引数:
| 引数 | 説明 |
|---|---|
rollup-id | 出金が属するロールアップ |
batch-index | この出金を出金ルートにコミットしている確定済みバッチ |
withdrawal-index | そのバッチ内の出金リーフのインデックス |
recipient | 支払先のアドレス |
denom | 支払う通貨単位 |
amount | 支払う金額 |
フラグ:
| フラグ | 説明 |
|---|---|
--proof | リーフからルートへ順に並べた、カンマ区切りの 16 進 Merkle 兄弟ハッシュ。出金リーフがバッチの出金ルートにコミットされていることを証明します |
--proof の値は包含証明です。すなわち、出金リーフからバッチのコミットされた出金ルートまでのパスに沿った兄弟ハッシュです。モジュールはリーフと提供された兄弟からルートを再計算し、支払いを行う前に、確定済みバッチのコミットされたルートと照合します。
リーフとノードのエンコーディング
- リーフ(第 1 の形式、チェーン v3.2.5 より前のバッチ用) =
rollup_id、0x00バイト、出金インデックス(8 バイト・ビッグエンディアン)、recipient文字列、0x00、denom文字列、0x00、amount(8 バイト・ビッグエンディアン)の SHAKE-256(32 バイト)。 - リーフ(第 2 の形式、チェーン v3.2.5 以降、両ネットワーク): チェーン v3.2.5 のバッチでは、リーフにチェーン ID も含まれます。RDK は両方の形式を構築します(
withdrawalLeafV1、withdrawalLeafV2)。 - 親 =
left || rightの SHAKE-256。各レベルで、出金インデックスの対応するビットが側を決定します。0は、リーフ(または途中のハッシュ)が左ノードであることを意味するため、ツリー内のリーフの位置はその出金インデックスです。 - すべての兄弟ハッシュは、ちょうど 32 バイトでなければなりません。
- 出金ルート(チェーン v3.2.5 以降、両ネットワーク): バッチの
withdrawals_rootは空か、ちょうど 32 バイトのいずれかです。v3.2.5 より前は、この長さのルールは適用されていませんでした。
このツリーを自前で組み立てないでください。@qorechain/rdk 0.7.0 以降の withdrawalsTree(および Python、Go、Rust、Java の同等のもの)は、バッチの出金ルートとすべての証明をチェーンとまったく同じように構築し、チェーン自身の検証器と照合して確認されています。assembleWithdrawalProof はデフォルトでチェーンのツリーを構築し、汎用の Merkle ヘルパーもデフォルトで SHAKE-256 を使うようになりました。
@qorechain/rdk 0.6.2 以前では、汎用の binaryMerkleRoot / binaryMerkleProof ヘルパー(および Python、Go、Rust、Java の同等のもの)は、デフォルトで SHA-256 を使い、奇数ノードを複製し、各リーフを再ハッシュしていましたが、チェーンは SHAKE-256 を使い、リーフを出金から構築します。そのため、これらのデフォルトで構築した証明はオンチェーンで検証されませんでした。0.7.0 にアップグレードするか、ハッシュとリーフのエンコーディングを上記のルールに合わせて上書きしてください。そうしないと、証明はオンチェーンで検証されません。
資金の出どころ
出金は、ロールアップ自身のエスクローされたステーク(ステークから作成時の 1% のバーンを差し引いたもの)から支払われます。すべてのロールアップのエスクローは 1 つのプールされたモジュール残高にありますが、v3.2.3 以降は、ロールアップごとの エスクロー台帳 が、各ロールアップが保有する額の帳簿となります。create-rollup はロールアップが保持するエスクローをそこに計上し、出金や不正証明の報酬はそこから支払われて差し引かれ、ロールアップがまだ保有している額を超える出金は、エスクロー不足のエラーで拒否されます。stop-rollup は残りだけを返金して台帳をゼロにし、停止したロールアップはそれ以降の出金を支払いません。したがって、あるロールアップについて証明された出金が、別のロールアップのステークから支払われることはありません。ロールアップのクエリには escrow_balance(そのロールアップのためにまだ保持されている uqor)が含まれます。モジュールには L1 → L2 のデポジットメッセージがないため、これはユーザー資金のブリッジではありません。
エンドツーエンドの出金フロー
L2 から L1 へのパス: 決済バッチが出金ルートをコミットし、バッチが確定し、その後パーミッションレスな包含証明が QoreChain 上でエスクローされた資金を解放します。
- バッチを決済する。 ロールアップオペレーターは
submit-batchで決済バッチを提出します。バッチは、そのアウトバウンドな L2 → L1 メッセージに対する出金ルートをコミットできます。 - 確定する。 バッチは、ロールアップの決済モードに従って確定します。
zkの場合は有効な証明検証時に、optimisticの場合はチャレンジウィンドウ後に(その間、challenge-batchがそれを争うことがあります)。チェーン v3.2.5 以降(テストネットは 2026 年 10 月 26 日から、メインネットは 2026 年 10 月 29 日から)、バッチはインデックス順に厳密に確定するため、まだsubmittedまたはchallengedの状態にある以前のバッチがあれば、そのバッチは待機します。オプティミスティックのウィンドウは、v3.2.4 アップグレード前に提出されたバッチではデフォルトで 100,800 ブロックです。v3.2.4 以降は、アップグレード高以降に提出されたバッチについて、ブロック時間の秒数で計測されます(テストネットでは 2026年10月19日の高さ 8,337,253 から、メインネットでは 2026年10月23日の高さ 3,742,566 から)。 - 証明して実行する。 確定後、誰でも特定の出金リーフに対する Merkle 包含証明(
--proof)を添えてexecute-withdrawalを提出します。モジュールは確定済みバッチの出金ルートに対して包含を検証し、エスクローから受取人に支払います。
ステップ 3 はパーミッションレスかつ証明ベースであるため、出金を運ぶバッチが確定した後は、出金はロールアップオペレーターの協力に依存しません。
関連
- ロールアップ概要 — 決済パラダイムと証明システムの互換性マトリックス。
- ロールアップのデプロイ —
submit-batchおよびchallenge-batchオペレーターコマンド。 - ロールアップ開発キット — 低レベルのモジュールリファレンス。