Le projet Free Pharma présenté dans ce repository est un proof of concept pour une plateforme Web3 de de mise en relation entre freelances et porteurs de missions.

Le projet répond aux besoins suivants :

• Garantir le paiement des missions en temps et en heure en basant les transactions sur un ensemble de smart contrats
• Permettre aux porteurs de mission d’économiser sur le temps et l’argent qu’implique actuellement le processus de recrutement.

Néanmoins, le public cible théorique de ce projet n’etant pas familier aux technologies Web3 et cryptomonnaies. Ce projet s'éforce également de remplir les deux suivants :

• Proposer une interface qui inspire la confiance aux utilisateurs
• Favoriser l’adoption des technologies Web3 par deux moyens :
  • proposer une rémunération en TOKEN natif PHARM (en plus de rémunération en fiat si ce devait être un projet en production)
  • Inciter les gens à staker leurs TOKEN sur la plateforme contre récompense. (fonctionnalité principale de ce POC)

Les rendements du staking sont annualisés, mais un mode Demo a été ajouté à l’application pour pouvoir la tester. (voir vidéo). En mode démo, une minute équivaut à une année.

Lien vers la vidéo

Lien vers l'application web

La liste des commandes est la suivantes :

• yarn blockchain Lancement de la blockchain locale
• yarn sc:deploy:local Déploiement des smart contracts
• yarn sc:seed:local Peuplement de l'application en local via un script
• yarn sc:deploy:sepolia Déploiement des smart contracts sur le réseau de test sepolia
• yarn sc:deploy:goerli Déploiement des smart contracts sur le réseau de test goerli
• yarn sc:test Lancement des tests des smart contracts
• yarn dapp:dev Lancement de l'application en mode développement
• yarn dapp:build Build de l'application
• yarn dapp:dev Lancement de l'application en mode production

Le reste des commandes est disponible dans le fichier package.json

git clone https://github.com/Elie-Mendy/Free-Pharma.git
cd frontend
yarn
cd ../hardhat-project
yarn

yarn blockchain

yarn sc:deploy:local        # deploiement des smart contracts
yarn dapp:build             # build de l'application
yarn dapp:start             # lancement de l'application

L'application sera accessible en local sur le port 3000 : http://localhost:3000

La documentation est générée automatiquement en reprenant les commentaires natspec associés aux fonctions dessmart contracts.

Une fois le projet cloné en local il est possible d'accéder à cette dernière via un serveur local en accedant au fichier présents dans le répertoire hardhat-pproject/docs

Les tests des smart contracts ont été rédigé de manière a etre utilisé comme une spec fonctionnelle Pour vous familiariser avec le projet il est fortement recommandé de lire le code en vous appuyant sur le rapport le document SPEC.md

• PHARM.sol : Token PHARM utilisé pour la rémunération des freelances et pour le staking.

• DataStorage.sol : Contient l’ensemble des data relatives aux missions, aux freelances et aux porteurs de missions.

• IDataStorage.sol : Interface du contrat DataStorage.sol

• FreePharma.sol : Contient la logique métier de l’application et les permissions des différents types d’utilisateurs. Interagie avec le contrat précédent pour la consommation et le stockage d’informations.

• StakingManager.sol : Gère le staking et l’attribution des récompenses en fonction du temps et des montants stakés.

• PriceProvider.sol : Fourni le prix de l’ETH (via chainlink)

• MockPriceProvider.sol : Assure le rôle du contrat précédent pour l’environnement de développement en fournissant un prix fixe de l’ETH.

• PHARM.sol : 0x274Aa9f2A679c8d9E92872BcFE8276FE62d27fAB
• DataStorage.sol : 0x202924be57c704BF7c5188d59a98373a09E511b6
• FreePharma.sol : 0x94aC16B129833DEA9C8A9F4FA88cB13b2027024b
• StakingManager.sol : 0x33FbA86C427720361b324F010e5F2e9b0715d5eF
• PriceProvider.sol : 0x73E5fF0d8d0a4E629f23C23034609108853a45E8

• Solidity
• Hardhat
• Etherjs
• Chai
• Mocha
• Infura

• NextJS
• Vercel
• Chakra-UI
• Raibowkit
• Wagmi
• Viem
• WalletConnect

Ce projet est sous licence MIT - voir le fichier LICENSE pour plus de détails.