1.入门文档
https://developers.eos.io/eosio-home/docs
Linux / Mac OS体验
EOSIO软件支持以下环境:
Amazon 2017.09 and higher
Centos 7
Fedora 25 and higher (Fedora 27 recommended)
Mint 18
Ubuntu 16.04 (Ubuntu 16.10 recommended)
Ubuntu 18.04
MacOS Darwin 10.12 and higher (MacOS 10.13.x recommended)
安装二进制文件
本教程将使用预构建的二进制文件。为了让您尽快开始,这是最好的选择。从源代码构建是一个选项,但会让您回到一个小时或更长时间,并且可能会遇到构建错误。
以下命令将下载各个操作系统的二进制文件。
如果您以前安装了EOSIO,请eosio_uninstall在下载和使用二进制版本之前运行脚本(它位于您克隆EOSIO的目录中)。
Mac OS X Brew安装
$ brew tap eosio / eosio
$ brew install eosio
Mac OS X Brew卸载
$ brew删除eosio
Ubuntu 18.04 Debian软件包安装
$ wget https://github.com/eosio/eos/releases/download/v1.5.2/eosio_1.5.2-1-ubuntu-18.04_amd64.deb
$ sudo apt install ./eosio_1.5.2-1-ubuntu-18.04_amd64.deb
Ubuntu 16.04 Debian软件包安装
$ wget https://github.com/eosio/eos/releases/download/v1.5.2/eosio_1.5.2-1-ubuntu-16.04_amd64.deb
$ sudo apt install ./eosio_1.5.2-1-ubuntu-16.04_amd64.deb
Debian软件包卸载
$ sudo apt删除eosio
Centos RPM软件包安装
$ wget https://github.com/eosio/eos/releases/download/v1.5.2/eosio-1.5.2-1.el7.x86_64.rpm
$ sudo yum install ./eosio-1.5.2-1.el7.x86_64.rpm
Centos RPM软件包卸载
$ sudo yum删除eosio.cdt
Fedora RPM软件包安装
$ wget https://github.com/eosio/eos/releases/download/v1.5.2/eosio-1.5.2-1.fc27.x86_64.rpm
$ sudo yum install ./eosio-1.5.2-1.fc27.x86_64.rpm
Fedora RPM软件包卸载
$ sudo yum删除eosio.cdt
开发调试环境搭建
nodeos:管理区块链节点的组件。
keosd:管理钱包的组件。
cleos:控制区块链和钱包CLI工具。
第一步:用Git克隆,下载EOS的源代码
git clonehttps://github.com/EOSIO/eos --recursive
要安装xcode和homebrew代码。如果还没有安装的情况,先设置xcode和homebrew。
xcode : https://developer.apple.com/xcode/
homebrew : https://brew.sh
更换为中科大的镜像源
cd /usr/local/Homebrew
git remote set-url origin http://mirrors.ustc.edu.cn/homebrew.git
cd ~ mkdir tmp cd tmp git clone http://mirrors.ustc.edu.cn/homebrew.git
sudo mv /usr/local/.git /usr/local.git_old
sudo mv /usr/local/Library /usr/local/Library_old
sudo cp -R homebrew/.git /usr/local/
sudo cp -R homebrew/Library /usr/local/
源代码包含构建脚本及构建实现。
cd eos
./eosio_build.sh
[图片上传失败...(image-88fe66-1547814603412)]
可能遇到的报错:
GMP包找不到
CMake Error at /usr/local/Cellar/cmake/3.9.0/share/cmake/Modules/FindPackageHandleStandardArgs.cmake:137 (message):
Could NOT find GMP (missing: GMP_LIBRARIES GMP_INCLUDE_DIR)
Call Stack (most recent call first):
/usr/local/Cellar/cmake/3.9.0/share/cmake/Modules/FindPackageHandleStandardArgs.cmake:377 (_FPHSA_FAILURE_MESSAGE)
解决办法:
brew install gmp
可能遇到ssl相关的错
CMake error: Could not find openSSL or GCrypt
但明明已经安装,原因是由于新版mac已经移除了openssl,所以我们需要手动配置环境变量,可以在cmake的命令行中通过-D的方式传入OPENSSL_ROOT_DIR和OPENSSL_LIBRARIES两个环境变量:
cmake -DOPENSSL_ROOT_DIR=/usr/local/Cellar/openssl/1.0.2l -DOPENSSL_LIBRARIES=/usr/local/Cellar/openssl/1.0.2l/lib ..
最后的联接时失败Link failed
第一种,使用brew install llvm后会遇到下面的报错:
- Configuring ChainBase on OS X
CMake Error at libraries/wasm-jit/Source/Runtime/CMakeLists.txt:26 (find_package):
Could not find a package configuration file provided by "LLVM" (requested
version 4.0) with any of the following names:
LLVMConfig.cmake
llvm-config.cmake
Add the installation prefix of "LLVM" to CMAKE_PREFIX_PATH or set
"LLVM_DIR" to a directory containing one of the above files. If "LLVM"
provides a separate development package or SDK, be sure it has been
installed.
-- Configuring incomplete, errors occurred!
解决办法,配置环境变量:
export LLVM_DIR=/usr/local/Cellar/llvm/4.0.1/lib/cmake/llvm
另一种可能,是手动安装llvm遇到下面的报错:
typeinfo for LLVMJIT::UnitMemoryManager in libRuntime.a(LLVMJIT.cpp.o)
"typeinfo for llvm::CmpInst", referenced from:
typeinfo for llvm::FCmpInst in libRuntime.a(LLVMEmitIR.cpp.o)
ld: symbol(s) not found for architecture x86_64
clang: error: linker command failed with exit code 1 (use -v to see invocation)
make[2]: *** [libraries/wasm-jit/Source/Programs/wavm] Error 1
make[1]: *** [libraries/wasm-jit/Source/Programs/CMakeFiles/wavm.dir/all] Error 2
初步怀疑这种是因为在第2节中,使用的是默认的llvm编译了,但却后续又使用手动安装的llvm进行后续操作导致的。故统一使用brew管理的llvm。
完整的解决过程,参考这里:https://github.com/EOSIO/eos/issues/99
完整的cmake脚本供参考
## 引入支持合约运行的编译器WASM
export WASM_LLVM_CONFIG=~/develop/eos/environment/wasm-compiler/llvm/bin/llvm-config
## 引入LLVM
export LLVM_DIR=/usr/local/Cellar/llvm/4.0.1/lib/cmake/llvm
## 新版mac移除了openssl的环境变量配置,手动设置并cmake
cmake -DOPENSSL_ROOT_DIR=/usr/local/Cellar/openssl/1.0.2l -DOPENSSL_LIBRARIES=/usr/local/Cellar/openssl/1.0.2l/lib ..
ERROR: Linking /usr/local/Cellar/python/3.6.5... Error: Permission denied @ dir_s_mkdir - /usr/local/Frameworks
需要执行以下命令
sudo mkdir /usr/local/Frameworks
sudo chown $(whoami):admin /usr/local/Frameworks
LLVM找不到
ERROR: Could not find a package configuration file provided by "LLVM" (requested version 4.0) with any of the following names
需要执行以下命令(检查一下你有没有这个目录,没有的话搜索一下)
export LLVM_DIR=/usr/local/Cellar/llvm@4/4.0.1/lib/cmake
参考链接
https://github.com/EOSIO/eos/issues/43
missing: Intl_INCLUDE_DIR
ERROR: Failed to find Gettext libintl (missing: Intl_INCLUDE_DIR)
需要执行以下命令
brew unlink gettext && brew link --force gettext
参考链接
https://github.com/EOSIO/eos/issues/2028?ref=tokendaily
ERROR:找不到 libc.bc和libc++.bc的问题
解决方法:工具链依赖库要一个一个装上去,c++14的
编译智能合约错误
ERROR:'stdint.h' file not found when running the example of smart contract “Hello World”
需要执行以下命令
cd ~/eos/build
sudo make install
参考链接
https://github.com/EOSIO/eos/issues/1718
Mac环境下Boost和wasm安装目录:
set(BOOST_INSTALL_DIR /usr/local/include/boost)
set(WASM_INSTALL_DIR /usr/local/wasm)
binaryen找不到
CMake Error: File /Users/joey/eos/externals/binaryen/LICENSE does not exist.
CMake Error at CMakeLists.txt:272 (configure_file):
configure_file Problem configuring file
-- Could NOT find Doxygen (missing: DOXYGEN_EXECUTABLE)
-- Doxygen not found. Contract documentation will not be generated.
-- Configuring incomplete, errors occurred!
See also "/Users/joey/eos/build/CMakeFiles/CMakeOutput.log".
缺少binaryen
cd /Users/joey/eos/externals
git clone https://github.com/EOSIO/binaryen.git
EOS启动网络的详细过程
准备工作:
1.启动钱包(这里不再啰嗦)
2.三个账户的公私钥
eosioEOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV 5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3
aiguoloveuip
EOS5YCbPBQqYoaMZKHkK2FhoNDSYFekqXSpYeWiCGDHCxU9w2U6mr 5JVK7ndrrqxZVzeM6MEMHb7QiULdxDuoA2upc37DqJhwCLTdG3y
eosproducer2
EOS7buuQTWf4KqdDC5xwbhaBkkNX9bnAnc7XoEXtaJTDXfzakisjs 5HskFQ7GLQ6UEoQWqCJPBjtFFCvaJ2brfS2qo5AcabRXmu
3.genesis.json的准备
{"initial_timestamp": "2018-06-01T12:00:00.000",
"initial_key": "EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV",
"initial_configuration": {
"max_block_net_usage": 1048576, "target_block_net_usage_pct": 1000, "max_transaction_net_usage": 524288, "base_per_transaction_net_usage": 12, "net_usage_leeway": 500, "context_free_discount_net_usage_num": 20, "context_free_discount_net_usage_den": 100, "max_block_cpu_usage": 200000, "target_block_cpu_usage_pct": 1000, "max_transaction_cpu_usage": 150000, "min_transaction_cpu_usage": 100, "max_transaction_lifetime": 3600, "deferred_trx_expiration_window": 600, "max_transaction_delay": 3888000, "max_inline_action_size": 4096, "max_inline_action_depth": 4, "max_authority_
4.各个节点的端口规划
http-server-addressp2p-listen-endpoint
p2p-server-address
p2p-peer-address
创世节点(eosio)
8884
9004
出块节点(aiguoloveuip)
88859005
9005
90
出块节点(eosproducer2)
88869006
9006
9004
90
启动创世节点:
1.代码:
/eos/home/Jungle/private_chain/eos-source/build/programs/nodeos/nodeos -e -p eosio --signature-provider=EOS6MRyAjQq8ud7hVNYcfnVPJqcVpscN5So8BhtHuGYqET5GDW5CV=KEY:5KQwrPbwdL6PhXujxW37FSSQZ1JiwsST4cqQzDeyXtP79zkvFD3 --plugin eosio::producer_plugin --plugin eosio::chain_api_plugin --plugin eosio::http_plugin --plugin eosio::history_api_plugin --http-server-address=172.26.247.122:8884 --p2p-listen-endpoint=172.26.247.122:9004 --p2p-server-address=172.26.247.122:9004 --p2p-peer-address 172.26.247.122:9005 --data-dir ./data/ --config-dir ./ --genesis-json genesis.json --max-transaction-time 3000
2.注意的地方
--data-dir 是数据存放的地方,包括blocks和state,所以不用另外在家--blocks-dir参数(为了更加整齐)
--max-tansaction-time 为的是解决报错Error 3080006: transaction took too long
--http-server-address --p2p-listen-endpoint --p2p-server-address三个都要指定,但是--p2p-peer-address不必添加,之后其他节点指定该节点后就会同步区块
将当前进程切换到后台 ctrl-z ,bg
--genesis-json每个节点第一次启动的时候都要加上genesis.json配置文件,get info得到的chainid是和genesis.json有关,所以必须指定
想要get transaction(get actions),可以加上参数--filter-on "*"
BIOS:
00_CONFIG.conf代码
{"SOURCES_FOLDER": "/eos/home/Jungle/private_chain/eos-source", "EOSIO_PRODUCER_PUB_KEY": "EOS7wp9yW6a9pwrnNmaUPGLdxmZmywY3B5mLEhrqJCrsNqSuev936", "EOSIO_PRODUCER_PRIV_KEY": "5Kk7LCFTcoyK2PjaBjPrDAYBJie2xUycHiWgChuVjvtkLEYuSgq", "WALLET_PASSWD":"", "INIT_ACCOUNT": "aiguoloveuip", "INIT_PUB_KEY": "EOS5YCbPBQqYoaMZKHkK2FhoNDSYFekqXSpYeWiCGDHCxU9w2U6mr ", "INIT_PRIV_KEY": "5JVK7ndrrqxZVzeM6MEMHb7QiULdxDuoA2upc37DqJhwCLTdG3y", "INIT_URL":"http://eos.aiguoloveuip.
01_BIOS_CONTRACT.sh代码
#!/bin/bashSOURCES_FOLDER="$( jq -r '.SOURCES_FOLDER' "00_CONFIG.conf" )"
CONTRACTS_FOLDER="$SOURCES_FOLDER/build/contracts"
EOSIO_PRODUCER_KEY="$( jq -r '.EOSIO_PRODUCER_PUB_KEY' "00_CONFIG.conf" )"
./cleos.sh set contract eosio $CONTRACTS_FOLDER/eosio.bios -p eo
only eosio initial producer.. 注意这里我们没有将eosio作为生产者,因为后面我们要投票,大于15%票数才会主网才算真正启动,然后eosio就会停止出块,由投票权重前21个节点出块
#./cleos.sh push action eosio setprods '{"schedule":[{"producer_name":"eosio","block_signing_key":"'$EOSIO_PRODUCER_KEY'"}]}' -p eosio
02_SYSTEM_ACCOUNTS.sh代码
#!/bin/bash./cleos.sh create account eosio eosio.bpay EOS84BLRbGbFahNJEpnnJHYCoW9QPbQEk2iHsHGGS6qcVUq9HhutG
./cleos.sh create account eosio eosio.msig EOS84BLRbGbFahNJEpnnJHYCoW9QPbQEk2iHsHGGS6qcVUq9HhutG
./cleos.sh create account eosio eosio.names EOS84BLRbGbFahNJEpnnJHYCoW9QPbQEk2iHsHGGS6qcVUq9HhutG
./cleos.sh create account eosio eosio.ram EOS84BLRbGbFahNJEpnnJHYCoW9QPbQEk2iHsHGGS6qcVUq9HhutG
./cleos.sh create account eosio eosio.ramfee EOS84BLRbGbFahNJEpnnJHYCoW9QPbQEk2iHsHGGS6qcVUq9HhutG
./cleos.sh create account eosio eosio.saving EOS84BLRbGbFahNJEpnnJHYCoW9QPbQEk2iHsHGGS6qcVUq9HhutG
./cleos.sh create account eosio eosio.stake EOS84BLRbGbFahNJEpnnJHYCoW9QPbQEk2iHsHGGS6qcVUq9HhutG
./cleos.sh create account eosio eosio.token EOS84BLRbGbFahNJEpnnJHYCoW9QPbQEk2iHsHGGS6qcVUq9HhutG
./cleos.sh create account eosio eosio.vpay EOS84BLRbGbFahNJEpnnJHYCoW9QPbQEk2iHsHGGS6qcVUq
03_TOKENMSIG_CONTRACTS.sh代码
#!/bin/bashSOURCES_FOLDER="$( jq -r '.SOURCES_FOLDER' "00_CONFIG.conf" )"
CONTRACTS_FOLDER="$SOURCES_FOLDER/build/contracts"
./cleos.sh set contract eosio.token $CONTRACTS_FOLDER/eosio.token -p eosio.token
./cleos.sh set contract eosio.msig $CONTRACTS_FOLDER/eosio.msig -p eosio.
04_TOKEN_CREATE_ISSUE.sh代码
#!/bin/bash./cleos.sh push action eosio.token create '["eosio", "1000000000.0000 EOS", 0, 0, 0]' -p eosio.token
./cleos.sh push action eosio.token issue '["eosio", "1000000000.0000 EOS", "init"]' -p eosio
05_SYSTEM_CONTRACTS.sh代码
#!/bin/bashSOURCES_FOLDER="$( jq -r '.SOURCES_FOLDER' "00_CONFIG.conf" )"
CONTRACTS_FOLDER="$SOURCES_FOLDER/build/contracts"
./cleos.sh set contract eosio $CONTRACTS_FOLDER/eosio.system -p eosio
./cleos.sh push action eosio setpriv '["eosio.msig",1]' -p eo
06_TEST_ACCOUNTS.sh代码
#!/bin/bashINIT_ACCOUNT="$( jq -r '.INIT_ACCOUNT' "00_CONFIG.conf" )"
INIT_PUB_KEY="$( jq -r '.INIT_PUB_KEY' "00_CONFIG.conf" )"
./cleos.sh system newaccount eosio INIT_PUB_KEY $INIT_PUB_KEY --stake-net "50.0000 EOS" --stake-cpu "500.0000 EOS" --buy-ram-kbytes 8888
07_TEST_ACCOUNTS_TRANSFER.sh代码
#!/bin/bashINIT_ACCOUNT="$( jq -r '.INIT_ACCOUNT' "00_CONFIG.conf" )"
这里我们转2亿个EOS,为后面抵押做准备,要大于EOS总数的15%,也就是1.5亿
./cleos.sh transfer eosio $INIT_ACCOUNT "200000000.0000 EOS" "init"
10_REGPRODUCER.sh 注册成为bp节点
#!/bin/bashINIT_ACCOUNT="$( jq -r '.INIT_ACCOUNT' "00_CONFIG.conf" )"
INIT_PUB_KEY="$( jq -r '.INIT_PUB_KEY' "00_CONFIG.conf" )"
INIT_URL="$( jq -r '.INIT_URL' "00_CONFIG.conf" )"
./cleos.sh system regproducer INIT_PUB_KEY "$INIT_URL" -p INIT_ACC
11_STAKE_TOKENS.sh cpu和net各抵押1亿EOS,就满足大于15%
#!/bin/bashINIT_ACCOUNT="$( jq -r '.INIT_ACCOUNT' "00_CONFIG.conf" )"
./cleos.sh push action eosio delegatebw '{"from":"'INIT_ACCOUNT'", "stake_net_quantity":"100000000.0000 EOS", "stake_cpu_quantity":"100000000.0000 EOS", "transfer": false}' -p $INIT_ACCOUN
13_VOTE_PRODUCER.sh 执行该命令后,创世节点开始停止出块
#!/bin/bashINIT_ACCOUNT="$( jq -r '.INIT_ACCOUNT' "00_CONFIG.conf" )"
./cleos.sh system voteproducer prods INIT_ACCOUNT -p $INIT_ACCOUNT
cleos.sh的脚本
#!/bin/bashCLEOS=/eos/home/Jungle/private_chain/eos-source/build/programs/cleos/cleos
@"
之后执行各个脚本
1-5是主网BIOS启动过程
./01_BIOS_CONTRACT.sh./02_SYSTEM_ACCOUNTS.sh
./03_TOKENMSIG_CONTRACTS.sh
./04_TOKEN_CREATE_ISSUE.sh
./05_SYSTEM_CONTRACTS.
6-10 是创建新账户并注册生产节点,抵押,投票,过程
./06_TEST_ACCOUNTS.sh./07_TEST_ACCOUNTS_TRANSFER.sh
./10_REGPRODUCER.sh
./11_STAKE_TOKENS.sh
./13_VOTE_PRODUCER.s
注意运行完这个命令后,创世节点停止出块
#等到bp节点启动后,bp节点开始出块,创世节点转为接收区块,类似出现如下信息:1998000ms thread-0 controller.cpp:769 start_block ] promoting proposed schedule (set in block 404) to pending; current block: 405 lib: 404 schedule: {"version":1,"producers":[{"producer_name":"aiguoloveuip","block_signing_key":"EOS5YCbPBQqYoaMZKHkK2FhoNDSYFekqXSpYeWiCGDHCxU9w2U6mr"}]}
出块节点aiguoloveuip的启动
config.ini中的配置
get-transactions-time-limit = 30max-transaction-time=3000 #防止产生transaction too long 错误 #config.ini文件中的genesis-json没有生效,所以启动节点是要指明该文件--genesis-json #genesis-json = "/eos/home/Jungle/aiguo/JungleTestnet-aiguoloveuip/genesis.json" http-server-address = 172.26.247.122:8885 p2p-listen-endpoint = 172.26.247.122:9005 p2p-server-address = 172.26.247.122:9005 # SSL # Filename with https private key in PEM format. Required for https (eosio::http_plugin) # https-server-address = # Filename with the certificate chain to present on https connections. PEM format. Required for https. (eosio::http_plugin) # https-certificate-chain-file = # Filename with https private key in PEM format. Required for https (eosio::http_plugin) # https-private-key-file = contracts-console = true #该配置项是console端输出,用于智能合约调试,使用print()函数 http-validate-host = 0 从v1.0.9版本之后 加上该配置项才能从外部连通http server #该值默认为1024; 如果启动node加上--filter-on "*"的话可能会出现bad acclocation 错误,issues中的#4661,所以增加了chain-state chain-state-db-size-mb = 2048 allowed-connection = any log-level-net-plugin = info max-clients = 120 connection-cleanup-period = 30 network-version-match = 0 sync-fetch-span = 2000 enable-stale-production = true #要为true,不然不出块 required-participation = 33 mongodb-queue-size = 256 plugin = eosio::producer_plugin
plugin = eosio::producer_abi_plugin 这个插件不需要添加,放开后报错
plugin = eosio::history_plugin plugin = eosio::history_api_plugin plugin = eosio::chain_plugin plugin = eosio::chain_api_plugin agent-name = aiguoloveuip
private-key = ["EOS5YCbPBQqYoaMZKHkK2FhoNDSYFekqXSpYeWiCGDHCxU9w2U6mr","5JVK7ndrrqxZVzeM6MEMHb7QiULdxDuoA2upc37DqJhwCLTdG3y"] 注意这里的格式改变了
signature-provider = EOS5YCbPBQqYoaMZKHkK2FhoNDSYFekqXSpYeWiCGDHCxU9w2U6mr=KEY:5JVK7ndrrqxZVzeM6MEMHb7QiULdxDuoA2upc37DqJhwCLTdG3y producer-name = aiguoloveuip
这里我们的p2p是连的创世区块,同步数据,即使创世区块没有指定p2p,也会同步到数据
启动节点的脚本start.sh
#!/bin/bashNODEOS=/eos/home/Jungle/private_chain/eos-source/build/programs/nodeos/nodeos
DATADIR=/eos/home/Jungle/private_chain/chain5/
$DATADIR/stop.sh
DATADIR/data/ --config-dir @" > DATADIR/stderr.txt & echo DATADIR/nodeos.pi
启动:
第一次启动
1.需要指明genesis.json文件
2.如果删除了数据,重新启动也用该命令(--delete-all-blocks就是将data数据删除了,所以不用手动删除)
./start.sh --genesis-json genesis.json --delete-all-blocks
以后如果数据还存在的话启动
./start.sh
如果重启后出现同步数据问题:
可以先尝试--replay-blockchain
再者可以:start.sh --hard-replay-blockchain --truncate-at-block [有问题的区块编号]
最后不行就--delete-all-blocks
--replay-blockchain
clear chain state database and replay all blocks
--hard-replay-blockchain
clear chain state database, recover as many blocks as possible from the block log, and then replay those blocks
--delete-all-blocks
clear chain state database and block log
--truncate-at-block arg (=0)
stop hard replay / block log recovery at this block number (if set to non-zero number)
出块节点eosproducer2的启动
config.ini中的配置
get-transactions-time-limit = 30max-transaction-time=3000 #genesis-json = "/eos/home/Jungle/aiguo/JungleTestnet-aiguoloveuip/genesis.json" http-server-address = 172.26.247.122:8886 p2p-listen-endpoint = 172.26.247.122:9006 p2p-server-address = 172.26.247.122:9006 access-control-allow-origin = * # SSL # Filename with https private key in PEM format. Required for https (eosio::http_plugin) # https-server-address = # Filename with the certificate chain to present on https connections. PEM format. Required for https. (eosio::http_plugin) # https-certificate-chain-file = # Filename with https private key in PEM format. Required for https (eosio::http_plugin) # https-private-key-file = allowed-connection = any log-level-net-plugin = info max-clients = 120 connection-cleanup-period = 30 network-version-match = 0 sync-fetch-span = 2000 enable-stale-production = true required-participation = 33 mongodb-queue-size = 256 plugin = eosio::producer_plugin
plugin = eosio::producer_abi_plugin
plugin = eosio::chain_api_plugin plugin = eosio::history_plugin plugin = eosio::history_api_plugin plugin = eosio::chain_plugin agent-name = eosproducer2
private-key = ["EOS5YCbPBQqYoaMZKHkK2FhoNDSYFekqXSpYeWiCGDHCxU9w2U6mr","5JVK7ndrrqxZVzeM6MEMHb7QiULdxDuoA2upc37DqJhwCLTdG3y"]
signature-provider = EOS7buuQTWf4KqdDC5xwbhaBkkNX9bnAnc7XoEXtaJTDXfzakisjs=KEY:5HskFQ7GLQ6UEoQWqCJPBjtFFCvaJ2brfS2qo5AcabRXmuwUCgz producer-name = eosproducer2
这里我们同步9004和9005的数据
p2p-peer-address = 172.26.247.122:9004
在这之前我们先要创建账户,注册出块节点,转账,抵押,投票
00_CONFIG.conf{
"SOURCES_FOLDER": "/eos/home/Jungle/private_chain/eos-source", "EOSIO_PRODUCER_PUB_KEY": "EOS7wp9yW6a9pwrnNmaUPGLdxmZmywY3B5mLEhrqJCrsNqSuev936", "EOSIO_PRODUCER_PRIV_KEY": "5Kk7LCFTcoyK2PjaBjPrDAYBJie2xUycHiWgChuVjvtkLEYuSgq", "WALLET_PASSWD":"", "INIT_ACCOUNT": "eosproducer2", "INIT_PUB_KEY": "EOS7buuQTWf4KqdDC5xwbhaBkkNX9bnAnc7XoEXtaJTDXfzakisjs", "INIT_PRIV_KEY": "5HskFQ7GLQ6UEoQWqCJPBjtFFCvaJ2brfS2qo5AcabRXmuwUCgz", "INIT_URL":"http://eosproducer2
06_TEST_ACCOUNTS.sh
#!/bin/bashINIT_ACCOUNT="$( jq -r '.INIT_ACCOUNT' "00_CONFIG.conf" )"
INIT_PUB_KEY="$( jq -r '.INIT_PUB_KEY' "00_CONFIG.conf" )"
./cleos.sh system newaccount eosio INIT_PUB_KEY $INIT_PUB_KEY --stake-net "50.0000 EOS" --stake-cpu "500.0000 EOS" --buy-ram-kbytes 88
07_TEST_ACCOUNTS_TRANSFER.sh
#!/bin/bashINIT_ACCOUNT="$( jq -r '.INIT_ACCOUNT' "00_CONFIG.conf" )"
./cleos.sh transfer eosio $INIT_ACCOUNT "200.0000 EOS" "init
10_REGPRODUCER.sh
#!/bin/bashINIT_ACCOUNT="$( jq -r '.INIT_ACCOUNT' "00_CONFIG.conf" )"
INIT_PUB_KEY="$( jq -r '.INIT_PUB_KEY' "00_CONFIG.conf" )"
INIT_URL="$( jq -r '.INIT_URL' "00_CONFIG.conf" )"
./cleos.sh system regproducer INIT_PUB_KEY "$INIT_URL" -p INIT_ACC
11_STAKE_TOKENS.sh 由于主网已经启动,这次抵押不需要太多EOS,只要权重排在前21就可以
#!/bin/bashINIT_ACCOUNT="$( jq -r '.INIT_ACCOUNT' "00_CONFIG.conf" )"
./cleos.sh push action eosio delegatebw '{"from":"'INIT_ACCOUNT'", "stake_net_quantity":"100.0000 EOS", "stake_cpu_quantity":"100.0000 EOS", "transfer": false}' -p $INIT_ACCOUN
13_VOTE_PRODUCER.sh
#!/bin/bashINIT_ACCOUNT="$( jq -r '.INIT_ACCOUNT' "00_CONFIG.conf" )"
./cleos.sh system voteproducer prods INIT_ACCOUNT -p $INIT_ACCOUNT
执行脚本
./06_TEST_ACCOUNTS.sh./07_TEST_ACCOUNTS_TRANSFER.sh
./10_REGPRODUCER.sh
./11_STAKE_TOKENS.sh
./13_VOTE_PRODUCER.sh
启动节点的脚本 start.sh
#!/bin/bashNODEOS=/eos/home/Jungle/private_chain/eos-source/build/programs/nodeos/nodeos
DATADIR=/eos/home/Jungle/private_chain/chain6/
$DATADIR/stop.sh
DATADIR/data/ --config-dir @" > DATADIR/stderr.txt & echo DATADIR/nodeos.
启动:
第一次启动(包括如果删除了数据,重新启动(--delete-all-blocks就是将data数据删除了,所以不用手动删除))
./start.sh --genesis-json genesis.json --delete-all-blocks
以后如果数据还存在的话启动
./start.sh
EOS主网连接与数据同步
一,从GitHub上克隆主网代码仓库:(注意EOS-Mainnet / eos与EOSIO / eos的版本是一致的。若以前在本地已经安装编译过EOSIO / eos的1.0.2版本及以上,则可以直接跳到步骤三)
git clone https://github.com/EOS-Mainnet/eos
cd eos
git submodule update --init --recursive
git tag
git checkout mainnet-1.0.2.2
二,编译EOS代码
./eosio_build.sh
三,替换config.ini和genesis.json文件
(1)运行nodeos节点后会生成默认的的config.ini / genesis.json文件,现在对其进行替换
(2)在不同系统中找到其文件地址:
linux-ubuntu:〜/ .local / share / eosio / nodeos / config /
mac-osx:〜/ Library / Application \ Support / eosio / nodeos / config /
(3)新的的config.ini文件设置如下:
fullnode sample config
blocks-dir = "blocks"
chain-state-db-size-mb = 1024
reversible-blocks-db-size-mb = 340
contracts-console = false
https-client-validate-peers = 1
http-server-address = 0.0.0.0:8888
access-control-allow-credentials = false
p2p-listen-endpoint = 0.0.0.0:9876
p2p-server-address = 0.0.0.0:9876
List of peers
p2p-peer-address = p2p.one.eosdublin.io:9876
p2p-peer-address = eu-west-nl.eosamsterdam.net:9876
p2p-peer-address = p2p.mainnet.eosgermany.online:9876
p2p-peer-address = 35.197.190.234:19878
p2p-peer-address = p2p.genereos.io:9876
p2p-peer-address = fullnode.eoslaomao.com:443
p2p-peer-address = new.eoshenzhen.io:10034
p2p-peer-address = node1.eosphere.io:9876
p2p-peer-address = p2p.meet.one:9876
p2p-peer-address = bp.eosbeijing.one:8080
p2p-peer-address = peer1.mainnet.helloeos.com.cn:80
p2p-peer-address = p2p-public.hkeos.com:19875
p2p-peer-address = pub1.eostheworld.io:9876
p2p-peer-address = eu1.eosdac.io:49876
p2p-peer-address = peer.eosio.sg:9876
p2p-max-nodes-per-host = 10
agent-name = "eosmainnet"
allowed-connection can be set to "specified" to use whitelisting with the "peer-key" option
allowed-connection = any
peer-private-key is needed if you are whitelisting specific peers with the "peer-key" option
peer-private-key = ["EOS6qTvpRYx35aLonqUkWAMwAf3mFVugYfQCbjV67zw2aoe7Vx7qd", "5JroNC1B4pz9gJzNZeU7tkU6YMtoeWRCr4CJJwKsVXnJhRbKXSC"]
max-clients = 250
connection-cleanup-period = 30
network-version-match = 1
sync-fetch-span = 100
max-implicit-request = 1500
enable-stale-production = false
pause-on-startup = false
max-transaction-time = 10000
max-irreversible-block-age = -1
txn-reference-block-lag = 0
Plugins used for full nodes
plugin = eosio::chain_api_plugin
plugin = eosio::history_api_plugin
plugin = eosio::chain_plugin
plugin = eosio::history_plugin
plugin = eosio::net_plugin
plugin = eosio::net_api_plugin
其中P2P对等实体地址的配置来源于:
https://docs.google.com/spreadsheets/d/1K_un5Vak3eDh_b4Wdh43sOersuhs0A76HMCfeQplDOY/edit#gid=0
(4)genesis.json文件内容如下:
{
"initial_timestamp": "2018-06-08T08:08:08.888",
"initial_key": "EOS7EarnUhcyYqmdnPon8rm7mBCTnBoot6o7fE2WzjvEX2TdggbL3",
"initial_configuration": {
"max_block_net_usage": 1048576,
"target_block_net_usage_pct": 1000,
"max_transaction_net_usage": 524288,
"base_per_transaction_net_usage": 12,
"net_usage_leeway": 500,
"context_free_discount_net_usage_num": 20,
"context_free_discount_net_usage_den": 100,
"max_block_cpu_usage": 200000,
"target_block_cpu_usage_pct": 1000,
"max_transaction_cpu_usage": 150000,
"min_transaction_cpu_usage": 100,
"max_transaction_lifetime": 3600,
"deferred_trx_expiration_window": 600,
"max_transaction_delay": 3888000,
"max_inline_action_size": 4096,
"max_inline_action_depth": 4,
"max_authority_depth": 6
}
}
此文件称为创世JSON文件,来自以下链接:
https://github.com/EOS-Mainnet/eos/blob/launch-rc-1.0.2/mainnet-genesis.json
四,将以上的创世JSON文件,复制拷贝到〜/ EOS /构建/程序/ nodeos目录下,并启动nodeos节点:
./nodeos --genesis-json genesis.json
可以看到节点已经连上主网,on_incoming_block就代表正在同步区块内容了。不过有的节点地址会出现连接不上的误差。可以尝试在上述的谷歌链接地址中的表格选择稳定的对等节点进行设置。
3546494ms thread-0 producer_plugin.cpp:290 on_incoming_block ] Received block ccf596b268aea49a... #479000 @ 2018-06-13T05:29:49.000 signed by genesisblock [trxs: 0, lib: 478999, conf: 0, latency: 527357494 ms]
3552228ms thread-0 producer_plugin.cpp:290 on_incoming_block ] Received block 3adbcf84f3dea90c... #480000 @ 2018-06-13T05:38:09.000 signed by genesisblock [trxs: 0, lib: 479999, conf: 0, latency: 526863228 ms]
3557963ms thread-0 producer_plugin.cpp:290 on_incoming_block ] Received block ec80ea02b2d795cb... #481000 @ 2018-06-13T05:46:29.000 signed by genesisblock [trxs: 0, lib: 480999, conf: 0, latency: 526368963 ms]
3563672ms thread-0 producer_plugin.cpp:290 on_incoming_block ] Received block 580cf0926b807c85... #482000 @ 2018-06-13T05:54:49.000 signed by genesisblock [trxs: 0, lib: 481999, conf: 0, latency: 525874672 ms]
3569426ms thread-0 producer_plugin.cpp:290 on_incoming_block ] Received block cce03eebb64b3c80... #483000 @ 2018-06-13T06:03:09.000 signed by genesisblock [trxs: 0, lib: 482999, conf: 0, latency: 525380427 ms]
3571971ms thread-0 net_plugin.cpp:1915 connect ] host: node1.eosphere.io port: 9876
3571971ms thread-0 net_plugin.cpp:1915 connect ] host: eu1.eosdac.io port: 49876
3571971ms thread-0 net_plugin.cpp:1915 connect ] host: peer.eosio.sg port: 9876
3571971ms thread-0 net_plugin.cpp:1915 connect ] host: p2p.mainnet.eosgermany.online port: 9876
五,查看链信息:
比对chain_id是否为:aca376f206b8fc25a6ed44dbdc66547c36c6c33e3a119ffbeaef943642f0e906
运行cleos命令:
cleos get info
返回信息为:
{
"server_version": "26ec83de",
"chain_id": "aca376f206b8fc25a6ed44dbdc66547c36c6c33e3a119ffbeaef943642f0e906",
"head_block_num": 493299,
"last_irreversible_block_num": 493298,
"last_irreversible_block_id": "000786f240401f6fcc24de5240ddd9fead88cbbbbec740c181258dc3e682fb96",
"head_block_id": "000786f36fafd9e98d703a004a302e86958de991dedbbc27f33c393c2adb2c6f",
"head_block_time": "2018-06-13T07:28:58",
"head_block_producer": "genesisblock",
"virtual_block_cpu_limit": 200000000,
"virtual_block_net_limit": 1048576000,
"block_cpu_limit": 199900,
"block_net_limit": 1048576
}
六,查看区块数据
在数据正常同步后,使用cleos命令可以查看一些区块信息:譬如查看区块191的数据
cleos get block 191
返回信息如下,可以看到交易内容
{
"timestamp": "2018-06-09T11:58:04.500",
"producer": "eosio",
"confirmed": 0,
"previous": "000000be7ec418241839c376b35a4ae88b305e045a4f0e779215c5f5f4508e5d",
"transaction_mroot": "1f09d60c3b791e1fa29e7fe980807ec36fab1c9fbc130f72f492e3b4c965184b",
"action_mroot": "1ca50b0889e5c6b884e621ff113b17868dfbbc7cd2d4549784c8e50a5114e75c",
"schedule_version": 0,
"new_producers": null,
"header_extensions": [],
"producer_signature": "SIG_K1_K87sojWELjnYSUvpS1Xy1L1P5Etr7xrcnuauqM5zoUYZRTL6eLXA9fZASdvH1ynUq1ZXSceNqWGrcAxj6cZt3ERvgk2aD9",
"transactions": [{
"status": "executed",
"cpu_usage_us": 1593,
"net_usage_words": 35,
"trx": {
"id": "ad77575a8b4f52e477682e712b1cbd884299468db6a94d909f90c6961cea9b02",
"signatures": [
"SIG_K1_KfUNC7KHjSGKBrk8FHjq9tqZA12q1aD9pspfBbLW9iw58B6DqoyebmLaEP2VUuJZa2nDZ11YdgEi2VwuqY5sSogh7MaG8p"
],
"compression": "none",
"packed_context_free_data": "",
"context_free_data": [],
"packed_trx": "eac01b5bbd00421775ad000000000100a6823403ea3055000000572d3ccdcd010000000000ea305500000000a8ed3232ba010000000000ea30550000000000004038a08601000000000004454f530000000098014e6576657220646f7562742074686174206120736d616c6c2067726f7570206f662074686f7567687466756c2c20636f6d6d697474656420636974697a656e732063616e206368616e67652074686520776f726c643b20696e646565642c206974277320746865206f6e6c79207468696e672074686174206576657220686173202d20656f7361636b6e6f776c6564676d656e74732e696f00",
"transaction": {
"expiration": "2018-06-09T11:58:34",
"ref_block_num": 189,
"ref_block_prefix": 2910132034,
"max_net_usage_words": 0,
"max_cpu_usage_ms": 0,
"delay_sec": 0,
"context_free_actions": [],
"actions": [{
"account": "eosio.token",
"name": "transfer",
"authorization": [{
"actor": "eosio",
"permission": "active"
}
],
"data": {
"from": "eosio",
"to": "b1",
"quantity": "10.0000 EOS",
"memo": "Never doubt that a small group of thoughtful, committed citizens can change the world; indeed, it's the only thing that ever has - eosacknowledgments.io"
},
"hex_data": "0000000000ea30550000000000004038a08601000000000004454f530000000098014e6576657220646f7562742074686174206120736d616c6c2067726f7570206f662074686f7567687466756c2c20636f6d6d697474656420636974697a656e732063616e206368616e67652074686520776f726c643b20696e646565642c206974277320746865206f6e6c79207468696e672074686174206576657220686173202d20656f7361636b6e6f776c6564676d656e74732e696f"
}
],
"transaction_extensions": []
}
}
}
],
"block_extensions": [],
"id": "000000bf87a9db45034a46671514a225cb1a5c30e9b8dc172bc75ef30a812970",
"block_num": 191,
"ref_block_prefix": 1732659715
}
EOS调试
编译带调试信息的EOS
编译可以调试(带源码信息)的EOS程序,增加-o Debug参数即可,即
$./eosio_build.sh -o Debug
下载源码等其他步骤请参考【[EOS源码编译运行](https://blog.csdn.net/itleaks/article/details/80367131)】一文
下载VSCode
和比特币,以太坊源码调试一样,vscode是最佳的调试EOS源码的调试工具
https://code.visualstudio.com/Download
调试配置流程
导入源码
配置调试文件
执行后,会生成launch.json, 然后修改program字段值为对应的程序即可,比如要调试nodeos, 则修改为如下
添加断点并开始调试
在行号左边点击即可添加断点
点击调试界面的右三角开始调试程序
注意
如果你曾经执行过release版本的nodeos,需要将数据清空,否则会报错
database created by a different compiler, build, boost version, or operating system
执行如下命令清空老数据
$ rm -rf ~/Library/Application\ Support/eosio