플래닛 구동 방법

플래닛을 구동하기 위한 안내입니다. 본 페이지의 이미지는 개발 단계의 테스트 화면임으로 실제 구동 화면과 다를 수 있습니다.

1. Planet

1) Introduction

플래닛은 HAVAH 생태계의 인터체인 네트워크 환경을 구성하고 거버넌스를 담당하는 오프체인 노드입니다. 생태계가 성장하면서 플래닛이 처리하는 작업의 종류가 다양해질 수 있고 이에 따라 추후 플래닛의 구동 필요 사양이나 보상 조건이 변경될 수 있습니다.

2) Planet V1

Planet의 첫 번째 버전인 Planet V1은 HAVAH 메인넷과 함께 동작할 수 있는 탈중앙화 오프체인 노드 네트워크를 구성하는 것을 1차 목표로 하여 설계되었습니다. 그래서 다양한 주기로 임무를 전달하고 처리할 수 있는지 확인하도록 개발되어 있습니다. V2 이후 버전에서는 이러한 구조를 기반으로 구체적인 임무를 할당 받고 수행하게 됩니다.

3) Operation & Verification

Planet V1은 각 Day*마다 6시간의 구동 조건을 충족하면 보상을 수령할 수 있습니다.

  • 플래닛의 구동 보상은 플래닛을 획득한 날의 다음 Day(다음 Term)부터 6시간 구동을 검증 받은 후 수령할 수 있습니다.

  • 구동 시간은 주기적으로 검증 받기 때문에 실제 구동 시간과 검증 받은 구동 시간은 다소 차이가 발생할 수 있습니다. 그래서 검증 받은 운영 시간 기준으로 6시간 이상 검증 받게 되면 보상 수령 조건을 만족하게 됩니다.

  • 구동을 중단했다가 다시 재개해도 구동 시간은 누적해서 인정받게 됩니다. 다만 다음 Day로 넘어가게 되면 이전까지 검증 받았던 구동 시간은 모두 리셋되기 때문에 처음부터 다시 구동 시간을 계산하게 됩니다.

  • 현재는 1분 주기로 standby 상태를 확인하고 20분 단위로 구동 시간을 검증하고 있지만 이 또한 실시간으로 변경될 수 있습니다.

  • 각 Day에서 보상 처리 점검 시간을 2시간씩 할당해 두어 안정적으로 보상 시스템이 잘 동작할 수 있도록 설계되어 있습니다. 그래서 각 Day의 시작 시간부터 시작하여 22시간 이내에 6시간 구동 시간 검증을 마쳐야 합니다. 점검 시간인 마지막 2시간 동안의 구동 시간은 검증 처리가 되지 않기 때문입니다.

** Day: 엄밀하게는 term이라고 불리는 시간으로서 통상적으로 1일에 해당하는 시간입니다. 이 시간은 하바 체인이 통상 1일 동안 생성하는 매 43,200개의 블록이 생성 완료되는 시간을 말합니다. 이는 블록 생성 및 합의 시간에 따라 다소 시간차가 발생할 수 있으며 여러 가지 이유로 상당 시간 동안 블록 합의가 일어나지 않으면 이 term도 그만큼 시간이 길어지게 됩니다. 또한 그 시작 시간도 매 43,200 블록의 첫 블록 생성 시간에 따라 매번 달라질 수 있습니다.

4) Reward

Reward 수량 결정 방식 각 planet이 보상 조건을 충족했을 때 수령하는 보상은 전체 보상액을 planet 개수로 나눈 양이 됩니다. 이 때 planet 개수는 새 Day가 시작되기 바로 직전 까지의 planet NFT 개수를 기준으로 합니다. 예를 들어, 새 Day가 시작되기 직전까지 발급 된 총 planet NFT가 4,300개이고 해당 Day의 전체 보상 총액이 4,300,000 HVH라면 1개의 planet당 1,000 HVH를 수령하게 됩니다. 여기서 300개의 planet이 보상 조건을 충족하지 못한 경우에는, 300개의 planet 보상분인 300,000 HVH를 Sustainable Fund에 귀속시켜 추후 HVH 소각 등에 사용되어 HVH 가치 하락 방어 목적으로 사용됩니다. 즉, 다른 planet이 보상 조건을 충족하지 못했다고 해서 보상 조건을 충족한 planet의 보상액이 증가 되지 않습니다.

