본문으로 건너뛰기

메인넷 연결하기

공식 제네시스 파일, 피어, 네트워크 설정으로 노드를 구성하여 운영 중인 QoreChain Vladi 메인넷에 참여하세요.

노트

이 페이지는 qorechain-vladi 메인넷(EVM 체인 ID 9801, 16진수 0x2649)을 다룹니다. 이 메인넷은 2026년 6월 7일부터 운영되고 있으며, Cosmos SDK v0.53 위에서 2026년 11월 12일부터 릴리스 v3.2.7을 실행합니다(거버넌스 제안 16으로 높이 4,164,600에서 적용, 블록은 약 15:01 UTC에 재개. v3.2.6은 2026년 11월 4일 높이 4,020,000에서 적용되었습니다). qorechain-diana 테스트넷(EVM 체인 ID 9800)에 대해서는 테스트넷 연결하기를 참고하여, 실제 메인넷에 나서기 전에 그곳에서 설정을 미리 연습해 보세요.

공개 엔드포인트​

체인을 조회하거나 트랜잭션을 브로드캐스트하는 용도뿐이라면 자체 노드는 필요하지 않습니다 — 아래의 공개 엔드포인트를 사용하면 됩니다.

서비스URL
컨센서스 RPChttps://rpc.qore.host (WebSocket: wss://rpc.qore.host/websocket)
Cosmos REST (LCD)https://api.qore.host
EVM JSON-RPChttps://evm.qore.host (체인 ID 9801)
SVM JSON-RPC (읽기 전용)https://svm.qore.host
블록 탐색기explore.qore.network

거래소·인덱서 등 부하가 큰 프로덕션 워크로드의 경우, 아래 설명대로 자체 노드를 운영하세요.

퍼블릭 호스트는 여러 사용자가 함께 쓰므로 제한이 있습니다(요청 속도, SVM RPC 크기, EVM 필터). eth_call과 가스 추정은 EVM JSON-RPC 호스트를 통해 처리됩니다. 퍼블릭 엔드포인트 제한을 참조하세요.


설치​

qorechaind 바이너리는 공식 사전 빌드 번들을 사용하거나 소스에서 직접 빌드하여 설치할 수 있습니다.

사전 빌드 바이너리 번들 (linux/amd64)​

현재 바이너리에 대한 정본(canonical source of truth)은 메인넷 매니페스트로, https://download.qore.host/mainnet/latest.json에서 실시간으로 갱신되는 JSON 파일입니다. 이 매니페스트에는 현재 바이너리 URL과 SHA-256, 현재 제네시스 URL/SHA-256/크기, 현재 피어 및 시드 목록, P2P 포트, 상태 동기화(state-sync) 신뢰 지점, 최소 호환 체인 버전이 담겨 있습니다. 설치 스크립트에 바이너리 버전이나 체크섬을 하드코딩하지 말고, 이 값들을 가져와 사용하세요 — 하드코딩한 값은 새 릴리스가 나오는 즉시 낡은 값이 됩니다.

curl -s https://download.qore.host/mainnet/latest.json -o latest.json

BINARY_URL=$(jq -r .binary.url latest.json)
BINARY_SHA256=$(jq -r .binary.sha256 latest.json)

curl -fsSL "$BINARY_URL" -o qore.tgz
echo "${BINARY_SHA256} qore.tgz" | sha256sum -c -

