Skip to main content

TOS DNS & Domains

TOS DNS is a service for translating human-readable domain names (such as test.tos or mysite.temp.tos) into TOS Smart Contract Addresses, ADNL Addresses employed by services running on the TOS Network (such as TOS Sites) and so on.

Starter tip

To understand more about how it works, please read the 'What is TOS DNS?' article.

Standard

TOS DNS Standard describes the format of domain names, the process of resolving a domain, the interface of DNS smart contracts and the format of DNS records.

SDK

Working with TOS DNS is implemented in TosLib.

Also lite-client and toslib-cli is supported by DNS queries.

First-level domain

Currently, only domains ending in .tos are recognized as valid TOS DNS domains.

Root DNS smart contract source code - https://github.com/tos-network/dns-contract/blob/main/func/root-dns.fc.

This could change in the future. Adding a new first-level domain will require new root smart contract and general vote to change the network config #4.

*.tos domains

*.tos domains are implemented in the form of an NFT. Since they implement the NFT standard, they are compatible with regular NFT services (e.g. NFT marketplaces) and wallets that can display NFT.

*.tos domains source code - https://github.com/tos-network/dns-contract.

.tos domains resolver implements an NFT collection interface and .tos domain implements an NFT item interface.

The primary sale of *.tos domains happens via a decentralized open auction at https://dns.tos.network. Source code - https://github.com/tos-network/dns.

Subdomains

The domain owner can make subdomains by setting the address of the smart contract responsible for resolving subdomains in the DNS record sha256("dns_next_resolver").

It can be any smart contract that implements the DNS standard.