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

# Integration Important Note

### 1. URL-Encoded

With [**KNS Domain API**](..#id-2.-kns-domain-api) and [**KNS Asset API**](..#id-1.-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.&#x20;

{% embed url="https://kns-2.gitbook.io/kns-docs-1/inscriptions/operations/create#rules" %}



### 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.&#x20;
* **Example**: '🏳️‍🌈' has a visual character length of 1.

_We use_ [_**graphemer**_](../../inscriptions/operations/create#rules) _to calculate the character length_

🔗 : [https://www.npmjs.com/package/graphemer](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.&#x20;
* Any characters outside the below standard will not be verified.&#x20;
* This step is crucial to prevent invalid inscriptions and ensure that domains function correctly.

🔗 : [https://www.npmjs.com/package/@adraffy/ens-normalize](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.&#x20;
* **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.

<div><figure><img src="https://299517459-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8lpQvHL6Td1G5ArlnmBf%2Fuploads%2Fj9oYKU7jzgBrydmAVinl%2Fimage.png?alt=media&#x26;token=ed0404c3-7abc-4d13-8514-02de070e5563" alt="" width="348"><figcaption><p>Warning Text Reference</p></figcaption></figure> <figure><img src="https://299517459-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8lpQvHL6Td1G5ArlnmBf%2Fuploads%2FB9l3tCRSO2FEjCjGtVSp%2Fimage.png?alt=media&#x26;token=dfb9426f-b5f6-4786-be97-ae9f360e0c38" alt="" width="349"><figcaption><p>Warning Text Reference</p></figcaption></figure></div>

