본문으로 건너뛰기

QoreChain SDK

QoreChain SDK는 양자 내성(quantum-safe) 트리플 VM 레이어 1 네트워크인 QoreChain 위에서 탈중앙화 애플리케이션을 구축하기 위한 공식 다중 언어 개발자 키트입니다.

이 문서에서는 SDK 설치, 네트워크 연결, 온체인 상태 조회, 계정 파생, 트랜잭션 서명 및 전송, 그리고 QoreChain의 각 가상 머신을 다루는 방법을 설명합니다.

QoreChain이란?​

QoreChain은 하나의 체인 위에서 세 가지 일급(first-class) 스마트 컨트랙트 런타임을 제공하는 레이어 1 블록체인입니다:

  • CosmWasm — Cosmos SDK 기반의 Wasm 스마트 컨트랙트.
  • QoreChain EVM Engine — 이더리움 호환 실행 환경(Solidity, viem, 표준 JSON-RPC).
  • SVM — 솔라나 스타일 JSON-RPC를 갖춘 솔라나 호환 런타임.

계정, 잔액, 토큰은 모든 런타임에서 공유되며, 체인은 크로스체인 상호운용성을 위한 IBC를 지원합니다.

설계부터 양자 내성​

QoreChain은 ML-DSA-87(Dilithium-5, FIPS 204)에 기반한 포스트 양자 암호(PQC) 프리미티브를 제공합니다. 고전적인 secp256k1 서명과 함께, 체인은 하나의 트랜잭션에 고전 서명과 포스트 양자 서명을 모두 담는 하이브리드 서명 방식을 지원하므로, 오늘날의 고전적 검증 아래에서 유효성을 유지하면서 동시에 포스트 양자 보호를 얻습니다.

SDK는 현재 ML-DSA-87 키 생성, 서명, 검증과 함께 하이브리드 트랜잭션을 위한 구성 요소를 제공합니다. 자세한 내용은 계정 및 PQC 서명을 참고하세요. 마케팅 문구가 아닙니다 — SDK는 체인이 실제로 구현한 프리미티브만을 정확히 노출합니다.

이 SDK가 다른 점​

완전한 멀티체인 패리티를 넘어, 세 가지 기능은 다른 어떤 레이어 1에도 없는 프로토콜 기능 위에 구축되었기 때문에 QoreChain에서만 가능합니다:

  • AI 사전 위험 점수(pre-flight risk scoring) — 브로드캐스트하기 전에 온체인 AI로 트랜잭션을 스캔합니다. simulateWithRiskScore는 가스와 함께 결정적 EVM 프리컴파일이 산출한 위험/이상 징후 판정을 반환하므로, 지갑이나 dApp이 서명 전에 경고(또는 차단)할 수 있습니다. AI 사전 점검을 참고하세요.
  • 통합 크로스 VM 호출 — 하나의 계정, 세 개의 VM, 하나의 트랜잭션. createCrossVMClient는 어떤 VM의 컨트랙트든 호출하며, callAtomic은 여러 크로스 VM 호출을 한 번의 서명으로 하나의 원자적 트랜잭션에 담습니다. 크로스 VM 호출을 참고하세요.
  • 양자 내성 DX — 멱등성이 보장되는 단 한 번의 호출 (ensurePqcRegistered / migrateToHybrid)로 서명자를 포스트 양자 보호 상태로 만들 수 있으며, 바로 사용할 수 있는 React 배지도 제공됩니다. 양자 내성을 참고하세요.

0.6.0과 0.7.0에서는 체인 수준의 기능 두 가지가 더 추가되었습니다:

  • 통합 eth-네이티브 계정 — 하나의 eth_secp256k1 키가 qor1…, 0x…, 그리고 SVM base58 주소로 표현되는 하나의 20바이트 아이덴티티이며, 모두 하나의 잔액을 공유합니다. 통합 계정을 참고하세요.
  • 인증자(Authenticator) 레인 — Phantom 또는 MetaMask 키를 정식(canonical) PQC 필수 계정에 연결하고, 최소 권한·지출 한도·철회 가능 조건 아래 릴레이어를 통해 지출하도록 할 수 있습니다. 인증자 및 위임 지출을 참고하세요.

새로운 @qorechain/react 키트(프로바이더, 훅, ConnectButton, QuantumSafeBadge)는 양자 내성 dApp 구축을 기본 경로로 만들어 줍니다 — React 키트 가이드를 참고하세요. 전체적인 근거는 왜 QoreChain SDK인가에서 확인하세요.

SDK 제품군​

SDK는 원하는 언어로 개발할 수 있도록 패키지 제품군으로 배포됩니다. 모든 패키지는 동일한 네트워크 프리셋, 파생 스킴, 단위(denomination) 계산, 조회 인터페이스를 공유합니다.

