지갑 설정

QoreChain은 네이티브, EVM, SVM 실행 환경 전반에 걸쳐 다양한 지갑 유형을 지원합니다. 사용 목적에 맞는 지갑을 선택하세요.

노트

아래 값은 qorechain-vladi 메인넷(EVM 체인 ID 9801, 2026년 6월 7일부터 가동 중)과 qorechain-diana 테스트넷(EVM 체인 ID 9800) 모두에 적용됩니다. 두 네트워크의 공개 엔드포인트는 네트워크 문서에 정리되어 있습니다.

Keplr 지갑

Keplr는 네이티브 QoreChain 트랜잭션, 스테이킹, 거버넌스에 권장되는 지갑입니다.

QoreChain을 커스텀 체인으로 추가하기

Keplr를 열고 Settings > Add Custom Chain으로 이동한 뒤 다음 값을 입력하세요:

필드	메인넷	테스트넷
체인 이름	`QoreChain`	`QoreChain Diana Testnet`
체인 ID	`qorechain-vladi`	`qorechain-diana`
RPC URL	`https://rpc.qore.host`	`https://rpc-testnet.qore.host`
REST URL	`https://api.qore.host`	`https://api-testnet.qore.host`
Bech32 접두사	`qor`	`qor`
코인 표시 단위	`QOR`	`QOR`
코인 최소 단위	`uqor`	`uqor`
소수 자릿수	`6`	`6`
코인 타입 (BIP-44)	`118`	`118`

체인을 추가하면 Keplr가 계정에 대한 qor1... 주소를 생성합니다.

가스 가격 하한선

네트워크 최소 가스 가격은 0.1uqor입니다. Keplr의 가스 가격 단계를 설정하는 경우(예: suggestChain 사용 시) 0.1 이상의 값을 사용하세요(권장 low/average/high: 0.1 / 0.15 / 0.25). 하한선 아래로 서명된 트랜잭션은 거부됩니다.

MetaMask (EVM)

MetaMask를 사용하면 QoreChain의 EVM 실행 환경과 상호작용할 수 있습니다 — Solidity 컨트랙트를 배포하고, ERC-20 토큰을 관리하고, 익숙한 Ethereum 툴링을 그대로 사용할 수 있습니다.

QoreChain을 커스텀 네트워크로 추가하기

MetaMask를 열고 Settings > Networks > Add Network로 이동한 뒤 다음 값을 입력하세요:

필드	메인넷	테스트넷
네트워크 이름	`QoreChain`	`QoreChain Diana Testnet`
RPC URL	`https://evm.qore.host`	`https://evm-testnet.qore.host`
체인 ID	`9801`	`9800`
통화 기호	`QOR`	`QOR`
블록 익스플로러 URL	`https://explore.qore.network`	`https://explore.qore.network`

네이티브 QOR는 EVM 인터페이스에서 18자리 소수점(wei 방식)을 사용합니다. 연결이 완료되면 MetaMask로 EVM 트랜잭션에 서명하고, 배포된 스마트 컨트랙트와 상호작용하고, QoreChain의 ERC-20 토큰을 관리할 수 있습니다.

한 번의 호출로 네트워크 등록하기

dApp의 경우, npm에 게시된 @qorechain/wallet-adapter 및 @qorechain/connect 패키지를 사용하면 한 번의 호출로 사용자의 지갑에 QoreChain을 등록할 수 있습니다 — EIP-3085를 통해 MetaMask에 네트워크 추가를 요청하고(EVM 레일에서 올바른 18자리 소수점 네이티브 QOR 포함), Keplr의 가스 가격 단계도 함께 구성합니다:

npm install @qorechain/wallet-adapter @qorechain/connect

import { addQoreEvmToWallet } from "@qorechain/wallet-adapter";

await addQoreEvmToWallet(); // prompts MetaMask with QoreChain's EVM network params

하나의 계정, 세 개의 주소 (통합 계정)

