본문으로 건너뛰기

멀티 VM (크로스 VM 호출)

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

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

크로스 VM 프리컴파일은 어느 네트워크에서도 활성화되지 않았습니다: EVM 모듈의 활성 정적 프리컴파일 목록은 메인넷과 테스트넷 모두에서 비어 있으므로, 0x…0901에 대한 호출은 빈 데이터를 반환하고 아무것도 실행하지 않습니다. CosmWasm 컨트랙트 업로드도 두 네트워크 모두에서 닫혀 있으며, SVM 트랜잭션 레인은 네트워크 전체에서 비활성화되어 있습니다. 프리컴파일이 활성화되고 CosmWasm 업로드가 다시 열리기 전까지는 호출할 대상이 없습니다. 이 페이지는 준비할 수 있도록 툴링을 문서화한 것이며, 이를 기반으로 프로덕션 흐름을 구축하지 마세요. EVM 프리컴파일: 네트워크 상태를 참조하세요.

노트

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

프리컴파일 주소​

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

console.log(CROSS_VM_PRECOMPILE); // 0x0000000000000000000000000000000000000901

크로스 VM 호출 인코딩​

encodeCrossVmCalldata는 executeCrossVMCall(string contract, bytes msg)를 위한 calldata를 빌드합니다. msg는 컨트랙트의 execute 메시지이며 UTF-8 JSON 문자열 또는 원시 바이트입니다.

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

const calldata = encodeCrossVmCalldata({
  contract: "qor1cosmwasmcontractaddress...",
  msg: JSON.stringify({ transfer: { recipient: "qor1...", amount: "100" } }),
});

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(string,bytes)", contractAddr, msg_);
    (bool ok, bytes memory ret) = CROSS_VM_PRECOMPILE.call(data);
    require(ok, "cross-VM call failed");
    return ret;
}

프리컴파일이 비활성 상태이므로 이에 대한 일반 .call은 빈 데이터와 함께 성공을 반환합니다. 오늘 이를 테스트한다면 ok 플래그에만 의존하지 말고 반환된 길이를 확인하세요.

멀티 VM 롤업 스캐폴딩​

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

이 템플릿에는 시작점이 되는 contracts/CrossVmCaller.sol이 포함되어 있습니다. 이를 신뢰하기 전에 위의 ABI와 비교해 보세요. 모든 스캐폴더 템플릿은 롤업 배포하기를 참고하세요.