패키지언어설치상태
@qorechain/sdkTypeScriptnpm i @qorechain/sdk게시됨 (npm, v0.7.0)
qorechain-sdkPythonpip install qorechain-sdk (import qorsdk)게시됨 (PyPI, v0.7.0)
qorechain-sdk (Go 모듈)Gogo get github.com/qorechain/qorechain-sdk/packages/go/...게시됨 (Go 프록시, 태그 packages/go/v0.7.0)
qorechain-sdkRustcargo add qorechain-sdk (import qorechain)게시됨 (crates.io, 최신 게시본; 저장소 기준 0.7.0)
io.github.qorechain:qorechain-sdkJavaio.github.qorechain:qorechain-sdk:0.7.0게시됨 (Maven Central, v0.7.0)
@qorechain/evmTypeScript (EVM 어댑터)npm i @qorechain/evm viem게시됨 (npm, v0.7.0)
@qorechain/svmTypeScript (SVM 어댑터)npm i @qorechain/svm @solana/web3.js게시됨 (npm, v0.7.0)
@qorechain/reactTypeScript (React 키트)npm i @qorechain/react게시됨 (npm, v0.7.0)
create-qorechain-dappCLInpm create qorechain-dapp게시됨 (npm, v0.7.0)

Python 배포판은 qorechain-sdk라는 이름으로 설치되지만 qorsdk로 import합니다. 모든 클라이언트는 각 레지스트리에 게시되어 있습니다 — 언어별 명령어는 설치를 참고하세요.

이 문서의 예제는 TypeScript 코어(@qorechain/sdk)를 기준으로 합니다. Python, Go, Rust, Java 클라이언트는 TypeScript와 완전한 네이티브 체인 패리티를 달성했습니다: 네트워크 프리셋, denom/주소 유틸리티, HD 계정 파생(네이티브/EVM/SVM), PQC(ML-DSA-87) 서명, 모든 커스텀 모듈과 표준 Cosmos 모듈을 위한 타입 지정 메시지 컴포저, 타입 지정 쿼리 클라이언트, 완전한 트랜잭션 라이프사이클(자동 가스, 오류 디코딩, 트랜잭션 추적, 블록/트랜잭션 검색), 하이브리드 포스트 양자 트랜잭션, 그리고 WebSocket 구독까지 지원합니다. 이 모든 클라이언트는 게시되어 있습니다: TypeScript는 npm(@qorechain/sdk 0.7.0), Python은 PyPI(qorechain-sdk 0.7.0, import qorsdk), Go는 모듈 프록시(태그 packages/go/v0.7.0), Rust는 crates.io(qorechain-sdk, 최신 게시본 — 0.7.0 크레이트 게시는 대기 중이므로 crates.io 또는 저장소에서 설치), Java는 Maven Central(io.github.qorechain:qorechain-sdk 0.7.0)에 게시되어 있습니다. EVM/SVM 실행 어댑터(@qorechain/evm, @qorechain/svm, 둘 다 0.7.0), @qorechain/react 키트(0.7.0), create-qorechain-dapp 스캐폴딩 CLI(0.7.0)는 TypeScript 전용이며 마찬가지로 npm에 게시되어 있습니다.

0.6과 0.7의 새로운 기능​

0.6.0 — 통합 eth-네이티브 계정 (체인 v3.1.83). 하나의 eth_secp256k1 키가 세 가지 주소 인코딩 모두로 표현되는 하나의 20바이트 아이덴티티이며, 모든 레인에서 하나의 사용 가능한 잔액을 공유합니다:

import { deriveUnifiedAccount } from "@qorechain/sdk";

const account = await deriveUnifiedAccount(mnemonic);
account.cosmos; // "qor1…"   (bech32, Native lane)
account.evm;    // "0x…"     (EIP-55, EVM lane)
account.svm;    // base58    (20 bytes + 12 zero bytes)

동일한 키로 네이티브 레인에서 서명하려면 signClassicalEth / signHybridEth를 사용하며, connectPhantomUnified는 결정적 Phantom 서명으로부터 비수탁형(non-custodial) 통합 계정을 파생합니다. 기존 coin-type-118 deriveNativeAccount는 변경되지 않았습니다. 통합 계정을 참고하세요.

0.6.1 — 컨센서스 크리티컬 수정. PQCHybridSignature 트랜잭션 본문 확장이 이제 protobuf로 인코딩됩니다(이전에는 JSON으로 인코딩되어 CheckTx에서 거부되었습니다). SDK ≤ 0.6.0으로 만든 하이브리드 트랜잭션은 온체인에서 거부됩니다 — 업그레이드하세요.

0.7.0 — 인증자 레인 (체인 v3.1.85). 연결된 Phantom(ed25519) 또는 MetaMask(secp256k1, 20바이트 주소 기준) 키가 최소 권한·지출 한도·철회 가능 조건 아래 릴레이어를 통해 정식 PQC 필수 계정에서 지출할 수 있습니다: MsgExecuteEVM / MsgExecuteCosmos / MsgRotatePQCKey 컴포저, 바이트 단위로 정확한 evmAuthSignBytes / cosmosAuthSignBytes / rotationSignBytes 헬퍼, permissionSchema 쿼리, 디코딩된 오류 코드, 그리고 TypeScript 지갑 빌더(buildPhantomExecuteCosmos, buildMetaMaskExecuteEvm, …)를 제공합니다. 복사해 붙여넣을 수 있는 예제가 포함된 전체 안내: 인증자 및 위임 지출.

다음 단계​