kanthgithub/DNSDapp

Distributed Name Registry System - Ethereum

Decentralized Name registration and fund-transfer Application (DNS-Dapp)

What does this do?

• Manage name registry on decentralized platform (ethereum)
• Buy/Sell via Bidding process for tamper-proof and best price mechanism
• Transfer funds (ether) via names (registered)
• Release names for a better price via bidding

Use Cases:

1. Checking the availability for a name
2. Reserve a name if available, by sending a tx with amount of ether
3. Release name by making it available (can be released only by their owners)
4. Bid on names already taken (bids must be > original price)
5. Owner of domain can change the ownership of the domain to the highest bidder
6. Name can be used to send ether to its owner

Technology Stack:

1. ethereum (ganache-cli)
2. truffle
3. nodeJS
4. web3
5. eslint

DataModel:

• Bid DataModel:

  • DataModel to store Bid Details for a given DNSName
  • bidState in the model represents different states bid can stay in the workflow
  • amount is the bidPrice made by Bidder
  • owner is the address of the Bidder

contract DNSBid {

    using DNSStates for DNSStates.BidStates;
    DNSStates.BidStates public bidState;
    bool public active;
    uint public amount;
    address public owner ;
    }

• Bid States:

  • enum to hold the states that bid can go through in a Bid-Life cycle

enum BidStates {
        BID_VOID,
        BID_OPEN,
        BID_ACCEPTED
    }

• Bid Registry:

• A Container/Registry to hold all details/bids made for a given DNSName

• Contains the storage for mappings:

  • dnsBidMap : map to store all bids and respective bidder-addresses
  • dnsBalanceMap : map to store the bidder-Address as key and bid-Price as Value
  • bestBidder : Address of the Bidder whose bid was highest (indicative price)

   //map to store all bids and respective bidder-address
   mapping(address => DNSBid) public dnsBidMap;

   // map Bidder to his/her value (address as key and ether as value)
   mapping (address => uint) public dnsBalanceMap;

   // winning bidder's address
   address  public bestBidder;

Solidity contract diagram:

Tests:

1. Javascript Tests
2. Solidity Tests (In-Progress)

lakshmikanth-MacBook-Pro:DNSDapp lakshmikanth$ truffle test
Using network 'test'.

Compiling ./contracts/BidRegistry.sol...
Compiling ./contracts/DNSBid.sol...
Compiling ./contracts/DNSDappMaster.sol...
Compiling ./contracts/DNSDataModel.sol...
Compiling ./contracts/DNSStates.sol...
Compiling ./contracts/DNSUtilLibrary.sol...


  Contract: DNSDappMaster
    ✓ assert that non-existent name check returns false (50ms)
asserted that system cannot reserve an existing DNSName
    ✓ assert that system cannot Reserve on an existing and active DNSName (187ms)
    ✓ assert that system can Reserve a new DNSName (101ms)
    ✓ assert that system can Reserve a new DNSName and Transfer funds by using DNSName (117ms)
asserted that system cannot Transfer funds to non-existing DNSName
    ✓ assert that system cannot Transfer funds to non-existing DNSName
    ✓ assert that user can bid on a Name (132ms)
asserted that user cannot bid on a non-existing DNSName
    ✓ assert that user cannot bid on a non-existent Name
asserted that user cannot do zero-bidding on a non-existing DNSName
    ✓ assert that user cannot do zero-bidding on an existent DNSName
reject currentBidder as currentBidPrice is lesser than indicativePriceError: VM Exception while processing transaction: revert
    ✓ assert scenario of multiple users bidding on a DNSName (204ms)
reject currentBidder as currentBidPrice is lesser than indicativePriceError: VM Exception while processing transaction: revert
    ✓ assert the bid-Finalizing process (290ms)
    ✓ assert that dnsNameOwner can release ownership (99ms)
failed-attempt of release-ownership by fakeOwner: Kaiju
    ✓ assert that dnsNameOwner cannot be released by non-owning entity (63ms)


  12 passing (1s)

Deployment:

• checkout source code
• navigate to source directory
• run npm install
• run truffle compile
• run truffle migrate
• run truffle test

Testnet Verification:

Rinkeby Testnet (Infura) - In-progress

Improvements / TODO:

1. UI on ReactJS
2. End to End tests
3. Use security mechanisms to avoid Re-entry and other DApp based attacks
4. Assert for events emitted during reservation , new bid and bid-finalization process