본문으로 건너뛰기

노드 명령어

QoreChain 노드를 초기화, 설정, 운영하는 데 사용하는 qorechaind 명령어 레퍼런스입니다.

노트

QoreChain은 두 개의 네트워크를 운영합니다: qorechain-vladi 메인넷(2026년 6월 7일부터 운영 중이며, 노드 릴리스 v3.2.7은 2026년 11월 12일 높이 4,164,600에서 거버넌스 제안 16으로 적용됨. v3.2.6은 2026년 11월 4일 높이 4,020,000에서, v3.2.5는 2026년 10월 29일 높이 3,906,833에서, v3.2.4는 2026년 10월 23일 높이 3,742,566에서, v3.2.3은 2026년 10월 20일 높이 3,662,051에서 적용됨)과 qorechain-diana 테스트넷(노드 릴리스 v3.2.8은 2026년 11월 12일 높이 9,929,500에서 적용됨. 그 전에 v3.2.7이 11월 6일 높이 9,594,600에서, v3.2.6이 10월 27일 높이 8,970,638에서, v3.2.5가 10월 26일 높이 8,890,800에서, v3.2.4가 10월 19일 높이 8,337,253에서 적용됨. 메인넷은 v3.2.8을 아직 적용하지 않음)입니다. 참여하려는 네트워크에 맞는 --chain-id를 지정하세요 — 아래 예시는 테스트넷을 대상으로 하며, 메인넷의 경우 --chain-id qorechain-vladi를 사용하세요. 각 네트워크의 현재 릴리스는 download.qore.host의 latest.json에 나와 있습니다.

이 페이지의 명령어는 v3.2.3 릴리스 바이너리를 기준으로 확인했습니다. v3.2.4 바이너리에는 v3.2.3 바이너리에 없는 명령어가 추가되어 있으며(예: stakingtier), 이러한 명령어는 두 네트워크 모두에서 실행됩니다(테스트넷은 2026년 10월 19일부터, 메인넷은 2026년 10월 23일부터). 이 매뉴얼에서 그런 명령어를 언급하는 경우 이를 명시합니다. v3.2.6 바이너리(두 네트워크 모두)는 두 가지 쿼리 명령어 query rlconsensus applied-params와 last-action을 추가합니다(쿼리 명령어 참조). 이 페이지의 나머지 내용은 두 릴리스에서 동일하게 동작합니다.


init​

주어진 모니커로 새 노드를 초기화합니다.

qorechaind init <moniker> --chain-id qorechain-diana
플래그타입설명
--chain-idstring체인 식별자 (항상 지정하세요. 생략하면 임의의 식별자가 생성됩니다)
--homestring노드 홈 디렉터리 (기본값: ~/.qorechaind)
--overwritebool기존 genesis.json을 덮어씁니다
--recoverbool키를 새로 만들지 않고 시드 문구를 입력하여 기존 키를 복구합니다

--home 아래에 config/, data/ 디렉터리 구조와 초기 genesis.json을 생성합니다. 네트워크 노드의 경우, 시작하기 전에 이 genesis.json을 해당 네트워크의 제네시스 파일로 교체하세요(메인넷 연결하기 참조).

init은 또한 네트워크의 EVM 체인 ID(qorechain-vladi는 9801, qorechain-diana는 9800)를 app.toml의 evm-chain-id 설정에 기록하므로, 올바른 --chain-id를 지정하세요.


start​

노드를 시작하고 동기화 또는 블록 생성을 개시합니다.

qorechaind start [flags]
플래그타입설명
--homestring노드 홈 디렉터리
--minimum-gas-pricesstring이 노드가 수락하는 최소 가스 가격. 네트워크 하한은 0.1uqor이므로 최소한 그 값 이상으로 설정하세요
--pruningstring프루닝 전략: default, nothing, everything, custom (--pruning-keep-recent 및 --pruning-interval과 함께 사용)
--halt-heightuint해당 블록 높이에서 노드를 정지합니다
--halt-timeuint해당 Unix 타임스탬프에서 노드를 정지합니다
--log_levelstring로그 상세 수준: info, debug, warn, error
--tracebool오류 발생 시 전체 스택 트레이스를 활성화합니다

공개 소스 트리로 빌드한 바이너리(커뮤니티 빌드)는 qorechain-vladi 또는 qorechain-diana에서 시작을 거부합니다. 양자내성 서명을 검증할 수 없고 네트워크의 블록을 정확하게 재생할 수 없기 때문입니다(노드 릴리스 v3.2.3 이후). download.qore.host의 릴리스 바이너리를 사용하세요. 소스에서 빌드하기를 참조하세요.


version​

릴리스 바이너리에서 qorechaind version은 릴리스 번호를 출력하지 않습니다: 빈 줄을 출력하며, version --long도 빌드 세부 정보를 추가하지 않습니다. 릴리스를 구분하는 데 이 명령어에 의존하지 마세요. 실행 중인 버전을 확인하려면 다음을 사용하세요.

  • 압축을 풀기 전에 다운로드한 아카이브의 SHA-256을 네트워크 매니페스트의 binary.sha256과 비교하세요(설치한 내용의 기록으로 그 아카이브 또는 체크섬을 보관하세요).
  • 체인에 적용된 업그레이드를 조회하세요: GET /cosmos/upgrade/v1beta1/applied_plan/<upgrade_name>은 업그레이드가 적용된 높이를 반환하며, 적용되지 않았으면 0을 반환합니다.
