以太坊客戶端go-thereum本地編譯及使用

chaors發表於2018-04-25

前言

比特幣是區塊鏈技術應用最成功的一個專案,也被業界公認為區塊鏈1.0技術。隨著區塊鏈技術的普及和發展,出現了以太坊智慧合約。

以太坊是一個建立在區塊鏈技術之上的去中心化應用平臺。我們可以在這個平臺上建立使用區塊鏈技術的去中心化應用。

可以這樣理解,以太坊就好比一個開發平臺(例如執行安卓程式的Android系統),基於區塊鏈技術的去中心化應用就好比Android系統上執行的Android應用。

這篇文章開始,將在本地編譯以太坊原始碼。並且,初步地學習基於命令列的以太坊客戶端基本使用。

本地編譯

專案初窺

開啟Ethereum的github地址:

Ethereum客戶端有兩種實現方式:go語言和c++。我們這裡選擇最常使用的go原因客戶端。

Ethereum專案

安裝準備

  • 1.go開發環境
  • 2.Homebrew
  • 3.Xcode環境

安裝geth(go-ethereum)

//安裝geth
brew tap ethereum/ethereum
brew install ethereum

cd ...
//遠端拉取go-ethereum專案
git clone https://github.com/ethereum/go-ethereum
cd .../go-ethereum
//make
make geth
複製程式碼

等待一會,ethereum本地編譯就完成了。接著就可以在命令列啟動並使用ethereum客戶端。

geth使用方法

基本使用範例

//1.從測試網路啟動一個以太坊網路節點
geth --datadir testNet --dev console 2>> test.log

//2.檢視賬戶,系統會有一個預設的賬戶
eth.accounts

//3.檢視餘額,由於是測試網路  預設賬戶會有大量的餘額
eth.getBalance(eth.accounts[0])

//4.建立新賬戶,使用者名稱為chaors  可以用2檢視
personal.newAccount("chaors")

//5.給新使用者轉賬 從一個地址轉給另一個地址9個以太幣
eth.sendTransaction({from:'0x4ca5da2d66d9bf9074bd2fd097f468d92cd15d17',to:'0x67588df863e337e78b290cb77809197de1b2fc38',value:web3.toWei(9,"ether")})
複製程式碼

基本使用示例

geth常用API

啟動geth後我們在進入js控制檯時候,會有一個提示,最下方列出了geth所有可以使用的模組:

...
modules: admin:1.0 clique:1.0 debug:1.0 eth:1.0 miner:1.0 net:1.0 personal:1.0 
rpc:1.0 shh:1.0 txpool:1.0 web3:1.0

複製程式碼

在js控制檯輸入任何一個模組名,都會列出該模組下所有的屬性和函式。這樣我們在使用geth的時候可以將模組名當做一個粗略的API說明,詳細參閱官方文件

使用模組粗略查詢API :

eth模組

personal模組

geth命令詳解

//命令格式
geth [選項] 命令 [命令選項] [引數…]

//主要命令
account           管理賬戶
attach            啟動互動式JavaScript環境(連線到節點)
bug               上報bug Issues
console           啟動互動式JavaScript環境
copydb            從資料夾建立本地鏈
dump              Dump(分析)一個特定的塊儲存
dumpconfig        顯示配置值
export            匯出區塊鏈到檔案
import            匯入一個區塊鏈檔案
init              啟動並初始化一個新的創世紀塊
js                執行指定的JavaScript檔案(多個)
license           顯示許可資訊
makecache         生成ethash驗證快取(用於測試)
makedag           生成ethash 挖礦DAG(用於測試)
monitor           監控和視覺化節點指標
removedb          刪除區塊鏈和狀態資料庫
version           列印版本號
wallet            管理Ethereum預售錢包
help,h            顯示一個命令或幫助一個命令列表

//ETHEREUM選項
--config value          TOML 配置檔案
–-datadir “xxx”         資料庫和keystore金鑰的資料目錄
–-keystore              keystore存放目錄(預設在datadir內)
--nousb                 禁用監控和管理USB硬體錢包
–-networkid value       網路識別符號(整型, 1=Frontier, 2=Morden (棄用), 3=Ropsten, 4=Rinkeby) (預設: 1)
–-testnet               Ropsten網路:預先配置的POW(proof-of-work)測試網路
--rinkeby               Rinkeby網路: 預先配置的POA(proof-of-authority)測試網路
--syncmode "fast"       同步模式 ("fast", "full", or "light")
--ethstats value        上報ethstats service  URL (nodename:secret@host:port)
--identity value        自定義節點名
--lightserv value       允許LES請求時間最大百分比(0 – 90)(預設值:0) 
--lightpeers value      最大LES client peers數量(預設值:20)
--lightkdf              在KDF強度消費時降低key-derivation RAM&CPU使用

//開發者選項
--dev                   使用POA共識網路,預設預分配一個開發者賬戶並且會自動開啟挖礦。
--dev.period value      開發者模式下挖礦週期 (0 = 僅在交易時) (預設: 0)

//ETHASH選項
--ethash.cachedir               ethash驗證快取目錄(預設 = datadir目錄內)
--ethash.cachesinmem value      在記憶體儲存的最近的ethash快取個數  (每個快取16MB ) (預設: 2)
--ethash.cachesondisk value     在磁碟儲存的最近的ethash快取個數 (每個快取16MB) (預設: 3)
--ethash.dagdir ""              存ethash DAGs目錄 (預設 = 使用者hom目錄)
--ethash.dagsinmem value        在記憶體儲存的最近的ethash DAGs 個數 (每個1GB以上) (預設: 1)
--ethash.dagsondisk value       在磁碟儲存的最近的ethash DAGs 個數 (每個1GB以上) (預設: 2)

