본문으로 건너뛰기

EVM 프리컴파일

QoreChain은 QoreChain EVM 엔진을 6개의 커스텀 프리컴파일 컨트랙트로 확장하여 프로토콜 수준의 기능을 Solidity에 직접 노출합니다. 이 프리컴파일들은 포스트 퀀텀 암호화, AI 리스크 스코어링, 크로스 VM 메시징, PRISM 합의 파라미터에 대한 온체인 접근을 제공합니다.

메인넷에서는 활성화되지 않음, 테스트넷에서는 4개 활성

아래의 QoreChain 프리컴파일 6개는 노드에 컴파일되어 있지만, EVM은 active_static_precompiles 파라미터에 있는 주소만 디스패치합니다. qorechain-vladi 메인넷(EVM 체인 ID 9801)에서는 작성 시점에 이 목록이 비어 있으므로 활성화된 것이 하나도 없습니다. qorechain-diana 테스트넷(EVM 체인 ID 9800)에서는 PQC Verify, PQC Key Status, PRISM Consensus Params가 활성화되어 있으며(테스트넷 거버넌스 제안 21로 활성화, 2026년 10월 27일 통과), CrossVM Bridge(0x…0901)도 목록에 있습니다(2026년 11월 7일 확인. 검토된 컨트랙트의 허용 목록과 함께 실행되며, 네트워크 상태 참조). AI 프리컴파일 2개는 어느 네트워크에서도 활성화되지 않았습니다. 목록에 없는 주소를 호출하면 성공하고 빈 데이터(0x)를 반환합니다. 리버트하지도, 오류를 반환하지도 않습니다. 이 중 어느 것이든 의존하기 전에 네트워크 상태를 확인하세요.

네트워크 상태​

프리컴파일주소qorechain-vladi (메인넷)qorechain-diana (테스트넷)
CrossVM Bridge0x…0901비활성허용 목록과 함께 활성(2026년 11월 7일 목록 확인. v3.2.7 업그레이드 후의 eth_call은 허용 목록의 컨트랙트에 도달했고 목록 밖의 컨트랙트에는 거부되었음, Multi-VM 참조)
PQC Verify0x…0A01비활성활성 (2026년 10월 27일부터)
PQC Key Status0x…0A02비활성활성 (2026년 10월 27일부터)
AI Risk Score0x…0B01비활성비활성
AI Anomaly Check0x…0B02비활성비활성
PRISM Consensus Params0x…0C01비활성활성 (2026년 10월 27일부터)

2026년 10월 27일에 실시간 active_static_precompiles 파라미터에서 읽은 상태입니다(메인넷은 v3.2.6 이후인 2026년 11월 4일에 다시 읽었으며 여전히 비어 있습니다. 2026년 11월 7일에는 두 네트워크를 다시 읽었습니다. 메인넷은 비어 있고 테스트넷은 0x…0901, 0x…0A01, 0x…0A02, 0x…0C01을 나열합니다). 이는 거버넌스로 변경되는 체인 파라미터이므로 각 네트워크의 목록은 거버넌스 제안이 통과될 때만 바뀝니다. 테스트넷 목록은 제안 21로 설정되었고, 작성 시점에 이를 변경하는 메인넷 제안은 없습니다. v3.2.3 릴리스(메인넷, 2026년 10월 20일)는 CrossVM 브리지와 AI 이상 탐지 프리컴파일의 강화된 버전을 프로토콜 기능 뒤에 두고 바이너리에 포함했지만 어떤 프리컴파일도 활성화하지 않았으며, v3.2.4(메인넷은 2026년 10월 23일부터, 테스트넷은 2026년 10월 19일부터), v3.2.6(메인넷은 2026년 11월 4일부터), v3.2.7(테스트넷은 2026년 11월 6일부터, 메인넷은 2026년 11월 12일부터) 모두 이를 바꾸지 않습니다. 메인넷 목록은 2026년 11월 12일에 다시 읽었으며 여전히 비어 있습니다. 읽기 전용인 PQC 및 합의 프리컴파일이 먼저, AI 2종은 읽기 전용 고정소수점 경로가 갖춰진 뒤에, CrossVM 브리지는 마지막에 활성화됩니다. 이 표에는 적용된 것만 나열합니다. 아직 투표 기간 중인 제안은 상태가 아닙니다.

