본문으로 건너뛰기

멀티 VM (크로스 VM 호출)

RDK에는 EVM 컨트랙트에서 0x0000000000000000000000000000000000000901 주소의 크로스 VM 프리컴파일로 향하는 호출을 인코딩하는 TypeScript 헬퍼가 포함되어 있으며, 이 프리컴파일은 해당 호출을 QoreChain Native(Wasm) 런타임의 QoreChain Native 컨트랙트로 라우팅하도록 설계되었습니다. 또한 이를 연결해 주는 multivm-rollup 스캐폴드 템플릿도 있습니다. 이 툴링은 EVM → QoreChain Native만을 다룹니다. SVM은 별도의 런타임이며 프리컴파일의 일부가 아닙니다.

아직 라이브 네트워크에서 사용할 수 없음

크로스 VM 프리컴파일은 메인넷에서 활성화되지 않았습니다: EVM 모듈의 활성 정적 프리컴파일 목록이 그곳에서 비어 있습니다(2026년 11월 4일 확인). 테스트넷의 목록은 2026년 10월 27일 확인 시 0x…0A01, 0x…0A02, 0x…0C01만 들어 있었고 11월 4일부터는 0x…0901도 들어 있었으며, 2026년 11월 7일에 다시 읽었을 때도 네 개가 모두 나열되어 있었습니다(체인 v3.2.5 아래의 노트 참조). 2026년 11월 7일, 테스트넷이 체인 v3.2.7을 적용한 뒤 테스트넷에서 0x…0901로의 읽기 전용 eth_call을 테스트했습니다. 허용 목록에 있는 대상은 해당 컨트랙트에 도달했고, 목록 밖의 대상은 거부되었습니다(테스트넷에서 테스트함 참조). 메인넷에서 0x…0901에 대한 eth_getCode는 0x를 반환하며, 이 주소에 대한 호출은 빈 데이터와 함께 성공하지만 아무것도 실행하지 않습니다(이 주소로의 eth_call은 2026년 11월 4일에 빈 데이터를 반환했습니다). QoreChain Native 컨트랙트 업로드도 두 네트워크 모두에서 닫혀 있으며, SVM 트랜잭션 레인은 네트워크 전체에서 비활성화되어 있습니다. 메인넷에서는 프리컴파일이 활성화되고 QoreChain Native 업로드가 다시 열리기 전까지 호출할 대상이 없으며, 테스트넷에서는 프리컴파일이 허용 목록과 함께 활성화되어 있고 eth_call로 테스트했습니다. 이 페이지는 준비할 수 있도록 툴링을 문서화한 것이며, 이를 기반으로 프로덕션 흐름을 구축하지 마세요. EVM 프리컴파일: 네트워크 상태를 참조하세요.

인코더는 0.6.0부터 체인의 레이아웃과 일치합니다

@qorechain/rdk 0.5.0 및 그 이전의 encodeCrossVmCalldata(그리고 해당 릴리스의 multivm-rollup 템플릿에 있는 CrossVmCaller.sol 스타터)는 executeCrossVMCall(string,bytes)를 사용했는데, 이는 노드가 디코딩하는 것과 다른 함수 셀렉터이므로 이들이 인코딩한 호출은 프리컴파일을 활성화한 네트워크에서도 프리컴파일에 도달할 수 없었습니다. 0.6.0은 executeCrossVMCall(uint8 targetVM, string targetContract, bytes payload)(셀렉터 0x3c11078c)를 인코딩하며, 이것이 노드가 디코딩하는 형식입니다(4바이트 셀렉터에 이어 ABI 인코딩된 인자들이 오고, targetVM 1이 QoreChain Native이며 지원되는 유일한 대상입니다). 릴리스 노트에 따르면 헬퍼의 calldata는 체인 자체의 디코더를 거쳐 왕복 변환됩니다. ABI는 활성화 전에 아직 바뀔 수 있습니다.

노트

RDK v0.4.2부터 Wasm 런타임의 VM 옵션 식별자는 native(QoreChain Native)입니다. cosmwasm은 여전히 허용되는 레거시 별칭이며, 두 값 모두 전송 시에는 cosmwasm으로 매핑됩니다.

프리컴파일 주소​

import { CROSS_VM_PRECOMPILE } from "@qorechain/rdk";

console.log(CROSS_VM_PRECOMPILE); // 0x0000000000000000000000000000000000000901

크로스 VM 호출 인코딩​

노드의 레이아웃을 직접 인코딩하세요. payload는 컨트랙트의 execute 메시지를 UTF-8 JSON 바이트로 만든 것입니다(viem 사용 예):

import { encodeFunctionData, parseAbi, toHex } from "viem";

const abi = parseAbi([
"function executeCrossVMCall(uint8 targetVM, string targetContract, bytes payload)",
]);

