Klaytn API Service Baobab 이용 방법 및 Test 를 위한 KLAY 수령
2020년 7월 9일 클레이튼에서는 클레이튼 1주년 대납정책을 통하여 Klaytn API Service (이하 KAS) 를 사용하는 고객에게 KLAY를 1년간 무료로 지원하였습니다.
본 정책을 통해서 고객은 Klaytrn API Service 에서 제공하는 Global Fee Payer를 통해서 KLAY를 직접 소유하고 있지 않더라도 Klaytn API Service Cypress (메인넷) 를 사용할 수 있었습니다.
2021년 7월 31일 클레이튼이 1주년 대납정책을 종료함에 따라 무료 KLAY가 더 이상 제공되지 않기에, Klaytn API Service를 사용하시는 고객분들께서는 Klaytn 네트워크 사용을 위해 1. Klaytn API Service 유료 사용고객으로 전환하신 후, Global Fee Payer 사용을 신청하시는 방법과 2.Klaytn API Service User Fee Payer 설정 또는 3. 직접 본인의 대납 어카운트를 준비하여 사용 하시는 방법이 있습니다.
더 상세한 설정방법과 관련한 안내들은 아래 링크를 통해서 확인해보실 수 있습니다.(https://www.klaytnapi.com/ko/landing/notice)
다만, 본인이 Klaytn API Service 무료로 이용하는 고객에 해당하시고 유료고객 전환 전에 Klaytn 과 Klaytn API Service을 적극적으로 테스트를 하시고 싶다면, 네트워크를 Baobab으로 전환함으로써 테스트 KLAY를 수령하여 테스트넷인 Klaytn Baobab 과 Klaytn API Service를 적극적으로 사용해보실 수 있습니다.
하단에서는 Klaytn API Service Baobab 사용방법 및 Baobab을 사용하기 위한 무료 KLAY 수령방법을 안내
드립니다.
[Klaytn API Service Baobab 설정]
Klaytn API Service Baobab을 사용하기 위해서는 네트워크, HTTP 헤더, 어카운트 세 가지 설정에 대한 사전변경이 반드시 필요합니다. 아래 안내들을 통해 말씀드린 세 가지 사항에 대한 설정을 완료하여 주시기 바랍니다.
- 콘솔페이지에서 Network를 Cypress에서 Baobab으로 설정
Klaytn API Service 콘솔에서 네트워크를 Cypress (메인넷) 에서 Baobab (테스트넷)으로 변경해 주셔야 합니다.
이유는 매일 무료로 제공되는 10,000 API 사용량 및 계정당 총 200개까지 제공되는 Wallet Key 사용량을 Baobab(테스트넷)에서도 확인하기 위해서입니다. - API 호출에 필요한 HTTP 헤더 내부 x-chain-id값을 1001로 변경
기존 KAS에서 Cypress(메인넷)를 사용하셨던 분들은 Baobab(테스트넷) 상에서 API 호출을 하기 위해 HTTP헤더를 변경하셔야 합니다. x-chain-id에 입력된 값을 통해 Klaytn 네트워크를 선택할 수 있으며, 현재 지원되는네트워크들의 값은 각 Baobab(1001)과 Cypress (8217)입니다. 그러므로, KAS Baobab(테스트넷) 네트워크를 사용하기 위해서는 x-chain-id를 1001로 설정하셔야 합니다.
추가적으로 Klaytn API Service 기본개념과 설정에 대해서 궁금하신 분들께서는 Klaytn API Service 가이드를
참고해주시기 바랍니다.
[Klaytn API Service Baobab 네트워크 사용을 위한 Account 생성 및 테스트 KLAY 수령 ]
Klaytn API Service에서 Baobab 네트워크를 사용하기 위해서는 Cypress와 동일하게 KLAY가 필요합니다. 다만, Klaytn API Service에서는 유저들이 더 손쉽게 Account 풀을 설정하고 자신의 어카운트를 생성하여 쉽게 테스트 KLAY를 수령할 수 있도록 개발하였습니다. (주의: Baobab에서 사용되는 KLAY는 시중에서 유통되는 KLAY와 상이합니다.
- 콘솔메뉴에 있는 Service를 클릭하여 나타난 메뉴 중, Wallet을 누르시면 Account Pool의 리스트를 확인하실 수 있습니다. +Account Pool 생성 버튼을 눌러주세요.
- Account Pool 생성을 위해서 이름을 기입합니다. 이름 작성에 대한 제약은 별도로 없으니 편하게 이름을 기입해주시면 됩니다. 다만, 한번 생성된 이름은 추후 변경이 불가하오니 Account Pool을 쉽게 인지할 수 있도록 설정해주세요.
- 생성하신 Account Pool을 클릭하면 Account Pool 상세정보 페이지로 넘어갑니다. 이곳에서 +Account 생성버튼을 클릭해주세요. 클릭하시면, 바로 Account가 생성이 되며 ‘Account 생성에 성공하였습니다.’라는 메시지를 확인하실 수 있습니다.
- 생성하신 어카운트는 Account Pool 상세정보 페이지 내에서 보이게 되며, 테스트 KLAY수령을 위해서 Address옆에 있는 노란색 배터리 버튼을 클릭해주세요. 클릭하시면, ‘Account의 KLAY를 충전하시겠습니까?’라는 메시지가 보여집니다. 예 버튼을 클릭해주세요. 클릭하시면, 바로 해당 Account에 테스트를 위한 KLAY가 충전되게 됩니다.
- 다시 해당 Account를 클릭하시면 아래와 같이 5개의 테스트 KLAY 충전된 부분을 확인해보실 수 있습니다. Klaytn API Service Baobab 네트워크를 사용하고 싶으신 고객분들께서는 매일 5개의 테스트 KLAY를 수령하여 본인이 개발하고 계시는 블록체인 서비스 테스트를 진행해보실 수 있습니다.
[Klaytn API Service Baobab 네트워크 내 Fee-payer 생성을 통한 자신의 User Fee Payer 설정]
Klaytn API Service에서 자신의 어카운트를 생성하셨다면, 이제 해당 어카운트에 있는 테스트 KLAY를 User Fee Payer 어카운트로 전송해야 합니다. User가 사용하는 Fee Payer 어카운트 또한 Klaytn API Service 콘솔에서 설정할수 있습니다.
- 콘솔메뉴에 있는 Service를 클릭하신 후 나타난 서비스에서, Wallet을 누르시면 Fee-payer Pools를 확인하실 수 있습니다. 들어가셔서 +Fee-payer Pool 생성 버튼을 눌러주세요.
- Fee-Payer Pool 생성을 위해서 이름을 기입합니다. 이름 작성에 대한 제약은 별도로 없으니 편하게 이름을 기입해주시면 됩니다. 다만, 한번 생성된 이름은 추후 변경이 불가하오니 Fee-Payer Pool을 쉽게 인지할 수 있도록 설정해주세요.
- 생성하신 Fee-payer Pool을 클릭하면 Fee-payer Pool 상세 화면으로 전환됩니다. 이곳에서 + Account 생성버튼을 클릭해주세요. 클릭하시면, 바로 Account가 생성 메시지가 발생되며 ‘수수료 전용 계정은 수수료 납부 용도 외에 KLAY 를 사용할 수 없으며, 한번 입금한 KLAY 를 출금할 수 없습니다. 수수료 대납 전용계정으로 생성시, 계정 업데이트에 대한 트랜잭션 수수료가 청구됩니다.’라는 메시지를 확인하실 수 있습니다. 이후, 예 버튼을 클릭해주시면, Account가 발급됩니다.
- 발급된 Account는 상세 페이지에서 목록으로 나타납니다. 목록에서 생성한 Account의 어드레스를 확인 후 복사해주시기 바랍니다. 이후, Account Pools 메뉴로 돌아가서 고객님이 생성하셨던 Account를 클릭하시면 어카운트의 상세정보 위에 KLAY 전송이라는 버튼을 확인할 수 있습니다. 해당 버튼을 눌러주세요.
- KLAY 전송 버튼을 클릭하면, 트랜잭션이라는 페이지로 전환됩니다. 해당 페이지에서 받는 주소를 이전 단계에서 복사했던 Fee-payer Pool에서 생성한 Account의 어드레스로 기입해주시고 원하시는 수량만큼의 KLAY를 기입합니다. 그리고 다음 버튼을 클릭해주세요.
- 다음 트랜잭션 페이지가 나오면서, KLAY전송을 위한 보내는 주소, 받는 주소, 보내는 주소의 잔고, 전송 수량 등의트랜잭션을 위한 상세 정보가 보여지게 됩니다. 문제가 없다면 동의 및 전송 버튼을 클릭해주세요.
(주의: 해당 트랜잭션을 발생시키기 위해서는 소량의 가스비가 필요합니다. 때문에 전송하시는 KLAY는 항상 가스비가 제외한 수량을 고려하여 입력해주셔야 합니다.) - 클릭하면, 바로 KLAY가 전송되었다라는 메시지와 함께 전송이 완료됩니다 실제 전송결과에 대해서는 Klaytnscope를 통해서 확인해보실 수 있습니다.
(주의: Klaytnscope에서도 마찬가지로 네트워크 설정값을 Cypress가 아닌 Baobab으로 설정해주셔야 합니다.)
블록체인 플랫폼 Klaytn과 Blockchain as a Service로 블록체인 서비스를 테스트하기 위한 Baobab네트워크 활용과 그 활용을 위한 테스트 KLAY 수령방법을 알아보았습니다. 이처럼 Klaytn과 Klaytn API Service는 런칭 전 서비스를 위한 테스트 환경을 제공해드리고 있습니다. 이 테스트 환경을 통해서 Klaytn API Service가 제공하는 모든 API 를 활용하고 테스트해보실 수 있습니다.
추가적으로 궁금하신 사항이 있으실 경우, Klaytn API Service 헬프센터를 통해 연락주세요.
감사합니다.