ロールアップのデプロイ

アプリケーション専用ロールアップは3通りの方法でセットアップできます。ダッシュボード(リクエストフォーム。オンチェーントランザクションではありません)、チェーンのCLI(qorechaind、オンチェーントランザクションを完全に制御)、またはTypeScript RDK(@qorechain/rdk と create-qorechain-rollup スキャフォルダー)を使う方法です。TypeScript RDKは現時点では設定と読み取りを対象としています。このページではこの3つすべてに加えて、オペレーターのライフサイクルとバッチコマンドについても解説します。

初期段階の機能

どちらのネットワークでも、ロールアップはまだ1つも作成されていません。以下のコマンドは qorechain-diana テストネット(EVMチェーンID 9800、チェーンバージョン v3.2.2)を使用しています。メインネット(qorechain-vladi、EVMチェーンID 9801)はチェーンバージョン v3.2.1 で稼働しています。このページはメインネットの挙動を説明しており、より新しいテストネットのリリースでは細部が異なる場合があります。すべてのデプロイはまずテストネットで検証してください。

手数料と署名

ネットワークは最低ガス価格 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文字を使用します。小文字の英字、数字、.、_、- が使え、先頭は英字または数字にします。新しいチェーンリリースではこのルールが強制されるため、最初からこの形式を使ってください
アカウント	ポスト量子鍵が登録済みで、ステーク額、レイヤーステーク、トランザクション手数料をまかなうのに十分な残高を持つ、資金の入ったQoreChainアカウント

デプロイ前に、現在の最低ステーク額とバーン率のライブなモジュールパラメータを照会してください。

qorechaind query rdk config

---

ダッシュボード経由でのデプロイ(Tools → Rollups)

ダッシュボードは Tools → Rollups の下にロールアップをデプロイフォームを提供します。これはリクエストフォームです。送信すると、あなたのアカウント向けのプロビジョニングリクエストが記録され、The Qore Trustがレビューします。新しいリクエストはprovisioning(準備中)ステータスで表示されます。オンチェーンの create-rollup トランザクションをブロードキャストすることはありません — ロールアップをオンチェーンに登録するには、以下のCLIを使用してください。

手順

1. サインインする。 リクエストの送信や既存のリクエスト一覧の表示には認証済みセッションが必要です。
2. ロールアップに名前を付ける。 ロールアップ名を入力します(2〜41文字:英字、数字、スペース、ハイフン、アンダースコア)。
3. 仮想マシンを選ぶ。 オンチェーンのレコードにはVMのラベルが保存されます。ロールアップは独自のランタイムでオフチェーンで実行されます。この選択はQoreChain自身のEVM、CosmWasm、SVMレーン上では実行されません。
   • EVM — Hardhat、Foundry、MetaMaskなどフルのEthereumツールチェーンを使えるSolidity / Vyperコントラクト
   • CosmWasm — Cosmos SDKランタイム上のRustスマートコントラクト、ネイティブIBC対応
   • SVM — 並列実行・高スループットなアプリ向けのSolana Virtual Machine
4. データ可用性(DA)レイヤーを選ぶ。 誰でも状態を再構築できるよう、ロールアップがトランザクションデータを公開する先です:QoreChain DA、Celestia、EigenDAのいずれか。EigenDAはダッシュボードレベルのオプションであり、オンチェーンの x/rdk のDAバックエンドはネイティブ、Celestia、またはその両方である点に注意してください — 詳細はデータ可用性を参照してください。
5. ガストークンを設定する。 ロールアップ上での実行手数料の支払いに使うトークンです。デフォルトはQORです。独自のネイティブトークンを使う場合はカスタムシンボルを入力してください。
6. シーケンサーを選ぶ。 トランザクションを決済前にどう並べるかを決める主体です:Shared sequencer(QoreChainの共有セット)、Dedicated (single)(自前の単一シーケンサーを運用)、Decentralized(パーミッションレスなシーケンサーセット)のいずれかです。
7. 決済先を選ぶ。 ロールアップが状態ルートと妥当性証明をアンカーする先です:QoreChainメインネットまたはEthereum。
8. リクエストを送信する。 プロビジョニングは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プロファイルは作成時に受け付けられますが、この方法で作成したロールアップには検証鍵(verifying key)が含まれないため、そのZKバッチはまだファイナライズできません(ZK / STARKと出金を参照)。

フラグ:

