README.md

Supply-Chain-Dapp

   

A simple Supply Chain setup with Solidity.

Demo Dapp Link

https://www.canva.com/design/DAFb-i9v_cM/-fK0pKTuOkFq5dfCPQxh_w/watch?utm_content=DAFb-i9v_cM&utm_campaign=designshare&utm_medium=link&utm_source=publishsharelink

Description

Supply chain is always hard to manage and requires a lot of admistrative machinery. However, when managed with smart contracts using blockchain, a lot of the paperwork is reduced. Also it leads to an increase in the transparency and helps to build an efficient Root of Trust. Supply-chain-dapp is such an implementation of a supply chain management system which uses blockchain to ensure a transparent and secure transfer of product from the manufacturer to the customer via the online e-commerce websites.

Architecture

The smart contract is being written with Solidity which is then compiled, migrated and deployed using Truffle.js on the Gode Testnet blockchain network.The frontend uses Web3.js to communicate with the smart contract and Gode Testnet blockchain network and Meta Musk Wallet is connect to Gode Test Network to do Transaction between each component in Supply .

---

Supply Chain Flow

Smart Contract Working Flow

This is a SupplyChain smart contract written in Solidity. The contract models the various roles and stages involved in the supply chain of a pharmaceutical product.

The contract owner is the person who deploys the contract and is the only one who can authorize various roles like retailer, manufacturer, etc.

There are several roles involved in the supply chain of the pharmaceutical product. These include the raw material supplier, manufacturer, distributor, and retailer.

The smart contract stores information about the medicine, such as its name, description, and current stage in the supply chain. There is also a function to show the current stage of a medicine, which can be used by client applications.

The smart contract also stores information about the various players in the supply chain, such as their name, address, and place of operation.

The addRMS(), addManufacturer(), addDistributor(), and addRetailer() functions can be used by the contract owner to add new players to the supply chain.

Overall, this smart contract provides a way to track the various stages of a pharmaceutical product in the supply chain, ensuring transparency and accountability.

🔧 Setting up Local Development

Step1.

Installation and Setup

• VSCODE : VSCode can be downloaded from https://code.visualstudio.com/

• Node.js : Download the latest version of LTS Node.js from https://nodejs.org/ and after installation check Version using terimal: node -v .

• Git : Download the latest version of Git from the official website at https://git-scm.com/downloads and check Version using terimal: git --version.

• MetaMask : can be installed as a browser extension from the Chrome Web Store or Firefox Add-ons store.

Step 2.

Connect Meta Musk with Gode Testnet.

1. Connect MetaMask: Open MetaMask in your browser and click on the network dropdown in the top-right corner.

2. After Clicking on add network u will get interface to add network name,rcp url,chain id put same as shown in the image below and click on Add or Save.

   

3. Select Gode Network in the Network Drop-Down.

4. Click on account address to copy and paste your address in this url : https://tool.godechain.net/faucet/ click on sent me.

4. Now You Will get the 1 gode on your account and check in meta musk wallet.

Step 3.

Compile & Deploy Smart Contract.

• Open VScode and open VScode Terimal by Ctrl + ' .

• Clone Project Type the following command and press Enter : git clone : https://github.com/faizack619/Supply-Chain-Gode-Blockchain.git

• Install truffle : Type the following command and press Enter: npm install -g truffle

• Install dependencies : Type the following command and press Enter: npm i

• File structure for DApp :

  contracts: This folder contains the Solidity smart contracts for the DApp. The Migrations.sol contract is automatically created by Truffle and is used for managing migrations.

  migrations: This folder contains the JavaScript migration files used to deploy the smart contracts to the blockchain network.

  test: This folder contains the JavaScript test files used to test the smart contracts.

  truffle-config.js: This file contains the configuration for the Truffle project, including the blockchain network to be used and any necessary settings.

  package.json: This file contains information about the dependencies and scripts used in the project.

  package-lock.json: This file is generated automatically and contains the exact version of each dependency used in the project.

  Clients: This Folder contains the client-side code, typically HTML, CSS, and JavaScript, can be organized into a client folder.

• Mnemonic : it requires mnemonic to be passed in for Provider, this is the seed phrase for the account you'd like to deploy from. Create a new .secret file in root directory and enter your 12 word mnemonic seed phrase to get started. To get the seedwords from metamask wallet you can go to Metamask Settings, then from the menu choose Security and Privacy where you will see a button that says reveal seed words, refer here for more details.

• Compile the smart contract : In the terminal, use the following command to compile the smart contract: truffle compile

• Configuring Truffle for GODE :

  • After Compile We Need To Deploy our Smart Contract on Blockchain.In Our Case We are Deploying on Gode testnet Which is testnet blockchain for development, used to test and develop Smart Contracts.

  

  • We need to install HDWallet run this command in npm install @truffle/hdwallet-provider

  • As you can see we have testnet which has network id : 5566 which identity gode testnet id.

  • truffle migrate --network testnet Command Will deploye Smart Contract to Gode Blockchain.

  • It will take some time For deployment and u will able find transaction hash,contract address and many more.

Step 4.

Run DAPP.

• Open terminal and enter the client folder

  • cd client

• Install all packages in the package.json file

  • npm i

• Install Web3 in the package.json file

  • npm install -save web3

• Run this Command :

  • npm

• Run the app

  • npm start

• The app gets hosted by default at port 3000.

Step 5.

Setup Account for Supply Chain Player.

1. Go to MetaMask, click on the account icon in the top-right corner, select create account, and name as Raw Material Supplier and Click "Create".

   

2. Add All participate(Raw Material,Supplier,Manufacture,Retail). by following above Step.

3. Get Gode for Each Player from this url https://tool.godechain.net/faucet/ .In Order to do Transaction.

License

This project uses an MIT license.

Documentation to help with Solidity

https://docs.soliditylang.org/en/v0.8.4/

Documentation to help with React

https://reactjs.org/docs/getting-started.html

Documentation to help with Truffle

https://www.trufflesuite.com/docs/truffle/reference/configuration

Documentation to help with Deployment on Gode Blockchain

https://docs.godechain.com/welcome/gode-chain/deploy-smart-contract/using-truffle-for-deploying-smart-contracts-on-gode