📜 [專欄新文章] Uniswap v2 實作 : 從創建交易對到Ether 換 Dai 投入 Compound
✍️ 田少谷 Shao
📥 歡迎投稿： https://medium.com/taipei-ethereum-meetup #徵技術分享文 #使用心得 #教學文 #medium

Uniswap v2 實作 : 從創建交易對到Ether 換 Dai 投入 Compound

V̶y̶p̶e̶r̶ Solidity coding time!

Image source: https://uniswap.org/

Outline

一. 前言二. 程式碼結構 1. Wrapped Ether(WETH)? 2. Impermanent Loss三. 創建交易對 - 準備 Interfaces四. 注入資金 - 注意事項五. 兌換虛擬貨幣六. 取得報價作為預言機七. 自行兌換 WETH八. 結語

一. 前言

暨上一篇解釋了 Uniswap 的演算法後，由於個人有使用 Uniswap v2 的需求，因此整理後寫成本篇，希望能幫助到其他也需要用 Uniswap 的讀者！(不熟 Uniswap 的人也可以參考區塊勢 許明恩 Astro Hsu 寫的介紹文：點我)

Uniswap 解析：恆定乘積做市商模型 Constant Product Market Maker Model 的 Vyper 實作

本文希望透過實際操作 Uniswap 我個人會用到、我認為大家比較常會用到的功能，來讓不熟悉的讀者快速了解其程式架構(v2 相較 v1 繁複)、熟悉實作方法，無法顧及全部還請見諒。

以下實作的測試環境為 Rinkeby 測試網，由於只是要講解使用方法，因此選擇在 Remix 上操作。

而 Uniswap v2 跟 v1 的差異，個人沒有很認真研究，大致列舉以下幾點，本文只會就其中幾點在後方進行較詳細的解釋：

使用 Wrapped Ether, WETH (於 二. 程式碼結構 解釋)，讓 ERC20 交易對不再需要透過 Ether ，降低 gas 的消耗，但還是可以用 Ether 支付

加入時間權重的預言機，降低被操縱價格的風險，於 六. 取得報價作為預言機 中舉例說明，有興趣者可以看看 白皮書 有詳細介紹

閃電貸

使用 Solidity 而非 Vyper，因為 Solidity 功能上較齊全，於 五. 兌換虛擬貨幣 中舉例說明原因

在開始之前，本文超長，播個背景音樂吧：

二. 程式碼結構

本段落簡單描述 Uniswap 程式碼各部分的功能。若讀者要自己實作，可以參考此處得知該去哪一份程式碼找相應的功能：

Factory / UniswapV2Factory.sol : 創建交易對、查詢交易對的地址與總數；查詢、指定交易對手續費的收款地址

Pair(ERC-20) / UniswapV2ERC20.sol : Uniswap 流動性代幣 ERC20 的部分

Pair / UniswapV2Pair.sol : Uniswap 流動性代幣的其他部分；查詢交易對資訊

Router / UniswapV2Router01.sol : 注入、取出流動性/資金；兌換虛擬貨幣。此合約看似最複雜，其實只是因為收付款的單位可以是 Ether 或是 ERC20，所以有很多重複的函式

ExampleOracleSimple.sol, ExampleSlidingWindowOracle.sol : 預言機的範例程式碼

Library / UniswapV2OracleLibrary.sol : 供預言機調用的函式

Library / UniswapV2Library.sol : 供內部調用的函式

除了描述程式碼結構，為了以下的實作我們還需要知道 Wrapped Ether 是什麼，順便了解其使用原因：

1. Wrapped Ether (WETH) ?

從字面上來解釋，Wrapped Ether 是被包起來的 Ether。那為什麼好好的 Ether 不用還要創造出另一版本，嫌這小小世界的術語不夠多嗎 (ETH, WETH, Dai, aDai, cDai, sDai…)？xD

wETH | ERC20 tradable version of ETH