フラグ	デフォルト	説明
--vm	(空 — プロファイルのVMを使用)	ロールアップのVMタイプを上書きします:evm、cosmwasm、svm、または custom。プリセットのVMを適用するには未設定のままにします。(RDKクライアントでは、WasmランタイムはVMタイプ native — QoreChain Native — で、cosmwasm はレガシーエイリアスとして残されています。cosmwasm はワイヤー上の値であり、このチェーンレベルのフラグが受け付ける値です。)

VMラベルはメタデータです

--vm はロールアップがどのランタイムを使うかを記録します。ホストチェーンはロールアップを決済するだけで、そのコントラクトを実行することはありません。ホストチェーン自体のCosmWasmアップロードは現在閉じられており、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パッケージとして提供されています。現時点では、構成の構築と検証、および状態の読み取りに最も役立ちます。トランザクション送信にこれらを頼る前に、以下の署名に関する注意を確認してください。

• @qorechain/rdk(v0.4.4)— TypeScript SDK:プリセットプロファイル付きのコンフィグビルダー、ロールアップおよび決済バッチのライフサイクル向けトランザクションヘルパー、ネイティブDA、型付き読み取りクライアント、そしてv0.4で追加された機能 — 量子安全な決済レシート、QCAI Rollup Copilot、クロスVMのcalldataヘルパー、ウォッチタワー。
• create-qorechain-rollup(v0.4.4)— プロファイルごとに実行可能なスターターテンプレートを1つクローンするスキャフォルダー(multivm-rollup テンプレートを含む)。

これらはnpmで公開されています。リポジトリには公開済みのオペレーターCLI @qorechain/rdk-cli(qorollup、v0.4.4)も含まれており、doctor、create、status、watch、params、suggest、ライフサイクル(pause/resume/stop)、keygen、manifest、withdraw、faucet の各コマンドと、v0.4の receipt、advise、watchtower コマンドが利用できます。

初回のv0.4.0リリース以降のハイライト:

• 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リリースで、これらの機能がSDK経由でRDKのTypeScriptユーザーに直接届きます。RDKのAPI変更はありません。

公開クライアントでの署名

両ネットワークでは、ネイティブレーンのすべてのトランザクションにハイブリッド(secp256k1 + ML-DSA-87)署名が必要です。現在公開されているnpmパッケージ(@qorechain/rdk 0.4.4)はクラシック署名のみのクライアントを通じて署名するため、チェーンの状態を読み取ることはできますが、トランザクションを受理させることはできません。現時点でトランザクションを送るには、CLI(--generate-only、続いて qorechaind tx pqc cosign)または@qorechain/sdkのハイブリッド署名で構築・署名してください。Python、Go、Rust、JavaのRDKクライアントもクラシック署名のみで、これらのネットワークでのトランザクションには適していません。インストールするバージョンを確認してください。RDKクライアントにハイブリッド署名を追加するリリースがあれば、ここに記載されます。

読み取りにはRDKのRESTルートが必要です

TypeScriptの読み取りヘルパー(rdk.params()、rdk.rest.getRollup())は /qorechain/rdk/v1/… のRESTルートを呼び出しますが、公開メインネットのエンドポイントは現在これを提供していません。メインネットでは qorechaind query rdk …(gRPC)を使用してください。

Python、Go、Rust、Javaクライアント

TypeScriptパッケージに加えて、RDKはTypeScriptの機能面をそのまま反映した、Python、Go、Rust、Java の完全なクライアントを提供します:検証付きのコンフィグビルダー、5つのプリセットプロファイル、denom/economics/bech32ユーティリティ、バイナリMerkleと出金証明のヘルパー、ロールアップマニフェスト、RESTおよび qor_ JSON-RPC読み取りクライアント、プリフライト/ヘルスチェック、アカウント(ニーモニック → qor アドレス)、そしてクラシックなトランザクション署名とブロードキャスト(SIGN_MODE_DIRECT。ハイブリッド署名のネットワークでは受け付けられません — 上の注意を参照)。すべて言語間で共有されるゴールデンベクターで検証されており、各レジストリで公開されています。

# Python — installs as qorechain-rdk, imports as qorrdk
pip install qorechain-rdk

# Rust
cargo add qorechain-rdk

# Go
go get github.com/qorechain/qorechain-rdk/packages/go

# Java (Maven / Gradle)
# io.github.qorechain:qorechain-rdk:0.4.4

import qorrdk

現在公開されているバージョン:Python qorechain-rdk 0.5.0(PyPI、インポート名 qorrdk)、Goモジュール github.com/qorechain/qorechain-rdk/packages/go(v0.5.0)、Rust qorechain-rdk 0.4.4(crates.io)、Java io.github.qorechain:qorechain-rdk 0.4.4(Maven Central)。これらのクライアントはチェーンの状態を読み取りますが、ネットワークが要求するハイブリッド署名は生成しません(上の注意を参照)。

