Tutorials, for User

 TreasuryRebalance 상태 조회하는 방법 (KIP-103)

4월 17일에 예정된 Cypress  KIP103 하드포크를 앞두고, KGP-6의 일환으로 제안된 트레저리 리밸런싱(KIP-103) 상태를 확인하는 방법에 대한 간단한 가이드를 준비했습니다.

통과된 KGP-6 제안에는 다음이 포함되었습니다:

  • 52억 8,100만 KLAY에 대한 선 소각
  • GroundX에 1.97억 KLAY 할당
  • 초기 발행 리저브, KGF, KIR 펀드를 3개의 새로운 펀드인 Klaytn Community Fund (KCF), Klaytn Foundation Fund (KFF), Klaytn Value Creation Reserve (KVC)로 리밸런싱

트레저리 리밸런싱 구현에는 위변조가 불가능하고 누구나 언제든지 검증할 수 있는 스마트 컨트랙트 기능이 포함되어 있습니다. 이에 Klaytn 블록체인 탐색기에서 데이터를 쿼리하는 실제 듀토리얼을 소개합니다. 아래의 듀토리얼은  클레이튼스코프 의 스크린샷으로 구성되어있습니다. 

1. 컨트랙트 열람

시작하기 위해, 클레이튼스코프 또는 클레이튼파인더를 방문하여 Read Contract를 클릭합니다.


KIP-103의 계약 주소는 다음과 같습니다: 0xD5ad6D61Dd87EdabE2332607C328f5cc96aeCB95

블록체인 탐색기 사이트에서 아래 스크린샷과 같이 데이터 쿼리 함수 목록을 볼 수 있습니다.

2. 기존 트레저리 펀드 월렛 정보 열람

기존의 지갑의 수를 조회하려면 getRetiredCount를 클릭합니다.

숫자 “4”가 표시되며, 이 숫자는 KIP-103 하드포크로 지갑 리밸런싱이 이루어지면 폐기되는 기존 지갑의 수입니다.

각 기존 지갑의 주소를 조회하려면 Retirees 를 클릭하고 인덱스를 입력합니다. 4개의 지갑이 확인되었으므로 0-3번을 입력하시면 됩니다.

다음은 각 인덱스가 나타내는 기존 트레저리의 지갑의 정보입니다.

0 – Klaytn Reserve 1

  • 주소: 0xAfD197d383453b08B7c1509BdB4B6afEe9F66578

1 – Klaytn Reserve 2

  • 주소: 0x5678300aBc1F599D865C3525df851b3902C88266

2 – KGF

  • 주소: 0x278e6332D69Eed782784d21802e3504a64A16456

3 – KIR

  • 주소: 0x3d803A7375a8EE5996f52A8d6725637a89f5Bbf8

3. 새로운 트레저리 펀드 월렛 및 잔액에 대한 정보 열람

기존 지갑의 수를 조회하려면 getNewbiesCount를 클릭합니다.

숫자 “3”이 표시되며, 이는 KIP-103 하드포크로 지갑 리밸런싱이 발생하면 할당될 새로운 지갑의 수입니다.

새로운 지갑의 주소와 잔액을 조회하려면 newbies를 클릭하고 숫자를 입력합니다. 3개의 지갑이 확인되었으므로 0-2를 입력할 수 있습니다.


각 인덱스가 나타내는 새로운 트레저리 월렛 목록은 아래와 같습니다.

0 – Klaytn Value Creation Fund (KVC)

  • 주소: 0x4f04251064274252D27D4af55BC85b68B3adD992
  • 할당된 수량: 2,000,000,000 KLAY 

1 – Klaytn Foundation Fund (KFF)

  • 주소: 0x85D82D811743b4B8F3c48F3e48A1664d1FfC2C10
  • 할당된 수량: 180,000,000 KLAY 

2 – Klaytn Community Fund (KCF)

  • 주소: 0xdd4C8d805fC110369D3B148a6692F283ffBDCcd3
  • 할당된 수량: 270,000,000 KLAY 

4. 리밸런싱 상태 확인

현재 트레이더리밸런싱 상태를 확인하려면 status를 클릭합니다.

리밸런싱에는 아래의 4가지 단계가 있습니다. 

  • 0 – Initialized: 컨트랙트 초기 상태
  • 1 – Registered: Retirees와 Newbies가 블록체인상에 등록됨 
  • 2 – Approved: 모든 Retiree가 승인됨
  • 3 – Finalized: 리밸런싱이 실행되고 완료됨

스크린샷에서 조회되는 “2” 상태는 retirees가 승인되었으며, reblanceBlockNumber에 도달하면 재조정이 실행될 것임을 의미합니다.

5. rebalanceBlockNumber 찾기

rebalanceBlockNumber는 자산 리밸런싱이 발생하는 블록입니다. 자산 재조정이 실행되고 완료되면 블록 번호를 조회할 수 있습니다. 조회하려면  rebalanceBlockNumber를 클릭합니다.

자산 리밸런싱이 실행되는 블록은 블록 번호 119750400입니다.

6. 예상 소각량 계산하기



아래의 공식을 사용하여 예상 소각량을 계산할 수 있습니다:

Burnt amount = sumOfRetiredBalance – (getTreasuryAmount + newbies’ balance). 

sumOfRetiredBalance를 클릭하면 소각된 지갑의 총 잔액을 확인할 수 있으며, getTreasuryAmount를 클릭하면 새로운 트레저리 월렛이 보유할 총 금액을 확인할 수 있습니다. 

본 듀토리얼 작성 시점(2023년 3월 31일) 기준으로, 예상되는 소각 금액은 5,291백만 KLAY입니다. 이 금액은 그 이후로 분배된 KGF/KIR 블록 보상으로 인해 KGP-6에 표시된 소각 금액보다 약간 더 큽니다.



블록 보상이 계속 분배되고 있기 때문에, KIP103 하드포크가 발생할 때까지 sumOfRetiredBalance는 계속 증가한다는 점에 유의하시기 바랍니다. 한편, 추가로 생성된 블록 보상도 트레저리 리밸런싱 중에 소각될 예정이니 안심하셔도 됩니다.

7. TreasuryRebalance 검증

KIP103 하드포크가 발생하고 스마트 컨트랙트가 실행되면 블록체인 탐색기에서 메모를 클릭하여 확인할 수 있습니다. 클레이튼 노드는 실행 시점에 트랜잭션 리밸런싱 결과를 설명하는 로그를 출력하며, 이 로그는 KIP-103 컨트랙트에 memo로 업데이트됩니다. 예시는 아래와 같습니다.


“retired” 값에는 은퇴한 주소(기존 지갑) 목록이 표시되며, “newbie” 에는 새로 생성한 주소(신규 지갑) 목록이 표시됩니다. 또한 “burnt” 값에서 소각된 KLAY의 양을 확인할 수 있습니다.


듀토리얼의 내용 관련한 추가적인 질문 등이 있다면, 아래의 채널을 참고하시길 바랍니다. 

Discord channel  Telegram group