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.


Last updated