AvalancheGo 설정 가이드
실행 플래그·RPC·Bootstrap 확인 방법 요약입니다.
출처: Run a Node - From Source, API Reference.
주요 실행 플래그
| 플래그 | 설명 |
|---|---|
| --network-id | mainnet(기본) 또는 fuji(테스트넷) |
| --http-host | HTTP API 바인드 주소. 원격 접속 허용 시 0.0.0.0 |
| --http-port | HTTP API 포트 (기본 9650) |
| --staking-port | Staking/P2P 포트 (기본 9651) |
| --data-dir | DB·설정 저장 경로 |
전체 옵션: ./build/avalanchego --help.
RPC 엔드포인트 (Bootstrap 완료 후)
노드가 bootstrap을 마친 뒤 다음 주소로 RPC 호출 가능합니다.
- P-Chain:
http://localhost:9650/ext/bc/P - X-Chain:
http://localhost:9650/ext/bc/X - C-Chain RPC:
http://localhost:9650/ext/bc/C/rpc
원격에서 접속할 때는 localhost를 노드의 공개 IP로 바꾸고, 기동 시 --http-host=0.0.0.0 사용. 방화벽에서 9650(·9651) 허용.
Bootstrap 완료 여부 확인
특정 체인이 bootstrap 완료였는지 확인:
curl -X POST --data '{
"jsonrpc":"2.0",
"id":1,
"method":"info.isBootstrapped",
"params": { "chain": "X" }
}' -H 'content-type:application/json;' 127.0.0.1:9650/ext/info
"result": { "isBootstrapped": true } 이면 해당 체인(X/P/C) bootstrap 완료.chain 값을 P, X, C로 바꿔 각각 확인할 수 있습니다.
Bootstrap 전에 다른 API를 호출하면 API call rejected because chain is not done bootstrapping 오류가 날 수 있습니다.
NodeID 확인
Validator 등록 등에 필요한 NodeID:
- 소스/바이너리 직접 실행:
./build/avalanchego --version출력 또는 로그에서 확인. - Installer Script(systemd):
sudo journalctl -u avalanchego | grep "NodeID"
로그에 나온 값을 앞에NodeID-를 붙여 사용(예:NodeID-6seStrauyCnVV7NEVwRbfaT9B6EnXEzfY).
포트
- 9650: HTTP API (RPC)
- 9651: Staking/P2P
방화벽·보안 그룹에서 필요 시 9650·9651 인바운드 허용.
State sync (Installer 사용 시)
Installer Script에서 state sync 를 켜면 bootstrap이 빨라지지만, 현재 네트워크 상태만 동기화합니다.
과거 데이터가 필요한 Archival 용도라면 state sync 를 끄고 설치하세요.