Çapraz VM kılavuzu
QoreChain, EVM, SVM ve QoreChain Native'ı yan yana çalıştırır ve x/crossvm modülü,
tek bir yerel hesabın bunlardan herhangi birinde bir sözleşmeyi çağırmasına olanak
tanır. SDK, bu çağrıları oluşturmak, imzalamak ve yayınlamak için — birkaçını
üç VM'nin tümünde tek bir atomik işlemde paketlemek dahil — üst düzey bir
createCrossVMClient yardımcısı sağlar; ayrıca mesaj durumunu izlemek için tipli
okuma yardımcıları sunar. EVM'nin içinden başlatılan EVM→yerel yönlendirme,
@qorechain/evm içindeki çapraz VM köprüsü precompile'ı aracılığıyla hâlâ
zincir üzerinde çalışır.
Çapraz VM çağrıları yalnızca hedef şeritlerinin sunduğu ölçüde kullanılabilir:
MsgCrossVMCall, mainnet üzerinde zincirin devre kesicisi tarafından kapatılmıştır (GET /cosmos/circuit/v1/disable_list,/qorechain.crossvm.v1.MsgCrossVMCallkaydını listeler); testnet üzerinde etkindir.- SVM işlem şeridi ağ genelinde devre dışıdır, QoreChain Native yükleme ve örnekleme izne tabidir (ve mainnet üzerinde sözleşme yoktur), EVM köprüsü precompile'ı da etkin değildir (bkz. EVM Precompile'ları).
- Aşağıdaki tipli REST okuma yardımcıları, genel ağ geçidinin sunmadığı rotaları
çağırır. Mesajları bunun yerine
connectQueryClients(rpc).crossvmile okuyun. - Her Native yol işlemi gibi, bir çapraz VM çağrısı da hibrit imzayı taşımalıdır:
imzalama istemcisini hesabın anahtar çiftiyle bağlayın
(
client.connectTx(signer, { pqcKeypair }), SDK 0.9.0 veya üstü); böylece çapraz VM istemcisi hibrit olarak imzalar (bkz. Hesaplar ve PQC imzalama). 0.9.0 öncesi sürümler bunu klasik olarak imzalar ve genel ağlar bunu reddeder.
Birleşik çapraz VM çağrıları
createCrossVMClient, MsgCrossVMCall'ı (tür URL'si
/qorechain.crossvm.v1.MsgCrossVMCall) sarar, böylece asla elle bir
{ typeUrl, value } oluşturmaz veya kendiniz bir payload kodlamazsınız.
İstemcinin göndericisi, bağlı TxClient'in adresidir; sourceVm varsayılan
olarak "evm" olur.
import { createClient, createCrossVMClient } from "@qorechain/sdk";
const client = createClient({ network: "testnet", endpoints: { rpc, rest } });
const tx = await client.connectTx(signer, { pqcKeypair }); // hybrid-signed (SDK 0.9.0)
const xvm = createCrossVMClient(tx);
// Call an EVM contract from a native account — the payload is ABI-encoded.
const { messageId, result } = await xvm.call({
sourceVm: "cosmwasm",
targetVm: "evm",
targetContract: "0xToken",
evm: { abi: erc20Abi, functionName: "transfer", args: ["0xRecipient", 1n] },
});
VMType, "evm" | "cosmwasm" | "svm" değerlerinden biridir (ayrıca VM_TYPES
dizisi olarak da dışa aktarılır).
VM başına payload kodlaması
Çağrı başına tam olarak bir payload şekli seçin:
| Şekil | Kodlama |
|---|---|
{ payload: Uint8Array | Hex } | ham baytlar, değişmeden geçirilir |
{ evm: { abi, functionName, args } } | viem'in encodeFunctionData'sı ile ABI olarak kodlanır (seçici + argümanlar) |
{ cosmwasm: object } | JSON.stringify, ardından UTF-8 baytları (QoreChain Native execute-msg kuralı) |
{ svm: { data: Uint8Array | Hex } } | ham baytlar (bir SVM talimat blob'u) |
EVM yolu viem'i geç (lazy) içe aktarır, bu nedenle isteğe bağlı viem peer'ı
yalnızca bir { evm: ... } payload'ı gerçekten kullandığınızda gereklidir.
Yalnızca oluşturma (çevrimdışı)
buildCall, yayınlamadan EncodeObject'i döndürür — inceleme, elle toplu işleme
veya başka bir yerde imzalama için kullanışlıdır. (EVM payload'ları asenkron
olarak ABI ile kodlanır, bu nedenle bunlar için call/callAtomic kullanın veya
önceden kodlayıp { payload } geçirin.)
const msg = xvm.buildCall({
targetVm: "svm",
targetContract: "Prog...",
svm: { data: new Uint8Array([1, 2, 3]) },
});
Atomik üçlü VM işlemleri
callAtomic, birden çok MsgCrossVMCall mesajını tek bir işlem gövdesinde
paketler, böylece tek bir imza altında atomik olarak yürütülürler — üçlü VM
başlığı. Tek imza, EVM + SVM + QoreChain Native'da yapılan çağrıların hepsi birlikte iner
veya hiçbiri inmez:
const { messageIds, result } = await xvm.callAtomic([
{
targetVm: "evm",
targetContract: "0xToken",
evm: { abi: erc20Abi, functionName: "transfer", args: ["0xRecipient", 2n] },
},
{ targetVm: "svm", targetContract: "Prog...", svm: { data: instructionBytes } },
{ targetVm: "cosmwasm", targetContract: "qor1c...", cosmwasm: { ping: {} } },
]);
Bir mesajı geri okuma
getMessage, bir çapraz VM mesajını kimliğine göre okur; tipli sorgu istemcisini
tercih eder ve qor_getCrossVMMessage JSON-RPC yöntemine (genel uç noktalar bunu
sunmaz) geri döner. Ona, konsensüs RPC'si üzerinden okuyan tipli sorgu istemcisini
verin:
import { connectQueryClients } from "@qorechain/sdk";
// rpcClient: a connected consensus-RPC client (the CosmJS RPC client type).
const queries = connectQueryClients(rpcClient);
const reader = createCrossVMClient(tx, { query: queries.crossvm });
const msg = await reader.getMessage(messageId);
// Module parameters and the pending queue, over the same typed client:
const params = await queries.crossvm.params();
const pending = await queries.crossvm.pendingMessages();
Çapraz VM mesaj durumunu okuma
@qorechain/sdk, x/crossvm üzerinde tipli REST sarmalayıcıları dışa aktarır.
Bunlar, genel ağ geçidinin sunmadığı
/qorechain/crossvm/v1/{message/{id},pending,params} yollarını çağırır
(api.qore.host ve api-testnet.qore.host üzerinde Not Implemented); bu nedenle
genel uç noktalar karşısında QoreHttpError fırlatırlar. Bu rotaları sunan düğümler
içindir; genel ağlarda yukarıdaki connectQueryClients'ı kullanın.
import {
createClient,
getCrossVmMessage,
getPendingCrossVmMessages,
getCrossVmParams,
} from "@qorechain/sdk";
const client = createClient({
endpoints: { rest: "https://api-testnet.qore.host" },
});
// A single message by id.
const msg = await getCrossVmMessage(client.rest, messageId);
// Pending messages. On a network running v3.2.8 or later the route is paginated
// (at most 100 per page) and `payload_hex` is cut to 1,024 bytes in the list:
// read the full payload with getCrossVmMessage.
const pending = await getPendingCrossVmMessages(client.rest);
// Module parameters.
const params = await getCrossVmParams(client.rest);
Bunlar tipli şekiller döndürür: CrossVmMessage, CrossVmMessageResponse,
PendingCrossVmMessagesResponse ve CrossVmParamsResponse.
Düğümler sunmaya başladığında, bir mesajı qor_ JSON-RPC ad alanı aracılığıyla da
okuyabilirsiniz:
Henüz sunulmuyor: yayımlanmış hiçbir düğüm sürümü
qor_JSON-RPC ad alanını sunmaz; bu nedenle bu çağrı bugün her genel uç noktada-32601(yöntem bulunamadı) döndürür. Bkz.qor_ad alanı.
const m = await client.qor.getCrossVmMessage(messageId);
EVM köprüsü precompile'ı
EVM→yerel yönlendirme, @qorechain/evm içinde sunulan çapraz VM köprüsü
precompile'ı aracılığıyla zincir üzerinde yürütülür:
import { PRECOMPILE_ADDRESSES } from "@qorechain/evm";
console.log(PRECOMPILE_ADDRESSES.crossVmBridge);
// 0x0000000000000000000000000000000000000901
Mainnet'te etkin değil; testnet'te etkin. Çapraz VM köprüsü precompile'ı mainnet'in etkin listesinde yoktur, bu yüzden orada
0x…0901adresine yapılan bir çağrı boş veri döndürür ve hiçbir şeyi yönlendirmez. Testnet'in listesi onu içerir (7 Kasım 2026'da okundu); 7 Kasım 2026'da ona yapılan salt okunur bireth_call, izin listesindeki bir sözleşmeye ulaştı ve başka her hedef için reddedildi ("is not allowlisted"). Bkz. EVM Precompile'ları: Ağ durumu.
Etkinleştikten sonra, bir Solidity sözleşmesi (veya viem) bir mesajı yerel katmana yönlendirmek için precompile'ı o adreste çağırır, ardından durumunu yukarıdaki okuma yardımcılarıyla izler. Tam precompile listesi için EVM kılavuzuna bakın.