Archived ! Moved to https://github.com/fabcotech/dappy-tools.

dappy-lookup

A library written in Typescript that resolves names from Dappy name system (DappyNS).

DappyNS is a next generation name system which:

• Is compliant with DNS RFC 1035
• Security-first designed by implementing DNS over HTTPS (RFC 8484)
• Persisted and distributed by blockchain RChain
• Enable clients to query in a trustless manner name records on the blockchain using:
  • A network of dappy name servers highly secured
  • A co-resolution mecanism to distribute the trust over the network

DappyNS is a trustless and secure way to distribute your public data with your partners, clients or devices (IOT). PKI certificates are good candidates. DappyNS can also help to organize and publish your DAO data due to to its hierarchical nature.

Try it with the CLI

npx @fabcotech/dappy-lookup fabcotech A --network=gamma

DappyNS documentation

You can find documentation here.

Installing

Node.js

npm i -S @fabcotech/dappy-lookup

You don't have a dappy name ? Mint in one.

Using dappy-cli ...

Examples

Stand-alone dappy lookup

Here is an example to get you started:

import { lookup } from 'dappy-lookup';

async function run() {
    // lookup the A records for example.dappy on d network
    const packetA = await lookup('example.dappy', 'A');
    console.log(packet);

    // lookup the AAAA records for example.dappy on d network
    const packetAAAA = await lookup('example.dappy', 'AAAA');
    console.log(packet);

    // lookup the CERT records for example.dappy on d network
    const packetCERT = await lookup('example.dappy', 'CERT');
    console.log(packet);
});

run();

This example above will resolve a name on default dappy network which is the d network, which is the DappyNS production ready network.

Next example do the same but on gamma network (used for testing purposes)

import { lookup } from 'dappy-lookup';

async function run() {
    // lookup the A records for example.dappy on gamma network
    const packetA = await lookup('example.dappy', 'A', { network: 'gamma' });
    console.log(packetA);
});

run();

NodeJS request using dappy-lookup with CA certificate retrieval

It's a really a pain point to get a valid CA certificate and to install it at operating system level.

On DappyNS, name servers not only distribute IPv4 (A records) and IPv6 addresses (AAAA records) but also certificates to trust over CERT records (alternative of DANE). It enable dappy-lookup client to fetch dynamically and in a trusted manner (using coresolution mecanism) CA certificates.

The example below demonstrates how to do this:

import { lookup, nodeLookup } from 'dappy-lookup';

const { answers: [{ data: ca }]} = await lookup('example.dappy', 'CERT')

https.get('https://example.dappy/', {
    lookup: nodeLookup,
    ca,
}, (res) => {
  ...
});

NodeJS enables to override lookup function for HTTP and HTTPS native modules.

So dappy-lookup provide a lookup function (created with nodeLookup) with the same signature as dns.lookup provided by NodeJS.

NodeJS requests using dappy-lookup

The example below shows how to replace native NodeJS lookup function with the dappy-lookup equivalent function. In this example the certificate is not recovered dynamically, it is installed previously on the operating system.

import { nodeLookup } from 'dappy-lookup';

https.get('https://example.dappy/', {
    lookup: nodeLookup,
}, (res) => {
  ...
});

Reference

Please read Reference to learn more about CLI commands and api.