Clone this repo:

Branches

  1. de2fdb9 gitreview: update gerrit host and project by Amin Bandali · 2 years, 7 months ago master
  2. 9f52a82 Merge changes I436c8e8c,I10daaf8c by Adrien Béraud · 3 years ago
  3. 4462748 instructions: fixes formatting by Patrick Elsen · 4 years, 1 month ago
  4. dab88e7 contract: update for solidity 0.6 by Adrien Béraud · 4 years, 2 months ago
  5. 493679b node: cache address by Adrien Béraud · 4 years, 2 months ago

Ring Nameservice

Ring Nameservice is used to resolve easily memorable usernames to Ring IDs. Ring clients communicate with the Nameservice using HTTP.

To run, make sure you have Solidity compiler solc installed.

Instructions for Ubuntu:

sudo add-apt-repository ppa:ethereum/ethereum
sudo apt-get update
sudo apt-get install solc

Then do a make in the project root directory.

You'll need to use Python 3.5+ to run the nameservice. If you already don't have tmux installed, do pip install tmux, and then:

python start_eth_cluster.py

Finally, make sure you have nodejs and npm install, do:

npm install
sudo nodejs index.js

(we need sudo for Express server to listen on port 80)

This will launch the HTTP server used to interface with the nameservice. Send a GET request to name/<username> to get its Ring ID. Send a POST request to name/<username> to register new username-RingID pair.

Optionally, you can dump all username-RingID pairs to file using:

nodejs read_names.js

This will dump all the username-RingID pairs to names.json file.