const calldata = encodeFunctionData({
abi,
functionName: "executeCrossVMCall",
args: [
1, // QoreChain Native
"qor1cosmwasmcontractaddress...",
toHex(new TextEncoder().encode(JSON.stringify({ transfer: { recipient: "qor1...", amount: "100" } }))),
],
});

@qorechain/rdk 0.6.0 이상(현재는 0.8.0)의 encodeCrossVmCalldata가 같은 calldata를 대신 빌드해 줍니다:

import {
CROSS_VM_PRECOMPILE,
CROSS_VM_TARGET,
encodeCrossVmCalldata,
isCrossVmPrecompileActive,
} from "@qorechain/rdk";

// Ask the node first: today this answers `active: false` on both networks.
const status = await isCrossVmPrecompileActive("https://api.qore.host");
console.log(status.active, status.reason);

const calldata = encodeCrossVmCalldata({
contract: "qor1cosmwasmcontractaddress...",
msg: JSON.stringify({ increment: {} }),
targetVm: CROSS_VM_TARGET.NATIVE, // 1 = QoreChain Native (CosmWasm); the default
});
// An EVM transaction to CROSS_VM_PRECOMPILE with `data: calldata`.

isCrossVmPrecompileActive(restBase)는 REST로 EVM 매개변수 active_static_precompiles를 읽고, 프리컴파일의 주소가 목록에 있을 때만 active: true로 응답합니다. 이것이 유일하게 신뢰할 수 있는 확인 방법이며 오프체인에서 이루어져야 합니다. 프리컴파일은 대상의 원시 응답을 그대로 반환하므로, 빈 응답만으로는 비활성 프리컴파일과 아무것도 반환하지 않는 컨트랙트에 대한 정상 호출을 구분할 수 없고, 프리컴파일은 활성 여부와 관계없이 바이트코드가 없기 때문입니다. active: true로 보고되더라도, 패키지 문서에 따르면 체인 v3.2.3부터 호출은 거버넌스가 허용 목록에 올린 대상(크로스 VM 매개변수 bridge_allowed_targets, 각 항목은 <vm>:<contract>)에만 도달하며 EVM-to-EVM은 거부됩니다.

2026년 10월 30일 이후 테스트넷 변경

2026년 11월 4일에 테스트넷의 활성 프리컴파일 목록(EVM 매개변수의 active_static_precompiles)에 0x…0901도 들어 있었고, 테스트넷의 GET /qorechain/crossvm/v1/params는 bridge_allowed_targets에 CosmWasm 대상 세 개를 나열했습니다. 메인넷은 그날 변함이 없었습니다: 활성 목록이 비어 있고, 허용 목록이 비어 있으며, eth_call을 통한 0x…0901 호출은 빈 데이터를 반환했습니다. 테스트넷 목록은 2026년 11월 7일에 다시 읽었으며 여전히 0x…0901이 들어 있습니다. 아래에서 테스트넷의 프리컴파일이나 허용 목록이 비활성이거나 비어 있다고 말하는 문장은 2026년 10월 27일부터 30일까지의 상태를 설명합니다. 테스트넷의 현재 동작은 테스트넷에서 테스트함에 있습니다.

체인 v3.2.5: 허용 목록, 응답 형식, 거부 (두 네트워크)​

체인 v3.2.5는 브리지의 동작을 바꿉니다. 메인넷은 2026년 10월 29일부터(거버넌스 제안 14, 높이 3,906,833), 테스트넷은 10월 26일부터 이를 실행 중이며, 이제 메인넷은 v3.2.7을, 테스트넷은 v3.2.8을 실행합니다. 프리컴파일은 메인넷에서 활성 상태가 아니므로 아래의 응답 형식은 이 릴리스의 동작이며 그곳에서 실행된 적은 없습니다. 거부 형식은 2026년 11월 7일 테스트넷에서 확인했습니다(테스트넷에서 테스트함 참조). 이 페이지의 다른 곳에서 프리컴파일이 대상의 원시 응답을 반환한다고 설명한 내용은 v3.2.5 이전 릴리스에 대한 설명입니다.

  • 허용 목록 경로. GET /qorechain/crossvm/v1/params는 대상 허용 목록을 포함한 브리지 매개변수를 제공합니다. 메인넷에서는 허용 목록이 비어 있으므로(2026년 11월 4일 확인) 아직 허용된 대상이 없으며, 테스트넷에서는 10월 30일에 비어 있었습니다(위의 노트 참조).
  • 고정된 응답 형식. 프리컴파일은 abi.encode(bytes)를 반환하므로 응답은 항상 64바이트 이상이며 빈 응답과 누락된 응답을 구분할 수 있습니다. abi.decode(ret, (bytes))로 디코딩하세요.
  • 거부에는 사유가 담깁니다. 브리지가 호출을 거부하면 Error(string)으로 리버트하며, 컨트랙트가 이를 읽고 전달할 수 있습니다.
  • 테스트넷에서는 활성, 메인넷에서는 비활성. 0x...0901은 메인넷의 활성 프리컴파일 목록에 없습니다. 테스트넷의 목록에는 들어 있으며(2026년 11월 7일 확인), 그날 그곳에서 거부와 허용 목록 동작을 테스트했습니다. 메인넷은 별도의 거버넌스 결정이 있을 때까지, v3.2.7 업그레이드(메인넷에는 2026년 11월 12일 적용. 크로스 VM 호출 메시지는 서킷 브레이커로 계속 일시 중지됨) 이후에도 크로스 VM 호출을 꺼 둡니다.

