본문으로 건너뛰기

아키텍처 및 개념

QoreChain은 세 개의 스마트 컨트랙트 가상 머신을 나란히 실행하며, 공유 계정과 공유 토큰을 갖춘 단일 Layer 1 체인입니다.

트리플 VM 모델​

VM컨트랙트SDK의 클라이언트 표면
QoreChain NativeRust/Wasm 컨트랙트 (CosmWasm 런타임)@qorechain/sdk의 client.cosmwasm() 및 queryContractSmart / execute 헬퍼
QoreChain EVM EngineSolidity / Vyper@qorechain/evm (viem 어댑터)
SVMSolana 프로그램@qorechain/svm (@solana/web3.js 어댑터)

네이티브(Cosmos) 레이어는 뱅크 전송, 스테이킹, 거버넌스, 그리고 런타임 간 메시지를 라우팅하는 x/crossvm 모듈을 처리합니다.

읽기 표면​

SDK는 여러 엔드포인트를 통해 노드와 통신합니다:

  • Cosmos REST (LCD) — 뱅크 잔액, 계정 정보, 모듈 쿼리.
  • 합의 RPC — 네이티브 트랜잭션 서명/브로드캐스트 및 QoreChain Native 읽기 클라이언트에 사용.
  • EVM JSON-RPC — 공개 엔드포인트의 표준 eth_*, net_*, web3_*, txpool_* 호출. QoreChain qor_* 네임스페이스와 EVM 프리컴파일은 아직 그곳에서 사용할 수 없습니다(아래 참조).
  • SVM JSON-RPC — SVM 런타임을 위한 Solana 호환 RPC(공개 엔드포인트에서는 읽기 전용이며, SVM 트랜잭션 제출은 네트워크 전체에서 비활성화되어 있습니다).

이를 활성화한 노드에서는 qor_* JSON-RPC 네임스페이스가 토크노믹스, PQC 키 상태, 하이브리드 서명 모드, 크로스 VM 메시지, 네트워크 통계 같은 QoreChain 고유 읽기를 노출합니다. TypeScript에서는 이들이 client.qor(QorClient)의 타입이 지정된 메서드이며, 동일한 표면이 Python, Go, Rust SDK에도 존재합니다. 공개 엔드포인트에서는 대신 REST 경로를 사용하세요(예: PQC 키 상태는 GET /qorechain/pqc/v1/account/{address}, 소각 통계는 GET /qorechain/burn/v1/stats).

아직 제공되지 않음: 릴리스된 어떤 노드 빌드도 qor_ JSON-RPC 네임스페이스를 제공하지 않으므로, 현재 모든 공개 엔드포인트에서 모든 qor_* 호출은 -32601(메서드를 찾을 수 없음)을 반환합니다. qor_ 네임스페이스를 참조하세요.

토큰 및 디노미네이션​

  • 표시 토큰: QOR.
  • 기본 디노미네이션: uqor, QOR당 10^6 기본 단위.

항상 기본 단위로 금액 계산을 하세요. SDK는 정확한 변환을 제공하므로 부동 소수점으로 정밀도를 잃지 않습니다:

import { toBase, fromBase } from "@qorechain/sdk";

toBase("1.5");        // "1500000"  (QOR -> uqor)
fromBase("1500000");  // "1.5"      (uqor -> QOR)

참고: EVM 런타임은 QOR를 18 소수 자릿수로 표현하며(EVM 관례), 이는 Cosmos uqor의 10^6 기본과는 다릅니다. @qorechain/evm 클라이언트는 표시에 기본적으로 18 소수 자릿수를 사용합니다. 대상 네트워크에 대한 값을 확인하세요.

주소​

동일한 키 자료는 세 가지 주소 형식으로 표현될 수 있습니다:

  • native — qor 접두사를 가진 bech32(qor1…), 검증자는 qorvaloper를 사용.
  • EVM — 0x…, EIP-55 체크섬.
  • SVM — ed25519 공개 키의 base58.

파생 경로는 계정 및 PQC 서명을 참조하세요.

크로스 VM​

QoreChain의 x/crossvm 모듈은 한 VM의 컨트랙트가 다른 VM의 액션을 트리거할 수 있게 합니다. EVM→네이티브 경로는 크로스 VM 브리지 프리컴파일(@qorechain/evm; 공개 네트워크에서는 아직 활성화되지 않음)을 통해 온체인에서 실행되며, SDK는 타입이 지정된 REST 읽기 헬퍼(getCrossVmMessage, getPendingCrossVmMessages, getCrossVmParams)와 메시지 상태를 추적하는 client.qor.getCrossVmMessage(...)를 제공합니다. 공개 엔드포인트에서는 REST 헬퍼와 client.qor가 제공되지 않으므로, connectQueryClients(rpc).crossvm으로 메시지를 읽으세요. 크로스 VM 가이드를 참조하세요.