FlightSurety

FlightSurety is a sample application project for Udacity's Blockchain course.

Architecture Notes

Application is separated into 2 smart contracts

• FligtsuretyData.sol for data persistence
• FlightsuretyApp.sol for application logic and oracles code

Contract Features

• Ability to control operational status (that is active or not active)
  • Note: Verify with Truffle Test
• Where appropriate, functions will have require() call at the beginning to fail fast
• First airline will be registered when the contract is deployed
  • Note: Verifiy with Truffle Test
• Only existing airline(s) may register a new airline until there are at least four airlines registered.
  • Note: Truffle Test
• Airline can be registered, but does not participate in contract until it submits funding of 10 ether.
  • Note: Verify with Truffle Test Dapp client
• Execute steps
  • npm run dapp
  • http://localhost:8000
• Capabilities
  • UI has the following capabilities
    • Fields for Airline Address and Airline Name
    • Amount of funds to send/which airline to send to
    • Ability to purchase flight insurance for no more than 1 ether
  • Passenger Payment
    • Passengers may pay up to 1 ether for purchasing flight insurance.
    • Note: Verify with Truffle Test
  • Passenger Repayment
    • If flight is delayed due to airline fault, passenger receives credit of 1.5X the amount they paid
      • Note: Verify with Truffle Test
    • Ability to trigger the contract to request flight status update (looking to see if there are flight delays that require insurance payout)
      • Note: Verify with Truffle Test
  • Passenger Withdraw
    • Passenger can withdraw any funds owed to them as a result of receiving credit for insurance payout
      • Note: Verify with Truffle Test
    • Insurance payouts are not sent directly to passenger’s wallet

Oracle Server App

• simulates the behaviour of an oracle(s).
• execute - npm run server

Install

This repository contains Smart Contract code in Solidity (using Truffle), tests (also using Truffle), dApp scaffolding (using HTML, CSS and JS) and server app scaffolding.

To install, download or clone the repo, then:

npm install truffle compile

Develop Client

To run truffle tests:

truffle test ./test/flightSurety.js truffle test ./test/oracles.js

note: requirements for project are verified by running the truffle tests. Dapp will showcase the basic functioality and data, but will not fully demonstrate all of the functionality of the 2 contracts.

To use the dapp:

truffle migrate npm run dapp

To view dapp:

http://localhost:8000

Develop Server

npm run server truffle test ./test/oracles.js

Deploy

To build dapp for prod: npm run dapp:prod

Deploy the contents of the ./dapp folder

Resources

• How does Ethereum work anyway?
• BIP39 Mnemonic Generator
• Truffle Framework
• Ganache Local Blockchain
• Remix Solidity IDE
• Solidity Language Reference
• Ethereum Blockchain Explorer
• Web3Js Reference