Wanchain Name Service (WNS) has been deployed

Oliver Birch
Published in
4 min readMay 22, 2018


Dear Wanchain Community,

We are pleased to announce that WNS smart contract has been deployed on mainnet at 0xee8d418fd33e69782015ea4313dfd8eb7b1b91ce

WNS smart contract is also deployed on the testnet at 0xe85cfdf43a0db4aa0ec054a57451af7c73d4625b. Users may register names under two top level domains:

  • .wan, which uses an auction based registrar with the same functionality as the main network, and allows users to keep names indefinitely; see Registrar.sol.
  • .test, which allows anyone to claim an unused name for test purposes, which expires after 28 days; see TestRegistrar.sol.

Please read carefully as currently this should ONLY be used by experienced developers (NOTE: **see guide below and read the whole article if you intend to bid before the Portal Network tool for all users is live**):

Our partner Portal Network will supply a tool with a user interface soon for users to register (thus simplifying the process).


WNS is live with main domain name “.wan” for registering.

WNS needs 6 characters min. to register, for example Jacklu.wan

The minimum bidding is 0.1 WAN where users may register names under the wan TLD, which uses an auction based registrar.

Wanchain is open to all developers to supply tools of WNS for our users.


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

WNS can be used to resolve a wide variety of resources. The initial standard for WNS defines resolution for Wanchain addresses, but the system is extensible by design, allowing more resource types to be resolved in future without the core components of WNS requiring upgrades.


The primary goal of WNS is to resolve human-readable names, like ‘Jacklu.wan’, into machine-readable identifiers, including Wanchain addresses and other identifiers. A secondary purpose is to provide metadata about names, such as ABIs for contracts, and who is information for users.

WNS has similar goals to DNS, the Internet’s Domain Name Service, but has significantly different architecture, due to the capabilities and constraints provided by the blockchain. Like DNS, WNS operates on a system of dot-separated hierarchial names called domains, with the owner of a domain having full control over the distribution of subdomains.

Top-level domains, like ‘.wan’ and ‘.test’ are owned by smart contracts called registrars, which specify rules governing the allocation of their subdomains. Anyone may, by following the rules imposed by these registrar contracts, obtain ownership of a second-level domain for their own use.


WNS has two principal components: the registry, and resolvers.

The WNS registry consists of a single central contract that maintains a list of all domains and subdomains, and stores three critical pieces of information about each:

The owner of the domain
The resolver for the domain
The time-to-live for all records under the domain

The owner of a domain may be either an external account (a user) or a smart contract. A registrar is simply a smart contract that owns a domain, and issues subdomains of that domain to users that follow some set of rules defined in the contract.

Owners of domains in the WNS registry may:

  • Set the resolver and TTL for the domain
  • Transfer ownership of the domain to another address
  • Change the ownership of subdomains
  • The WNS registry is deliberately straightforward, and exists only to map from a name to the resolver responsible for it.

Resolvers are responsible for the actual process of translating names into addresses. Any contract that implements the relevant standards may act as a resolver in WNS. General-purpose resolver implementations are offered for users whose requirements are straightforward, such as serving an infrequently changed address for a name.

Each record type — Wanchain address, and so forth — defines a method or methods that a resolver must implement in order to provide records of that kind. New record types may be defined at any time via the WIP standardisation process, with no need to make changes to the WNS registry or to existing resolvers in order to support them.


Names in WNS are represented as 32 byte hashes, rather than as plain text. This simplifies processing and storage, while permitting arbitrary length domain names, and preserves the privacy of names onchain. The algorithm used to translate domain names into hashes is called namehash. Namehash is defined in EIP137.

In order to preserve the hierarchal nature of names, namehash is defined recursively, making it possible to derive the hash of a subdomain from the hash of the parent domain and the name or hash of the subdomain.

REMINDER: For more information about how to bid please go to:

— — — — — — — — — — —

About Wanchain

Wanchain connects and exchanges value between different blockchain ledgers in a distributed manner. It uses the latest cryptographic theories to build a non-proprietary cross-chain protocol and a distributed ledger that records both cross-chain and intra-chain transactions. Any blockchain network, whether a public, private or consortium chain, can integrate with Wanchain to establish connections between different ledgers and perform low cost inter-ledger asset transfers. The Wanchain ledger supports not only smart contracts, but also token exchange privacy protection.

— — — — — — — — — — —

These are our official social platforms:

Reddit: https://www.reddit.com/r/wanchain

Discord: https://discord.gg/3DpeV6W

Telegram Chat: https://t.me/WanchainCHAT

Telegram Announcements: https://t.me/WanchainANN

Medium: https://medium.com/wanchain-foundation

Facebook: https://www.facebook.com/wanchainfoundation

Twitter: https://twitter.com/wanchain_org

Instagram: https://www.instagram.com/wanchain_org

Our other Telegram Chats:

Korean Wanchain Telegram: https://t.me/wanchainkorea

Chinese Wanchain Telegram: https://t.me/wanchainchinese

South East Asia Wanchain Telegram: https://t.me/wanchainasean

India Wanchain Telegram: https://t.me/wanchainindia



Oliver Birch

VP - Global Communications & Growth at Wanchain