Crypto DNS

This packages translates domain names into crypto wallet addresses, using standard TXT records set by the DNS.

Motivation

Crypto currency wallet addresses aren't readable or rememberable. Just like in the "normal" DNS system, where we translate domain names to IP addresses, a system which translates domain names to wallet addresses would be useful.

There are several providers of such translation services like ENS which are using smart contracts for the translation, but using those will result in gas fees, which are currently really high.

Fortunately we already have DNS as a global translation system in place, which we can use. By adding TXT records we are able to associate wallet addresses for one or multiple crypto currencies to our domain or subdomain. This package is heavily inspired by this blog post of Mattias Geniar.

Installation

Using npm:

npm install crypto-dns

Using yarn:

yarn add crypto-dns

Example

Lookup single address for a currency with the highest priority:

import { lookupOne } from 'crypto-dns';

const lookupSingleAddress = await lookupOne('thirdweb.de', 'ETH');
// -> string
// 0xD982065960f77282eDB555b43B175Cf3A7dAC72d

You can also lookup all addresses for a currency (sorted by priority):

import { lookupMany } from 'crypto-dns';

const lookupMultipleAddresses = await lookupMany('thirdweb.de', 'ETH');
// -> array
//[
//  {
//    version: 1,
//    priority: 10,
//    currency: 'ETH',
//    address: '0xB9Af69a9850a98d9Fb66Ce210E88021Ad583961a',
//  },
//  {
//    version: 1,
//    priority: 10,
//    currency: 'ETH',
//    address: '0xD982065960f77282eDB555b43B175Cf3A7dAC72d',
//  },
//  {
//    version: 1,
//    priority: 20,
//    currency: 'ETH',
//    address: '0xccaa72d80EeB1A2Ac91B6Fdebff995D55ea9368a',
//  },
//];

To receive addresses for every available currency you can use the lookup method:

import { lookup } from 'crypto-dns';

const lookupResultForAllCurrencies = await lookup('thirdweb.de');
// -> array
//[
//  {
//    version: 1,
//    priority: 10,
//    currency: 'ETH',
//    address: '0xB9Af69a9850a98d9Fb66Ce210E88021Ad583961a',
//  },
//  ...
//  {
//    version: 1,
//    priority: 10,
//    currency: 'MATIC',
//    address: '0xD982065960f77282eDB555b43B175Cf3A7dAC72d',
//  },
//];

Features

• Use your domain as alias for your crypto wallet addresses
• Available for every crypto currency
• Works with your main domain and all subdomains
• Use priority to weight wallet addresses

DNS format

crypto:<formatVersion>:<priority> <currency>:<walletAddress>

Keyword	Description
formatVersion	Version of the format of the DNS string Currently only 1 is available.
priority	Specify priority of the entry (3 digits). The lower, the higher priority.
currency	Symbol of the crypto currency (case-insensitive). Use CoinMarketCap to find all symbols.
walletAddress	String with your wallet address. The format depends on the currency.

Regex:

/^crypto:(?<formatVersion>\d):(?<priority>\d{1,3})\s(?<currency>\w+):(?<walletAddress>.*)/

Examples:

`crypto:v1:10 eth:0xD982065960f77282eDB555b43B175Cf3A7dAC72d`
`crypto:v1:10 matic:0xD982065960f77282eDB555b43B175Cf3A7dAC72d`
`crypto:v1:10 btc:XXXX`

How to use subdomains

Subdomains can be used like root domains. Just use your subdomain when adding it to the DNS instead of the @ path.

Configuration

You can pass a configuration object as the last parameter on each lookup-Function.

const config = {
  nameserver: 'https://8.8.8.8/resolve',
  timeout: 1500,
};

const lookupSingleAddress = await lookupOne('thirdweb.de', 'ETH', config);

The following configurations are available:

Configuration	Type	Default	Description
nameserver	string	https://1.1.1.1/dns-query	Server-URL for DoH-Resolution (Cloudflare: https://1.1.1.1/dns-query, Google: https://8.8.8.8/resolve)
timeout	number	2000	Timeout for DoH HTTP-Call

Tests

You can validate all tests by running:

yarn install
yarn test

License

This library is licensed under the MIT License.

Bugs & Feature Requests

For Bug reports or feature requests, please create an issue in the crypto-dns repository.

Support & Funding

If you would like to support or fund the development of this project, feel free to contact me via mail.