主因有兩個：廣泛地說，Ether 是以太坊上的原生虛擬貨幣，但它與廣為使用的 ERC20 標準並不相容( ERC20 有 approve(), transfer() 等等功能)；而針對 Uniswap 的場景來說，v1 的交易對都一定有 Ether，而使用 Ether 可能會造成 Impermanent Loss，於下方解釋。

因此，就以上兩點的解決方法個別是：

部署一 ERC20 <-> Ether 的兌換合約：使用者將 Ether 付給 Wrapped Ether (ERC20) 的智能合約，合約就會給使用者同等數目的 WETH；拿回 Ether 則有點不太一樣，方法是告訴 WETH 的合約使用者要 withdraw()，WETH 的合約就會把使用者 WETH 擁有的額度設回 0 (或減少) 並返還 Ether，於 五. 兌換虛擬貨幣 中舉例說明

v2 交易對的建立不再只能是 (Ether, ERC20)，可以是 (ERC20, ERC20)

2. Impermanent Loss

Impermanent loss 在 DeFi 指的是像 Uniswap 這類用演算法的去中心化交易所，如果交易對是兩幣價不相干的虛擬貨幣，例如：穩定幣 (Dai, USDC, etc) 和 Ether，流動性提供者 liquidity provider 會因為幣價的相對波動而比起直接持有兩幣還損失了一筆。

