@fabcotech/dappy-node v3.34.0

Dappy-node

Dappy node is a DoH and an authoritative name server, written in NodeJS. It is a core component of the dappy protocol and ecosystem.

Dappy node is currently available with three connectors for storing the zones : memory (dev), postreSQL (production) and RChain (blockchain, experimental).

dappy website

docs for domain purchase and management

dappy-tools repository

Quick start

Run a dappy-node with memory zone provider using npx

# Run a dappy-node that save zones in memory
DAPPY_NODE_ZONE_PROVIDER=memory DAPPY_NODE_CACHING=0 npx @fabcotech/dappy-node

# Resolve example.d A record
dappy-lookup example.d A --endpoint=http://127.0.0.1:3001

Build and test

# In dappy-tools root
npm i & npx lerna bootstrap

# Build the npm lib from dappy-tools/packages/dappy-node
npm i
npm run build

# Build the docker image from dappy-tools/
docker build . -f ./packages/dappy-node/Dockerfile -t dappynodelocal

# test
npm run test

Understanding dappy-node

Zone providers

Dappy-node abstracts how zones and records are persisted.

There are 3 zone providers availables:

• memory: for demo and development purpose. It contains a built-in zone example with some records. It is the easiest way to start and experiment dappy-node.
• postgresql: for production purposes when confidentiality is needed. Zones and records are persisted on a pg instance.
• rchain: experimental provider that connects with a RChain (L1) deployment.

Each of these zone providers have their own jobs and routes.

Use DAPPY_NODE_ZONE_PROVIDER environment variable to define zone_provider.

DNS over HTTPS

Dappy-node is queryable over HTTPS. It implements DoH RFC. DNS packets are sent over HTTPS in binary format.

Under the hood, dappy-node use dns-packet to decode and encode DNS packets.

Every DoH clients can query dappy-node, it includes browsers like Chrome. Dappy provide a command line dappy-lookup that makes DoH queries. You can try it like this:

npx @fabcotech/dappy-lookup example.d A --endpoint=http://127.0.0.1:3001

Support

We are open to, and grateful for, any contributions made by the community.

Report a bug

We use the issue tracker to keep track of bugs and improvements to dappy-node itself and the documentation. We encourage you to open issues to discuss improvements, architecture, theory, internal implementation, etc. If a topic has been discussed before, we will ask you to join the previous discussion.

Reference

dappy-node configuration

dappy-node is configurable through environments variables. To be more convenient, dappy-node try to load a .env file named dappyrc at startup.

Below, here are all environments variables read by dappy-node.

General environment variables

if DAPPY_NETWORK_ID is unknown, the program will try to load a dappy network from the file ./dappyNetwork.js.

Environment variables read when postgresql is used as zone provider

API Reference

Please read API Reference for more details.

Kubernetes

Kubernetes guide

Docker

When deploying using docker, we assume you have setup a secure postgreSQL database already (on your server or a cloud provider). And know the DAPPY_PG_CONNECTION_STRING (in the format postgresql://postgres:postgres@db1234.cloudprovider.com:5432/dappy) for allowing dappy-node to write/ready in the database.

Note : the host address from within the container may vary depending on your OS, on linux it's probably 172.17.0.1, on macOS host.docker.internal.

.pgdata folder is shared with container, it will be useful only if you're running a pg instance locally.

docker compose up

dappy-nod should be exposed on port 3001, you can run curl localhost:3001/hashes to make sure it's up, and responds with hashes of the zones.

Now you must to link your local port 3001 to the public port 443 or else of your public IP address. (nginx or Apache). You'll need to generate a certificate (see Kubernetes guide) and configure your nginx to use this self signed certificate.

Local postgreSQL and adminer

Want to start a local postgreSQL (localhost:5432) + adminer (localhost:8082) ? (we do not recommend for production)

docker compose --file docker-compose-pg-adminer.yml  up