Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

ICON Name Service

Join the chat at

πŸ“–πŸ” Documents and implementations for the ICON Name Service.

| English | ν•œκ΅­μ–΄ |


πŸ’‘ What is ICON?

ICON is building a massive platform that will allow various blockchains to interact with each other via smart contracts. Existing within what developers brand the ICON Republic, communities will connect with each other using ICON’s loopchain technology.

πŸ’‘ What is BNS?

BNS – or blockchain name system – is the protocol on the internet that turns human-comprehensible decentralized website names such as β€˜website.icx’ or β€˜mywebsite.eth’ into addresses understandable by decentralized network machines.

πŸ“ Description

INS is the ICON Name Service, a distributed, open, and extensible naming system based on the ICON blockchain.

πŸ“š Documents

Table of Contents

πŸ“ Guideline

Testnet Contracts

Title Description
Name Yeouido (μ—¬μ˜λ„)
API endpoint
Network ID (nid) 3
Transaction fee on
SCORE audit off
INS Contract Network Contract Address Transaction Hash
Registry Yeouido cx1720bef7a1d0552e4609c5a72a71a173ca84b8f7 0xbabcb7c2a92ff57654d08db662a0db2f1719b2adac2e99b37c3cf16b664afccb
Registrar Yeouido cxb444156d3c905d4b690e1f8cb20e492624cc6e74 0x344a38f23e1e17af67519fe645c1cd9c9e67b7e129001edd13cb98030591729b
Resolver Yeouido cxb5952c5bcf62276dbf15a695dfd62ebc2af64f0e 0x97a22d0abe079ff017d09807e52fb59ddc58439a4f60cd8cbcd6654263874bc8

πŸ“ ICON in Web3.0

INS plays an connecting and entry layer in Web3.0 services. It connects with ICON wallet, blockchain server, decentralized content resources, and decentralized database. INS Workflow

πŸ—‚οΈ INS Technical Stack

ICON Name Service (INS) governs by three smart contract components, registrar, registry, and resolver. The three smart contracts contain the core logic for the whole ICON Name System implementation which is from the ownership managment for a domain, how to securely save the data, to the global resolving layer. The INS global resolving layer can connect different tech stacks and enhances the usability for different infrastructures. INS Stack

State Layer

State layer is where user’s β€œstate”, or user’s information and behavior, is stored. For ICON, Loopchain is where these data are stored, and gives users the ability to control their own state.

Computation Layer

Computation layer is where SCORE executes complicated calculations. It is an environment for smart contracts on ICON to be checked and managed, just like how EVM (Ethereum Virtual Machine) manages smart contract on Ethereum. When a transaction occurs on ICON, the logic designed in SCORE will determine its path that cannot be altered. Portal Network will be deploying INS (SCORE) on this layer that consists 3 major components.

Component Layer

With the combination of state layer and computation layer, many things could be implemented in the component layer. INS for instance, consists 3 major componentsβ€Šβ€”β€Šregistrar, registry and resolver. These components make sure that INS is operable and could meet the specific needs of each individual.

Component Layer

Protocol Layer

On the Protocol Layer, we will be presenting our BNS (Blockchain Name Service) standards that can make the INS more efficient and applicable. With the state, computation and component layers behind the scene, protocol layer serve as a gateway for users and developers to interact with our INS standard.

User Control Layer

User control layer is in charge of managing private keys to communicate with the state layer. INS empowers users to control, set up and manage their digital asset with an easier and readable text. This enables more use cases around INS at the application layer. For example, our Web Builder let users to create their own decentralized websites (DWebs) binded with an INS, and a further enhancement on our extension could be used to access these DWebs with ease at β€œyourwebsite.icon”.

User Control Layer & Application Layer

Application Layer

INS can be implemented into many other applications on ICON platform, such as wallet that can resolve INS, dApp that utilize INS for users identity and many more. We believe that it is an essential components to provide a better environment for both technical and non-technical users.

#️⃣ Reference

  • IIP6 - ICON Name Service Standard

πŸ“£ Contributing

See for how to help out.

πŸ—’ Licence

See LICENSE for details.


πŸ“–πŸ” Documents and implementations for the ICON Name Service.








No releases published


No packages published