체인 버전 v3.1.83부터 QoreChain 계정은 세 가지 인코딩을 가진 하나의 20바이트 아이덴티티입니다: qor1… (네이티브), 0x… (EVM), base58 형식 (SVM). 계정은 하나의 잔액을 가지며 — eth 네이티브 계정의 경우 — 네이티브 경로에서 요구되는 포스트 양자 하이브리드 서명을 포함하여 하나의 키로 세 레인 모두에서 서명합니다.

@qorechain/wallet-adapter로 코드에서 통합 지갑을 생성할 수 있습니다:

import { generateQoreWallet } from "@qorechain/wallet-adapter";

const w = await generateQoreWallet();          // or walletFromMnemonic(mnemonic)
console.log(w.addresses.cosmos);               // qor1...
console.log(w.addresses.evm);                  // 0x... (same identity)
console.log(w.addresses.svm);                  // base58 (same identity)
// Native-lane sends use signHybridEth (classical eth_secp256k1 + ML-DSA-87 hybrid).

세 가지 형식 중 어느 주소로 자금을 보내든 동일한 잔액으로 입금됩니다.

연결된 지갑: 지출 키로서의 Phantom과 MetaMask

체인 버전 v3.1.85부터는 dApp에서 QoreChain 계정의 자금을 사용하기 위해 루트 키를 노출할 필요가 없습니다. Phantom (ed25519) 키 또는 MetaMask (personal_sign을 통한 Ethereum 주소 기준) 키를 계정의 인증자(authenticator)로 등록할 수 있으며 — 범위가 지정된 권한, 지출 한도, 만료 기한, 즉시 철회 기능과 함께 — 이후 dApp 백엔드가 릴레이하는 전송을 승인할 수 있습니다. 전체 모델과 코드는 연결된 지갑 인증자를, 엔드투엔드 예제는 SDK 인증자 가이드를 참고하세요.

Solana 지갑 (SVM)

QoreChain의 SVM 실행 환경은 표준 Solana 툴링과 호환되며, 계정의 네이티브 QOR 잔액을 SVM 인터페이스에서 직접 확인할 수 있습니다(lamports 단위, 9자리 소수점; 1 uqor = 1,000 lamports). Solana 호환 지갑이나 라이브러리를 자유롭게 연결하세요.

@solana/web3.js 사용하기

import { Connection } from "@solana/web3.js";

// Public read-only endpoint (or http://localhost:8899 on your own node)
const connection = new Connection("https://svm.qore.host");
const slot = await connection.getSlot();
console.log("Current slot:", slot);

공개 SVM 엔드포인트는 읽기 전용이며, 트랜잭션 제출에는 자체 노드가 필요합니다. 자세한 내용은 SVM 개발을 참고하세요.

PQC 지원 지갑 (Cosmos 경로에서 필수)

QoreChain은 cosmos 트랜잭션 경로에서 하이브리드 포스트 양자 암호화(PQC)를 요구합니다. 현재 체인 버전(v3.1.82) 기준 네트워크 기본값은 hybrid_signature_mode = required이고 allow_classical_fallback = false이므로 — 모든 cosmos 경로 트랜잭션은 표준 secp256k1 (ECDSA) 서명과 함께 ML-DSA-87 (Dilithium-5) 서명을 반드시 포함해야 합니다. PQC 계정에서 발생한 클래식 서명만 있는 cosmos 트랜잭션은 거부됩니다.

Cosmos 트랜잭션에는 하이브리드 PQC 확장이 필요합니다

cosmos 경로에서 클래식 서명만 있는 일반 트랜잭션을 전송하면 거부됩니다. Dilithium-5 서명을 PQCHybridSignature 트랜잭션 확장으로 첨부해야 합니다. 표준 CosmJS / Keplr 툴링은 이 확장을 자체적으로 생성하지 않습니다 — qorechaind tx pqc cosign CLI 명령어, QoreChain SDK의 하이브리드 서명(아래 참조), 또는 코드에서 직접 구성하려면 오픈소스 qorechain-pqc 라이브러리(hybridSignBytes)를 사용하세요. 유일한 예외는 제네시스 gentx와 PQC 키 등록/마이그레이션 트랜잭션입니다.

