Skip to main content



Cool banner

Hey there you are on the offical dappy docs, welcome ! πŸš€πŸ˜‰.

Dappy is a public open source name system that uses the blockchain, and provides a zero-trust co-resolution system. It has been engineered specifically for 🏒 critical APIs and SDKs, πŸ”’ protection of sensitive data and 🚀 lean + rapid monitoring and management. It is therefore a good fit for enterprises web applications, cryptocurrency, B2B or any other web application (or API) that needs high security and privacy.

Dappy clients (browser or programs) do co-resolution, many public resolvers are queried (DNS over HTTPS) for IP addresses or certificates, instead of a single resolver. It removes many attack vectors and allows companies to easily and securely expand digital services.

Dappy provides these instantaneous benefits :

  • Easy and direct management of zones (through API) : No need to manually connect and update DNS, it can all be automated, there are no DNS registrars, DNS registries, or any other private service.
  • No need to work with a Certificate Authority to get a certificate.
  • No need to renew certificates because dappy does not rely on certificate authorities provided by browsers or operating systems.
  • You can easily manage hundreds of endpoints, subdomains and TLS configurations with one JSON file and simple CLI commands.
  • Data exchange is 100x more secure and confidential, because the nodeJS process will do co-resolution for service discovery, your web services are protected against many MITM and cache poisoning scenarios.

We're going to walk you through creating your first domain name in dappy. If you know already a bit about DNS, we're going to create a zone file.

You should get to a working mydomain.d website in few minutes only.

Getting Started​

Dappy works a simple blockchain protocol that is specifically designed for names management. You will not need tokens or cryptocurrency.

Dappy CLI is the only javascript library that we need to use here.

@fabcotech/dappy-cli on NPM

mkdir dappydomain
cd dappydomain
npm init
npm i @fabcotech/dappy-cli@latest --save-dev


You can skip the two following sections as we will take many sortcuts to start playing with the dappy name system. Private keys are directly created for each new account on

Knowing or creating a private key (production)​

Private key is the critical string that you need to create to manage domain names in dappy, you can use a private key that you already use for Ethereum or any EVM blockchain platform (secp256k1 algorithm). For obvious security reasons we don't generate one for you on the website, except on where an insecure development key pair is created and displayed automatically.

If you don't have any or just want a new one, you can create it with one command.

npx @fabcotech/dappy-cli generateprivatekey

This commands maps to the npm package elliptic that has 11M monthly download, and is distributed by

Setting up config file (production)​

dappy.config.json is the only file we'll need to setup.

You must know only two things to start working:

  • A dappy network ID .options.dappyNetworkId, you will likely use either gamma (the test network with free domain names) or d (the production network).
  • A private key .options.privateKey.

You can create it by hand, but you can download a template directly from the "Domains" section on or after one or more purchases.

"options": {
"privateKey": "abcdef",
"dappyNetworkId": "d"

We are now set up 😼😼😼.

Before going further you want want to get familiar with some concepts, checkout Blockchain and the dappy name system.

We can also go straight to creating a zone.