Ethereum DApp for Tracking Items through Supply Chain

Introduction

This project consists in a decentralized application (DApp) for flight delay insurance for passengers.

Important: The project was made with the versions below, since Truffle v5 comes with Solidity v0.5 with many changes concerning mutability and visibility.

• Truffle v4.1.14 (core: 4.1.14)
• Solidity v0.4.24 (solc-js)
• Ganache CLI v6.12.2 (ganache-core: 2.13.2)

Important: The project didn't use any external libraries worth mentioning and also didn't use IPFS to host the frontend part decentralized as well.

Getting Started

1. Clone this repository.
2. Install the dependencies with NodeJS and NPM.
3. Test the application making calls to the contract on the Rinkeby Test Network.
4. Take a look at the transactions happening on the Rinkeby Test Network at Etherscan explorer.

Dependencies

1. Create an Ethereum account. Ethereum is a decentralized platform that runs smart contracts.
2. Create an account and install the Metamask extension on your web browser.
3. Create an Infura account to publish the contracts into the Rinkeby Test Network.
4. Install Truffle CLI. Truffle is the most popular development framework for Ethereum.
5. Use this passphrase with Ganache command as a suggestion "candy maple cake sugar pudding cream honey rich smooth crumble sweet treat". Ganache is part of the Truffle suite that you can use to run a personal Ethereum blockchain.

Important: You will need your personal passphrase from your Ethereum account to publish into the Rinkeby Test Network, hence the .secret file in the truffle-config.js, even tough being a test network.

Instructions

1. Install the dependencies:

  npm i
  npm i -g truffle@4.1.14
  npm i -g ganache-cli

2. Turn on the Ganache suite so that you will have pre-defined accounts to test the contracts:

  ganache-cli -m "candy maple cake sugar pudding cream honey rich smooth crumble sweet treat"

3. Compile, migrate and test the contracts with truffle (on a separate console). It will use the previously up and running ganache locally blockchain.

  truffle compile
  truffle migrate
  truffle test

4. Publish the contracts into the Rinkeby Test Network with your Infura key:

  truffle migrate --reset --network rinkeby

5. Check out and test the DApp in the frontend with the command below. You can run on the ganache-cli window, since Ganache was only for testing purpose.

  npm run dev

Important: As a reminder, the frontend of the application will interact with the contract on the Rinkeby Test Network, not with the pre-built accounts and deployed contracts made by the Ganache suite, as you can see in the browser's developer console.

Output

Here is an example of the smart contract in the blockchain and the transactions on Rinkeby:

Etherscan info:

• Transaction ID: 0x6b3dc37663772515e0464098be314717e109ccdfb882725ce65432161d8e4404
• Contract: 0xcf5a7edb0a5967acab9b81eb06c021b81b9ce1af