//交易池選項
--txpool.nolocals            為本地提交交易禁用價格豁免
--txpool.journal value       本地交易的磁碟日誌:用於節點重啟 (預設: "transactions.rlp")
--txpool.rejournal value     重新生成本地交易日誌的時間間隔 (預設: 1小時)
--txpool.pricelimit value    加入交易池的最小的gas價格限制(預設: 1)
--txpool.pricebump value     價格波動百分比(相對之前已有交易) (預設: 10)
--txpool.accountslots value  每個帳戶保證可執行的最少交易槽數量  (預設: 16)
--txpool.globalslots value   所有帳戶可執行的最大交易槽數量 (預設: 4096)
--txpool.accountqueue value  每個帳戶允許的最多非可執行交易槽數量 (預設: 64)
--txpool.globalqueue value   所有帳戶非可執行交易最大槽數量  (預設: 1024)
--txpool.lifetime value      非可執行交易最大入隊時間(預設: 3小時)

//賬戶選項
––unlock value              需解鎖賬戶用逗號分隔
––password value            用於非互動式密碼輸入的密碼檔案


//API和控制檯選項
––rpc                       啟用HTTP-RPC伺服器
––rpcaddr value             HTTP-RPC伺服器介面地址(預設值:“localhost”)
––rpcport value             HTTP-RPC伺服器監聽埠(預設值:8545)
––rpcapi value              基於HTTP-RPC介面提供的API
––ws                        啟用WS-RPC伺服器
––wsaddr value              WS-RPC伺服器監聽介面地址(預設值:“localhost”)
––wsport value              WS-RPC伺服器監聽埠(預設值:8546)
––wsapi  value              基於WS-RPC的介面提供的API
––wsorigins value           websockets請求允許的源
––ipcdisable                禁用IPC-RPC伺服器
––ipcpath                   包含在datadir裡的IPC socket/pipe檔名(轉義過的顯式路徑)
––rpccorsdomain value       允許跨域請求的域名列表(逗號分隔)(瀏覽器強制)
––jspath loadScript         JavaScript載入指令碼的根路徑(預設值:“.”)
––exec value                執行JavaScript語句(只能結合console/attach使用)
––preload value             預載入到控制檯的JavaScript檔案列表(逗號分隔)

//網路選項
––bootnodes value           用於P2P發現引導的enode urls(逗號分隔)(對於light servers用v4+v5代替)
--bootnodesv4 value         用於P2P v4發現引導的enode urls(逗號分隔) (light server, 全節點)
--bootnodesv5 value         用於P2P v5發現引導的enode urls(逗號分隔) (light server, 輕節點)
-–port value                網路卡監聽埠(預設值:30303)
-–maxpeers value            最大的網路節點數量(如果設定為0,網路將被禁用)(預設值:25)
-–maxpendpeers value        最大嘗試連線的數量(如果設定為0,則將使用預設值)(預設值:0)
-–nat value                 NAT埠對映機制 (any|none|upnp|pmp|extip:<IP>) (預設: “any”)
-–nodiscover                禁用節點發現機制(手動新增節點)
-–v5disc                    啟用實驗性的RLPx V5(Topic發現)機制
-–nodekey value             P2P節點金鑰檔案
-–nodekeyhex value         十六進位制的P2P節點金鑰(用於測試)

//礦工選項
––mine                  開啟挖礦
––minerthreads value    挖礦使用的CPU執行緒數量(預設值:8)
––etherbase value       挖礦獎勵地址(預設=第一個建立的帳戶)(預設值:“0”)
––targetgaslimit value  目標gas限制:設定最低gas限制(低於這個不會被挖?) (預設值:“4712388”)
––gasprice value        挖礦接受交易的最低gas價格
––extradata value       礦工設定的額外塊資料(預設=client version)

//GAS選項
--gpoblocks value       用於檢查gas價格的最近塊的個數  (預設: 10)
--gpopercentile value   建議gas價參考最近交易的gas價的百分位數,(預設: 50)

//除錯選項
––metrics                   啟用metrics收集和報告
––fakepow                   禁用proof-of-work驗證
––verbosity value           日誌詳細度:0=silent, 1=error, 2=warn, 3=info, 4=debug, 5=detail (default: 3)
––vmodule value             每個模組詳細度:以 <pattern>=<level>的逗號分隔列表 (比如 eth/*=6,p2p=5)
––backtrace value           請求特定日誌記錄堆疊跟蹤 (比如 “block.go:271”)
--debug                     突出顯示呼叫位置日誌(檔名及行號)
––pprof                     啟用pprof HTTP伺服器
––pprofaddr value           pprof HTTP伺服器監聽介面(預設值:127.0.0.1)
––pprofport value           pprof HTTP伺服器監聽埠(預設值:6060)
––memprofilerate value      按指定頻率開啟memory profiling    (預設:524288)
––blockprofilerate value    按指定頻率開啟block profiling    (預設值:0)
––cpuprofile value          將CPU profile寫入指定檔案
––trace value               將execution trace寫入指定檔案


//WHISPER選項
––shh                        啟用Whisper
––shh.maxmessagesize value   可接受的最大的訊息大小 (預設值: 1048576)
––shh.pow value              可接受的最小的POW (預設值: 0.2)

複製程式碼

這樣,Ethereum客戶端的本地編譯和基本使用就告一段落。下一篇我們就可以來簡單地寫一個基於以太坊的智慧合約

參考資料

. . . .

網際網路顛覆世界,區塊鏈顛覆網際網路!

--------------------------------------------------20180424 22:01

相關文章