Planet 재판매시 주의 사항 Planet 보상은 planet NFT 별로 관리됩니다. 그래서 planet NFT를 재판매하게 된다면 그 전에 모든 보상을 클레임한 후에 판매하셔야 합니다. 판매가 된 이후에는 새 소유주가 기존 보상을 클레임할 수 있는 권리를 부여 받기 때문에 이전에 남은 보상을 클레임해 갈 수 있습니다.

2. Planet Runner V1

1) Introduction

플래닛 러너는 플래닛 구동 소프트웨어입니다. 플래닛 러너에 구매한 플래닛을 등록해서 운영할 수 있으며, 사용자가 직관적으로 인지할 수 있도록 현재 플래닛의 구동 상태를 표시해 주고 있습니다. 등록할 수 있는 플래닛 수량에 제한은 없지만, 등록 플래닛 수가 많은 경우, 플랫폼 PC의 사양에 따라 플래닛 러너 구동이 원활하지 않을 수 있습니다.

  • 플래닛 러너 설치 권장 사양 Planet 구동을 위한 최소 OS 버전: Windows 10/ Mac OS 11.44/ Ubuntu 22.04

  • 플래닛 러너 지원 언어 ENGLISH

2) Download

플래닛을 구매했다면, havah.io > Planet 에서 구동시킬 시스템 사양에 맞는 플래닛 러너를 다운로드 합니다.

3) Installation

※ 공통

  • 최초 설치가 아닌 경우, 이전 버전의 플래닛 러너를 완전히 삭제 후 최신 버전의 플래닛 러너를 설치해 주세요.

  • OS 별로 시스템 사용 권한 허용을 해줘야 하는 경우가 있을 수 있습니다. 드문 경우, 바이러스 프로그램에서 허용을 해줘야 하는 경우에도 동일하게 허용될 수 있도록 조치해주세요.

(1) Windows

- Setup.exe 파일을 실행해 주세요. - 설치를 시작하면 Windows의 PC 보호 안내 팝업이 뜹니다. - 팝업 내용 중 ‘Run anyway’ 를 선택하면 ‘yes’ 버튼을 선택할 수 있습니다. - ‘yes’ 버튼을 선택하면, 설치 허용을 위한 안내 팝업이 뜨며, 모두 허용을 선택하여 계속 진행을 합니다.

- 플래닛 러너를 설치할 폴더 위치를 지정하고, 설치를 계속 진행합니다.

- 설치가 완료되고 플래닛 러너를 실행시키면, 다시 한 번 실행 권한을 요구합니다. - 허용을 해주시면 구동 준비가 완료 됩니다.

(2) macOS

- dmg 설치 파일을 실행해주세요. 설치를 시작합니다.

- 설치를 시작하면 앱 사용을 위한 보안 설정을 해줘야 합니다. - 개발자 미인증 팝업이 뜨면 우선 “Cancel” 버튼을 눌러서 팝업을 닫아주세요. 그리고 macOS의 “System Preferences” > “Security & Privacy” > “Allow applications downloaded from” 에서 “Open Anyway” 를 선택해주세요. - 설치를 마치면 응용 프로그램에 플래닛 러너가 보이게 됩니다. - 앱을 실행하면 한번 더 보안 체크를 하므로, 팝업에서 ‘Open’ 버튼을 선택해 주시면 설치 및 구동 준비가 완료 됩니다.

(3) Linux/Ubuntu

