EOS開發環境安裝搭建
EOSIO構成組件
EOSIO是由三個component組成的。
- nodeos:管理區塊鏈節點的組件。
- keosd:管理錢包的組件。
- cleos:控制區塊鏈和錢包CLI工具。
安裝EOSIO
此文檔以MacOS Darwin 10.12為基準。
在EOSIO的github庫下載源碼。
$ git clone https://github.com/EOSIO/eos --recursive
要安裝xcode和homebrew代碼。如果還沒有安裝的情況,先設置xcode
和homebrew
。
- xcode : https://developer.apple.com/xcode/
- homebrew : https://brew.sh
源代碼包含構建腳本及構建實現。
$ cd eos
$ ./eosio_build.sh
如果成功的話,就會出現下面的信息。
[100%] Linking CXX executable unit_test [100%] Built target unit_test _______ _______ _______ _________ _______ ( ____ \( ___ )( ____ \\__ __/( ___ ) | ( \/| ( ) || ( \/ ) ( | ( ) | | (__ | | | || (_____ | | | | | | | __) | | | |(_____ ) | | | | | | | ( | | | | ) | | | | | | | | (____/\| (___) |/\____) |___) (___| (___) | (_______/(_______)\_______)\_______/(_______) EOSIO has been successfully built. 00:11:21 To verify your installation run the following commands: /usr/local/bin/mongod -f /usr/local/etc/mongod.conf & cd /Users/scion/git/eos/build; make test For more information: EOSIO website: https://eos.io EOSIO Telegram channel @ https://t.me/EOSProject EOSIO resources: https://eos.io/resources/ EOSIO Stack Exchange: https://eosio.stackexchange.com EOSIO wiki: https://github.com/EOSIO/eos/wiki
解決問題
- 如果build過程中出現這樣的error時:
CMake Error at /usr/local/Cellar/cmake/3.11.3/share/cmake/Modules/FindPackageHandleStandardArgs.cmake:137 (message): Failed to find Gettext libintl (missing: Intl_INCLUDE_DIR) Call Stack (most recent call first): /usr/local/Cellar/cmake/3.11.3/share/cmake/Modules/FindPackageHandleStandardArgs.cmake:378 (_FPHSA_FAILURE_MESSAGE) /usr/local/Cellar/cmake/3.11.3/share/cmake/Modules/FindIntl.cmake:47 (FIND_PACKAGE_HANDLE_STANDARD_ARGS) programs/cleos/CMakeLists.txt:29 (find_package)
應該是homebrew
的gettext
連接到了不正確的版本,更改連接信息就可以了:
$ brew link gettext — force
在環境變量文件(~/.profile)
添加gettoxt path
:
export PATH=”/usr/local/opt/gettext/bin:$PATH”
參考:https://github.com/EOSIO/eos/issues/2174
- 也有可能發生這種情況:
Mac OS 10.13.3 build error “path mongo-cxx-driver already exists”
這樣解決:
sudo rm -rf /tmp/mongo*
cd /path/to/eos
rm -rf build/
git pull
git submodule update — init — recursive
./eosio_build.sh
參考:https://github.com/EOSIO/eos/issues/3197
驗證
安裝順利完成。為了驗證,執行下測試腳本。
$ /usr/local/bin/mongod -f /usr/local/etc/mongod.conf &
$ cd build/
$ make test
Running tests...
Test project /Users/scion/git/eos/build
Start 1: test_cypher_suites
1/35 Test #1: test_cypher_suites ................... Passed 0.04 sec
Start 2: validate_simple.token_abi
2/35 Test #2: validate_simple.token_abi ............ Passed 0.08 sec
Start 3: validate_eosio.token_abi
...
34/35 Test #34: restart-scenarios-test-hard_replay ... Passed 151.83 sec
Start 35: validate_dirty_db_test
35/35 Test #35: validate_dirty_db_test ............... Passed 4.42 sec
100% tests passed, 0 tests failed out of 35
下面完成安裝:
$ cd build
$ sudo make install
運行EOSIO
試著運行EOSIO的組件吧。這是為了構建開發環境,所以可以先用一個節點。
nodeos
用帶有option
的命令直接執行就行了
$ nodeos -e -p eosio --plugin eosio::chain_api_plugin --plugin eosio::history_api_plugin
其中:
- e : 區塊生成
- p eosio : 區塊生產者名稱
— plugin eosio::chain_api_plugin : 區塊鏈相關API插件
— plugin eosio::history_api_plugin : 歷史記錄相關API插件
可以用配置文件替換參數。
- config file位置:
~/Library/Application Support/eosio/nodeos/config/config.ini
- 當
nodeos
第一次運行時,該文件自動生成。
$ vi ~/Library/Application\ Support/eosio/nodeos/config/config.ini
...
# enable-stale-production = false
enable-stale-production = true
...
# producer-name =
producer-name = eosio
...
plugin = eosio::chain_api_plugin
plugin = eosio::history_api_plugin
...
執行nodeos
:
$ nodeos
如果運行正常,可以看到在控制臺上0.5秒生成block的信息。
為了確認nodeos
是否正常運行,讓我們試試應用程序API接口。
在運行於8888
端口的應用軟件服務上試試HTTP Request
:
$ curl -k -v ‘http://127.0.0.1:8888/v1/chain/get_info‘ -X GET
Note: Unnecessary use of -X or --request, GET is already inferred.
* Trying 127.0.0.1...
* TCP_NODELAY set
* Connected to 127.0.0.1 (127.0.0.1) port 8888 (#0)
> GET /v1/chain/get_info HTTP/1.1
> Host: 127.0.0.1:8888
> User-Agent: curl/7.54.0
> Accept: */*
>
< HTTP/1.1 200 OK
< Connection: close
< Content-Length: 529
< Content-type: application/json
< Server: WebSocket++/0.7.0
<
{"server_version":"012dc012","chain_id":"cf057bbfb72640471fd910bcb67639c22df9f92470936cddc1ade0e2f2e7dc4f","head_block_num":363,"last_irreversible_block_num":362,"last_irreversible_block_id":"0000016ad0238cef2f6a8de2098115ba155cbbc535122912a7a62f66097adbd6","head_block_id":"0000016b8cbb9154a759f2e61968fc1069fcf0ef9468886614d0538a97d96c61","head_block_time":"2018-06-12T07:10:59","head_block_producer":"eosio","virtual_block_cpu_limit":287075,"virtual_block_net_limit":1506023,"block_cpu_limit":199900,"block_net_limit":1048576}
或是利用cleos
命令執行。
$ cleos get info
{
"server_version": "012dc012",
"chain_id": "cf057bbfb72640471fd910bcb67639c22df9f92470936cddc1ade0e2f2e7dc4f",
"head_block_num": 580,
"last_irreversible_block_num": 579,
"last_irreversible_block_id": "000002436a1baaeb366b55995ddad7de0822f177d60a8c6e336e3f5fcb18ecc5",
"head_block_id": "00000244e6923239c0649ddada0dd47a2df80df13fa825275df9ddac975e6162",
"head_block_time": "2018-06-12T07:12:48",
"head_block_producer": "eosio",
"virtual_block_cpu_limit": 356561,
"virtual_block_net_limit": 1871085,
"block_cpu_limit": 199900,
"block_net_limit": 1048576
}
keosd
同樣用帶有option
的命令直接執行就行了
$ keosd — http-server-address=127.0.0.1:8900
- http-server-address : REST API,
nodeos
默認端口是8888。cleos
默認端口考慮使用8900,URL不可用。
只能通過替換keosd
配置文件選項來運行。
- 配置文件位置:
~/eosio-wallet/config.ini
。 - 第一次
keosd
操作,文件自動生成。
$ vi ~/eosio-wallet/config.ini
# http-server-address = 127.0.0.1:8888
http-server-address = 127.0.0.1:8900
執行keosd
:
$ keosd
在運行於8900
端口的應用軟件服務上試試HTTP Request
:
$ curl -k -v ‘http://127.0.0.1:8900/v1/wallet/list_wallets‘ -X GET
Note: Unnecessary use of -X or — request, GET is already inferred.
* Trying 127.0.0.1…
* TCP_NODELAY set
* Connected to 127.0.0.1 (127.0.0.1) port 8900 (#0)
> GET /v1/wallet/list_wallets HTTP/1.1
> Host: 127.0.0.1:8900
> User-Agent: curl/7.54.0
> Accept: */*
>
< HTTP/1.1 200 OK
< Connection: close
< Content-Length: 2
< Content-type: application/json
< Server: WebSocket++/0.7.0
<
[]
或者使用cleos
命令運行:
$ cleos wallet list
Wallets:
[]
nodeos
和keosd
可以正常工作,現在可以使用EOSIO服務了。
參考文件是EOSIO官方wiki文檔,參考了本地環境的安裝。
另:《EOS智能合約與DApp開發入門》教程已經上線,愛學習等不及的可以抓緊體驗一下:
EOS教程
EOS開發環境安裝搭建