The Zilliqa Name Service (ZNS) is a suite of smart contracts to make a naming system like DNS on the blockchain. ZNS connects the familiar and powerful name system mechanics to blockchain assets like addresses, websites and application data, as well as traditional dns records.
- Docker required
- Node.js and Yarn are required as well.
yarn install
Tests run against standalone zilliqa development node. You will need to install Docker before.
Note: don't forget to perform
docker login
to be able to pullunstoppabledomains/zilliqa-dev-node
image
yarn zilliqa:start
It's requires keep port 5555
open on local machine. If port already occupied -
you may have zilliqa-dev-node
already run. You can check this via command
below.
docker ps
You should see similar output if node was ran. Almost each docker command
requires CONTAINER ID
. Container id generates automatically on each
docker run
:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
3ab2b677fd8f us-central1-docker.pkg... "/usr/local/bin/isol…" 11 minutes ago Up 11 minutes 0.0.0.0:5555->5555/tcp mystifying_wright
yarn test
yarn zilliqa:stop
docker logs <CONTAINER ID>
docker run -p 5555:5555 us-central1-docker.pkg.dev/unstoppable-domains/zilliqa/zilliqa-dev-node
You may need to rebuild docker image for zilliqa development node
.
cd docker/build
docker build . -t zilliqa-dev-node
And run your brand new docker image:
docker run -p 5555:5555 zilliqa-dev-node
To build & push a new version of node image use Build & Push Zilliqa Dev Node
GitHub Action.
For an introduction to Zilliqa and Scilla and some of the design considerations look at the Zilliqa Reference.
There are 3 ZNS contract variants.
-
Registry – This contract where the ZNS names are stored. Registry mechanics are explained in detail in the Registry Reference.
-
Resolvers – In order to keep the size of the main ZNS contract low, the ZNS resolution is stored in separate contracts called Resolvers. Resolvers mechanics are explained in detail in the Resolvers Reference.
-
Registrars – These contracts manage the registration of new ZNS names. ZNS has 2 of them. An auction registrar, which implements open, ascending price, variable length auction. And a simple registrar listing all names for a fixed price designed to be put in place after the initial auction period. Registrar mechanics are explained in detail in the Registrar Reference.