cabal-dns
Cabal-specific fork of datprotocol/dat-dns, originally written by pfrazee
Issue DNS lookups for Dat archives using HTTPS requests to the target host. Keeps an in-memory cache of recent lookups.
API
var cabalDns = require('cabal-dns')()
cabalDns.resolveName('foo.com', function (err, key) { ... })
cabalDns.resolveName('foo.com').then(key => ...)
cabalDns.resolveName('foo.com', {ignoreCachedMiss: true})
cabalDns.resolveName('foo.com', {ignoreCache: true})
cabalDns.resolveName('foo.com', {noDnsOverHttps: true})
cabalDns.resolveName('foo.com', {noWellknownDat: true})
cabalDns.listCache()
cabalDns.flushCache()
var cabalDns = require('cabal-dns')({
dnsHost: 'dns.google.com',
dnsPath: '/resolve'
})
var cabalDns = require('cabal-dns')({
persistentCache: {
read: async (name, err) => {
throw err
},
write: async (name, key, ttl) => {
}
}
})
cabalDns.on('resolved', ({method, name, key}) => {...})
cabalDns.on('failed', ({method, name, err}) => {...})
cabalDns.on('cache-flushed', () => {...})
Spec
In detail.
Option 1 (DNS-over-HTTPS). Create a DNS TXT record witht he following schema:
cabalkey={key}
Option 2 (.well-known/cabal). Place a file at /.well-known/cabal
with the following schema:
{cabal-url}
TTL={time in seconds}
TTL is optional and will default to 3600
(one hour). If set to 0
, the entry is not cached.