테스트넷에서 테스트함​

테스트넷은 2026년 11월 12일부터(높이 9,929,500) 체인 v3.2.8을 실행합니다. 2026년 11월 7일에 executeCrossVMCall(uint8,string,bytes)의 calldata(대상 VM 1, 페이로드 {})로 0x…0901에 읽기 전용 eth_call 요청 두 건을 보냈습니다.

대상결과
bridge_allowed_targets에 없는 CosmWasm 주소cross-VM bridge call refused: target cosmwasm:<address> is not allowlisted와 함께 되돌려짐
bridge_allowed_targets에 있는 CosmWasm 컨트랙트호출이 컨트랙트에 도달했고 컨트랙트가 빈 페이로드를 거부했으므로(Error parsing into type cw20::msg::Cw20ExecuteMsg) 브리지가 이를 전달한 것입니다. 컨트랙트가 받아들이는 메시지는 보내지 않았습니다

이는 허용 목록과 되돌림 사유를 보여 줍니다. eth_call은 아무것도 바꾸지 않고 페이로드도 일부러 유효한 메시지가 아니었으므로, 상태를 바꾸는 호출의 성공을 보여 주지는 않습니다. 프리컴파일은 세 개의 인자를 받으며, 0.5.0 및 그 이전의 두 인자 형식은 여기에 도달하지 못합니다. 메인넷에는 이 동작이 없습니다. 그곳에서는 프리컴파일이 꺼져 있습니다.

@qorechain/rdk 0.7.0 이상에는 이를 위한 헬퍼가 있습니다(Solidity가 만든 인코딩에 대해 확인됨): getCrossVmParams(허용 목록), crossVmTargetReady(프리컴파일 활성, 브리지 활성화, 대상이 허용 목록에 있는지를 확인하며, 그렇지 않으면 막는 사유를 함께 반환), decodeCrossVmResult(abi.decode(ret, (bytes))), decodeRevertReason(Error(string)).

Solidity 측​

EVM 컨트랙트에서는 인코딩된 호출과 함께 프리컴파일 주소를 호출합니다:

address constant CROSS_VM_PRECOMPILE = 0x0000000000000000000000000000000000000901;

function callCosmWasm(string calldata contractAddr, bytes calldata msg_)
external returns (bytes memory)
{
bytes memory data = abi.encodeWithSignature(
"executeCrossVMCall(uint8,string,bytes)", uint8(1), contractAddr, msg_
);
(bool ok, bytes memory ret) = CROSS_VM_PRECOMPILE.call(data);
require(ok, "cross-VM call failed");
return ret;
}

프리컴파일이 메인넷에서 비활성 상태이므로 그곳에서 이에 대한 일반 .call은 빈 데이터와 함께 성공을 반환하고 아무 일도 하지 않습니다. ok 플래그만으로는 호출이 실제로 적용되었는지 알 수 없습니다. 컨트랙트 안에서 신뢰할 수 있는 방어책은 항상 비어 있지 않은 확인 응답을 반환하는 대상을 사용하고, 호출 뒤에 require(ret.length > 0)를 두어 빈 응답을 실패로 처리하는 것입니다. multivm-rollup 템플릿이 이렇게 합니다(0.6.0부터).

멀티 VM 롤업 스캐폴딩​

npm create qorechain-rollup my-app -- --template multivm-rollup

multivm-rollup 템플릿에는 src/crossvm-call.ts(프리컴파일이 라이브인지 확인한 뒤 calldata를 출력합니다)와 executeCrossVMCall(uint8,string,bytes)를 호출하고 대상으로부터 비어 있지 않은 응답을 요구하는 contracts/CrossVmCaller.sol이 포함되어 있습니다. 0.7.0부터 이 컨트랙트는 abi.encode(bytes) 결과를 디코딩하고, 활성 프리컴파일이 반환하는 최소 64바이트를 요구하며, 체인의 거부 사유를 그대로 전달합니다. 프리컴파일이 비활성인 동안에는 호출이 동작하게 만들어 주지 않습니다. 모든 스캐폴더 템플릿은 롤업 배포하기를 참고하세요.