Headless 형으로 제작된 플래닛 러너는 리눅스 사용자 대상으로 플래닛 러너를 손쉽게 실행시킬 수 있도록 제작되었습니다. - 터미널에서 앱 실행

./havah-planet-runner-headless-linux-1.0.0

- Permission 허용: 실행 파일에 x 권한이 없는 경우 실행시킬 수 없습니다. 권한을 주도록 합니다.

chmod 755 havah-planet-runner-headless-linux-1.0.0

- 추가 권한이 필요한 경우, 별도 권한 점검 필요

- preferences.json 파일 작성: 터미널에서 플래닛 러너를 실행시키면, Error가 보일 것입니다. 이는 access code를 설정하지 않았기 때문입니다.

./havah-planet-runner-headless-linux-1.0.0

플래닛 러너를 구동시키기 위해서는 플래닛별 access code를 preferences.json에 설정해야 합니다. - preferences.json 파일 작성 a. https://havah.io에 접속하여 구동시킬 플래닛의 access code를 발급받습니다. b. 아래를 참고하여, 운영하려하는 플래닛 개수만큼 access code를 입력하여 json 파일을 생성합니다. c. 플래닛 러너 실행 파일과 같은 위치에 둡니다.

{
"planet.access_code" : [ "00000xxxxxxxxxxx", "00000xxxxxxxxxxx"]
}

플래닛 러너 구동 및 모니터링

./havah-planet-runner-headless-linux-1.0.0

터미널에서 플래닛 러너의 구동 상태를 확인할 수 있습니다. 에러가 발생한 경우 에러코드들이 콘솔에 표시되며, 구동기간 동안은 로그로 남게 됩니다. 실행 파일과 같은 위치에 logs 폴더가 생성되어 있을 것입니다.

3. How to Run

1) Access Code 얻기

플래닛을 구매한 사용자는 https://havah.io 웹 페이지에서 지갑 연결 후 My Planet 페이지에서 구매한 Planet 내역을 확인할 수 있습니다. 그리고 각 Planet 별로 access code를 발급 받을 수 있습니다.

플래닛 구동을 위해서 access code를 복사하여 준비합니다. - Planet Runner에서 “My Planet”으로 바로 접속 가능합니다. - HAVAH 홈페이지에 로그인 및 지갑 연결 후 “My Planets” 페이지에서 “EXTRACT” 버튼을 누르면 Access Code가 발급 됩니다.

· 동일 플래닛 엑세스 코드로 동시에 여러 기기를 통해 플래닛 구동을 시도할 경우, 중복으로 구동을 시도한 플래닛의 모든 구동이 모두 멈추게 되니 엑세스 코드의 외부 유출은 삼가하시고 플래닛의 구동은 하나의 기기에서만 진행하시기 바랍니다.

· 플래닛 액세스 코드를 새로 발급 받을 경우 기존 액세스 코드는 무효화 되고, 해당 플래닛이 구동중이었다면 플래닛의 구동 또한 멈추게 되니 엑세스 코드의 재발급은 꼭 필요한 경우에만 진행하시기 바랍니다.

2) 플래닛 러너 구동

- 정상적으로 실행된 화면

Access code 입력 플래닛 러너 우측 하단에 “+ Add Planet” 버튼을 선택합니다. 그리고 위에서 준비한 access code를 입력합니다. 입력되면 즉시 플래닛은 구동을 시작하게 됩니다.

4. 플래닛 러너 구동 완전히 종료 하기

플래닛 러너를 완전히 종료하기 위해서는 아래의 방법으로 종료 해 주세요.

앱 창의 x 버튼으로는 완전한 종료가 되지 않습니다.

1) Windows OS

  • 작업 표시줄 > 플래닛 러너 앱 아이콘 > 마우스 오른쪽 클릭 > Context 메뉴 중 “Quit”

  • 러너 앱 좌측 상단 햄버거 메뉴 > 메뉴 중 “Quit HAVAH Planet Runner”

