ocku / whois-servers

🌎 A whois server list compiled weekly from IANA's TLD list.

@ocku/whois-servers

A whois server list compiled weekly from IANA's TLD list.

If no differences are found between the previous list and the current list, no update will be pushed.

Usage

This library provides a compiled list of whois servers for each TLD in the format {domain: server}.

import servers from '@ocku/whois-servers';
// or
const servers = require('@ocku/whois-servers');

console.log(servers.de); // whois.nic.de
console.log(servers.arpa); // whois.iana.org
console.log(servers['xn--tckwe']); // whois.nic.xn--tckwe

For any languages other than Node

All JavaScript files are generated from cache/servers.json, which contains the original domain:server map. You can download it with:

wget https://raw.githubusercontent.com/ocku/whois-servers/main/cache/servers.json

Punycode

Punycode TLDs are supported, but to keep overhead low, special Unicode characters are not automatically transcoded to LDH.

What this means is that if you want to get the server of a tld, for example コム, you would have to reference it by its ASCII name:

servers['xn--tckwe']; // whois.nic.xn--tckwe

Staying up to date

All server updates are done by raising the patch version of the library, so you should be able to stay up to date simply by updating your dependencies every so often.

Build

In the case that you want to build this library yourself, first make sure you have the following dependencies installed:

• yarn
• whois
• jq (>= v1.7)

and then do the following:

yarn # install prettier
./genenerate.sh # run the generator

And that's it! It will take a while but that's all that you need to do.

Reference

• this project was heavily inspired by the whois-servers-list npm package.