容我舉個例解釋清楚點，可以搭配我上一篇所寫的 Uniswap 的演算法 來理解：假設一開始 1 Ether 幣價為 100 Dai，只有一流動性提供者 LP 投入了 1 Ether 及 100 Dai (1 * 100 = 100 = k，k值要維持不變)，總價值為 200 Dai。當 Ether 的幣價來到 200 Dai，眼尖者會發現資金池中的 Ether 價格低、有利可圖，因此會進行套利，例如：拿 33 Dai 約可以換到 0.25 Ether (0.75 * 133 ≒ 100)，比起市場上要用 50 Dai 才能換到 0.25 Ether，套利者賺到了。此時，流動性提供者若將自己的資金提出，0.75 Ether 和 133 Dai 此時的總價值是 283 Dai，看似比當初的 200 Dai 還多，但其實將兩幣放著不動 1 Ether + 100 Dai 在此時就已經是 300 Dai 的價值了。於是，impermanent loss 就變成了 permanent loss :(

三. 創建交易對

- 準備 Interfaces

在開始之前，由於使用到的合約不少，所以我將全部所需整理在此：點我。其中，UniswapImplementation.sol 是本文實作的檔案。

若讀者在自己調用 Interface 時遇到版本問題，就依照 compiler 提供的指示稍作修改即可。我所整理的合約都修正過版本的差異、以下的實作也測試了可行，因此可以安心使用。

進入正題

通常大家使用的 Uniswap 資金池都是已經存在的，而如果想要上架自己的虛擬貨幣就要自己創建一組新的交易對，有兩種方式：在 Uniswap 官網上執行或是透過呼叫 Uniswap 的合約來建立，本文使用合約的方式。

首先，我們需要決定資金池為哪兩種虛擬貨幣，那就很普通地選 ETH 和 Dai 吧。雖然選了 ETH，但如同上方所述實際上必須使用 WETH，於是記下其在 Rinkeby 上的位置 。Dai 就使用 Compound 部署在 Rinkeby 上的版本，位置在 0x5592EC0cfb4dbc12D3aB100b257153436a1f0FEa。

接著，打開 IUniswapVFactory.sol，依照官方文件的指示將此合約部署在 Rinkeby 上的 0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f。以下會有許多由 Uniswap 文件得知的合約地址及其他資訊等等，就不再一一附上來源或畫面截圖!

如上圖黑框所示，輸入了地址後按下藍色按鍵就完成部署了。接著，如下圖將 Dai 的地址 及 WETH 的地址輸入 createPair()：

由於這個交易對我已經部署過了，因此讀者若想嘗試就麻煩去找別的 Rinkeby 上的測試幣了、或自己發一個! 完成後可以用 getPair() 輸入兩幣地址來確認交易對被建立成功：

如果想要進一步核對，可以先呼叫下圖紅框中的 allPairsLength()，得知當前總共有幾組交易對，再將 (交易對數 - 1) 輸入 allPairs()，就能得到和上圖一樣的地址。需要減 1 是因為陣列的 index 從 0 開始。

allPairsLength 的值會因為其他人的使用而增加，故日後可能會和本圖產出的 9 不同

四. 注入資金

看到標題的讀者可能會想：為何要把注入資金/流動性和上方的創建交易對分開呢？因為注入流動性這個功能被放在了 UniswapV2Router01.sol 中，所以就分開解釋。

雖然上一節只需要複製貼上按按鍵，但接下來要探討的注入資金 addLiquidity() 及虛擬貨幣的交換 swap()比起創建交易對 createPair() 是較有可能被融入到其他 DeFi 服務的功能(應該不太會有人會一直需要創建新的交易對)，因此打開 UniswapImplementation.sol、要開始 Solidity coding!

如果不熟悉為何別的 DeFi 會需要在自己的服務中使用 Uniswap，可以搜尋 DeFi Money Lego/ DeFi 樂高，顧名思義就是在一個 DeFi 服務上使用另一個 DeFi 服務。實際的例子有：Aave 的新功能是可以拿往 Uniswap 注入流動性後得到的流動性代幣再投入 Aave 來賺取利息，以及下一節兌換虛擬貨幣的功能可以在 Pelith 的輕鬆貸 EasyDai、一站式 DeFi 組合工具 Furucombo 等場景中看到他們如何將 Uniswap 銜接上其他的 DeFi 服務。

回歸正題

在開始之前，先簡單提及一下有哪些變數、instance 需要初始化：

我們要呼叫 Uniswap 合約的 instance 來進行互動: IUniswapV2Router01

不只需要 Dai 的 instance，也需要 Dai 和 WETH 的地址；DaiAmount 和 ETHAmount 是為了稍後注入流動性所設置的，本文假設第一筆流動性我們使用 200 Dai + 1 Ether

immutable 是版本 0.6.5 加入的，用途是讓變數只能被讀取 read-only，但不同於 constant 的是能夠在 constructor() 中賦值。之所以各 instance 的地址不一起加上 immutable ，是因為若加上了，這些地址就不能在 constructor() 中被使用

p.s. 由於 gist 沒有 Solidity 的 syntax highlighting，所以隨便用了 .js 請忽略

看完了初始設定後，由於我們目前鎖定的資金池是 Dai 及 ETH，因此使用如下的 addLiquidityETH() 此函式，可以直接匯入 ETH 及 Dai。

本處我使用長度為 3 的陣列 addLiquidityResult 來記錄注入資金後的返回值：注入 Ether 的數量、Dai 的數量及返回的 Uniswap 流動性代幣的數量。實際上應該要依照不同使用者記錄的他們執行 addLiquidity() 後各自的返還值

第五行中的 approve() 是為了讓 UniswapV2Router01 的合約能夠從我們部署的合約 UniswapImplementation 取得 200 Dai 的使用權

於第六行 addLiquidityETH() 後方的大括號 {value: ETHAmount}，這是 Solidity 0.6.0 後版本如果要在呼叫 function 的同時送入 Ether 的標準寫法，以前的寫法 .value() 目前也還能用但 compiler 會給提示

addLiquidityETH() 的第三、四個參數為最少要成功注入的數量。使用者能夠成功注入的數量取決於資金池中兩虛擬貨幣當下的數量，而本處直接給 0 比較方便

這邊非常重要的是上述程式碼還欠缺了一個無法被寫在合約內的步驟：使用者要同意這個被部署的合約 UniswapImplementation 可以從自己的帳戶中轉出 200 Dai。因此，將 ERC20 (Dai) 部署在 Rinkeby 上的位置，也就是0x5592EC0cfb4dbc12D3aB100b257153436a1f0FEa，接著輸入被部署合約的地址以及 200 Dai = 200000000000000000000、按下 approve() 後準備作業完成，如下圖。

終於可以呼叫 addLiquidity() 了! 如下圖，在紅框中以 1 Ether 呼叫黑框中的 addLiquidity() 後，就能成功將資金注入到 liquidity pool 了! 由於本文寫在測試後，因此沒有留下第一次 addLiquidity() 的結果 :(

此處被部署的合約位置跟上方截圖不同，因為其中測試了一些東西所以重新部署qq

接著，可以拿出 IUniswapV2Pair.sol，將其部署在 三. 創建交易對 中成功部署的位置 0x03E6c12eF405AC3F642B9184eDed8E1322de1a9e，使用黑框中的 getReserves() 就可以看到資金池中確實有匯入的資金! (本處依然沒有第一次使用後的截圖，因此截圖只是為了讓讀者看到 getReserves() 的結果)

此圖黑框中的值代表：在資金池中，Dai的數量、Ether的數量及上一次匯入資金的時間戳記

- 注意事項

使用 addLiquidity() 時需要小心的地方是：除了第一筆注入的資金可以自行決定兩虛擬貨幣的數量，第二筆開始就會依照其演算法算出兩幣可以投入的各自數量，因此使用者放入的兩幣中可能會有部分的其中一幣被 Uniswap 返回。

上方的程式碼只是為了第一筆流動性所寫，如果不是第一筆的情況就需要用成功注入流動性後的返回值(例如筆者的作法是用一陣列 addLiquidityResult 來存結果)來把沒有成功注入的資金返回給使用者。

五. 兌換虛擬貨幣

本節使用的兌換功能依舊是來自 IUniswapV2Router01.sol。

由於兌換虛擬貨幣實際上只有五行不到的程式碼，那麼就來把兌換 Ether 而得到的 Dai… 投到 Compound 來賺取放款利息吧! (雖然只是在測試網) 如果覺得這個場景似曾相識，沒錯，這就是上面提到的 輕鬆貸 EasyDai 的不專業版本!

首先將 Ether 和 Dai 互換的邏輯完成：

Ether 換 Dai : 使用 swapExactETHForTokens()，給某數量的 Ether 能換多少 Dai 是多少

Dai 換 Ether : 使用 swapExactTokensForETH()，作法只差在要把 Dai 轉到當前合約，再同意 UniswapV2Router01 可以從當前合約把 Dai 轉走

兩個做法的第二個參數都是可以自行指定兌換的路徑，此處就直接給 WETH 和 Dai 的地址即可(順序有差)。需要注意的是這個路徑要是動態陣列 dynamic array，而這就是 Vyper 所不支援的功能! 動態陣列跟靜態陣列宣告方式的差別我有註解在程式碼中

此處就先來試試 Dai 換 Ether 吧!和上方一樣，在使用時也要先 approve() 當前合約，當前合約才能轉走使用者的 Dai。

由上方的截圖可以很清楚的看到 Dai 換 Ether 這個動作牽涉到的資金轉移路徑：

Dai: 我的帳戶→當前合約→交易對所在合約

WETH: 交易對所在合約→UniswapV2Router01

Ether: WETH 合約→UniswapV2Router01→我的帳戶

以上的路徑有些人稍微思考後可能會納悶：為什麼上方沒有一筆 WETH 從 UniswapV2Router01 再轉到 WETH 合約的動作呢? 這就是在 Wrapped Ether (WETH) ? 中提到的案例。原因是：把 WETH 還回 WETH 的合約時實際上使用的函示是 withdraw() 而非 transfer()，而在 WETH 合約中發生的只是把使用者 WETH 擁有的額度歸零或減少而已。

接下來就是把 Dai 轉到 Compound 的部分。由於 Compound 不是本文重點，此處只求功能正常，因此比起真正的實作方法當然是簡化許多。

一如往常初始化 Compound 合約的 instance

ETH 換 Dai 後放入 Compound : 將用 ETH 換得的 Dai 的數量，也就是 swapExactETHForTokens() 返回的第二個值，approve() Compound 的合約後就可以用 mint() 匯入了! 要注意的是，ETH 換成 Dai 後的收款地址(第四個參數)是當前合約，才能從此合約轉 Dai 到 Compound

還款給使用者: 用 redeem() 取出 Dai，一如往常同意 UniswapV2Router01 使用 Dai 的權力

之所以說這個程式碼不能真的拿來用是因為：cDai 轉給使用者、讓使用者自己持有是比較安全的作法；即使選擇把 cDai 留在當前合約，以上程式碼檢查 cDai 數量是用當前合約 address(this) 去檢查，實際上應該要去記錄每個使用者所擁有的 cDai 數量

最後附上截圖，可以看一下資金的轉移路徑：

ETH -> WETH -> Dai -> cDai (Compound)

cDai -> Dai -> WETH -> ETH

六. 取得報價作為預言機

若使用 Uniswap v1的報價作為預言機，攻擊者可以利用其演算法造成的滑點來操控價格。為此，Uniswap v2 提供了兩個加入時間權重的合約範例：

ExampleOracleSimple.sol : 簡單版

ExampleSlidingWindowOracle.sol : 複雜版；Sliding Window 在此場景是指透過改變擷取資料(歷史價格)的片段，用該特定期間的價格來做成時間權重，讓使用上更靈活!

本處以簡單版為例。打開 ExampleOracleSimple.sol，由於一些匯入檔案的問題我將 UniswapV2OracleLibrary 也放在這份檔案中。

做法非常簡單：將 UniswapV2Factory、Dai 及 WETH 所在的地址作為部署合約 ExampleOracleSimple 時的輸入值就完成了。部署成功後會有個 24 小時的鎖 Time lock，因為這個預言機是有時間權重的，所以並不是一部署完就能立刻使用。若要體驗更新價格此功能可以使用我部署的兩個，其位置我寫在註解中。

將 WETH 或是 Dai 的地址和要查詢的數量輸入 consult() 就能查到兩虛擬貨幣的價格：

1 ETH 價格約為 97 Dai

1 Dai 價格約為 0.01 ETH

然而，在測試網上我們沒辦法拿著預言機查到的價格套入演算法來核對，因為測試網上的 Uniswap 沒有啟用收費機制，而 k 值要在收費機制啟動時才能被計算，欲知詳情者就麻煩去看官方文件了!

七. 自行兌換 WETH

上方雖然有提到 WETH 在 Uniswap 中的使用原因及場合，但或許有人想試著自己動手將 Ether 換成 WETH、把 WETH 換回 Ether。方法非常簡單，將 WETH.sol 部署到 0xc778417E063141139Fce010982780140Aa0cD5Ab 就能使用，如下圖：

按下綠框中的 At Address 後，使用下方黑框中的 deposit 搭配在中間的黑框輸入所要兌換 Ether 的量，就能成功換到 WETH。同理，圖中未顯示的 withdraw 功能就是讓人輸入 WETH 來換回等量的 Ether。

稍微提一下，如果是第一次兌換，將 WETH 所在的地址輸入 Metamask 就能在錢包中看到自己擁有的 WETH 的數量，如下兩圖：

Voila!

八. 結語

呼，雖然上述操作及程式碼的撰寫其實還蠻簡單的，但畢竟 Uniswap 的功能不少、我個人也希望能將小細節解釋清楚些，因此長度遠超過預期...有看到結尾處的讀者，辛苦了xD 希望大家現在對於 Uniswap v2 的內容跟實作方法都很清楚了!

最後，如果本文有任何錯誤，請不吝提出，我會盡快做修正；而如果我的文章有幫助到你，可以看看我的其他文章，歡迎一起交流 :)

田少谷 Shao - Medium

Uniswap v2 實作 : 從創建交易對到Ether 換 Dai 投入 Compound was originally published in Taipei Ethereum Meetup on Medium, where people are continuing the conversation by highlighting and responding to this story.

👏 歡迎轉載分享鼓掌

📜 [專欄新文章] 類 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.

👏 歡迎轉載分享鼓掌