Skip to content

Latest commit

 

History

History
43 lines (32 loc) · 2.2 KB

IMPLEMENTATION.md

File metadata and controls

43 lines (32 loc) · 2.2 KB
Raw

Implementation

ZNS Spec

The internet HTTP protocol is using the URL below:

<protocol>://<subdomain>.<domain>.<top-level domain>/<path>

Example:

https://www.portal.zil/path

Spec

  • http: The ZNS and protocol will be passed separately when the service requests.
  • www.portal.zil: The content of the ZNS is used when user requests to the browser.
  • path: The path is not processed at the DNS level, the same as ZNS, if there is a path, it is handled by other way or method.

Resolving Names

Resolving names in ZNS is a three step process:

  1. Normalise and hash the name you want to resolve (see Namehash).
  2. Query the ZNS registry for the address of the resolver responsible for the name.
  3. Query the resolver for the resource you want to look up.

Updating ZNS Records

Your application may wish to provide users with a means of updating names they own to point to resources your application provides or manages. Doing so follows a similar process to Resolving Names:

  • Normalise and hash the name you want to resolve (see Namehash).
  • Query the ZNS registry for the address of the resolver responsible for the name.
  • Call the appropriate update method on the resolver.

Namehash

Names in ZNS 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. The Namehash algorithm 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 namehash of the parent domain and the name or hash of the subdomain label.

Terminology

  • domain - the complete, human-readable form of a name; eg, wallet.portal.zil.
  • label - a single component of a domain; eg, portal, wallet, or zil. A label may not contain a period ('.').
  • label hash - the output of the keccak-256 function applied to a label.
  • node - the output of the namehash function, used to uniquely identify a name in ZNS.