Skip to content

IMPLEMENTATION.md

Latest commit

 

History

History
53 lines (39 loc) · 2.57 KB

IMPLEMENTATION.md

File metadata and controls

53 lines (39 loc) · 2.57 KB

Implementation

PNS Smart Contracts

The link of PNS smart contract as below:

PNS Spec

The internet HTTP protocol is using the URL below:

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

Example:

https://www.portal.perl/path

Spec

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

Resolving Names

Resolving names in PNS is a three step process:

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

Updating PNS 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 PNS registry for the address of the resolver responsible for the name.
  • Call the appropriate update method on the resolver.

Namehash

Names in PNS 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.perl.
  • label - a single component of a domain; eg, portal, wallet, or perl. 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 PNS.