The RIF Name Service architecture is based on 4 components:

  • Registry: RNS domain registry.
  • Registrar: the auction logic manager.
  • Deeds: handle locked tokens and rent payment commits.
  • Resolver: the resolution between a domain and a resource.
  • Reverse resolution: the resolution between an address and a name.



To register a domain in RNS is by auction that is performed by the registrar contract. This contract manages the auction process, any user can start an auction for any available domain name, any user can bid in any auction in Open state, and only the highest bidder acquires that domain name.

The subdomains can be delegated using the registry contract without an auction process only by the domain owner. For example: nakamoto.rsk can register satoshi.nakamoto.rsk subdomain directly, and delegate the ownership of the subdomain.


The Deed contract has two main functions:

  • Register the bid payment: for each bid, the Registrar contract deploys a Deed contract and sends user’s bade RIF tokens to it.

  • Manage the annual rent: the owner must pay an annual rent for each domain acquired.


The Registry contract stores and handles the resolution between a domain name, its owner and the resolver for the domain.


The Resolver contract handles the resolution between the name domain and the resource. Each Registry entry references a Resolver. A user can use RNS Resolver or implement a custom Resolver.

Reverse suite

A TLD, a registrar, and a resolver interface that allows for reverse resolution of RSK addresses using RNS. This permits associating a human-readable name with any RSK blockchain address. Resolvers can be certain that the reverse record was published by the owner of the RSK address in question.