동작 방식

지갑은 표준 secp256k1 (ECDSA) 서명과 함께 ML-DSA-87 PQC 서명을 트랜잭션 확장으로 첨부합니다. 클래식 서명은 확장을 제외한 서명 바이트에 대해 계산되므로 클래식 검증에서는 여전히 유효하며, PQC 서명이 양자 내성을 제공합니다.

Dilithium-5 키 생성

하이브리드 서명을 위한 포스트 양자 키를 생성하세요:

qorechaind tx pqc gen-key

자동 등록

첫 트랜잭션에 PQC 공개 키를 포함하면 QoreChain이 이를 온체인에 자동으로 등록합니다. 별도의 등록 단계가 필요하지 않습니다. (PQC 키 등록/마이그레이션 트랜잭션 자체는 하이브리드 요구 사항에서 면제되므로, 계정이 첫 키를 부트스트랩할 수 있습니다.)

SDK를 이용한 하이브리드 서명

QoreChain SDK는 includePqcPublicKey: true 옵션과 함께 buildHybridTx를 사용하여 규격에 맞는 cosmos 트랜잭션을 생성합니다. 이 호출은 Dilithium-5 확장을 첨부하고 자동 등록을 위해 공개 키를 포함시킵니다. SDK 계정 및 PQC 서명을 참고하세요.

PQC 모드

세 가지 시행 모드는 거버넌스로 관리되며, 현재 네트워크 기본값은 Required입니다:

모드	설명
Disabled	PQC 검증이 꺼져 있습니다. 표준 서명만 사용합니다.
Optional	트랜잭션에 PQC 서명을 포함할 수 있습니다. 포함된 경우 검증됩니다.
Required (기본값)	모든 cosmos 경로 트랜잭션은 유효한 PQC 서명을 포함해야 합니다.

활성 모드는 체인 수준에서 설정되며 거버넌스를 통해 변경할 수 있습니다.

EVM / MetaMask에는 영향 없음

위의 MetaMask (EVM) 흐름은 하이브리드 요구 사항의 영향을 받지 않습니다. EVM 트랜잭션은 별도의 eth_secp256k1 ante 경로를 사용하며 PQC 확장이 필요하지 않습니다.

CLI 지갑

qorechaind 바이너리에는 커맨드라인 사용을 위한 키 관리 시스템이 내장되어 있습니다.

새 키 생성

qorechaind keys add mykey

이 명령은 새 키 쌍을 생성하고 니모닉 문구를 표시합니다. 니모닉을 안전하게 보관하세요 — 이 키를 복구할 수 있는 유일한 수단입니다.

주소 확인

qorechaind keys show mykey -a

이 명령은 qor1... bech32 주소를 출력합니다.

모든 키 나열

qorechaind keys list

기존 키 가져오기

qorechaind keys add mykey --recover

니모닉 문구를 입력하라는 프롬프트가 표시됩니다.

다음 단계

첫 트랜잭션 — 새 지갑으로 QOR 토큰 전송하기
테스트넷 연결 — 가동 중인 Diana 테스트넷에 참여하기

Keplr 지갑​

QoreChain을 커스텀 체인으로 추가하기​

MetaMask (EVM)​

QoreChain을 커스텀 네트워크로 추가하기​

한 번의 호출로 네트워크 등록하기​

하나의 계정, 세 개의 주소 (통합 계정)​

연결된 지갑: 지출 키로서의 Phantom과 MetaMask​

Solana 지갑 (SVM)​

@solana/web3.js 사용하기​

PQC 지원 지갑 (Cosmos 경로에서 필수)​

동작 방식​

Dilithium-5 키 생성​

자동 등록​

SDK를 이용한 하이브리드 서명​

PQC 모드​

CLI 지갑​

새 키 생성​

주소 확인​

모든 키 나열​

기존 키 가져오기​

다음 단계​