注記

TypeScript RDKとそのテンプレートはデフォルトで qorechain-diana テストネットを対象としており、v0.4.2以降はプリセットが公開ライブエンドポイントにそのまま到達します。バージョンを固定し、メインネットの前にテストネットで検証してください。

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

スキャフォルダーは、ドキュメント化されたステーク額と作成時バーンのコスト、およびロールアップを作成してそのステータスを読み取るための次のステップを表示します。

テンプレートがインストールするRDKのバージョンを確認する

テンプレートは現在 @qorechain/rdk を0.2系に固定しています。スキャフォールド後に npm install @qorechain/rdk@latest を実行して、公開 qore.host エンドポイントのプリセットと現行の読み取りクライアントを取得してください。スターターの submit-batch スクリプトは参照用のフローにすぎません。例示的なルートとサンプル証明を送信するもので、ライブネットワーク上でバッチをファイナライズすることは想定されていません。

コードからロールアップ構成を構築する

プリセットから構成を構築し、チェーンからライブのステーク額とバーン率を読み取って、作成メッセージを生成します。コンフィグビルダーは validate() / build() で決済 → 証明の互換性マトリクスを強制します。得られた値は、上記のCLI(またはハイブリッド署名に対応したクライアント)で送信してください — 署名に関する注意を参照してください。

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: it works where the RDK REST routes are served and
// is refused (HTTP 501) on mainnet today — use `qorechaind query rdk config` there.
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クライアントは署名者を必要とせず、RDKのRESTルートが提供されている環境で動作します(現在のメインネットでは動作しません)。

const rollup = await rdk.rest.getRollup("my-defi-rollup");
console.log(rollup.status, rollup.settlementMode, rollup.daBackend, rollup.vmType);

バッチについては、qorechaind query rdk batch [rollup-id](後述)を使用してください。

---

ライフサイクル管理

ロールアップは 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回限りの作成時バーンを差し引いた額 — が作成者に返還されます。1,000 QORのレイヤー登録ステークは、ロールアップのレイヤーが廃止される際に別途返還されます。

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 / STARKと出金を参照)。

バッチを提出する

ロールアップの決済バッチを提出します。ロールアップID、バッチインデックス、16進エンコードされた状態ルートを取ります。

qorechaind tx rdk submit-batch [rollup-id] [batch-index] [state-root-hex] \
  --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

CLIコマンドはこの3つの位置引数しか取らないため、提出できるのはバッチ0のみです。以降のバッチには、prev_state_root(および、使う場合は data_hash、withdrawals_root、tx_count)を設定できるクライアントが必要です。ロールアップのバッチは決済されますが、現在のメインネットでは x/multilayer にアンカーされません(Rollup Development Kitを参照)。

バッチにチャレンジする(オプティミスティックロールアップ)

どのアカウントでも、チャレンジ期間内であれば、保証金(ロールアップの challenge_bond。nft と custom プリセットでは1,000 QOR)と不正証明を提出することで、submitted 状態のバッチにチャレンジできます。ロールアップ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)し、ファイナライズできなくなります。その後、ロールアップの作成者がresolve-challengeメッセージでこれを解決します(CLIコマンドとしては公開されていません。クライアントを使用してください)。結果はチェーン自身が、保存された証明を検証して決定します。不正が認められた場合、バッチは rejected となり、保証金は返還され、チャレンジャーにはロールアップのステークから保証金と同額が追加で支払われます。却下された場合は、保証金は作成者に渡り、バッチは submitted に戻ります。

バッチを確認する

# Latest batch for a rollup
qorechaind query rdk batch [rollup-id]

# A specific batch by index
qorechaind query rdk batch [rollup-id] --index 42

---

照会

コマンド	目的
qorechaind query rdk rollup [rollup-id]	特定のロールアップの詳細
qorechaind query rdk list-rollups	登録済みのすべてのロールアップ
qorechaind query rdk batch [rollup-id]	最新の決済バッチ(または --index)
qorechaind query rdk config	RDKモジュールのパラメータ
qorechaind query rdk suggest-profile [use-case]	qor_suggestRollupProfile RPCへの案内を表示します。公開エンドポイントはこれを提供していないため、プリセットプロファイルの表からプロファイルを選んでください

---

次のステップ

• データ可用性 — ネイティブ、Celestia、冗長DAバックエンド。
• ZK / STARKと出金 — 証明検証と、execute-withdrawal によるL2 → L1の出金フロー。