codewithmesfin/alchemy-decentalized-supply-chain
Mesfin Tsegaye
Create a decentralised supply chain tracking application
Create a decentralised supply chain tracking application
Smart Contract
Write a smart contract that implements a supply chain tracking system, with functions to
Also write tests using ethers.js (or any other library of your choice) that verifies the following cases:
Frontend or Script
Create a basic frontend, which displays the items as serial numbers along with their status, and allows users to order new items and cancel the ordered items. Connect the smart contract with the frontend using Ethers.js.
...............
Project Setup
Clone the project from git
https://github.com/sciemesfin/alchemy-decentalized-supply-chain.git1. Frontend source code
This is a decentralized application (dApp) built on top of the Ethereum blockchain. The dApp is designed to help users track the status of items in a supply chain. The project was bootstrapped with Create React App and uses the ethers.js library to interact with the Ethereum network.
This project was bootstrapped with Create React App.
Getting Started
Navigate to the frontend project folder
cd frontend
cd frontendThen install the dependencies:
npm installTo run the project, first add a symbolic link to the smart contract's ABI file: Make sure the
smart contract code is already setuped and run:ln -s ../../smart-contract/artifacts/contracts/SupplyChain.sol/SupplyChain.json node_modules/SupplyChain.json
ln -s ../../smart-contract/artifacts/contracts/SupplyChain.sol/SupplyChain.json node_modules/SupplyChain.jsonTo start the development server, run:
npm run start This will start the app in development mode on http://localhost:3000.Available Scripts
In the project directory, you can run:
npm test Launches the test runner in the interactive watch mode. See the section about running tests for more information.npm run build Builds the app for production to the build folder. It correctly bundles React in production mode and optimizes the build for the best performance.The build is minified and the filenames include the hashes. Your app is ready to be deployed!
See the section about deployment for more information.
npm run eject Note: this is a one-way operation. Once you eject, you can’t go back!How to Use the dApp
The dApp has a simple user interface that allows users to order items, view the status of those items, and cancel orders.
To order a new item, enter the name of the item in the input field and click the "Order" button. This will send a transaction to the Ethereum network to create a new order.
To view the status of existing orders, the app queries the smart contract to get a list of all items and their status. The status of each item is displayed next to the item name in the list.
To cancel an order, click the "Cancel" button next to the item in the list. This will send a transaction to the Ethereum network to cancel the order.
.................
2. Smart Contract source code
Overview
This is a smart contract implemented in Solidity language for a simple supply chain system. It is based on the OpenZeppelin Ownable library and allows the owner to approve and ship items ordered by users.
Usage
To use this smart contract, you can follow these steps:
Navigate to the smart contract project folder, run
cd smart-contractInstall the required dependencies by running
npm install.Compile the contract by running
npx hardhat compile.Test the contract using
npx hardhat test. You can also generate a gas report by running REPORT_GAS=true npx hardhat test.Start a local development network by running
npx hardhat node.Deploy the contract to your local network by running
npx hardhat run --network localhost scripts/deploy.ts.Like this project
Posted May 1, 2024
Contribute to codewithmesfin/alchemy-decentalized-supply-chain development by creating an account on GitHub.
