# Un peu de blabla

## C'était mieux avant

La création d'amitié est une célébration, mais aussi un engagement. Nous choisissons avec soin nos amis car notre temps est précieux et nous souhaitons le passer dans le meilleur cercle possible.
Aujourd'hui les nouvelles technologies permettent de rester en contact facilement quelle que soit la distance réduisant ainsi le temps nécessaire pour communiquer avec chaque individu, mais réduisant également le temps que l'on consacre à nos relations.
Enzym propose de remettre au centre de votre réseau social les gens qui comptent vraiment pour vous tout en faisant partie de ces nouvelles technologies avec ses avantages.

## Ça va être mieux maintenant

Le modèle choisi est de représenter l'effort investi dans le lien social par une monnaie virtuelle, autrement dit une crypto-monnaie du même genre que le **Bitcoin** ou l'**Ethereum**, ou encore le **Litecoin**.
Enzym introduit ainsi le **ZYM** qui va permettre de valoriser vos relations.
Les créations d'amitié requièrent cette monnaie, rendant beaucoup plus difficile d'avoir des centaines de contacts sur le réseau.
Les ZYM sont une monnaie virtuelle crée par Enzym et stockée sur les portefeuilles virtuels créés avec chaque compte.
Les utilisateurs dépensent des ZYM pour envoyer des messages à des utilisateurs qu'ils n'ont pas encore en amis.
Les deux utilisateurs créant le lien d'amitié doivent verrouiller une partie de leurs ZYMs. Ces ZYMs leurs sont rendus si l'amitié est brisée (mais c'est triste :( ).

# Un peu de parano

Nous avons tous entendu parler des scandales sur les réseaux comme Facebook et Google+ au sujet de la vie privée. Ces réseaux se sont avérés de véritables aspirateurs de données, qu'ils utilisaient pour eux ou revendaient à des tiers. On s'est aperçus finalement que l'on ne pouvais prédire ce qu'il se passait derrière les rideaux de ces grosses boites.
A une époque où vos habitudes, les détails de votre vie sont commercialisés à votre insu pour rentabiliser la gratuité des services, on peut commencer à sérieusement se poser la question de la protection de vos données. C'est cet objectif qu'Enzym cherche à accomplir également, en utilisant le monde merveilleux de la décentralisation et plus spécifiquement de la Blockchain.

# Un peu de crypto

Vous avez tous entendu parler de Bitcoin, Ethereum, Litecoin et je ne sais quel autre coin, mais au final c'est quoi, et pourquoi c'est important pour Enzym?
Chaque crypto monnaie est en fait un simple registre public, que tout le monde peut consulter et qui liste les transactions d'une adresse à l'autre.
N'importe qui peut posséder une adresse et écrire dans ce livre de partout dans le monde, parfois sans même devoir révéler son identité (son adresse suffit).
Ce registre public est ce qu'on appelle la Blockchain, et il y'en a une par crypto à priori. Ce n'est pas le cas des ZYMs et nous allons voir pourquoi.
Parmi les blockchains célèbres il y'a celle d'Ethereum, elle est plus permissive et permet de faire plus de choses que simplement des transactions monétaires : on peut écrire dedans tout ce qu'on veut.
Ainsi du point de vue d'un informaticien, la blockchain Ethereum est en fait une énorme base de données en ligne décentralisée.
Sachant celà, des informaticiens ont développé un protocole permettant de stocker dans cette base de données qui a combien sur son compte d'une autre monnaie, créant ainsi pour la première fois une crypto-monnaie DANS la blockchain d'une autre crypto monnaie.
C'est ce qu'est le ZYM : une crypto-monnaie à l'intérieur de la monnaie Ethereum. Elle est tout aussi sûre à utiliser que l'Ether.
Complexe? Alors ne lisez pas plus loin, ça va être bien pire.

## Décentralisation

Aujourd'hui un outil existe permettant aux utilisateurs de savoir exactement comment fonctionne l'application qu'ils emploient et ce que ça implique. C'est la blockchain. Elle nous servira de base de données afin que le moins de choses possible dépendent de nos serveurs.
Grace à la décentralisation, l'utilisateur garde le contrôle de ses données et peut facilement voir les conséquences et la portée de ses actes.

## Ethereum

Le ZYM est une monnaie à l'intérieur d'Ethereum.
La blockchain Ethereum, aussi appelée EVM (Ethereum Virtual Machine) est beaucoup plus qu'un registre public qui traque qui a combien sur son compte. C'est une base de données décentralisée, capable même de contenir du code et donc stocker des programmes entiers.
Le ZYM est un programme qui tourne sur la blockchain Ethereum, lui garantissant la même sécurité que l'Ether. Cependant sur Ethereum, les transactions sont payantes, créant un coût pour l'utilisateur d'Enzym. nous avons dû trouver une autre solution.

## Les sidechain Ethereum

Une sidechain ethereum est une blockchain capable de communiquer avec la chaine Ethereum. Il y'a plusieurs éditeurs de sidechain, nous avons choisi Loom Plasma Chain pour la notre.
Elle permet de :
- Payer les frais de transaction à la place de l'utilisateur
- Réduire les coûts de fonctionnement d'Enzym
- Réduire les temps de transactions à quelques secondes

Ainsi Enzym paye un abonnement d'un an à Loom et en échange nos utilisateurs ont des transactions illimitées sur Plasma Chain.
Les ZYMs hebergés sur Plasma Chain peuvent être transferés sur Ethereum et inversement grâce à deux contrats ERC20 déployés sur les blockchains.

# Et enfin du technique!

## Implémentation

Le projet est hebergé chez gitlab [ici](https://gitlab.com/enzym/zymjs).

Le mono repo est divisé en 3 projets :
- contracts
- wallet
- bridge

*contracts* est un projet utilisant truffle et capable de déployer via la ligne de commande les deux contrats nécessaires pour que ZYM fonctionne, ainsi que de les lier avec Loom.

*wallet* est une librairie utilisant le [SDK javascript de Loom](https://github.com/loomnetwork/loom-js) ainsi que [Web3](https://github.com/ethereum/web3.js) pour manipuler les blockchains. Elle est capable de créer et gérer des portefeuilles contenant des ZYMs.

*bridge* est un projet permettant de faire le pont entre l'application Enzym et la librairie wallet

### Les contrats ERC20 AKA Fungible Tokens

Les monnaies comme ZYM sont un contrat Ethereum obéissant à certaines régles présentées dans [cet article](https://www.ethereum-france.com/qu-est-ce-qu-un-token-erc20/) en français.

### Plasma chain

On peut suivre Plasma Chain depuis le [Blockexplorer](https://loom-blockexplorer.dappchains.com/).
Un contrat ERC20 un peu particulier sera déployé sur la chaine Plasma grâce au projet *contracts*.
La quantité de ZYM à la base est 0 et une nouvelle fonction non présente dans la spécification ERC20 est ajoutée. Celle ci sera appelée par Loom lors du transfert de Tokens depuis Ethereum.

### Les contrats

[gitlab](https://gitlab.com/enzym/zymjs/tree/master/contracts)

Ce projet contient les contrats Ethereum et Loom du token ZYM. Il y'en a deux.
Le premier sur Plasma n'a pas de tokens et les génère à la volée quand ils sont traferés depuis le contrat Ethereum.
Sur Ethereum se trouve le second contrat, lui aussi un ERC20 mais cette fois-ci avec une quantité non nulle et avec un code très classique.

#### Ethereum

pragma solidity ^0.4.24;

import "openzeppelin-solidity/contracts/token/ERC20/StandardToken.sol";

contract ZYMCoinEVM is StandardToken {
    string public name = "ZYM Coin";
    string public symbol = "ZYM";
    uint8 public decimals = 18;

    // one billion in initial supply
    uint256 public constant INITIAL_SUPPLY = 1000000000;

    constructor() public {
        totalSupply_ = INITIAL_SUPPLY * (10 ** uint256(decimals));
        balances[msg.sender] = totalSupply_;
    }
}

Le ZYM est créé sur la chaine Ethereum. Sa quantité est donnée par la valeur *INITIALSUPPLY*. Chaque ZYM a 18 décimales, pérmettant ainsi d'avoir une très petite granularité et effectuer des transferts de faible valeur avec précision.

#### Loom

pragma solidity ^0.4.24;

import "openzeppelin-solidity/contracts/token/ERC20/StandardToken.sol";

contract ZYMCoin is StandardToken {
    // Transfer Gateway contract address
    address public gateway;

    string public name = "ZYM Coin";
    string public symbol = "ZYM";
    uint8 public decimals = 18;
    
    constructor(address _gateway) public {
        gateway = _gateway;
        totalSupply_ = 0;
    }

    // Used by the DAppChain Gateway to mint tokens that have been deposited to the Ethereum Gateway
    function mintToGateway(uint256 _amount) public {
        require(msg.sender == gateway, "only the gateway is allowed to mint");
        totalSupply_ = totalSupply_.add(_amount);
        balances[gateway] = balances[gateway].add(_amount);
    }
}

Ce contrat ne possède aucun ZYM à la base. Seul le Gateway loom peut appeler (suite à un ordre de transfert de ZYM depuis Ethereum) la fonction *mintToGateway*.
Cette fonction va créer le double des ZYMs à transférer sur Loom, les rendant ainsi utilisables sur cette chaine. Les ZYM d'origine, eux, sont gardés par le contrat gateway jusqu'au transfert inverse. Quand un ZYM passe de Loom à Ethereum, il est détruit sur le contrat ZYMCoin, et le ZYM Ethereum est envoyé au propriétaire.

### Le Gateway

Le gateway est un serveur Loom qui fait le lien entre les deux chaines.
Il a son propre contrat ethereum qui contient un registre qui stocke des paires de contrats d'un token ERC20 inter-chaine comme ZYM.
Il est résponsable du transfert du token d'une chaine à l'autre. Le même contrat lie aussi les adresses Ethereum et Loom d'un même utilisateur / compte. Le transfer inter-chaine n'est autorisé qu'en interne, entre ces adresses.

Un ordre de transfert depuis Ethereum vers Loom consiste en deux étapes client :
- Transferer les ZYMs sur le contrat Gateway
- Donner l'ordre au serveur Gateway de transférer les ZYMs sur Loom
Le serveur effectue le transfert en deux étapes
- Le serveur donne l'ordre au contrat erc20 sur Loom de créer (ou "mint") la même quantité de ZYMs
- Il crée une transaction pour transferer ces ZYMs au destinataire

Un ordre de transfert depuis Loom vers Ethereum consiste en deux étapes client :
- Transferer les ZYMs sur le contrat Gateway
- Donner l'ordre au serveur Gateway de transférer les ZYMs sur Ethereum

Le serveur effectue le transfert en deux étapes :
- La version Loom des ZYMs est détruite
- La version Ethereum des ZYMs est transferée sur l'adresse Ethereum du compte

Ainsi le Gateway de loom est le point le moins sécurisé entre le PoS d'Ethereum et le dPoS de la chaine Loom. Ce serveur est une machine unique et en cas de panne, les transferts sont interrompus. De plus nous n'avons pas encore d'information quand à la possibilité des propriétaires de ce serveur de récupérer les tokens déposés sur le gateway pour eux.
Des règles de sécurité sont encore à mettre en place.

### Le wallet

[gitlab](https://gitlab.com/enzym/zymjs/tree/master/wallet)

Le wallet est la librairie js/ts écrite pour Enzym. Elle a pour fonction d'intéragir avec les deux blockchains. C'est cette librairie qui est responsable des mouvements de ZYM entre utilisateurs et entre l'utilisateur et Enzym.

### Bridge

[gitlab](https://gitlab.com/enzym/zymjs/tree/master/bridge)