현재 목록을 직접 확인하세요 (비어 있으면 활성화된 것이 없음).

curl -s https://api.qore.host/cosmos/evm/vm/v1/params | jq .params.active_static_precompiles
curl -s https://api-testnet.qore.host/cosmos/evm/vm/v1/params | jq .params.active_static_precompiles

빈 반환 데이터에 대비하기​

비활성(또는 QoreChain이 아닌) 주소는 데이터 없이 성공을 반환하므로, 길이를 확인하지 않고 저수준 호출의 원시 반환 바이트를 읽어서는 안 됩니다. abi.decode와 타입이 지정된 인터페이스 호출은 빈 데이터에서 리버트하며 이는 안전한 결과입니다. 직접 작성한 저수준 호출은 이를 명시적으로 확인해야 합니다.

(bool ok, bytes memory ret) = address(0x0000000000000000000000000000000000000a02)
.staticcall(abi.encodeWithSignature("pqcKeyStatus(address)", account));
require(ok && ret.length >= 96, "precompile not active");
(bool registered, uint8 algorithmId, bytes memory pubkey) = abi.decode(ret, (bool, uint8, bytes));

이 주소들로 가치를 보내지 마세요. payable이 아니며, 비활성 프리컴파일 주소로 보낸 가치는 그곳에 남아 복구할 방법이 없습니다.

테스트넷에서 활성화된 프리컴파일 3개가 응답하는지 빠르게 확인하는 방법입니다(Foundry의 cast 사용. 메인넷에서는 이 주소들이 대신 빈 데이터를 반환합니다).

RPC=https://evm-testnet.qore.host
cast call 0x0000000000000000000000000000000000000c01 "rlConsensusParams()(uint256,uint256,uint256,uint256)" --rpc-url $RPC
cast call 0x0000000000000000000000000000000000000a02 "pqcKeyStatus(address)(bool,uint8,bytes,bool)" 0x0000000000000000000000000000000000000001 --rpc-url $RPC

표준 프리컴파일​

여섯 개의 QoreChain 프리컴파일 외에도 노드에는 표준 cosmos/evm 프리컴파일이 포함되어 있습니다. 같은 규칙이 적용됩니다. 거버넌스가 active_static_precompiles에 주소를 등록한 곳에서만 실행되며, 노드의 커뮤니티 빌드에는 포함되어 있지 않습니다.

주소프리컴파일
0x…0100P-256 (상태 비저장)
0x…0400Bech32 (상태 비저장)
0x…0800스테이킹
0x…0801분배(Distribution)
0x…0802IBC 전송 (ICS-20)
0x…0804뱅크 (읽기 전용)
0x…0805거버넌스
0x…0806슬래싱

0x…0803(베스팅)은 업스트림에서 예약되어 있으며 구현되어 있지 않습니다. 해당 주소에는 아무것도 없습니다. QoreChain에서 스테이킹, 위임, 검증인 운영은 네이티브 레인 전용이므로(스테이킹과 검증인 참조), 스테이킹 프리컴파일 위에 스테이킹 플로우를 구축하지 마세요. 출처: 공개 코어 저장소의 docs/EVM_PRECOMPILES.md, 태그 v3.2.6.


프리컴파일 주소 맵​

가스 수치는 프리컴파일이 활성화된 후 노드가 부과하는 값입니다 (바이트당은 호출 입력 바이트당을 의미합니다).

프리컴파일주소기본 가스설명
CrossVM Bridge0x000000000000000000000000000000000000090150,000 + 바이트당 4동기식 크로스 VM 호출(EVM에서 QoreChain Native으로)
PQC Verify0x0000000000000000000000000000000000000a0125,000 + 바이트당 8ML-DSA-87 포스트 퀀텀 서명 검증
PQC Key Status0x0000000000000000000000000000000000000a022,500계정에 등록된 PQC 키가 있는지 확인
AI Risk Score0x0000000000000000000000000000000000000b0150,000트랜잭션 데이터에 대한 AI 생성 리스크 스코어 조회
AI Anomaly Check0x0000000000000000000000000000000000000b0240,000전송이 이상 거래로 플래그되는지 확인
PRISM Consensus Params0x0000000000000000000000000000000000000c011,500현재 PRISM 튜닝 합의 파라미터 조회

