[轉]EOS智能合約 & 私鏈激活 & 基本操做

連接：https://www.jianshu.com/p/90dea623ffdf

簡介

本篇文章，將跟你們介紹eos私鏈的激活、基礎智能合約的安裝，以及爲你們演示轉帳等基礎操做。尚未安裝eos私鏈的同窗，能夠參考我上篇文章，先搭建好私鏈。

智能合約

承接上篇文章，咱們啓動私鏈 —> 建立公私鑰對 —> 建立錢包 —> 將公私鑰對導入錢包 —> 建立user帳戶。有同窗會問，咱們何時能發交易、作一些轉帳等基本操做？那咱們就不得不提出一個新概念—智能合約。簡單來講，智能合約是條款以計算機語言而非平常語言或法律語言記錄的智能合同，其工做的基本原理相似於計算機程序的if-then語句，在預先設定的條件達成時，就自動執行相應的合同條款。

eos的全部功能，都是基於智能合約完成的。因此，若是咱們要激活私鏈，想在私鏈上完成轉帳等交易，就須要部署eos的基礎合約。eos有幾個比較重要的系統合約，是咱們必需要部署的：

- eosio.bios：eos的系統啓動合約。這個合約是eos不少命令的基礎合約，讓咱們能夠直接經過eosio帳戶控制eos私鏈

- eosio.token：eos的發幣合約。系統執行這個合約發行EOS，合約實現了指定代幣發行給哪一個帳戶、代幣最大發行量、轉帳方法等功能

- eosio.msig：eos的提案合約。EOS持有人可使用合約方法提出一個提案，其餘人能夠表決經過或者不經過這個提案，經過這個合約能實現交易的多重簽名方案

- eosio.system：eos的系統命令合約。這個合約幾乎實現了eos所有的系統命令，包括建立帳戶、資源質押、超級節點投票、域名競拍等功能

全部的系統合約都在eos/contracts目錄下面，這幾個合約內部的方法實現細節，我會單獨寫文章介紹，你們如今只須要大體記住它們的做用便可。

私鏈激活

咱們將模擬eos主網的部署啓動過程，對eos私鏈進行激活：建立一系列系統帳戶、部署一系列系統合約、發幣、選舉超級節點等，你們跟着我一步一步操做。

第一步，部署eosio.bios系統合約，部署帳戶爲eosio。

咱們須要使用cleos命令行工具部署智能合約

cd eos

cleos set contract eosio contracts/eosio.bios -p eosio

 

 

tips：

- 這個操做是將eosio.bios合約部署到了eosio帳戶上，-p是指定受權帳戶爲eosio。執行這個命令時，錢包必定要處於unlock狀態，方便調取eosio帳戶的私鑰。

- 執行cleos set contract時，可能會出現下面的報錯：

 

 

這是由於eos的虛擬機使用的是webassembly，智能合約源碼是用c++寫的，須要先編譯成wasm/wast文件，再部署到eos上面，才能被虛擬機執行。咱們使用eos自帶的工具eosiocpp去編譯源碼，這個工具在節點安裝時就已經安裝好了：

cd eos/contracts/eosio.bios

eosiocpp  -o  eosio.bios.wast   eosio.bios.cpp

第二步，建立一系列系統帳戶。

eos的系統帳戶是用來部署智能合約的，由eosio帳戶建立，有如下幾個帳戶：

- eosio.bpay：超級節點獲取出塊獎勵的臨時代管帳戶，增發EOS的1%的25%會先轉到這個帳戶

- eosio.msig：用來部署eosio.msig合約

- eosio.names：用來管理域名競拍

- eosio.ram：用來管理ram買賣

- eosio.ramfee：用來管理ram買賣產生的手續費，每筆買賣扣1%的手續費

- eosio.saving：增發EOS臨時存放帳戶，增發總量 5%，其中80%放在此帳戶，另外 20%再分紅25%和75%，分別給eosio.bpay和eosio.vpay

- eosio.stake：用來管理抵押換取cpu、net資源的EOS

- eosio.token：用來部署eosio.token合約

- eosio.vpay：節點們按照得到投票多少比例獲取獎勵的臨時代管帳戶，增發EOS的1%的75%會先轉到這個帳戶

使用cleos create key生成公私鑰對，再將私鑰導入錢包，最後執行cleos create account生成系統地址，忘記怎麼操做的同窗，請回顧我上篇內容中的錢包、帳戶部分。

cleos create key

cleos  wallet  import  -n  <wallet name>  --private-key  <private key>

cleos  create  account  eosio  <system account name>  <owner public key>  <active public key>

給你們舉個例子，展現eosio.token帳戶是怎麼建立的：

 

 

第三步，部署eosio.token合約，部署帳戶爲eosio.token。

cd eosio

cleos  set  contract  eosio.token  contracts/eosio.token  -p  eosio.token

第四步，部署eosio.msig合約，部署帳戶爲eosio.msig。

cd eos

cleos  set  contract  eosio.msig  contracts/eosio.msig  -p  eosio.msig

 

 

第五步，發佈EOS代幣，調用eosio.token帳戶下的eosio.token智能合約的create函數。

cleos  push  action  eosio.token  create  '[ "eosio", "1000000000.0000 EOS"]' -p eosio.token

 

 

tips：cleos push action命令，用來觸發eosio.token合約的create函數，代幣發行帳戶是eosio，發行量10億，代幣的符號是EOS。

第六步，將EOS資產打入eosio帳戶，調用eosio.token帳戶下的eosio.token智能合約的issue函數。