# archive checksum, as published
curl -s https://download.qore.host/mainnet/latest.json | jq -r '.version, .binary.sha256'
# has v3.2.3 / v3.2.4 / v3.2.5 / v3.2.6 / v3.2.7 been applied on mainnet, and at which height? (a name that was not applied returns {"height":"0"})
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.3 # {"height":"3662051"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.4 # {"height":"3742566"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.6 # {"height":"4020000"}
curl -s https://api.qore.host/cosmos/upgrade/v1beta1/applied_plan/v3.2.7 # {"height":"4164600"}

status​

실행 중인 노드에 현재 상태를 조회합니다. 동기화 상태, 최신 블록 높이, 합의 정보를 포함합니다.

qorechaind status
플래그타입설명
--nodestringRPC 엔드포인트 (기본값: tcp://localhost:26657)

node_info, sync_info, validator_info 섹션을 포함한 JSON을 반환합니다.


client configuration​

config 하위 명령어는 없습니다. 클라이언트 기본값(chain-id, keyring-backend, output, node)은 <home>/config/client.toml에서 읽습니다. 이 파일을 편집하거나, 명령어마다 플래그(--chain-id, --keyring-backend, --output, --node)를 지정하세요.


keys​

트랜잭션 서명을 위한 로컬 키링을 관리합니다.

새 키 추가​

qorechaind keys add <name> [flags]
플래그타입설명
--keyring-backendstring백엔드: os, file, kwallet, pass, test, memory
--key-typestring키 알고리즘: secp256k1 (기본값) 또는 eth_secp256k1
--coin-typeuint32HD 코인 타입 (기본값 118)
--recoverbool니모닉으로부터 키를 복구합니다
--multisigstring멀티시그에 사용할 키의 콤마 구분 목록
--multisig-thresholduint필요한 최소 서명 수

전체 키 목록 조회​

qorechaind keys list --keyring-backend <backend>

키 상세 정보 조회​

qorechaind keys show <name> [flags]
플래그타입설명
--bechstring출력 형식: acc, val, cons
--addressbool주소만 표시합니다
--pubkeybool공개 키만 표시합니다

키 삭제​

qorechaind keys delete <name> --keyring-backend <backend>

키 내보내기 (암호화된 아머 형식)​

qorechaind keys export <name>

키 가져오기​

qorechaind keys import <name> <keyfile>

genesis​

제네시스 파일을 관리합니다.

제네시스 계정 추가​

qorechaind genesis add-genesis-account <address> <coins> [flags]
플래그타입설명
--vesting-amountstring베스팅 수량
--vesting-start-timeint베스팅 시작 시각 (Unix 타임스탬프)
--vesting-end-timeint베스팅 종료 시각 (Unix 타임스탬프)

제네시스 트랜잭션 생성​

qorechaind genesis gentx <key-name> <stake-amount> [flags]
플래그타입설명
--chain-idstring체인 식별자
--monikerstring검증인 모니커
--commission-ratestring초기 수수료율
--commission-max-ratestring최대 수수료율

제네시스 트랜잭션 수집​

qorechaind genesis collect-gentxs

다른 genesis 하위 명령어: bulk-add-genesis-account, migrate.

제네시스 파일 검증​

qorechaind genesis validate

합의 엔진​

이 하위 명령어들은 QoreChain 합의 엔진 계층과 상호작용합니다.

검증인 키 표시​

qorechaind comet show-validator

합의 공개 키를 JSON 형식으로 출력합니다. 검증인 신원을 확인하는 데 사용됩니다.

노드 ID 표시​

qorechaind comet show-node-id

P2P 노드 식별자(16진수 인코딩)를 출력합니다. 영구 피어 설정에 사용됩니다.


export​

현재 체인 상태를 JSON 제네시스 파일로 내보냅니다. 체인 업그레이드나 스냅샷에 유용합니다.

qorechaind export [flags]
플래그타입설명
--for-zero-heightbool높이 0에서 재시작하기 위한 내보내기를 준비합니다
--heightint특정 블록 높이에서 상태를 내보냅니다
--homestring노드 홈 디렉터리
--output-documentstring내보내기 결과를 STDOUT 대신 이 파일에 기록합니다
--modules-to-exportstrings내보낼 모듈의 콤마 구분 목록 (기본값: 전체)
--jail-allowed-addrsstrings투옥 해제할 투옥된 검증인의 운영자 주소

rollback​

체인 상태를 한 블록 되돌립니다. 합의 실패로부터 복구할 때 유용합니다.

qorechaind rollback [flags]
플래그타입설명
--hardbool블록 저장소에서도 마지막 블록을 제거합니다
--homestring노드 홈 디렉터리

이 명령어는 애플리케이션 상태와 합의 상태를 모두 되돌립니다. 되돌릴 수 없으므로 신중하게 사용하세요.