📜 [專欄新文章] 類 Python 的合約語言 Vyper 開發入門:與 Solidity 差異、用 Truffle 部署、ERC20 賣幣合約實做
✍️ 田少谷 Shao
📥 歡迎投稿: https://medium.com/taipei-ethereum-meetup #徵技術分享文 #使用心得 #教學文 #medium
有鑒於個人近期關注的 Uniswap 及 Curve 皆用 Vyper 實作,索性瀏覽了官方文件並嘗試一些開發工具,希望此文能減少一些讀者初嘗 Vyper 會遇到的麻煩!
Vyper and Solidity
Outline
一. Vyper 極簡介二. 與 Solidity 語法差異三. 開發、開發環境設置 1. 語法高亮 2. 本地 Vyper compiler 安裝 3. 使用 Truffle 操作 ERC20 - 安裝 Truffle - 發幣 - 寫個簡易賣幣合約四. 已知 Remix 問題 五. 結語
一. Vyper 極簡介
Vyper 是除 Solidity 外,以太坊上的另一智能合約 (Smart contract) 語言。其語法和 Python 相近,但畢竟也是寫合約的語言,邏輯差異不大,所以若熟悉 Solidity 應該不難理解用 Vyper 寫出的合約!
Vyper 主要被設計和 Solidity 的區別是安全性及可讀性,這部分會在下一段落及後方的實作中舉例說明。
二. 與 Solidity 語法差異
Vyper 與 Solidity 的差異有許多,在本段只就個人認為感受較深的三點進行說明,其他差異只進行翻譯,有興趣的讀者可以到官方文件詳細了解:https://vyper.readthedocs.io/en/latest/index.html
1. 沒有 modifier
Solidity 常見的 onlyOwner() modifier; 由於 gist 沒有 Solidity 的語法高亮,故截圖
在 Vyper 中單純用 assert 及 assert_modifiable 來進行條件檢查,兩者差別為若要檢查函數執行後的返還值,要用後者,如下圖:
Vyper 寫法
2. 沒有 Class inheritance 繼承
繼承是物件導向程式設計 (OOP) 的核心概念,但各種繼承關係有時候確實很複雜。Vyper 沒有繼承,這無疑大幅地增加了程式可讀性及安全性,以及降低審計程式碼的難度。在此提供一個例子供不熟悉 OOP 複雜之處的讀者有個概念:
source: https://consensys.github.io/smart-contract-best-practices/recommendations/#multiple-inheritance-caution
在上例中,contract A 的 fee 值 (因繼承自 contract B 和 C,故有 fee 一值) 是 5、a 值也是 5 (因繼承自 contract Final,故有 a 一值)。原因是 A 先繼承 B 再繼承 C,因此 contract A 中的 setFee() 是使用了 contract C 的 setFee(),而 a 值是由於 C(5),這代表 contract C 的 constructor (舊版本中即 function C(),函式名稱同 contract 名稱) 被傳入的值為 5。
稍微延伸一下以上概念,將 contract A 改成:contract A is C, B。如此一來,a 值還有 fee 值都會是 3,因為這次 A 先繼承 C 再繼承 B,因此最終吃到的值是 contract B 的。
以上就是 OOP 繼承的複雜之處的簡單範例說明,應該能稍微感受到爲什麼除去繼承後會大幅提高可讀性及安全性,畢竟即使是熟悉 OOP 的人有時頭腦一混亂也會開始懷疑自己寫的程式碼繼承結構是否正確 …
3. 沒有 dynamic array 動態陣列
這應該是目前 Vyper 設計中爭議最大的部分。沒有動態陣列代表在宣告陣列時需要宣告其長度,也就是說 Solidity 中的寫法 uint[], bool[] 等等,這些是不會出現在 Vyper 的。在 Vyper 中只能出現諸如:
# Vyper 的變數宣告方式為 變數名稱: 存取範圍(變數型態(若為陣列給長度))
values: uint256[10]participants: public(address[20])
可以看到上方的 uint256 及 address 兩陣列皆需要宣告長度,不能不宣告而使其動態地配置空間。
沒有動態陣列固然可以確保執行運算的範圍、次數,但一來動態陣列真的很方便、二來在 Solidity 有此功能而 Vyper 卻沒有的情況下可能會造成麻煩,詳見此一討論串:點我。
4. 沒有 inline assembly,程式碼中不會有組合語言
5. 沒有 function overloading,函式不會因傳入的參數數目不同而結果不同
6. 沒有 operator overloading,運算符號不會有不同於預設的自定義功能
7. 沒有無限迴圈,可免於 gas limit attack
8. 十進位定點數 decimal fixed point 而非二進位 (binary) 定點數,詳見:點我
三. 開發、開發環境設置
結論先講
開發 Vyper 的最佳姿勢目前個人認為是在本地裝上 Vyper compiler、用 Truffle 部署,並在撰寫時將檔名後加上 .py 就能有 Python 的語法高亮👌
1. 語法高亮 (syntax highlighting)
有語法高亮絕對是舒服地寫程式的第一步。
Remix 有 Vyper 的語法高亮,但一來個人目前不推薦使用 Remix 來撰寫 Vyper,原因詳見下方 4. 已知 Remix 問題;二來 Remix 的語法高亮其實也沒有很清楚,因此個人推薦:在本地開發,將檔名後加上 .py 就會有 Python 的語法高亮。
2. 本地 Vyper compiler 安裝
照官方說明使用 Python 的虛擬環境 virtualenv:
source: https://vyper.readthedocs.io/en/latest/installing-vyper.html#installing-vyper
簡單兩點提醒:
如果中間那行報錯但確實已經有 Python,則可能是版本問題。依照自己電腦上的版本改成相應的即可,ex: python3.6 改成 python3
進入虛擬環境後(檔案路徑前方應有 vyper-venv 的提示),使用此指令: vyper {檔案名稱}.vy,即可編譯 .vy 檔;使用完畢後輸入 deactivate 即可退出
3. 使用 Truffle 操作 ERC20
安裝 Truffle
Truffle 雖有冗餘的 migration 但也別無他法,畢竟 Remix 目前仍不完善 :(
下載流程可以照官方文件,使用 vyper-example:
source: https://github.com/truffle-box/vyper-example-box
由於我們會接上測試網 Ropsten,因此還要下載 truffle-hdwallet-provider:
source: https://github.com/trufflesuite/truffle-hdwallet-provider
接者就可以開始使用 Vyper 寫合約了!
發幣
由於 Vyper 的官方文件中已經有許多優質範例,因此本文希望來點不一樣但大家卻又很熟悉的…以 ERC20 為例(這千篇一律的主題xD):
用 Curve 的 ERC20 程式碼為範本,發一個幣(又要發…)
寫一個簡易賣幣合約
選擇這個主題一方面畢竟 ERC20 是以太坊的最大宗應用之一,二來有興趣的讀者可以透過讀 ERC20 的程式碼來熟悉 Vyper,並在看過本文的流程後對於用 Vyper+Truffle 來操作 ERC20 有完整的概念!
好的,首先複製一份 Curve 的 ERC20 程式碼(看到就順手拿來用),並複製到 Truffle 所在路徑的 contracts 資料夾中:https://github.com/curvefi/curve-contract/blob/pool_compound/vyper/ERC20.vy
由於第一點希望著重在跑一次流程,因此不改動合約的程式碼。
將 ERC20.vy 複製到 contracts 資料夾中後,到 migrations 資料夾開啟 2_deploy_contracts.js,首先將 require() 中的參數改為 ERC20.vy 的檔名 ERC20,再來依照自己喜好決定幣的名稱、代號、小數點位數及發行總量,輸入於 deployer.deploy() 中。
接著,為了和測試網 Ropsten 互動,需要將以下程式碼寫入 truffle-config.js。
第二行的 privateKeys 是帳號的私鑰。以下實作需要兩個帳號來操作,因此請從錢包匯入兩組私鑰(並非助憶詞)。
在第 13 行中 HDWalletProvider 此函式的第三個參數代表要用第幾個帳號最為預設帳號(部署合約等),第四個函數代表總共匯入幾組帳號。而第二個參數則是需要至 Infura 申請一個 project 來得到串接 Ropsten 的連結。這兩步驟並非本文重點,因此不詳細解說步驟,Google 搜尋關鍵字應該就會找到方法!
接著,就可以輸入以下指令來將代幣發佈到 Ropsten:
truffle deploy --network ropsten
有進入虛擬環境才可以編譯 .vy 檔,若忘記就會收到如下的錯誤訊息:
記得打開虛擬環境才能編譯 .vy 檔
成功後就可以在 contract address 中看到代幣發佈的位置,加入到 Metamask 中就可以看到。本文的例子是維尼代幣 Winnie the Coin, WTC ;)
contract address 便是 ERC20 的所在
Winnie the Coin, WTC
好了,到此測試網上又多了一個測試用的垃圾廢幣。
寫個簡易賣幣合約
賣幣合約中我想要簡單有兩個功能就好:付錢買幣 、結束銷售,以下就是程式碼。買幣的部分就不寫太詳細,固定價格為 0.01 Ether 可以買 500 代幣。
簡單說明幾點:
Solidity 的 constructor() 在 Vyper 中為 Python 風的 __init__():
函式的屬性(public, private, payable 等等)放在函式上方,與 Python 的修飾器位置相同
總之寫法跟 Python 很像,次方也一樣是用兩次乘法代表:**
變數前加上 self 代表是當前合約的變數/全域變數,因此非常容易與函式中的變數/區域變數做區隔
由於已經在第一行匯入了 ERC20 那份合約,因此透過將地址傳入合約當參數,就可以呼叫在該地址的合約:ERC20(self.tokenAddress) 。並且,可以將部署的合約存成一個變數 erc20 較方便
寫完合約後一樣要更改 migrations 資料夾中的 2_deploy_contracts.js 如下,將代幣所在的地址作為參數輸入。
由於先前已經部署過一次了,因此要重置才能再部署第二次,輸入以下指令:
truffle deploy --reset --network ropsten
部署成功之後就要來試著買幣啦!輸入以下來進入 console:
truffle console --network ropsten
成功進入後應該會看到 truffle(ropsten)> 的字樣。接著,首先取得部署的兩合約,並查看是否有返回合約資訊:
# ERC20 及 SellToken 是先前在 2_deploy_contracts.js 中的變數名稱,代表被部署的合約
let instance1 = await ERC20.deployed()instance1 # 印出 instance1 的資訊
let instance2 = await SellToken.deployed()instance2 # 印出 instance2 的資訊
再來,為了讓 SellToken 可以賣幣,要先用 ERC20 的合約匯幣到 SellToken 的合約。因此,輸入以下指令:
instance1.transfer(instance2.address, 10000)
# 這裡數字只要設為 > 500 就可以
接著,我們要利用第二個帳號去買幣(第一個帳號為預設帳號,因此就是代幣擁有者)。將帳號的資訊存入變數 accounts 中,再指定送出交易的帳號是第二個帳號。由於我個人匯入私鑰的順序是將第一個帳號存在 truffle-config.js 的 privateKeys[0]、第二個帳號存在 privateKeys[1],因此第二個帳號的地址就會在 accounts[1] 的位置:
let accounts = await web3.eth.getAccounts()
instance2.buyToken({from: accounts[1], value: 10000000000000000})
# value 為 10^16 是因為在 SellToken 的 buyToken 函式中買一次要 0.01 Ether, 即為 10^16 wei
然後應該就會在自己的第二個帳號中看到匯入的幣了~
最後,由於合約中結束銷售就是一個自殺 selfdestruct 函式,因此可以呼叫看看,第一個帳戶錢包中的錢應該會增加,因為第二個帳戶有付款買幣;並且,可以到 Ropsten 上瀏覽,應該能看到相關提示:
中間 contract 的右上角有 Self Destruct 的樣式
四. 已知 Remix 問題
Remix 目前有兩個版本,只有新版有 Vyper 的編譯器。在此整理目前遇到的問題,如果有人也遇到可以對照一下本處,可以省去很多自我懷疑xD
不會報錯
Remix 的編譯結果有時會是錯的、和本地端編譯出來的結果不同
舉上方的 SellToken 合約為例,將其複製到 Remix 中使用左邊的 Remote Compiler 有錯,但又不報錯 q_q (ERC20 的合約有在同檔案目錄)
左方有紅色三角形,代表編譯失敗,但沒有報錯訊息可以看…
getter function 竟然要花錢
用 Solidity 寫的合約,查詢 public 變數的值應該是不用消耗 gas 的,但不知何故查詢 Vyper 寫的合約的 public 變數卻要消耗 gas,如下圖…
可以看到中下方有 22026 gas 的消耗
Local compiler 無法使用
圖中的 Local Compiler 此選項,個人雖照官方文件執行 vyper-serve 但卻失敗,因此若有讀者成功希望能留個言不吝分享!
五. 結語
Vyper 作為一個比 Solidity 更新的合約語言,在寫程式碼的方面沒什麼問題,但相關的開發工具、學習資源等都遠不及 Solidity。
Vyper 主打的兩個特色:可讀性的部分相信看完上面的讀者應該已經有些感覺;安全性…小白如作者我倒是沒有感受到顯著的不同。況且 Solidity 已經發展許久,很多錯誤的寫法、知名的安全漏洞大家應該也很熟悉了,還有 Openzeppelin 提供安全合約寫法的範本,因此有待以後高人解說安全性是否真的是 Vyper 較好。
有興趣者可以查看 Vyper 的安全報告:點我,大意是目前 Vyper 的編譯器仍有許多問題待改進! (感謝 Chih-Cheng Liang 的提供)
本文對 Vyper 的介紹及其與 Solidity 的差異只講了個大概,欲知更詳細的介紹還是要麻煩讀者前往官方文件了:https://vyper.readthedocs.io/en/latest/index.html
最後,如果本文有任何錯誤,請不吝提出,我會盡快做修正;而如果我的文章有幫助到你,可以看看我的其他文章,歡迎一起交流 :)
田少谷 Shao - Medium
類 Python 的合約語言 Vyper 開發入門:與 Solidity 差異、用 Truffle 部署、ERC20 賣幣合約實做 was originally published in Taipei Ethereum Meetup on Medium, where people are continuing the conversation by highlighting and responding to this story.
👏 歡迎轉載分享鼓掌
重置安全提示問題 在 棒球殿堂 Facebook 的最讚貼文
✳1.0.2版本任務獎勵配發優化事項
🔆為增進玩家進行遊戲取得資源順暢,1.0.2版本優化貨幣類部分獎勵將於任務完成、簽到完成、成就完成後直接加入玩家貨幣欄,不再以至信箱配送
🔆請玩家特別注意以下相關獎勵配發流程:
-優化領取金幣、鑽石、紅利獎勵後,直接計算加在目前持有數上
1.每日任務
2.簽到
3.成就獎勵
-優化進行賽季模式,獎勵道具會發送至信箱
1.比賽任務
2.季賽任務
3.季後賽結束
🎉🎉《棒球殿堂2017》版本更新及明星賽活動情報🎉🎉
開機登入獎勵:SE季賽最佳65評價以上選手卡包x1+A級訓練藥水x5
✳領取時間至 7/6 23:59
⚾慶改版登入天天送!!
活動時間:7/7 ~ 7/12
活動內容:於以下指定時間登入遊戲即可獲得對應獎勵
✳獎勵詳見官網公告: https://goo.gl/4hpzWb
⚾限時登入獎勵再加碼!
活動時間:7/7 ~ 7/12 每天的11:00~12:59
活動內容:於以下指定時間登入遊戲即可獲得對應獎勵
✳獎勵詳見官網公告: https://goo.gl/4hpzWb
⚾HOT TIME! LIVE季賽金幣加倍提升!
活動時間:7/6 ~ 7/12 每天的 19:00 - 21:59
活動內容:於HOT TIME活動時期間內,登入遊戲進行LIVE季賽,完成比賽後可獲得2倍金幣獎勵
⚾暑假限時活動! LIVE對戰手動賽完成3場拿獎勵!
活動時間:7/7 ~ 7/12 每天的11:00 ~ 12:59
活動內容:於活動指定時間內,每天登入遊戲並進行LIVE對戰手動賽模式 3 場,即可立即獲得對應獎勵
✳獎勵詳見官網公告: https://goo.gl/4hpzWb
⚾明星賽特別活動Part1 LIVE對戰模擬賽金幣5倍限時提升!
活動時間:7/7 ~ 7/9 每天的 19:00 - 21:59
活動內容:於活動時期間內,登入遊戲進行LIVE對戰模擬賽,完成比賽後可獲得5倍金幣獎勵
⚾明星賽特別活動Part2 LIVE對戰模擬賽經驗加倍限時提升!
活動時間:7/7 ~ 7/9 每天的 19:00 - 21:59
活動內容:於活動時期間內,登入遊戲進行LIVE對戰模擬賽,完成比賽後可獲得2倍經驗獎勵
⚾明星賽特別活動Part3 強化成功機率限時1.5倍提升!
活動時間:7/8 ~ 7/9 每天的 18:00 - 18:59
活動內容:於以下指定時間登入遊戲進行球員卡強化,強化成功機率提升1.5倍!
⚾獎勵配發
1. FUN暑假限時挑戰!LIVE對戰手動賽天天3場獎勵
2. 一週挑戰! LIVE對戰模擬賽單週任務!
3. 雙平台單月儲值滿額加碼送!
✳以上獎勵將於今日(7/6 20:00前陸續配送至玩家信箱)
⚾系統內容調整
[獎勵]
-優化領取金幣、鑽石、紅利獎勵後,直接計算加在目前持有數上
1.每日任務
2.簽到
3.成就獎勵
-優化進行賽季模式,獎勵道具會發送至信箱
1.比賽任務
2.季賽任務
3.季後賽結束
[鏡頭]
-增加狀況發生時的鏡頭
推軌鏡頭呈現捕手的畫面
1.後方界外球,捕手追球與接殺時
2.捕手後方的界外球
3.捕手接殺範圍
-鏡頭跟隨打者,或以推軌方式呈現打者畫面
1.前方未有守備
2.內野安打或一壘時出現接近的判決
3.德州安打安全上一壘
4.外野高飛球接殺
5.出現全壘打時
6.主場有類似爭議狀況時
7.一壘有類似爭議狀況時
[賽季模式]
-賽季重置按鈕變更置LIVE季賽主畫面
-加大LIVE季賽模式的季賽任務視窗
-修正Homerun Derby對方選手的評價顯示錯誤問題
-修正Homerun Derby沒有進行該Round的狀態下結束連線,無法繼續問題
-修正AI投手能力,根據球威、變化、控球、球速的能力會有不同揮空機率
※揮空機率只有在對手是AI時發動
[挖角]
-增加可能出現的選手種類標示
-優化不同類型挖角的評價標示
[任務]
-優化蒐集達成率的標示方式
-蒐集視窗增加前往自由市場的功能按鈕
-修正實際成就數量的標示
[一局勝負]
-優化配對方式
-優化比賽清單順序排列
-增加最高比賽數量至15場
[球團管理]
-在交易與挖角選單中增加,屬於該選單隊伍資訊的提示功能按鈕
-優化先發名單A、B的顯示資訊方式
-增加選手卡鎖定/解鎖按鈕
-優化強化點數顯示
-優化強化畫面,可查看強化對象與材料選手資訊、登錄先發名單、擁有技能等
-優化交易提案只有一名選手時,預設選擇提案結果
-優化交易提案標示選手的自由市場基準價
-在先發名單中點擊自由市場價值圖示時移動至自由市場
[自由市場]
-詳細搜尋增加投手守位篩選
-詳細搜尋增加打者守位篩選
-優化只有在活動進行時才會出現活動按鈕
[全壘打模式]
-優化Homerun Race時擁有的打者目錄篩選
-優化套用卡片、增加、狀態能力
[對戰模式]
-優化對戰模式配對規則,當在同一等級時以球團戰力為基準
-增加降級、晉級比賽的資訊
-增加配對取消按鈕
-對戰模式主畫面增加好友對戰按鈕
-優化降級、晉級比賽的分數
-修正LIVE對戰(手動賽)紀錄,以LIVE對戰手動賽的記錄標示
-修正LIVE對戰(模擬賽)紀錄,以LIVE對戰模擬賽的記錄標示
-修正取消選手再次簽約視窗時,先發名單沒有合約為0的選手時,可以繼續進行比賽 (合約為0的選手不可比賽)
[模式紀錄]
-優化遊戲內進行比賽的紀錄為即時套用
1.LIVE季賽: 進行中的季賽模式紀錄
2.LIVE對戰: 進行中當週次的對戰模式紀錄
3.一局勝負: 選手紀錄
4.模擬賽中標示的打者打擊率為季賽的打擊率
[其他]
-強化保管箱道具標籤標示
-增加活動進行中點擊活動按鈕(E字母標示),跳出活動視窗功能
-增加新手教學提示功能
-優化裝備篩選器功能
-選手清單篩選器新增[未登錄]的功能
-優化選手清單篩選器排列順序功能
-增加信箱、保管箱的資訊
-優化在有限制時間的投球時,數值條填滿的時候為沒有時間限制
-優化取消補手配球時,可以從[球種選擇]開始進行
-新增比賽中查看簡略投打能力的資訊
-優化根據投手的球種等級有不同顏色
-優化根據選手狀態和能力發動動作的頻率
-新增優化內野守備選手的補位和動作
-修正選手卡強化時,偶爾出現文字重疊顯示的問題
-修正替換球員登場時技能未套用問題
-優化點擊選手強化按紐時,未選擇[選手保護]的狀況,會跳出提示訊息 (+1強化時例外)
-修正[簽到更新時間]文字
-新增在選手替換時,顯示選手狀態的圖示
-更新台中洲際棒球場、桃園國際棒球場的球場細節
-更新球員卡與球員頭像
重置安全提示問題 在 街頭籃球 Facebook 的最讚貼文
【你問我答小編重點整理🏀🏀】
🔈提問:挑戰賽是永久開放的嗎❓,挑戰賽徽章是否會歸零❓
👉回答:挑戰賽是永久開放的喔~徽章不會歸零。
🔈提問:灌籃拉杆跟上籃拉杆,這兩種拉杆的成功率是看訓練營中哪個屬性呢❓
👉回答:這些看的是技能單獨的命中率,跟訓練營是沒關係的唷~
🔈提問:【飛身抄截】發動率的問題,請問是否是有什麼技巧可以觸發這個技能呢❓
👉回答:此技能在對方的傳球路線上會容易觸發的。
🔈提問:訓練營有一項"安全接球距離"的選項,有減少到"空中接球"時被蓋的機率嗎❓
👉回答:安全接球距離說的是傳球失誤的機率,跟空接被火鍋沒有關係。
🔈提問:花式突破升級超過兩等後揮往前衝跟距離變短是bug嗎❓
👉回答:技能升級完全不影響動作的長短。
🔈提問:請問飛身攔截的技能等級,是否會影響觸發率❓
👉回答:不影響,技能只影響數值。
🔈提問:邀請好友分享獎勵什麼時候重置❓
👉回答:每週一重置。
🔈提問:補籃的命中率是看投籃還是上籃❓
👉回答:上籃。
還有近期玩家大大留言的建議我們也都有收集到喔~
1、遊戲中"請別帶球"讓玩家認為不舒服,希望改成"請多傳球"等正面用語。
2、希望推出黑名單功能。
3、希望邀請組隊跟訊息可以有提示音。
4、希望可以多出一些男性小前鋒和得分後衛。
5、翅膀會擋住視線,希望可以優化。
感謝以上大大提出的建議,遊戲也會繼續不斷完善的。
其他玩家大大如果還有什麼好的建議都可以提給我們喔~感謝大大們對遊戲的關注!