Kimi的筆記

這篇會著重在erc20 smart contract實作mint跟burn的部分，所以需要先了解erc20喔！ erc20 token在設計上可以a.預先產生，b.產生部分然後部分用挖的(mint)或是c.都用挖的。當然在應用上跟token屬性有關，例如是屬於security token或是utility token。簡單來說，像是股票可以獲利或是配息概念的算是security token，需要受各國法令監管，那utility token就比較像是點數的概念，至於細節怎麼分不是本篇重點。 mint的使用時機，例如在crowd sale時，每一筆進入crowd sale的錢，crowd sale 的contract 就會呼叫token contract去產生某個數量的token，這個動作就可以稱作mint。也有不用挖的，一開始就產生好，例如秘銀（MITH），從etherscan可以看到token contract怎麼寫的，這裡可以看到 MITH的contract 。當然你想產多少就多少，不過就看有沒有人買單 ＸＤ 回到正題，要"挖"聽起來，就覺得很複雜，但其實smart contract的本質就是記帳，所以其實就只是數字上的加減而已，下面是範例程式 function mint(address _to, uint256 _amount) public { totalSupply_ = totalSupply_.add(_amount); balances[_to] = balances[_to].add(_amount); emit Mint(_to, _amount); } 其實就只是把 增加個人的token的數量 ，然後增 加整個contract token的總數 而已。當然，這種function需要做權限的控管，不然大家都可以自己產，token就會沒價值了。講完"挖"應該很好想像怎麼burn吧?! 就是把數量減掉就好了！(當然這也需要做權限控管) function _burn(address _who, uint256 _value) public { balances[_who] = balances[_who].sub(_value); totalSu...

版本 - truffle 4.1.11 一不小心，就寫到了III...沒有偷文章數的意思阿~~~ 不過我在這邊先破題，truffle的debug功能，還在發展中，其實沒有想像中的方便跟powerful，例如在debug的過程還滿常會發生exception的（這還滿常發生的）、 無法得知 global變數內容...等等。官方一樣有很詳細的解說，可以看 這裡 。 要debug其實很簡單，先複製你要debug的transaction hash，然後 $ truffle debug 0x1d8791c26e7aa941c295bed8ed81a3d5fb4790ed9f84a76e2d4341c6c4b09131 接著會看到指令 Commands: (enter) last command entered (step next) (o) step over, (i) step into, (u) step out, (n) step next (;) step instruction, (p) print instruction, (h) print this help, (q) quit (b) toggle breakpoint, (c) continue until breakpoint (+) add watch expression (`+:<expr>`), (-) remove watch expression (-:<expr>) (?) list existing watch expressions (v) print variables and values, (:) evaluate expression - see `v` o/i/u/n：一般有在用IDE debug的都知道，就不做解釋 +：可以加觀察的變數 v：就是顯示目前變數的值（global目前都是空值） 一步一步debug就會看到在哪行source code，像是這樣 Token777.sol: 277 : if (_to== address ( 0x00 )) return ; 278 : TokenReceiver x; 279 : if ( doesContractIm...

版本 - truffle 4.1.11 延續 上篇 ，繼續講測試的部分 寫test case有兩個方式，一個是用 solidity 另一個是用 javascript ，官方文件寫得還滿清楚的。記得你寫的test case的檔案，要放在 test/ 下 先介紹solidity的寫法，要先import下面這兩個smart contract，當然也要記得import你自己的smart contract import "truffle/Assert.sol" ; import "truffle/DeployedAddresses.sol" ; import "../contracts/Token777.sol" ;  再來是命名規則，contract要以  Test   為開頭，測試function要以  test  為開頭 contract TestTaroToken { function testMint () public { Token777 token = Token777 (DeployedAddresses. Token777 ()); address user = 0x2849f61e08B66A3b0eC2512613092174Df19Db1e ; uint base = token. balanceOf (user); uint incremental = 30000000000000000000 ; token. mint (user,incremental, "" ); Assert. equal (token. balanceOf (user), base+incremental, "balance is not equal" ); } } test case看起來相當直覺，就是先取得contract object後，呼叫mint（你想測試的function）這個function，最後用Assert確認結果，跟我們一般寫UT很相似。當然也有提供 beforeAll , beforeEach , afterAll 跟  afterEach...

今天來介紹一下truffle。 版本 - truffle 4.1.11     在我一開始踏入這個圈子的時候，是truffle是出testrpc這個工具，當時google了一下，有人說不好安裝設定，所以就選用了parity。parity對於初期開發還不錯用，有圖形化的介面，寫完的code直接部署，呼叫function有下拉式選單可以直接使用，event log也很清楚顯示。其實也滿推的，不過一開始不懂的時候，genesis 設定檔也是搞了一陣子（不過現在也沒多懂 XD）。     那parity既然這麼好用，幹嘛用truffle？truffle後來出了Ganache，一個圖形化的介面，會有transaction的列表，裡面會有input data （我覺得可惜的是沒有output event），還有log，可以看實際呼叫了哪個rpc call等一些資訊。但重要的安裝完後，點兩下直接就可以用，不需複雜的設定檔，對於單純只要開發smart contract的人來說，才是最方便的。     但是！這些都不是重點， 重點是truffle可以跑test cases跟逐步debug 。對！逐步，我跟同事分享，同事眼睛都亮起來了，因為在寫smart contract在debug部分其實挺麻煩的，雖然Remix也可以做到debug，但是class越多source file越多，在Remix上需要一個一個copy過去，就沒這麼方便。此外，寫test case這部分 對公司產品開發的流程上有很大的幫助，不用像我之前還傻傻的用web3j自己寫testing framework.....     這偏廢話有點多，接下來就介紹怎麼 寫test cases 跟 debug （安裝就不用講了吧，下載下來點兩下，下一步下一步下一步....我是用Windows XD），細節可以參考 這篇 ，官方說得滿清楚的，懶得看英文的可以繼續往下看     首先， 在Windows上不要使用Windows的cmd ，會有名稱問題，我是用Git的bash shell，然後下 truffle init 會在目錄下長出這些東西，其中Mirgrations.sol跟1_initial_migratio...

每次看完raw transaction的組法，都會忘記，所以紀錄一下 使用Web3元件呼叫smart contract的function，就我所知有兩個方法 ，一個是自己組成raw transaction，另一個是用web3j產生的 java wrapper呼叫（不過最終還是組成raw transaction）。在這邊就是要介紹raw transaction到底是怎麼組成的 首先，會先對function做encoding的動作，encoding完會長得下面這樣，一堆hex字串 以上圖來說，我對 addMember(address, bytes, bytes...) （參數太多，所以做省略）這個function做encoding，最前面是function的symbol，作sha3然後取前四個bytes keccak256("addMember(address,bytes,bytes,...)") // 0x 9400062b 56b462ed4e31c3f26b13ce3523a3881b5c19480da8856142e9b687d0 後面緊接著的就是參數了，這個很容易理解。更詳細的解釋可以參考 Inside an Ethereum transaction ，解釋得很清楚 接下來，就是把encoded function組成raw transaction了 組完的結果會像這樣 在原本的hex字串，頭尾加上一堆不知道幹嘛的字串， 本篇的重點就是在解釋這個字串 。 如果，讀者有看完上面那篇Inside an Ethereum transaction，就可以知道，其實transaction的組成是由 var rawTx = { nonce, gasPrice, gasLimit, to, value, data, signature }; 這裡的data就是encoded function，所以前面還有nonce, gas price, gas limit跟送給誰的地址，最後是加上signature。不過，如果你直接看，一定會納悶，感覺對但好像又不對，中間似乎穿插了莫名的值，這是因為Ethereum在做serialize的時候，選用RLP做enc...

Part II 拖得有點久... 其實產生出wrapper後，直接看source code，就大概懂怎麼使用了，web3j 直接把smart contract的function轉成Java function。接下來會解釋的就是怎麼load contract跟怎麼subscribe events。 備註：這裡的範例是用 web3j 3.1.1 所產生 How to load smart contract wrapper 首先，看到load的方法有兩個，其實只有差在Credentials跟TransactionManager public static Ballot load (String contractAddress , Web3j web3j , Credentials credentials , BigInteger gasPrice , BigInteger gasLimit) { return new Ballot(contractAddress , web3j , credentials , gasPrice , gasLimit) ; } public static Ballot load (String contractAddress , Web3j web3j , TransactionManager transactionManager , BigInteger gasPrice , BigInteger gasLimit) { return new Ballot(contractAddress , web3j , transactionManager , gasPrice , gasLimit) ;}   Credentials ：     這是Web3j的基本元件，大概沒什麼好說的（被揍飛 XD），還是附一下範例，基本就是帶入一串私鑰即可 Credentials cred = Credentials. create ( privatekey ); 如果，你的應用沒有需要快速連續送交易，或是不要求在listen event的間隔，其實這樣就可以了。但若有其中一項需求，這個方式就無法滿足，需要用TransactionManager。 TransactionMa...

本篇是在介紹，如何使用Web3j能快速開發Oracle，不用一個一個刻跟ABI互動的function 因為整個ethereum都還在發展中，相關的工具也是，所以變動很快，這邊我使用的是 Web3j 2.3.1 ，搭配 Solidity 0.4.17 不清楚Oracle的，可以參考 這篇 ，寫得相當詳細跟清楚 簡單來說，ＥＶＭ是一個封閉環境，不可跟外界接觸，不過event（可以想作是一般寫程式的log）是會被寫到鏈上的，寫到鏈上就代表是公開網路，大家都可以去讀取，再透過程式（也就是Oracle）去監聽特地的event。然後smart contract裡的function本來就是可以從外部被執行的。所以就是透過監聽event跟執行smart contract的function，進而從外界可以跟smart contract 做互動。 首先，先撰寫你自己的smart contract，下面這是我從官方copy過來的範例，然後加了兩個event，完整的smart contract可以看 這裡 pragma solidity ^ 0 . 4 . 17 ; contract Ballot { event EventVote ( uint id, address voter, uint time); event EventNewVoter ( address voter); function giveRightToVote ( address voter) { require (( msg . sender == chairperson) && ! voters[voter].voted && (voters[voter].weight == 0 )); voters[voter].weight = 1 ; EventNewVoter (voter); } function vote ( uint proposal) { Voter storage sender = voters[ msg . sender ]; require ( ! sender.voted); ...