2) macOS

  • 작업 표시줄 > “HAVAH Planet Runner” > 메뉴 트리 중 “Quit HAVAH Planet Runner“

  • 작업 트레이 > 앱 아이콘 > 마우스 오른쪽 클릭 > Context 메뉴 중 “Quit”

  • 단축키 사용 "CMD + Q"

5. How to claim for HVH coin?

1) HAVAH.io 에 로그인 합니다.

2) 우측 상단 CONNECT 버튼을 눌러 지갑을 연결 합니다. (플래닛을 보유하고 있는 지갑이어야 합니다.)

3) 우측 상단에 닉네임 영역을 선택하면 My Planets 메뉴가 나타나고, My Planets 메뉴를 선택 하면 보유 중인 Planet·mPlanet 와 구동 현황을 볼 수 있는 페이지로 연결됩니다.

4) 이 My Planets 페이지에서 HVH Claim 진행 할 수 있습니다.

6. 용어 및 주의사항 안내

  • Day - 플래닛을 가동할 수 있는 회차를 의미하며 한 회차당 1회의 보상 수령이 가능합니다.

  • Period of day - 해당 회차의 시작 시간과 끝 시간을 의미하며 이 사이에 플래닛을 가동하여 보상 수령 조건을 충족해야 합니다.

  • Operation - Verified: 플래닛 가동을 인증 받은 시간을 의미하며 플래닛 6시간 가동을 인증 받아야 보상 수령이 가능합니다. - Operating: 플래닛을 가동한 물리적인 시간을 의미하며 가동 시간을 인증 받아야 하므로 Verified 정보와 차이가 있을 수 있습니다. - Estimated time of completion: 해당 회차에서 플래닛 가동이 완료되는 예상 시간을 의미합니다. - Complete before: 해당 회차에서 가동 인증이 종료되는 시점을 의미하며 당일 보상을 수령하기 위해서는 해당 시간 전에 플래닛 6시간 가동을 인증 받아야 합니다.

  • 주의사항 - 클라이언트는 PC에서만 실행할 수 있으며 모바일 장치에서는 액세스할 수 없습니다. - 컴퓨터가 꺼져 있거나 절전 모드로 전환되면 플래닛 작동이 중지됩니다. - 성능에 따라 1개의 PC에서 다수의 플래닛을 구동할 수 있습니다. (단, 플래닛의 기능이 변경될 경우 동시에 구동 가능한 플래닛 수가 변경될 수 있습니다.) - Planet 구동 보상은 좌측 하단의 MY Planet 페이지에서 클레임 할 수 있습니다. - 컴퓨터를 종료하지 않고 계속 켜놓아도 일일 보상 수령 조건을 충족할 수 있습니다. (매일 클레임을 진행하지 않아도 자동으로 누적되며 일괄 클레임이 가능합니다.) - Planet 가동 후 Verified 시간이 6시간 도달 시 당일 보상 수령 조건을 충족할 수 있습니다. - Planet 운영 시간은 UTC 02:00:00 ~ 23:59:59 입니다. 안정적으로 일일 보상 수령 요건을 충족하기 위해서 최소 16:00 이전에 가동을 시작해야 합니다. - 동일 플래닛 엑세스 코드로 동시에 여러 기기를 통해 플래닛 구동을 시도할 경우, 중복으로 구동을 시도한 플래닛의 모든 구동이 모두 멈추게 되니 엑세스 코드의 외부 유출은 삼가하시고 플래닛의 구동은 하나의 기기에서만 진행하시기 바랍니다. - 플래닛 액세스 코드를 새로 발급 받을 경우 기존 액세스 코드는 무효화 되고, 해당 플래닛이 구동중이었다면 플래닛의 구동 또한 멈추게 되니 엑세스 코드의 재발급은 꼭 필요한 경우에만 진행하시기 바랍니다.

Last updated