tar xzf qore.tgz
sudo install -m0755 qorechaind /usr/local/bin/
sudo mkdir -p /opt/qorechain/lib && sudo cp lib/*.so /opt/qorechain/lib/
export LD_LIBRARY_PATH=/opt/qorechain/lib

이 번들에는 qorechaind와 함께 필요한 공유 라이브러리(libqorepqc.so, libqoresvm.so, libwasmvm.x86_64.so, 그리고 v3.2.8부터 libwasmvmqore_v1.x86_64.so)가 포함되어 있습니다. 개별 파일이 아니라 lib/ 디렉터리 전체를 복사하세요.

노드를 최신 상태로 유지하세요

풀 노드는 네트워크가 실제로 실행 중인 릴리스를 계속 따라가야 합니다 — 오래된 버전을 고정해 쓰지 말고, 항상 매니페스트가 가리키는 바이너리를 설치하세요. 현재 매니페스트(2026년 11월 12일 확인)는 v3.2.7이며 minCompatible은 3.2.7, upgradeHeight는 4,164,600입니다. 메인넷은 2026년 11월 12일 거버넌스 제안 16을 통해 해당 높이에서 v3.2.7을 적용했으며(블록은 약 15:01 UTC에 재개), 이전 릴리스를 그대로 실행하는 노드는 그 높이를 넘어 체인을 따라갈 수 없습니다. 번들은 qorechaind-v3.2.7-b3-linux-amd64.tar.gz(99,472,930바이트, SHA-256 d4b2f166a75900d2354759b067b3e21c6fbd96003ac056163791cf4b7fb242b5)입니다. 매니페스트에 따르면 번들의 lib/ 폴더 전체를 복사해야 하며, v3.2.7에서 이 폴더에는 libqorepqc.so, libqoresvm.so, libwasmvm.x86_64.so가 들어 있습니다. 업그레이드를 놓치고 여전히 v3.2.6인 노드는 높이 4,164,600에서 UPGRADE "v3.2.7" NEEDED와 함께 정지하며, 해결 방법은 이 번들을 (lib/ 폴더와 함께) 설치하고 재시작하는 것입니다(상태는 유지됩니다). 메인넷에서 이전에 있었던 거버넌스 업그레이드는 블록 높이 2,122,074의 v3.1.94(발행 상한), 블록 높이 2,981,742의 v3.2.0(EVM 인가 윈도우와 v2 하이브리드 서명 바이트), 블록 높이 3,556,788의 v3.2.2(2026년 10월 16일, 제안 7), 블록 높이 3,662,051의 v3.2.3(2026년 10월 20일, 제안 11), 블록 높이 3,742,566의 v3.2.4(2026년 10월 23일, 제안 13), 블록 높이 3,906,833의 v3.2.5(2026년 10월 29일, 제안 14), 블록 높이 4,020,000의 v3.2.6(2026년 11월 4일, 제안 15)입니다. v3.2.1은 높이가 없는 노드 로컬 릴리스였습니다. v3.2.6에서도 트랜잭션 서명은 바뀌지 않았으며, v3.2.7은 텍스추얼 서명 모드를 추가 옵션으로 더합니다. 새로 합류하는 노드에는 매니페스트가 명시한 v3.2.7 바이너리가 필요합니다. 제네시스부터 리플레이하기보다는 상태 동기화(아래 참고)를 권장합니다. 게시된 체인 데이터 스냅샷은 이 모든 업그레이드 높이보다 이전 시점의 것이므로, 이를 복원한 노드는 해당 업그레이드를 리플레이해야 합니다.

app.toml에 evm-chain-id = 9801을 설정하고(다른 값은 오류로 기록됩니다) 시스템 시계를 NTP로 동기화된 상태로 유지하세요. 시계가 60초를 초과하여 어긋나면 노드가 중지됩니다. binary.url을 신뢰하기 전에 항상 매니페스트의 "version"과 "minCompatible" 필드를 확인하세요 — 매니페스트는 테스트넷에 먼저 반영된 뒤 안정화 기간을 거쳐 메인넷에 반영되는 방식으로 의도적으로 승격됩니다. 서명 형식, 주소, 소수 자릿수, 메모, 수수료는 v3.2.3이나 v3.2.4에서 바뀌지 않았습니다.

테스트넷(qorechain-diana)은 메인넷보다 한 릴리스 앞선 v3.2.8을 실행합니다(v3.2.5는 2026년 10월 26일, v3.2.6은 2026년 10월 27일, v3.2.7은 2026년 11월 6일, v3.2.8은 2026년 11월 12일에 적용되었으며, 메인넷은 v3.2.8을 적용하지 않았습니다). 두 네트워크 사이에서 바이너리를 절대 복사하지 마세요. 항상 실행 중인 네트워크의 매니페스트를 따르세요.

조율된 업그레이드가 예정되면, 제안문에 해당 높이가 명시되고 그때까지는 이전 릴리스에 머물라고 안내합니다. 노드는 그 높이에서 정지하며, 그때 새 바이너리로 재시작하면 됩니다. 어떤 바이너리든 교체하기 전에 제안의 status(curl -s https://api.qore.host/cosmos/gov/v1/proposals/<id>)와 메인넷 매니페스트의 version 및 upgradeHeight 필드를 확인하세요. 업그레이드 바이너리를 해당 높이 전에 설치하지 마세요. 이를 미리 탑재한 노드도 정지합니다. 2026년 11월 12일에는 설정된 업그레이드 계획이 없었습니다(curl -s https://api.qore.host/cosmos/upgrade/v1beta1/current_plan이 "plan": null을 반환했습니다). 마지막 업그레이드인 거버넌스 제안 16은 2026년 11월 12일 높이 4,164,600에서 **v3.2.7 (build 3)**를 적용했습니다(그 앞의 제안 15는 2026년 11월 4일 높이 4,020,000에서 v3.2.6을 적용했습니다). 새 노드가 무엇을 설치해야 하는지는 위의 매니페스트가 기준입니다.

소스에서 빌드하기 (개발 전용)​

git clone https://github.com/qorechain/qorechain-core.git
cd qorechain-core
CGO_ENABLED=1 go build -o qorechaind ./cmd/qorechaind/

이렇게 빌드하면 스텁 키퍼가 포함되고 사후양자 서명기가 없는 커뮤니티 바이너리가 만들어지며, 이 바이너리는 네트워크의 합의 상태를 재현하거나 하이브리드 서명 트랜잭션을 생성할 수 없습니다. 메인넷에서 노드를 운영하려면 위의 릴리스 바이너리를 설치하세요. 전체 사전 요구 사항(Go 1.26+, CGO, 네이티브 라이브러리)은 소스에서 빌드하기를 참고하세요.

노드 초기화​

qorechaind init my-node --chain-id qorechain-vladi

이 명령은 ~/.qorechaind/ 아래에 기본 설정 및 데이터 디렉터리를 생성합니다.


제네시스 다운로드​

위에서 가져온 매니페스트의 URL과 SHA-256을 사용하여, 로컬 제네시스 파일을 공식 메인넷 제네시스로 교체하세요.

GENESIS_URL=$(jq -r .genesis.url latest.json)
GENESIS_SHA256=$(jq -r .genesis.sha256 latest.json)

curl -fsSL "$GENESIS_URL" -o ~/.qorechaind/config/genesis.json
echo "${GENESIS_SHA256} $HOME/.qorechaind/config/genesis.json" | sha256sum -c -

동일한 파일은 체인 자체에서도 실시간으로 제공되므로, 다운로드한 내용을 아래와 같이 교차 검증할 수 있습니다.

curl -s https://rpc.qore.host/genesis | jq '.result.genesis' > /tmp/genesis-live.json

이 파일은 Vladi 메인넷의 초기 상태 — 제네시스 검증인 집합, 토큰 배분(제네시스 시점의 TGE), 모듈 파라미터 — 를 정의합니다.


피어 구성​

노드 설정을 편집하여 공개 메인넷 센트리 노드에 연결하세요. 노드 ID와 호스트는 자주 바뀌므로 하드코딩하지 말고, 매니페스트에서 현재 피어·시드 목록을 읽어오세요.

PEERS=$(jq -r '.peers | join(",")' latest.json)
SEEDS=$(jq -r '.seeds | join(",")' latest.json)

~/.qorechaind/config/config.toml을 열고 persistent_peers(및 seeds) 필드를 위 값으로 설정하세요.

persistent_peers = "<value of $PEERS>"
seeds = "<value of $SEEDS>"

~/.qorechaind/config/app.toml에서 최소 가스 가격도 설정하세요(네트워크 수수료 하한선은 0.1uqor입니다).

minimum-gas-prices = "0.1uqor"

권장 설정​

풀 노드는 블록 타임을 선택하지 않으며, 이는 검증인이 정합니다(메인넷은 현재 약 3.1초마다 블록을 생성합니다). 검증인을 운영하면서 검증인 그룹으로부터 값을 전달받은 경우가 아니라면 컨센서스 타임아웃은 기본값 그대로 두세요. 공개 RPC 노드에 유용한 멤풀 설정은 config.toml에서 다음과 같습니다.

[mempool]
size = 5000

빠른 부트스트랩(스냅샷 또는 상태 동기화)​

제네시스부터 동기화하면 시간이 오래 걸릴 수 있습니다. 매니페스트의 stateSync 필드는 매시간 갱신되는 신뢰 높이/해시 쌍을 담고 있으므로, 높이를 직접 조사하는 대신 이 값을 사용해 상태 동기화를 구성하세요.

TRUST_HEIGHT=$(jq -r .stateSync.trustHeight latest.json)
TRUST_HASH=$(jq -r .stateSync.trustHash latest.json)

그런 다음 config.toml의 [statesync] 섹션을 위 값으로 설정하세요 — 신뢰 지점을 직접 구해야 할 때를 위한 수동 RPC 기반 대체 방법을 포함한 전체 절차는 노드 운영하기를 참고하세요.

체인 데이터 스냅샷도 매니페스트에 나열되어 있습니다(snapshot.url, snapshot.sha256, snapshot.height). 새 스냅샷이 이전 것을 대체하므로 파일명이나 높이를 하드코딩하지 말고 매니페스트에서 값을 읽으세요. 이 스냅샷은 용량이 크며(수십 기가바이트) 2026년 10월에 게시된 것은 블록 높이 1,966,629(2026년 8월 21일)에서 생성되었습니다 — 위에 나열된 모든 업그레이드 높이보다 이전이므로, 이를 복원한 노드는 해당 업그레이드를 리플레이해야 합니다. 대개는 상태 동기화가 더 빠르고 이를 피할 수 있습니다.

SNAPSHOT_URL=$(jq -r .snapshot.url latest.json)
SNAPSHOT_SHA256=$(jq -r .snapshot.sha256 latest.json)

curl -fsSL "$SNAPSHOT_URL" -o snapshot.tar.gz
echo "${SNAPSHOT_SHA256} snapshot.tar.gz" | sha256sum -c -

tar xzf snapshot.tar.gz -C ~/.qorechaind/

노드 시작​

노드를 실행하여 네트워크와 동기화를 시작하세요.

qorechaind start --minimum-gas-prices=0.1uqor

노드는 피어에 연결하여 블록 다운로드를 시작합니다(제네시스부터, 또는 스냅샷을 복원했다면 해당 높이부터).


동기화 상태 확인​

노드가 최신 블록을 따라잡고 있는지 확인하세요.

curl localhost:26657/status | jq '.result.sync_info.catching_up'
  • true — 노드가 아직 동기화 중입니다. 완료될 때까지 기다리세요.
  • false — 노드가 완전히 동기화되어 새 블록을 처리하고 있습니다.

최신 블록 높이도 확인할 수 있습니다.

curl localhost:26657/status | jq '.result.sync_info.latest_block_height'

올바른 네트워크에 연결되어 있는지 확인하세요 — network 필드에 qorechain-vladi가 표시되어야 합니다.

curl localhost:26657/status | jq '.result.node_info.network'

모니터링​

QoreChain은 노드의 상태와 성능을 모니터링할 수 있는 여러 엔드포인트를 제공합니다.

Prometheus 메트릭​

원시 메트릭은 다음 위치에서 확인할 수 있습니다.

http://localhost:26660/metrics

이 메트릭은 Prometheus 호환 수집기라면 어디서든 수집(scrape)할 수 있습니다.

Grafana 대시보드​

Docker Compose로 실행 중이라면 Grafana는 다음 위치에서 사용할 수 있습니다.

http://localhost:3001

처음 로그인할 때는 안내에 따라 직접 자격 증명을 설정하고, 기본값을 그대로 두지 마세요. 사전 구성된 대시보드는 블록 생성, 트랜잭션 처리량, 피어 연결, 리소스 사용량을 보여줍니다.

REST 헬스 체크​

REST API는 빠른 상태 확인용 엔드포인트를 제공합니다.

http://localhost:1317

포트 참조​

포트프로토콜설명
26657TCPRPC — 트랜잭션 조회 및 브로드캐스트
26656TCPP2P — 피어 간 네트워크 통신
1317HTTPREST API — HTTP를 통한 체인 상태 조회
9090gRPCgRPC API — 프로그래밍 방식 체인 접근
8545HTTPEVM JSON-RPC — 이더리움 호환 RPC(체인 ID 9801)
8546WebSocketEVM WebSocket — 실시간 EVM 이벤트 구독
8899HTTPSVM RPC — 솔라나 호환 RPC(읽기 전용이며, SVM 트랜잭션 레인은 비활성화되어 있음)
26660HTTPPrometheus 메트릭 엔드포인트

네트워크 정보​

항목값
체인 IDqorechain-vladi
EVM 체인 ID9801 (16진수 0x2649)
체인 버전v3.2.7 (2026년 11월 12일 높이 4,164,600에서 적용)
운영 시작2026년 6월 7일
블록 타임약 3.1초 (측정된 평균)
토큰QOR (uqor, 10^6 마이크로 단위 = 1 QOR)
최소 가스 가격0.1uqor
계정 접두사qor
검증인 접두사qorvaloper
SDKCosmos SDK v0.53

다음 단계​