Solidity 인터페이스​

IQorePQC.sol​

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

interface IQorePQC {
/// @notice Verify an ML-DSA-87 (Dilithium-5) signature
/// @param pubkey The 2592-byte ML-DSA-87 public key
/// @param signature The 4627-byte ML-DSA-87 signature
/// @param message The original message bytes
/// @return valid True if the signature is valid
function pqcVerify(
bytes calldata pubkey,
bytes calldata signature,
bytes calldata message
) external view returns (bool valid);

/// @notice Check if an account has a registered PQC public key
/// @param account The Ethereum-style address to check
/// @return registered True if a PQC key is registered
/// @return algorithmId The PQC algorithm identifier (1 = ML-DSA-87)
/// @return pubkey The registered public key bytes (empty if not registered)
/// @return possessionProven True only if the key was registered with a verified proof of possession
function pqcKeyStatus(address account)
external
view
returns (bool registered, uint8 algorithmId, bytes memory pubkey, bool possessionProven);
}

v3.2.4부터(메인넷은 2026년 10월 23일부터, 테스트넷은 2026년 10월 19일부터) pqcKeyStatus의 출력에는 pubkey 뒤에 네 번째 값 bool possessionProven이 추가됩니다. 계정의 현재 키가 검증된 소유 증명으로 증명되었는지 여부입니다(양자내성 서명 참조). 이 프리컴파일이 활성화된 곳에서는 항상 반환됩니다. 테스트넷에서는 이미 적용되어 있으며(키가 없는 계정에 대한 호출은 false, 0, 0x, false를 반환합니다), 메인넷에서는 업그레이드로 프리컴파일이 활성화된 뒤에 적용됩니다. 위 인터페이스에는 네 가지 출력이 모두 나열되어 있습니다. 키를 신뢰해야 하는 컨트랙트는 네 번째 값을 반드시 확인해야 합니다. 소유 증명은 등록 시 선택 사항이므로 registered만으로는 충분하지 않습니다.

IQoreAI.sol​

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

interface IQoreAI {
/// @notice Get the AI-generated risk score for transaction data
/// @param txData The transaction data to evaluate
/// @return score Risk score in basis points (0-10000)
/// @return level Risk level: 0=SAFE, 1=LOW, 2=MEDIUM, 3=HIGH, 4=CRITICAL
function aiRiskScore(bytes calldata txData)
external
view
returns (uint256 score, uint8 level);

/// @notice Check if a transfer is flagged as anomalous
/// @param sender The sender address
/// @param amount The transfer amount in wei
/// @return anomalyScore The anomaly score (higher = more anomalous)
/// @return flagged True if the transfer exceeds the anomaly threshold
function aiAnomalyCheck(address sender, uint256 amount)
external
view
returns (uint256 anomalyScore, bool flagged);
}

IQoreConsensus.sol​

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

interface IQoreConsensus {
/// @notice Get current PRISM-tuned consensus parameters
/// @return blockTime Current target block time in milliseconds
/// @return baseGasPrice Current base gas price in wei
/// @return validatorSetSize Current active validator set size
/// @return epoch Current PRISM epoch number
function rlConsensusParams()
external
view
returns (
uint256 blockTime,
uint256 baseGasPrice,
uint256 validatorSetSize,
uint256 epoch
);
}

사용 예제​

PQC Verify — 포스트 퀀텀 서명 검증​

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.24;

import "./interfaces/IQorePQC.sol";

contract PQCVerifier {
IQorePQC constant PQC = IQorePQC(0x0000000000000000000000000000000000000a01);

/// @notice Verify a PQC signature and revert if invalid
function verifyOrRevert(
bytes calldata pubkey,
bytes calldata signature,
bytes calldata message
) external view {
bool valid = PQC.pqcVerify(pubkey, signature, message);
require(valid, "PQC signature verification failed");
}
}

