안녕하세요. Klaytn API Service 팀입니다.

Klaytn은 Klaytn 메인넷 출범 1주년 기념으로 클레이튼 기반 서비스 운영에 필요한 트랜잭션 수수료(가스비·gas fee 이하 'Fee' 라고 칭함)를 지난 2020년 7월 9일(목) 부터 전액 대납해왔습니다. 

지난 1년동안 진행되어 온 Fee Delegation (대납) 을 통한 Klaytn 의 트랜잭션 수수료 무료정책이 차주 토요일인 7월 31일이 되면 완전히 종료될 예정입니다. 이에 따라 기존에 Fee 대납을 활용하시던 고객분들께서는 서비스에 지장이 없도록 반드시 사전에 이전 작업을 진행해주셔야 합니다.

7월 31일 이후 시행될 Fee 대납 유형은 아래와 같이 3가지 유형으로 나눌 수 있습니다.

Fee 대납 유형

1. KAS의 Global Fee Payer 활용

   • KAS (Klaytn API Service)의 Global Fee Payer는 Ground X에서 잔고를 상시 모니터링하는 Fee Payer입니다. 대납 정책이 종료됨에 따라, Global Fee Payer를 사용하는 경우 사용한 Fee만큼의 현금으로 청구됩니다.
   • Fee 사용 금액을 계산하기 위해 Coingecko의 가격이 적용됩니다. 가격 산정 기준은 Coingecko에서 산정한 전일종가 기준(UTC기준 0시, 한국시간 오전09시)으로 원화와 달러화의 가격이 결정되며, 결정된 금액에 수수료(수수료율 3%)가 추가됩니다.  다만, 실제 가격의 업데이트는 한국시간 기준 오전 11시에 이루어지니 참고하여 주시기 바랍니다. (Coingecko의 실제 종가데이터 업데이트 시간에 따른 기준)
   • 기존에 KAS Global Fee Payer를 통해 Fee 대납 정책을 적용 받으시던 분들은 어떤 수정없이도 사용 가능합니다. 다만 8월부터는 사용한 Fee가 청구됩니다.
   • 8월부터 전달될 청구서에는 기존 KAS이용금액과 사용하신 Fee의 합산금액에 대한 부가세가 적용될 예정입니다.
   • KAS 무료플랜을 이용하시는 고객분들께서는 해당 Global Fee Payer 서비스 이용이 불가함을 참고해주시기 바랍니다. 무료플랜 이용 고객분들께서는 아래의 User Fee Payer 사용 안내를 참고하여 주시기 바랍니다.
     
     

2. KAS의 User Fee Payer 활용

   • KAS (Klaytn API Service)에는 사용자가 직접 Fee를 대납할 수 있는 Pool을 만들고 관리할 수 있습니다. 
   • User Fee Payer의 경우, 보안을 위해 입금시 반환이 불가합니다. 사용자 Fee Payer는 오직 Fee 대납에만 사용될 수 있으며, 일단 입금이 되면 개발사도 입금된 금액을 이전할 수 없습니다. 그러므로 꼭 필요한 만큼 소액으로 충전하며 사용하시길 권장 드립니다.
   • 곧 추가될 Notification 설정 기능을 통해, 특정 금액 이하로 잔고가 줄어들 때 알림을 받을 수 있습니다.
   • KAS 무료플랜을 이용하시는 고객분들께서는 User Fee Payer를 이용하여 Fee대납을 진행해 주시기 바랍니다.
     
     

3. 직접 Fee Payer 구축

   • 별도의 대납 전용 어카운트를 준비하여 직접 대납을 구성하실 수 있습니다. 이는 Klaytn의 어카운트 / 키 구조를 활용해 구현할 수 있습니다. 참고: *클레이튼 계정 구조

  제시된 대납 유형을 이용하기 위한 이전 작업은, 현재 이용하고 계신 대납 방식에 따라 크게 4가지 형태로 나눌 수 있습니다.

상황별 대응 방법

1. 기존 제공된 Fee 대납 주소 사용 → KAS Global Fee Payer 활용

   • 이 경우 기존 대납 주소는 7월 말까지 사용 가능하고, 그 후 잔여 금액은 환수 조치될 예정입니다.
   • KAS Reference Documentation 문서를 참고하셔서 KAS의 Global Fee Payer를 사용하도록 코드를 수정할 필요가 있습니다.
   • 이 경우 대납을 위한 Balance 관리는 필요가 없어지나, 사용된 Fee가 청구서에 포함됩니다.
     
     

2. 기존 제공된 Fee 대납 주소 사용 → KAS User Fee Payer 활용

   • 이 경우 기존 대납 주소는 7월 말까지 사용 가능하고, 그 후 잔여 금액은 환수 조치될 예정입니다.
   • Console에서 FeePayer Pool을 만들고, 해당 풀에 사용할 대납 계정을 생성합니다.
   • KAS Reference Documentation  를 참조하여 기존 코드를 수정합니다.
   • 이렇게 사용되는 Fee Payer Account의 잔고는 직접 관리하셔야 합니다. 주기적으로 KLAY를 충전하셔서 사용하실 수 있습니다.
   • 다만 Fee Payer Account의 KLAY는 보안 강화의 목적으로 오직 Fee 대납으로만 사용할 수 있게 설정되어 있으며, 충전된 금액은 다시 옮길 수 없습니다. 입금시 주의하셔야 합니다.
     
     

3. 기존 KAS Global Fee Payer 사용 → KAS User Fee Payer로 이전

   • 이 경우 KAS 연결에 사용되는 코드는 동일합니다.
   • KAS Reference Documentation  를 참조하여 기존 API 호출 코드를 수정합니다.
   • 호출할 API의 URL Path 를 수정합니다. (ex: /v2/tx/fd/value → /v2/tx/fd-user/value)
   • API 호출시 feepayer, feeratio argument를 추가합니다.
     
     

4. 직접 Fee Payer 구축

   • 이 경우는 상황과 목적에 따라 다양한 형태의 접근이 가능합니다.
   • 수수료 위임 트랜잭션 과 계정  문서를 참고하십시오.

  모쪼록 사용자 여러분들께서는 대납 서비스 종료시점인 7월 31일 이전에 미리 준비하시어, 서비스 운영에 문제가 발생하지 않으시기를 바랍니다.

  Klaytn Fee Delegation Policy에 관심 가져주셔서 다시 한 번 감사드리며, 추가적 문의 사항은 KAS 공식 헬프센터 혹은 KAS 공식 문의 메일(kas@groundx.xyz)로 연락해주시기 바랍니다.

감사합니다.