크리보라 네트워크 노드 데몬 구축 및 운영 가이드
kryvora-network/kryvora-node
GitHub크리보라 노드는 분산 물리 인프라 네트워크(DePIN)의 공식 데몬으로, 작업자 하드웨어를 중앙 허브에 연결하여 상태 검증 및 가용성 증명 작업을 수행합니다.
- 노드는 텔레메트리 측정과 피어 상태 검증을 복합적으로 처리하며, 운영을 위해서는 Arbitrum One 기반의 'Genesis Node Key'가 필수입니다.
- 안정적인 구동을 위해 최소 2코어/2GB RAM 이상의 사양과 함께 로컬 텔레메트리 프로브를 위한 포트 4177 개방이 요구됩니다.
- 노드 운영 전, 반드시 Genesis Node Key로 부트스트랩 토큰을 확보해야 하며, 인증되지 않은 접속은 중앙 코디네이션 허브에서 거부됩니다.
Kryvora는 분산 물리 인프라 네트워크(DePIN)로, `kryvora-node` 데몬은 작업자 하드웨어와 Kryvora Hub를 연결하여 상태 검증과 작업자 코디네이션을 수행합니다. 이 노드는 Worker Engine에서 태스크 실행을 담당하며, Telemetry Daemon이 Port 4177을 통해 주기적으로 원격 측정 프로브(telemetry probes)를 실행하고 피어의 상태를 검증합니다. 모든 데이터는 Kryvora Storage Store에 저장되며, 시스템은 Mutual TLS와 gRPC/HTTP 통신 방식을 사용해 Heartbeat (30초 간격) 및 검증 프로브를 주고받습니다.
노드 운영을 위해서는 Arbitrum One 체인에 배포된 활성 **Genesis Node Key**가 필수적입니다. 이 키는 `0xBCf2cD12D1D37578fA7C69805fE77788e866BE1a` 주소에서 확인할 수 있습니다. 데몬을 실행하기 전, 반드시 [node.kryvora.network](https://node.kryvora.network)를 통해 부트스트랩 을 확보해야 하며, 이 토큰이 없거나 유효하지 않은 노드는 Coordination Hub (`hub.kryvora.network:4188`)에서 거부됩니다.
시스템 요구 사항으로는 최소 2코어 CPU와 2GB RAM, 그리고 20GB의 SSD 스토리지가 필요합니다. 또한 로컬 텔레메트리 프로브를 위해 인바운드 포트 4177이 개방되어야 합니다. 노드를 배포하는 방법은 세 가지가 제공됩니다: Linux systemd 자동 스크립트를 이용한 설치, Docker Compose 사용, 또는 Go 1.22 이상을 요구하는 소스 코드 빌드 방식입니다.
데몬은 `config.yaml` 파일이나 환경 변수를 통해 설정되며, 주요 구성 요소로는 노드의 고유 식별자(`node.id`), 로컬 측정 주소(`0.0.0.0:4177`), 그리고 중앙 허브 엔드포인트(`hub.kryvora.network:4188`) 등이 있습니다. 실행된 데몬은 포트 4177에서 `/health`, `/status` (피어 연결 및 블록 높이 정보), `/metrics` (Prometheus 형식) 등 다양한 상태 정보를 노출합니다.
용어 풀이
- 토큰
- AI 모델이 글을 처리하는 단위. 단어보다 작은 조각이며 사용량과 요금을 셀 때 기준이 돼요.