Records reference

This page contains an overview of all standardized resolver records. The reference is divided into sections, grouping records by their namespaces and use-cases:

Developers may also set custom records for the domains. Domain records are stored as a key-value dictionary by Resolvers and are not validated on the smart-contract level. For more details, check out Architecture overview and Managing domain records.

Crypto payments

For information about crypto payments, see Managing domain records - Crypto payments records.

crypto.ETH.address

Ethereum Address to receive crypto payments.

Format

Example

0x[0-9a-fA-F]{40}

0x0f4a10a4f46c288cea365fcf45cccf0e9d901b94

crypto.BTC.address

Bitcoin Address to receive crypto payments.

Format

Example

Address - Bitcoin Wiki

1Nb7Mt1EqUqxxrAdmefUovS7aTgMUf2A6m

crypto.<TICKER>.address

Crypto currency address of the ticker.

Browser resolution

Browser resolution is described in the Browser resolution algorithm article.

browser.preferred_protocols

Protocols that browser should prioritize to display content for.

Format

Example

JSON serialized array

["ipfs","http"]

browser.redirect_url

A fallback URL, to which a user will be redirected if no other resolution method is supported.

Format

Example

RFC-1738

http://example.com/home.html

DWeb records

For more details, see Browser resolution algorithm - DWeb Records.

dweb.ipfs.hash

IPFS network content hash.

Format

Example

[0-9a-zA-Z]{46}

QmVaAtQbi3EtsfpKoLzALm6vXphdi2KjMgxEDKeGg6wHvK

dweb.bzz.hash

Swarm network content hash.

Format

Example

[0-9a-f]{64}

d1f25a870a7bb7e5d526a7623338e4e9b8399e76df8b634020d11d969594f24a

DNS records

For more details, see Browser resolution algorithm - DNS Records.

dns.ttl

Default TTL setting for all DNS records.

Format

Example

\d+

128

dns.A

DNS A record IP addresses.

Format

Example

JSON serialized array

["10.0.0.1","10.0.0.2"]

dns.A.ttl

TTL setting for all A records.

Format

Example

\d+

128

dns.CNAME

DNS CNAME record IP addresses.

Format

Example

JSON serialized array

["example.com."]

dns.CNAME.ttl

TTL setting for all CNAME records.

Format

Example

\d+

128

dns.<RECORD>

Specified DNS record values.

Format

Example

JSON serialized array

["example.com."]

dns.<RECORD>.ttl

TTL setting for corresponding type of records.

Format

Example

\d+

164

Deprecated records

ipfs.html.value

Deprecated: use dweb.ipfs.hash instead.

Format

Example

[0-9a-zA-Z]{46}

QmVaAtQbi3EtsfpKoLzALm6vXphdi2KjMgxEDKeGg6wHvK

ipfs.redirect_domain.value

Deprecated: use browser.redirect_url instead.

Format

Example

RFC-1738

http://example.com/home.html