가스 비용: 기본 25,000 + 입력 데이터 바이트당 8 가스. 입력은 ABI 인코딩된 호출(공개 키 2592 바이트, 서명 4627 바이트, 메시지, 그리고 ABI 오프셋과 패딩)이므로, 일반적인 ML-DSA-87 검증은 대략 85,000~90,000 가스가 소요됩니다.

PQC Key Status — 계정 등록 여부 확인​

contract PQCChecker {
IQorePQC constant PQC_STATUS = IQorePQC(0x0000000000000000000000000000000000000a02);

function requirePQCKey(address account) external view {
(bool registered, , , bool possessionProven) = PQC_STATUS.pqcKeyStatus(account);
require(registered, "Account must have a registered PQC key");
require(possessionProven, "The key was registered without a proof of possession");
}
}
possessionProven 확인하기

소유 증명은 등록 시 선택 사항이므로 registered만으로는 계정이 해당 키를 제어한다는 사실이 증명되지 않습니다. 등록된 포스트 양자 키에 의존하는 컨트랙트는 possessionProven이 true인지도 반드시 요구해야 합니다.

가스 비용: 정액 2,500.

AI Risk Score — 트랜잭션 리스크 평가​

import "./interfaces/IQoreAI.sol";

contract RiskGate {
IQoreAI constant AI = IQoreAI(0x0000000000000000000000000000000000000b01);

uint8 constant MAX_ALLOWED_RISK = 2; // Allow up to MEDIUM

function executeIfSafe(bytes calldata txData) external {
(uint256 score, uint8 level) = AI.aiRiskScore(txData);
require(level <= MAX_ALLOWED_RISK, "Risk level too high");

// Proceed with execution...
}
}

리스크 레벨:

레벨값
SAFE0
LOW1
MEDIUM2
HIGH3
CRITICAL4

레벨은 AI 엔진이 해당 트랜잭션에 부여한 심각도 레이블에서 나오며, 스코어는 베이시스 포인트(0 - 10000)로 반환됩니다. 스코어 범위에서 레벨로의 고정된 매핑은 없으므로, 스코어 임계값이 아니라 level을 기준으로 게이팅하세요.

가스 비용: 정액 50,000.

AI Anomaly Check — 의심스러운 전송 플래그 처리​

contract AnomalyGuard {
IQoreAI constant AI = IQoreAI(0x0000000000000000000000000000000000000b02);

function safeTransfer(address sender, uint256 amount) external view {
(uint256 anomalyScore, bool flagged) = AI.aiAnomalyCheck(sender, amount);

if (flagged) {
revert("Transfer flagged as anomalous");
}
}
}

가스 비용: 정액 40,000.

PRISM Consensus Params — 합의 상태 조회​

contract ConsensusReader {
IQoreConsensus constant RL = IQoreConsensus(
0x0000000000000000000000000000000000000c01
);

function getBlockTime() external view returns (uint256) {
(uint256 blockTime, , , ) = RL.rlConsensusParams();
return blockTime;
}

function getCurrentEpoch() external view returns (uint256) {
(, , , uint256 epoch) = RL.rlConsensusParams();
return epoch;
}
}

가스 비용: 정액 1,500에, 호출이 수행하는 상태 읽기에 대한 표준 비용이 추가됩니다.

네 가지 값의 의미

