Integration Important Note

With KNS integration, it is crucial to fulfill the below requirements for the seamless KNS experience.

1. URL-Encoded

With KNS Domain API and KNS Asset API integration, domains must be URL-encoded to correctly identify all domain names.

2. Emoji Domains Invalid Using String Length

Emoji domains cannot be validated using string length, as it may result in errors. Please refer to the link below we use in our docs for proper handling.

3. Character Length & Fee Handled by Graphemer

  • Character Length & Fee must handle correctly.

  • Price is calculated based on the visual character length of the domain.

  • Example: '🏳️‍🌈' has a visual character length of 1.

We use graphemer to calculate the character length

🔗 : https://www.npmjs.com/package/graphemer

4. Normalize KNS Domain

  • KNS Domains follow the same standard as ENS, please make sure to use the below to normalize the domain name.

  • Any characters outside the below standard will not be verified.

  • This step is crucial to prevent invalid inscriptions and ensure that domains function correctly.

🔗 : https://www.npmjs.com/package/@adraffy/ens-normalize

5. ⚠️ Risk Notification For Resolve Integration

  • When users uses .kas domain to resolve addresses, the resolve UI must provide a Warning Text to remind users to verify the address.

  • Example Warning Text: “⚠️Before sending a transaction, please ensure that the resolved address is correct. Once a transfer is sent, it cannot be reversed. Any input errors may result in the loss of assets. Please verify carefully.

Warning Text Reference
Warning Text Reference

Last updated