クロス VM 相互運用性
QoreChain のトリプル VM アーキテクチャ(EVM、QoreChain Native、SVM)は、いずれかの仮想マシン上のスマートコントラクトが、他のいずれの VM 上のコントラクトとも通信できるように設計されています。x/crossvm モジュールは、同一トランザクション内のパスとキューに入るパスを持つ呼び出しメッセージを提供します。
クロス VM 呼び出しは、ターゲットとなるレーンが利用可能な範囲でのみ利用できます。
MsgCrossVMCallは、メインネットではサーキットブレーカーによって無効化されています(qorechaind query circuit disabled-list)。テストネットでは有効です。- 両ネットワークとも、トランザクションに対して SVM レーンは無効であるため、SVM 側の処理は実行できません。
- QoreChain Native のアップロードは両ネットワークで許可制であり、インスタンス化はメインネットで許可制です。メインネットには保存されたコントラクトコードがないため、メインネットには呼び出せる QoreChain Native コントラクトはまだありません。テストネットでは、ガバナンスが審査済みのコントラクトをいくつか保存しており、どのアカウントでもインスタンス化できます(QoreChain Native 開発を参照)。そのため、テストネットには QoreChain Native のターゲットが存在し得ます。
- 同期の EVM プリコンパイルはメインネットでは有効ではなく、テストネットでは、審査済みの QoreChain Native コントラクトの許可リスト付きで有効です(2026 年 11 月 7 日に確認。v3.2.7 アップグレード後に、これを経由した読み取り専用の呼び出しを実行しました。下記参照)。強化版が v3.2.3 以降バイナリに含まれています。(2026 年 10 月 27 日に、テストネットのガバナンスが他の 3 つのプリコンパイル、PQC Verify、PQC Key Status、PRISM Consensus Params を有効化し、CrossVM ブリッジは 11 月 4 日までにテストネットの一覧に加わりました。メインネットで有効なものはありません。)
メインネットでは、モジュールの REST ルート(/qorechain/crossvm/v1/...)は公開ゲートウェイでは提供されていません(501)。メッセージは CLI または gRPC/ABCI クエリクライアントで読み取ってください。
以下のエンドポイントはローカルノードをデフォルトとします。メインネットでは qorechain-vladi の RPC エンドポイント(Cosmos RPC 26657、EVM JSON-RPC 8545)を使用してください。テストネットは qorechain-diana です。
アーキテクチャの概要
EVM (Solidity) QoreChain Native (Rust/Wasm) SVM (BPF)
| | |
|--- sync (precompile) ->| |
| | |
|<-- async (EndBlocker) -|-- async (EndBlocker) ->|
| | |
|<------------ async (EndBlocker) ----------------|
| パス | 方向 | タイミング | メカニズム |
|---|---|---|---|
| 同期 | EVM から QoreChain Native | 同一トランザクション | 0x0000...0901 のプリコンパイル(テストネットでは有効、メインネットでは有効ではありません。下記参照) |
| メッセージ(デフォルト) | 任意の VM から他の任意の VM | 同一トランザクション | MsgCrossVMCall。呼び出しは即座に実行され、失敗するとトランザクション全体がリバートされます |
| メッセージ(キュー) | 任意の VM から他の任意の VM | 次のブロック(またはそれ以降) | async を指定した MsgCrossVMCall。メッセージはキューで待機します |
同期パス(EVM から QoreChain Native)
同期パスは、アドレス 0x0000000000000000000000000000000000000901 にある EVM プリコンパイルを使用します。Solidity コントラクトが QoreChain Native コントラクトを呼び出し、同一トランザクション内でレスポンスを受け取れるように設計されています。
CrossVM ブリッジのプリコンパイルは、qorechain-vladi では有効ではありません。そこでの 0x…0901 への呼び出しは成功し、空のデータを返します。qorechain-diana では active_static_precompiles のリストに 0x…0901 が含まれています(2026 年 11 月 7 日に確認)。v3.2.7 アップグレード後の 2026 年 11 月 7 日に、これを経由した読み取り専用の eth_call を実行しました(結果は下記)。v3.2.3 バイナリには強化版が含まれています(STATICCALL を拒否し、ネストした呼び出しを呼び出しフレームのガスで計量し、EVM のリバートが QoreChain Native 側も取り消すようにジャーナルに記録し、許可リストに載った QoreChain Native ターゲットにのみ到達し、クロス VM サーキットブレーカーを尊重します)が、ガバナンスで承認された提案によって有効リストに追加された場所でのみ動作します(これまでのところテストネットのみで、メインネットは対象外です)。メインネットでは、2026年11月12日の v3.2.7 アップグレード後も、別途ガバナンスの決定があるまで、プリコンパイルとクロス VM 呼び出しはオフのままです。以下の例はノードがデコードするレイアウトです。プリコンパイルが有効になるまでメインネットでは実行できません。テストネットでは、許可リストの範囲内で呼び出せます(次のセクション)。EVM Precompiles: Network status を参照してください。
Solidity の例
ノードは、プリコンパイルの入力を、4 バイトのセレクターと、それに続く executeCrossVMCall(uint8 targetVM, string targetContract, bytes payload) の ABI エンコードされた引数としてデコードします(セレクターは 0x3c11078c)。targetVM は、QoreChain Native コントラクトの場合は 1 です(QoreChain Native は CosmWasm ランタイムです。0 は EVM で、強化版ブリッジはこれをターゲットとして拒否します)。targetContract はコントラクトの bech32 アドレスを文字列にしたもので、payload はコントラクトの execute メッセージを UTF-8 の JSON バイト列にしたものです。プリコンパイルは、ターゲットの生のレスポンスバイト列を返します。
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;
contract CrossVMCaller {
address constant CROSSVM = 0x0000000000000000000000000000000000000901;
uint8 constant TARGET_QORECHAIN_NATIVE = 1;
function callQoreChainNative(string calldata contractAddr, bytes calldata executeMsg)
external
returns (bytes memory)
{
bytes memory data = abi.encodeWithSignature(
"executeCrossVMCall(uint8,string,bytes)",
TARGET_QORECHAIN_NATIVE,
contractAddr,
executeMsg
);
(bool ok, bytes memory ret) = CROSSVM.call(data);
require(ok, "cross-VM call failed");
// While the precompile is not active, the call succeeds with empty data
// and nothing executes; treat an empty reply as a failure.
require(ret.length > 0, "cross-VM precompile not active or empty reply");
return ret;
}
}
これはノードがデコードするレイアウトであり、@qorechain/rdk のエンコーダーが構築するレイアウトと同じです。上記のコントラクトは、マルチ VM のスターターと一致します。プリコンパイルを通じて資金を添付することはできません(MsgCrossVMCall のメッセージパスは --funds を受け付けます)。プリコンパイルがメインネットでは有効ではないため、このサンプルは現在メインネットでは何も実行できません。テストネットでは、次に説明する許可リストの範囲内で動作します。サンプルのコントラクト自体はこのページのためにデプロイしておらず、以下の呼び出しは eth_call で直接行いました。
プリコンパイルが有効な場所では、プリコンパイルが QoreChain Native コントラクトを即座に実行して結果を返します。(@qorechain/rdk のヘルパー encodeCrossVmCalldata(0.6.0 から利用可能で、現行の 0.8.0 にも含まれます)が calldata を構築します。マルチ VM を参照してください。)ガスコスト:基本 50,000 + 入力 1 バイトあたり 4 + 実行コスト。
テストネットでの動作(許可リスト、2026 年 11 月 7 日に確認)
qorechain-diana(ノードリリース v3.2.8、2026 年 11 月 12 日から)では、プリコンパイルはブリッジの許可リストにある QoreChain Native コントラクトにのみ到達します。GET /qorechain/crossvm/v1/params は、それらを bridge_allowed_targets に列挙します(2026 年 11 月 7 日時点で 3 件。cosmwasm:qor1... の形式)。同じ箇所に enabled が true、max_message_size が 65536、max_queue_size が 1000、queue_timeout_blocks が 100 と並びます。2026 年 11 月 7 日に、executeCrossVMCall(1, target, 0x7b7d) を使って 0x…0901 に対する読み取り専用の eth_call を 2 回実行しました。
- 許可リスト外のターゲット:
cross-VM bridge call refused: target cosmwasm:qor1... is not allowlistedでリバートします。 - 許可リスト内のターゲット: 呼び出しはコントラクトに到達します(空の
{}メッセージに対して、ノードはコントラクト自身のエラーError parsing into type cw20::msg::Cw20ExecuteMsgを報告します)。これは経路が機能していることを示します。このページのために、プリコンパイル経由で状態を変更するクロス VM トランザクションは送信していません。
メインネットでは、2026年11月12日の v3.2.7 アップグレード後も、別途ガバナンスの決定があるまで、プリコンパイル(0x…0901)とクロス VM 呼び出しはオフのままです(サーキットブレーカー)。
v3.2.7 でクロス VM 呼び出しに加わる変更
これらは 2026 年 11 月 6 日からテストネットで、2026 年 11 月 12 日からメインネットで適用されています(メインネットではクロス VM 呼び出し自体がオフのままなので、オンに切り替えた場合にのみ関係します)。
- ターゲット VM で失敗した呼び出しは、きれいに失敗するようになりました。それはその呼び出しだけの失敗であり、キューは次のメッセージに進みます。
- 不正な形式のターゲットは、送信時にコードスペース
crossvmのコード 5 で拒否されます。 - クロス VM 呼び出しは、EVM プリコンパイルのアドレスをターゲットにできなくなりました。
メッセージパス(MsgCrossVMCall)
その他のクロス VM 呼び出しには MsgCrossVMCall トランザクションを使用します。チェーンは送信者から送信元レーンを判断するため、メッセージにはターゲット VM、ターゲットコントラクト、ペイロード、および任意の資金のみが含まれます。デフォルトでは、呼び出しはトランザクション内で即座に実行され、ターゲットが失敗するとトランザクション全体がリバートされます。async フラグを指定すると、メッセージは代わりにキューに入れられ、後のブロックでモジュールのエンドブロックキュー処理によって処理されます(下記のライフサイクルを参照)。前述のとおり、このメッセージはメインネットでは無効化されています。
CLI
tx crossvm call は、ターゲット VM(evm、cosmwasm、または svm)とターゲットコントラクトを位置引数として受け取り、ペイロードは 16 進で指定します。CLI は送信元 VM を尋ねません。チェーンが状態から呼び出し元のレーンを導出し、宣言されたフィールドは無視します(CLI はメッセージ自身の検証を通すためにプレースホルダーを埋めます)。
qorechaind tx crossvm call evm 0x1234567890123456789012345678901234567890 \
--payload 0a0b0c --from mykey --generate-only > tx.json
その他のフラグ:--funds <coins>(QoreChain Native ターゲットのみ)と、呼び出しを即時実行せずキューに入れる --async。tx.json は tx pqc cosign で署名してブロードキャストします(ポスト量子署名を参照)。手数料の下限はガス 1 単位あたり 0.1 uqor です。呼び出し元自身のレーンへの呼び出しは拒否されます(v3.2.3 以降)。
MsgCrossVMCall は、メインネットではサーキットブレーカーによって無効化されているため、現時点ではこのコマンドは成功しません。(v3.2.3 より前のリリースバイナリは、送信元 VM が空のためメッセージ自身の検証を通過しないメッセージも構築していましたが、v3.2.3 バイナリでこれは修正されています。)テストネットではこのメッセージは有効ですが、SVM レーンは無効なため SVM ターゲットには到達できません。EVM ターゲットには到達でき、QoreChain Native ターゲットも、そこでコントラクトがインスタンス化された後であれば到達できます。
メッセージのライフサイクル
キューに入ったすべてのクロス VM メッセージは、定義された一連の状態を遷移します。
Submitted --> Pending --> Executed
|
+--> Failed
|
+--> Timed Out
| 状態 | 説明 |
|---|---|
| Submitted | メッセージがキューに受理された |
| Pending | 次の EndBlocker パスでの実行を待機中 |
| Executed | ターゲットコントラクトが正常に呼び出され、レスポンスが記録された |
| Failed | ターゲットコントラクトの実行がリバートされ、エラーが記録された |
| Timed Out | メッセージが実行されずに queue_timeout_blocks を超過した |
v3.2.3 以降、失敗したキュー内の呼び出しは全体がロールバックされます。残るのはその Failed レコードのみで、失敗した QoreChain Native 呼び出しに添付された資金がコントラクトに移されることもなくなりました。モジュールが無効化されている間、または MsgCrossVMCall がサーキットブレーカーによって無効化されている間は、キューは実行されません。キュー内のメッセージは保留のままとなり、先にスイッチが解除されない限りタイムアウト時に失効します。
CosmWasm への非同期呼び出し(v3.2.8)
リリース v3.2.8 以降(後のメインネットアップグレードまではテストネットのみ)、CosmWasm への非同期呼び出しは前払いされ、上限付きでキューに入ります。
MsgCrossVMCall のフィールド | 意味 |
|---|---|
async_gas_limit (8) | キューに入れた呼び出しのために予約するコントラクトのガス単位(デフォルト 500,000) |
async_max_factor (9) | 受け入れる混雑係数の上限(デフォルト 4 倍)。適用中の係数がこれを超えている場合、呼び出しは拒否されます |
- エスクロー。 送信者は、ガス単位 x 係数 x ガス価格をエスクローアカウントに前払いします。デフォルトでは 500,000 x 4 x 0.1 uqor、約 0.2 QOR です。呼び出しが使わなかった分は、実行時に返金されます。
- キュースロット手数料。 呼び出しをキューに入れる際、少額のスロット手数料も支払います。
- 送信者ごとに保留中の呼び出しは最大 100 件。 1 件が完了またはタイムアウトするまで、それ以上の呼び出しは拒否されます。
- 失敗した呼び出しにも課金されます。 失敗した呼び出しも、実行した処理の分は支払います。
- 重い呼び出し: 大きなコードをロードするコントラクトでは、
async_gas_limitとasync_max_factorを引き上げてください。cw721 規模のコントラクトは、ブロック内の初回呼び出しではデフォルトに収まりません。 - コードから。 SDK 0.14.0 は、各言語で両方のフィールドを受け付けます(TypeScript:
asyncGasLimitとasyncMaxFactor。validateCrossVmAsyncGasがそれらを検査します。asyncMaxFactorは百万分率で、1,000,000 が 1 倍です)。また、ページング付きの保留中クエリのすべてのページを返します。これはテストネットで実行していません。
パラメータ
| パラメータ | 値 | 説明 |
|---|---|---|
enabled | true | モジュールレベルのスイッチ(呼び出しメッセージ自体は、メインネットでは別途無効化されています) |
max_message_size | 65,536 バイト | メッセージあたりの最大ペイロードサイズ |
max_queue_size | 1,000 | キュー内の保留中メッセージの最大数 |
queue_timeout_blocks | 100 | 未処理メッセージがタイムアウトするまでのブロック数 |
イベント
x/crossvm モジュールは次のイベントを発行します。
| イベント | 属性 | 説明 |
|---|---|---|
crossvm_request | message_id, source_vm, target_vm, target_contract, sender | 新しいクロス VM メッセージが送信された |
crossvm_response | message_id, status, result | メッセージが実行された(成功または失敗) |
crossvm_timeout | message_id, source_vm, target_vm | メッセージが実行されずに失効した |
WebSocket 経由でイベントを購読します。
wscat -c ws://localhost:26657/websocket
> {"jsonrpc":"2.0","method":"subscribe","params":["tm.event='Tx' AND crossvm_request.message_id EXISTS"],"id":1}
メッセージの照会
CLI
# Query a specific message by ID
qorechaind query crossvm message <message-id>
# 保留中のメッセージを一覧表示(v3.2.8 以降は最大 100 件の 1 ページ。続きは next key で取得)
qorechaind query crossvm pending
# Module parameters
qorechaind query crossvm params
JSON-RPC
まだ提供されていません: リリース済みのノードビルドはいずれも
qor_JSON-RPC 名前空間を提供していないため、現時点ではすべての公開エンドポイントでこの呼び出しは-32601(メソッドが見つかりません)を返します。qor_名前空間を参照してください。
curl -X POST http://localhost:8545 \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "qor_getCrossVMMessage",
"params": ["<message-id>"],
"id": 1
}'
レスポンス形式
{
"message_id": "crossvm-00000042",
"source_vm": "cosmwasm",
"target_vm": "evm",
"target_contract": "0x1234...abcd",
"sender": "qor1sender...",
"payload": "...",
"status": "executed",
"result": "0x...",
"submitted_height": 12345,
"executed_height": 12346
}
設計上の考慮事項
アトミック性: 同期呼び出し(プリコンパイル経由の EVM から QoreChain Native)は、いずれかの側がリバートするとトランザクション全体がリバートされるよう、アトミックになるように設計されています。強化版のプリコンパイルはネストした呼び出しをジャーナルに記録するため、呼び出し元コントラクトでのリバートは QoreChain Native 側も取り消します。これはテストネットでのみ有効です。非同期呼び出しはブロックをまたいでアトミックではありません。Failed および Timed Out の状態を適切に処理できるようコントラクトを設計してください。
順序付け: キュー内のメッセージは、各 EndBlocker パス内で FIFO で処理されます。異なるソース VM をまたぐ順序付けは保証されません。
ペイロードのエンコーディング: ペイロード形式はターゲット VM に依存します。
- EVM ターゲット: ABI エンコードされた関数呼び出し
- QoreChain Native ターゲット: JSON エンコードされた実行メッセージ
- SVM ターゲット: 16 進エンコードされた BPF 命令データ
次のステップ
- EVM プリコンパイル — 同期 CrossVM プリコンパイルの状況と、その他の計画中のプリコンパイル
- EVM 開発 — QoreChain 上での Solidity 開発
- QoreChain Native 開発 — Rust/Wasm コントラクト開発
- SVM 開発 — BPF プログラムのデプロイ