Project7-4_Smart_contract

程式架構

• TransactionContract
  • addSellerAddress
  • addCourierAddress
  • setCommitteeAddress
  • buyStuff
  • createTransaction
  • confirmPurchase
  • claimTransaction
  • unclaimTransaction
  • deliveryComplete
  • confirmReceived
  • transactionComplete
  • getTransactionInfo
  • refoundBuyerAmount
  • testPesticide

粗體字為合約主要結構，其他setter及modifier等過於繁瑣故不在此列出，請至Transaction.sol查看。
主要重心著重在交易流程完整性及身分驗證，並提供各種功能讓買家、賣家、物流、農委會及合約持有者方便使用。農產品驗證的部分仍然需要具體的行為，故我們希望可以留下

運作流程

首次執行

1. setCommitteeAddress，合約首次建立後，須由合約擁有者手動指定農委會的Address
2. addSellerAddress，通過農委會驗證過的賣家才可以使用合約進行販賣
3. addCourierAddress，通過農委會驗證的物流業者才可以進行接單

開始運作

1. buyStuff，買家先挑選所需的各產品數量，傳入一大小為4的陣列，代表各產品的購買數量(為方便測試，目前只開放4種產品購買)，回傳訂單編號、已選定之產品數量、總金額等。
   • 此處需注意！訂單編號必須記住，之後所有操作都必須傳入指定的訂單編號才可運作。(此處可交由上層API處理)
2. createTransaction，賣家進行確認並成立訂單。
   • 讓賣家建立訂單是為了避免有買家惡意亂下訂單的情況，只有通過農委會認證的賣家才能進行販賣。
3. confirmPurchase，訂單成立後買家可以進行付款的動作，填入指定的訂單編號，並於value欄位填入付款金額，單位為wei。付款金額可於(1)的回傳內容得知，或是透過訂單編號呼叫getTransactionInfo來重新確認訂單資料。
   • 付款金額目前是支付到合約當中，會等到交易完成才給賣家領取。
   • 在這裡會確認買家帳戶中是否有足夠金額可以購買以及付款金額是否正確
4. claimTransaction，物流業者進行主動接單，若接單後因故無法處理，可以透過unclaimTransaction棄單，讓其他人接單。
5. deliveryComplete，物流業者完成配送。
6. confirmReceived，買家確認收貨。
7. transactionComplete，賣家確認交易完成，並收到貨款；物流業者從貨款中抽取一部分作為運費。

所有訂單皆透過以上方式按照順序運作，若沒依照順序執行，會因為身分不同或訂單狀態不正確而阻擋，因而浪費gas，故使用者呼叫API時請小心。

輔助功能

1. refoundBuyerAmount，當交易進行中發生任何問題，需要取消交易並退還款項，可透過此方式將已支付到合約內的金額退還給買家。若交易已完成或交易狀態異常則無法操作。
2. testPesticide，若農委會檢測到產品有問題，可以呼叫此功能，會將進行中的所有交易訂單暫時鎖住。若要解鎖，要請合約持有者進行訂單的個別操作來解鎖。
3. getTransactionInfo，所有交易都是公開透明的，任何人都可以透過訂單編號查詢訂單狀態，此功能會將訂單的所有內容回傳。

部署

1. 於線上編譯器編譯通過，並使用JavaScript VM做部署測試，依照以上方法進行操作，功能皆正常運作。之後嘗試將ByteCode導出並於柑橘測試網路部署成功。
2. 嘗試使用Injected Web3做部署測試，才知道此線上編譯器的部署功能也能快速部署至測試網路。
3. 目前只有部署完成的階段，並未使用任何前端進行API呼叫。

Tangerine Testnet

Rinkeby Testnet

在 Remix IDE上用Injected Web3做部署，成功會產生網址如下圖，要點進去才可看到合約成功的地方(如上方網址所呈現)

Contribution

click me