Guideline and Final Announcement for the Termination of Klaytn’s 1st Anniversary Fee Delegation Policy
Hello. This is Klaytn API Service team.
Klaytn has been paying the full transaction fee (Gas fee and Transaction fee are called ‘Fee’) required for the operation of Klaytn-based services from July 9, 2020 to commemorate the first anniversary of the launch of the Klaytn Mainnet.
Klaytn's Fee Delegation Policy that has been proceeding for the past year will be completely terminated on July 31st, 2021. Therefore, it is indeed necessary for the customers who have been using the Fee Delegation to prepare changes in advance in order to avoid any issues during our service operation.
There are three types of Fee delegated payment methods that will be applied after July 31st.
Fee Delegation Type
-
KAS’ Utilization of Global Fee Payer
-
Global Fee Payer of KAS (Klaytn API Service) is a Fee Payer that monitors balance on GroundX at all times. With the termination of the payment policy, if you use Global Fee Payer, you will be charged as much cash as you used.
-
Coingecko's price is applied to calculate the Fee usage amount. The standard of price calculation is a previous price (0am UCT 9 am KST) basis determined by Coingecko, which also determines the price of KRW and USD. The fee will be added to the determined price. (Fee rate is 3%). However, the price update will reflect at 11 am KST to follow the Coingecko's actual price update time.
-
Those who have previously been subject to the Fee delegation policy through KAS Global Fee Payer can use it without any modification. However, the used fee will be charged from this August.
-
VAT that includes KAS service Fee and the total amount of used Fee will be applied to an invoice that will be delivered from August.
-
For customers who are currently using a KAS free plan, please note that Global Fee Payer service will not be available. If you are a KAS free plan user, please refer to the User Fee Payer instructions below.
-
-
KAS’ Utilizaiton of User Fee payer
-
Klaytn API Service(KAS) allows users to create and manage pools that allow users to pay for the fee themselves.
-
In the case of User Fee Payer, for security purposes, this cannot be returned once the deposit has been made. User Fee Payer can only be used for Fee delegation and once the deposit is made, the service company cannot transfer the amount deposited. Therefore, we recommend you to charge it in small amounts as much as you need.
-
The notification Settings feature that will be added soon will let you get notified when your balance shrinks below a certain amount.
-
For KAS free plan users, please proceed fee delegation payment through User Fee Payer
-
-
Direct Payment Deployment
-
You can prepare a separate account for payment and organize the fee delegation yourself. This can be implemented using Klaytn's account/key structure.
-
Required processes for the Fee delegated payment types that are mentioned above can be also divided into four types, depending on the payment method you are currently using.
How To Set Up Based On Each Condition
-
Using existing Fee delegation address → Utilizing KAS Global Fee Payer
-
In this case, the existing payment address will be available by the end of July, and the remaining amount will be recovered after that.
-
It is necessary to modify the code to use KAS' Global Fee Payer by referring to the KAS Reference Document.
-
In this case, Balance management for payment is not required, but the used Fee will be included in the invoice.
-
-
Using existing Fee delegation address → Utilizing KAS User Fee Payer
-
In this case, the existing payment address will be available by the end of July, and the remaining amount will be recovered after that.
-
Create a FeePayer Pool in the Console, and create a payment account for that pool. See KAS Reference Documentation to modify existing code.
-
Please manage the balance of the Fee Payer Account that is used in this way. You can charge KLAY regularly and use it.
-
However, Fee Payer Account's KLAY is set to be used only for Fee delegation for security enhancement purposes, and the charged amount cannot be moved again. You have to be careful when you make a deposit.
-
-
Use existing KAS Global Fee Payer → transferring to KAS User Fee Payer
-
In this case, the code used to connect to KAS remains the same
-
Please modify an original API calling code by referring to the KAS Reference document.
-
Modify URL Path of making API Calls (ex: /v2/tx/fd/value → /v2/tx/
fd-user/value ) -
When making API call, add feepayer and fee ratio argument.
-
-
-
Direct Fee Payer Deployment
-
In this case, various forms of access are available depending on the situation or purpose you have.
-
situation and purpose. Please refer to Fee Delegation Transactions and Account document.
-
Please prepare in advance before July 31st, so as to avoid problems with your service operation. We thank you again for your interest in the Klaytn Fee Delegation policy.
For further inquiries, please submit a request to the official KAS help center or contact KAS official support email (support@klaytnapi.com).
Thank you.
Klaytn API Service Team