Documentation
Advanced
DNS over HTTPS

What is DNS over HTTPS?

⚠️
This feature is still in beta testing.

We provide a public DNS over HTTPS server for accessing .bit account data stored in the Nervos Network.

Currently, we only support DNSLink (opens in a new tab) TXT records because our clients have limitations in handling other record types that are derived from a .bit ipfs/ipns record.

Endpoint

Our public DoH API can be accessed at this endpoint: https://bit.site/dns-query

curl -H 'accept: application/dns-json' 'https://bit.site/dns-query?name=planet.bit'
{
  "Status": 0,
  "TC": false,
  "RD": true,
  "RA": false,
  "AD": false,
  "CD": false,
  "Question": [
    {
      "name": "planet.bit",
      "type": 16
    }
  ],
  "Answer": [
    {
      "name": "planet.bit",
      "type": 16,
      "TTL": 300,
      "data": "dnslink=/ipns/k51qzi5uqu5dkzybr2f39fi5pbqvdfturze6i3110mk8uhka3cqk6qz1v8q4og"
    }
  ],
  "Authority": [],
  "Additional": []
}

Usage with Kubo (go-ipfs)

You can use this server with Kubo (opens in a new tab) by adding the following to your config:

"DNS": {
  "Resolvers": {
    "bit.": "https://bit.site/dns-query"
  }
}

After that, your Kubo will be able to resolve .bit account like this:

ipfs resolve -r /ipns/planet.bit
/ipfs/bafybeigyk5bq7ieev7vai6pesuumo75witojez5zuv4yigruwlethsgjqa

So the Kubo gateway will be able to serve the content of the .bit account:

http://127.0.0.1:8080/ipns/planet.bit/
IPFS PinningURL Shortener