dethercontractrepo v2.0.0

Dether - Ethereum smart contracts

Version 0.1

This version is the MVP version, its not suppose to reflect our entire version describe in our white paper.
What this version is supposed to do:
Allow shop and teller to add geolocalised point, to be visible by user reading smart contract.
For teller to have the possibility to sell ETH. The map is cut in zone https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
And we store address of shop and teller in a mapping country => postal Code:
mapping(bytes2 => mapping(bytes16 => address[])) shopInZone;
This way someone could easily get all the shop in his postalcode by just call the function:

function getZoneShop(bytes2 _country, bytes16 _postalcode) public view returns (address[]) {
   return shopInZone[_country][_postalcode];
}

He could then loop on the function getShop with all the address he gets from this previous function:

function getShop(address _shop) public view returns (
 int32 lat,
 int32 lng,
 bytes2 countryId,
 bytes16 postalCode,
 bytes16 cat,
 bytes16 name,
 bytes32 description,
 bytes16 opening
 ) {
  Shop storage theShop = shop[_shop];
  lat = theShop.lat;
  lng = theShop.lng;
  countryId = theShop.countryId;
  postalCode = theShop.postalCode;
  cat = theShop.cat;
  name = theShop.name;
  description = theShop.description;
  opening = theShop.opening;
 }

This smart contract is supposed to be used just like that by the most Dapps possible to show their user where they could spend their crypto or buy or sell cryptos.
We keep moderator roles contralised for now, but we will use decentralised arbitration court later to be able to delete illegal shop for example.
To be able to register a shop or a teller, the ethereum user need to be certified we keep this role centralised as well for now but we'll use decentralised KYC services like uport soon.
To be certified user will either need to register their phone, or pass KYC.
To operate on a zone a shop or a teller will need to stake DTH. The price will differ among zone and will be automatically calculated by the smart contract regarding different parameter like localisation, number of teller or shop already present. For now the price a user need to stake is set by a moderator in a centralised way.
Centralised moderator role in the V0.1:
-Set the licence price. -Delete fraudulent shop/teller.
-Open/close zone (country).
-Certify user to be able to register.

To be integrated on the futures versions:
-Loyalty program
-Affiliate/referal program
-Auction system on zone and category.
-Dynamic licence pricing
-Decentralised moderation.
-Decentralised KYC

Upgradable VS unpgradable
Those smart contracts are unupgradable, only the funds and certification are on a separate contract, but for the data structure and the logic, we are sure that we will have to change many things on the future, so we keep things simple and cheaper in gas by having logic and data in the smart contract.
If someone register a point on the contract and we deploy a new version, we will manually load all the active point on the new smart contract.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Table of Contents

• Install
• Docs
• Function call(#function call)
• Test
• Deploy
• Contributing
• Authors
• Licence
• Donation

Install

This repo its a truffle project, you first need to have truffle installed. And then install all the dependencies

npm install
truffle install bytes

Docs

Coming soon

Function call

Register a shop or a teller

You need to call: function transfer(address _to, uint _value, bytes _data) public returns (bool); Of the DTH contract with the address of dether core as a parameter

Inputs

• address _to: DetherCore address
• uint _value: At least the licence price for your zone
• bytes _data: Formatted list of arguments
• FOR SHOP

So the final _data parameter will looks like: 0x3100496E39000386BB47494758313120314141000000000000000072657374617572616e74000000000000436f6f6c204a6f620000000000000000492073656c6c20636f6f6c207468696e677320666f7220455448000000000000 this hex string will be parsed on the fallback fonction of the DetherCore

• FOR TELLER

The final _datavalue will looks like: 0x3200496E39000386BB47494758313120314141000000000000000000003131757365723100000000000000000000000038 this hex string will be parsed on the fallback fonction of the DetherCore

Update a teller

A teller can update his data, however he can't move his location, if he want to do this he will have to delete his sell point, and then to recreate a new one.

UpdateTeller()

Inputs

• currencyId: int8 - cf annexe1 for table of Currency
• messenger: telegram nickname (max 16 bytes)
• avatarId: 1 - 100 value for avatar
• rates: margin seller want to take * 10, for 8.7%, put 87
• online: true if teller want to stay visible, false if teller want to pass offline
• PAYABLE FUNCTION, you can send ETH during transaction.

(TODO add other fonction)

Test

Test are located on the test/ folder, you can run it in the truffle console directly

truffle develop
test

deploy

You need to have an .env files with valid mnemonic phrase with ETH:

MNEMONIC = "xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx xxxx"

Then deploy (on kovan):

truffle migrate --network kovan

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors

• Mehdi Amari - Fukunaga42
• Stéphane Roche - Janaka-Steph

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Donation

• Ethereum Foundation
• Etherscan
• MyEtherWallet
• CoinMarketCap