v3.2.6부터(두 네트워크 모두 이 릴리스 또는 이후 릴리스를 실행하며, 프리컴파일 자체는 테스트넷에서만 활성화됨) rlConsensusParams는 고정된 플레이스홀더 대신 rlconsensus 모듈이 보유한 값을 반환합니다. 적용된 블록 시간 목표(밀리초), 적용된 가스 가격 하한, 모듈의 default_validator_set_size, 에이전트의 현재 에포크입니다. 2026년 10월 27일 테스트넷에서는 5000, 100, 100, 1을 반환했습니다(GET /qorechain/rlconsensus/v1/applied_params와 같은 적용 값이며, REST / gRPC 엔드포인트 참조). 이 값들은 모듈 자체의 설정이며 측정된 블록 시간이 아닙니다(메인넷에서 약 3.1초, 테스트넷에서 약 1.3초). 또한 테스트넷에서 에이전트는 섀도 모드로 실행되므로 아무것도 적용하지 않습니다. 메인넷에서는 이 주소가 활성 목록에 없습니다. v3.2.6 코드가 바이너리에 들어 있고(rl-params-precompile-live가 활성화됨) 2026년 11월 4일에 이 주소로 보낸 eth_call은 빈 데이터(0x)를 반환했습니다. v3.2.6보다 오래된 노드에서는 같은 호출이 고정된 플레이스홀더 기본값을 반환합니다.

CrossVM Bridge — EVM에서 QoreChain Native 호출​

경고

CrossVM 브리지 프리컴파일은 메인넷에서 활성화되어 있지 않으며 테스트넷에서는 활성입니다(2026년 11월 7일 확인). 테스트넷에서는 v3.2.7 업그레이드 후인 2026년 11월 7일에 이를 통한 읽기 전용 eth_call을 실행했습니다. 허용 목록에 있는 대상은 컨트랙트에 도달하고, 그 밖의 대상은 is not allowlisted로 거부됩니다(크로스 VM 상호운용성에 상세 내용). 메인넷에서는 별도의 거버넌스 결정이 있기 전까지 v3.2.7 업그레이드 이후에도 크로스 VM 호출과 함께 꺼진 상태로 유지됩니다. v3.2.3부터 바이너리에는 강화된 버전이 들어 있으며, 이 버전은 STATICCALL을 거부하고, 중첩 호출을 호출 프레임에 남은 가스로 제한되는 가스 미터에서 실행하며 저널에 기록해 호출하는 컨트랙트의 되돌림이 QoreChain Native 쪽도 함께 취소하게 하고, 허용 목록에 있는 QoreChain Native 대상에만 접근하며(EVM 대상은 거부됨), 크로스 VM 서킷 브레이커를 준수합니다. 거버넌스 제안이 메인넷에서 이를 활성화하기 전까지는 그곳에 동기식 EVM-to-QoreChain Native 경로가 없습니다. MsgCrossVMCall 메시지 경로는 크로스 VM 상호운용성을 참고하세요. 이 경로 자체도 현재 메인넷에서는 꺼져 있습니다.

노드는 calldata를 executeCrossVMCall(uint8 targetVM, string targetContract, bytes payload)로 디코딩합니다 (4바이트 셀렉터 다음에 ABI 인코딩된 인자). 지원되는 용도는 EVM에서 QoreChain Native으로의 호출(targetVM = 1)뿐이며, ABI는 활성화 전에 변경될 수 있습니다. @qorechain/rdk 헬퍼 encodeCrossVmCalldata는 0.6.0부터 이 레이아웃을 인코딩하며(이전 릴리스는 다른 함수를 인코딩했습니다), isCrossVmPrecompileActive는 실제 active_static_precompiles 목록을 읽습니다. 멀티 VM을 참조하세요.

가스 비용: 기본 50,000 + 입력 바이트당 4 가스, 여기에 대상 컨트랙트 실행 비용이 더해집니다. 자세한 내용은 크로스 VM 상호운용성을 참고하세요.


인터페이스 파일 위치​

Solidity 인터페이스 파일은 직접 임포트할 수 있도록 저장소에 제공됩니다.

contracts/
interfaces/
IQorePQC.sol
IQoreAI.sol
IQoreConsensus.sol

Hardhat 또는 Foundry 프로젝트에 다음과 같이 설치하세요.

# Copy interfaces to your project
cp -r contracts/interfaces/ my-project/contracts/interfaces/

또는 Solidity 파일에서 임포트 경로를 통해 참조하세요.

import "./interfaces/IQorePQC.sol";
import "./interfaces/IQoreAI.sol";
import "./interfaces/IQoreConsensus.sol";

다음 단계​