Description

▪ Follow the instructions very carefully. Answers that do not conform to the instructions will not be given credit.
▪ Understand thoroughly all the code given to you in this lab. Search for documentation online if there is a primitive or API you have not encountered before.
▪ Submit only one file for this homework: DutchAuction.sol.
▪ Your grade on this homework will be weighted by three regular homeworks. It is very important that you score well on it.

1. Read about Ethereum smart contract security:
a. https://consensys.github.io/smart-contract-best-practices/
b. Your score on the homework will be reduced if you submit insecure code.
2. Start up the vagrant-managed virtual machine included in the homework 8 zip, log into it using ssh. Then, start the Ethereum node server, and then use truffle to test the provided contracts. The tests should run, but most should not pass. Note: You must run “npm install” once under the homework8/auction directory before running truffle. The command installs code packages needed for the project.
3. Read about Dutch auctions: https://en.wikipedia.org/wiki/Dutch_auction
4. Read and thoroughly understand the provided code
a. contracts/DutchAuction.sol: an incomplete, skeletal implementation of a Dutch auction.
b. test/<k>_dutch_auction.js: mocha tests for the contract
c. test/framework.js: a testing harness to make tests easier to write 5. Part A: You will write a smart contract that implements a Dutch auction.
a. The seller instantiates a DutchAuction contract to manage the auction of a single, physical item at a single auction event. The contract is initialized with the following parameters:
i. reservePrice: the minimum amount of wei that the seller is willing to accept for the item
ii. numBlocksAuctionOpen: the number of blockchain blocks that the auction is open for
iii. offerPriceDecrement: the amount of wei that the auction price should decrease by during each subsequent block.
iv. judgeAddress: used by another part in this assignment.
b. The seller is the owner of the contract.
c. The auction begins at the block in which the contract is created.
d. The initial price of the item is derived from reservePrice, numBlocksAuctionOpen, and offerPriceDecrement: initialPrice = reservePrice + numBlocksAuctionOpen*offerPriceDecrement
e. A bid can be submitted by any Ethereum externally-owned account.
f. The first bid processed by the contract that sends wei greater than or equal to the current price is the winner. The wei should be transferred immediately to the sender and the contract should not accept any more bids. All bids besides the winning bid should be refunded immediately.
6. Part B: You will enhance the DutchAuction contract so that a judge can be designated for the auction. The judge behaves like an escrow in that he ensures that the seller received the wei of the winning bid if and only if the winner receives the item. A judge is specified by the judgeAddress parameter in the contract constructor. If a judgeAddress is not provided then, the contract should behave exactly as in Part A. However, if a judge is specified, then the behavior of the contract should be enhanced as follows:
a. The wei of the winning bid is no longer automatically sent to the seller.
b. Instead, a call to the finalize() function is now required after the winning bid is made, which will send the wei of the winning bid to the seller.
d. If the winner does not call finalize() and the judge also does not call finalize, then the judge can call the refund() function to send the wei of the bid back to the winner. You must ensure that the judge can only call one of these functions once and that the judge cannot send the wei to himself.
7. Notes:
c. Minimal tests are provided for you, but you are required to thoroughly test your work. The tests used to grade your submission will be different than the provided tests.