由於EOS的發行人是eosio帳戶，因此調用issue這個函數，須要eosio帳戶受權

cleos  push  action  eosio.token  issue  '[ "eosio", "1000000000.0000 EOS", "test message"]' -p eosio

 

 

第七步，部署eosio.system合約，部署帳戶爲eosio。

cd eos

cleos  set  contract  eosio  contracts/eosio.system  -p  eosio -x 1000

 

 

第八步，建立帳戶。

這裏咱們建立帳戶，將使用cleos system newaccount命令，這是eos上建立普通帳戶所用的命令，底層實際上調用的是eosio.system合約的newaccount函數。以前提到的cleos create account命令，實際上是爲了eosio帳戶建立系統帳戶提供的命令，須要特殊權限才能執行。

cleos system newaccount  <account to pay for create cost>  <new account name> <owner public key> <active public key>  --stake-net <amount> --stake-cpu  <amount> --buy-ram  <amount>

eosio帳戶建立了一個帳戶voter1，爲這個新帳戶抵押了20000EOS、20000EOS去換取cpu和net資源，付費20000EOS爲這個帳戶買了ram資源。

 

 

tips：

- 新建立的帳戶，須要抵押必定的EOS去換取cpu、net資源，須要花費必定EOS去買ram資源，用於交易的發送。用於抵押cpu和net的EOS是能夠贖回的，贖回須要3天時間。

- 資源的分配是按比例的。好比，抵押全網1%的eos，就能夠換取全網1%的cpu或者net資源。

- cpu和net資源是可再生的，使用後一天就可恢復，ram是不可再生資源，用完得再買。

第九步，投票選舉超級節點

上一步，咱們建立兩個帳戶voter1和bp1。eos的主鏈或者私鏈，初始的時候都是被系統帳戶eosio控制的。可是，若是想要激活eos的全部功能，則必須投票選舉超級節點，且全網投票必須超過發行總量的15%，即1.5個億。主鏈上是選舉21個超級節點，它們輪流出塊。私鏈上，咱們只須要選舉一個超級節點，讓它出塊便可。下面，咱們將爲你們演示超級節點的選舉過程。

1）eosio將1.5億EOS轉帳給voter1

cleos  transfer  eosio  voter1  "150000000.0000 EOS"  -p  eosio

 

 

2）voter1將EOS抵押爲cpu、net資源，由於只有抵押爲資源的EOS才能用於投票。

cleos  system  delegatebw  voter1  voter1  "150000000.0000 EOS"  "0 EOS"

咱們抵押了1.5億 EOS去換cpu資源，0 EOS去換net資源。cleos  system  delegatebw命令詳情以下，from是出抵押的EOS的帳戶，to是接收抵押資源的帳戶，stake_net_quantity和stake_cpu_quantity是抵押EOS的金額：

 

 

 

 

3）將bp1註冊爲超級節點，只有註冊的帳戶，其餘帳戶才能給它投票

cleos  system  regproducer  bp1  <bp1's public key>

 

 

4）voter1投票給bp1，這裏的投票是帳戶行爲，等於將voter1抵押的所有EOS都投給了bp1

cleos  system  voteproducer  prods  voter1  bp1

 

 

這步執行完畢後，私鏈就算激活了，這時你會發現eosio帳戶已經不能出塊了，咱們須要修改配置文件config.ini，將producer-name替換爲bp1，signature-provider換成bp1的公私鑰對，而後執行nodeos重啓節點，這時就是bp1負責出塊了

 

 

基本操做

激活了私鏈以後，咱們就解鎖了eos所有的功能。下面，我將爲你們介紹下EOS上的基本操做，如：查詢帳戶詳情、轉帳、質押資源、投票、查詢帳戶餘額等

帳戶相關

1）查詢帳戶，這個命令能夠看到帳戶的基本權限、cpu和net的質押和使用狀況

cleos get account <account name>

 

 

2）轉帳

cleos transfer <from account>  <to account>  <amount>  <transfer message>

 

 

3）查詢帳戶餘額

cleos get currency balance <發幣合約部署的帳戶>  <account name>  <代幣符號>

 

 

4）質押EOS換取cpu、net資源

cleos system delegatebw <from account>  <to account>  <amount of EOS for cpu>  <amount of EOS for net>

from account和to account相同時，是本身給本身質押資源；不一樣時，是其餘帳戶幫忙質押資源給本身。

 

 

5）取消資源質押

cleos  system undelegatebw  <from account>  <to account>  <amount of EOS for cpu>  <amount of EOS for net>

 

 

6）查看待贖回的資源

取消質押後，EOS並不會立刻回到帳戶餘額裏，須要等待三天。這時能夠在refunds表裏查看待贖回的資源。

cleos get table <合約部署帳戶> <account name> refunds

 

 

7）手動觸發refund

若是三天後發現EOS還沒回到餘額裏，則須要手動觸發refund函數。undelegatebw命令，本質上是在函數裏延遲三天調用refund函數，屬於合約調合約，有失敗的可能。這裏我很少作解釋，從此會專門寫一篇文章具體介紹。refund函數屬於eosio.system合約，因此須要使用cleos push action命令：

cleos push action eosio refund '["account"]'   -p account

由於沒到3天就觸發refund，節點的輸出日誌會報錯，須要等待

 

 

 

 

投票相關

1）註冊爲候選超級節點，註冊以後其餘帳戶才能爲其投票

cleos system regproducer <account name> <public>

 

 

2）爲超級節點投票

cleos  system  voteproducer  prods <account name>  <account you want to vote>

 

 

3）查看超級節點投票狀況

cleos system listproducers