eos源码赏析(一):Ubuntu下eos代码编译

       网上已经有很多关于btc的源码分析了,由于eos主网上线还需时日,且网上关于eos的源码解析较少,斗胆尝试着做一个系列的文,学习eos的源码,也提升一下自己的阅读代码的能力和对新知识的了解能力。要阅读赏析源码首先运行起来,看看大概是个什么样子,这样心里有个底,也就踏实多了。本文为系列文的第一篇,Ubuntu下eos代码的编译,是依据官网文档的指导完成的。

       官方文档链接:https://github.com/EOSIO/eos

       根据官方文档提示,eos代码仅支持Ubuntu16.04版本或更高版本上进行编译(推荐使用Ubuntu16.10),本文在Ubuntu16.04上实现。在编译eos代码之前,我们首先要获取eos代码编译、运行所需要依赖的工具和库,具体获取方式可在终端中输入以下指令来实现:

sudo apt-get update

wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key

sudo apt-get install clang-4.0 lldb-4.0 libclang-4.0-dev cmake make

                     libbz2-dev libssl-dev libgmp3-dev

                     autotools-dev build-essential

                     libbz2-dev libicu-dev python-dev

                     autoconf libtool git

       其中 LLVM是构架编译器(compiler)的框架系统,以C++编写而成,用于优化以任意程序语言编写的程序的编译时间(compile-time)、链接时间(link-time)、运行时间(run-time)以及空闲时间(idle-time),而Clang正是我们完成eos代码编译的编译器。Eos代码大量的依赖于boost库,因此我们需要获取boost库并进行编译、安装,同时将boost库的相关信息添加至环境变量,以上步骤可以通过以下指令来实现:

cd ~

wget -c 'https://sourceforge.net/projects/boost/files/boost/1.66.0/boost_1_66_0.tar.bz2/download' -O boost_1.66.0.tar.bz2

tar xjf boost_1.66.0.tar.bz2

cd boost_1_66_0/

echo "export BOOST_ROOT=$HOME/boost_1_66_0" >> ~/.bash_profile

source ~/.bash_profile

./bootstrap.sh "--prefix=$BOOST_ROOT"

./b2 install

source ~/.bash_profile

       如果觉得下载慢的话,也可以自己去boost官网下载对应的版本(linux64位)然后按照上面的步骤进行解压、添加环境变量、编译、安装。

接下来我们需要获取并安装secp256k1-zkp,具体我们可以把它看做是一个加解密的库,具体获取、编译、安装可以通过以下方式实现:

cd ~

git clone https://github.com/cryptonomex/secp256k1-zkp.git

cd secp256k1-zkp

./autogen.sh

./configure

make

sudo make install

       同时,我们还需要WASM编译器,由于llvm和clang中并未对WASM进行配置,因此需要我们进行手动编译

mkdir  ~/wasm-compiler

cd ~/wasm-compiler

git clone --depth 1 --single-branch --branch release_40 https://github.com/llvm-mirror/llvm.git

cd llvm/tools

git clone --depth 1 --single-branch --branch release_40 https://github.com/llvm-mirror/clang.git

cd ..

mkdir build

cd build

cmake -G "Unix Makefiles" -DCMAKE_INSTALL_PREFIX=.. -DLLVM_TARGETS_TO_BUILD= -DLLVM_EXPERIMENTAL_TARGETS_TO_BUILD=WebAssembly -DCMAKE_BUILD_TYPE=Release ../

make -j4 install

       以上获取了eos代码编译所需要使用的工具以及依赖库,在保证以上步骤完成的基础上,我们就可以编译并运行一个eos节点了。在编译之前,我们首先要从git上下载eos的源码,由于eos代码分支较多,我们可以加上—recursive来获取完整的代码,如下指令:

git clone https://github.com/eosio/eos --recursive

       获取到代码之后,我们就可以对eos进行编译了

cd ~

git clone https://github.com/eosio/eos --recursive

mkdir -p ~/eos/build && cd ~/eos/build

cmake -DBINARYEN_BIN=~/binaryen/bin -DWASM_ROOT=~/wasm-compiler/llvm -DOPENSSL_ROOT_DIR=/usr/local/opt/openssl -DOPENSSL_LIBRARIES=/usr/local/opt/openssl/lib ..

make -j$( nproc )

         编译完成之后我们可以在路径~/eos/build/programs看到以下文件夹:

       eosiod里面是服务端的区块链组件相关文件。

       eosioc里面是区块链的命令行接口相关文件

       eosio-launcher里面是网络节点的应用相关文件。

       eosiowd里面是eos钱包相关文件


       现在我们cd到eosiod路径下,可以执行eosiod,在执行的过程中可能会产生报错,如果没产生报错的话,可以用ctrl+c停止eosiod的运行,此时我们可以在eosiod文件夹下看到一个名为data-dir的文件夹,其中包含有eosiod的相关配置信息。打开config.ini把以下内容添加进去:


# Load the testnet genesis state, which creates some initial block producers with the default key

genesis-json = /path/to/eos/source/genesis.json

 # Enable production on a stale chain, since a single-node test chain is pretty much always stale

enable-stale-production = true

# Enable block production with the testnet producers

producer-name = inita

producer-name = initb

producer-name = initc

producer-name = initd

producer-name = inite

producer-name = initf

producer-name = initg

producer-name = inith

producer-name = initi

producer-name = initj

producer-name = initk

producer-name = initl

producer-name = initm

producer-name = initn

producer-name = inito

producer-name = initp

producer-name = initq

producer-name = initr

producer-name = inits

producer-name = initt

producer-name = initu

# Load the block producer plugin, so you can produce blocks

plugin = eosio::producer_plugin

# Wallet plugin

plugin = eosio::wallet_api_plugin

# As well as API and HTTP plugins

plugin = eosio::chain_api_plugin

plugin = eosio::http_plugin

        再次运行./eosiod,然鹅,又一次出现了错误

        原来提示我们genesis.json文件路径不对,那么我们可以用Locate genesis来查找我们本机中的genesis.json所在的路径,并将该路径添加至,eos的编译配置文件中去,如下图:

         再次运行eosiod,又出现了下图的报错:

        原来是提示我们配置文件中enable-stale-production使用了两次或者两次以上,我们再重新打开config.ini将其中一个enable-stale-production注释掉即可

现在我们再运行一次./eosiod,终于,见证奇迹的时刻到了:

         当你看到上图,说明你的第一个eos节点已经运行起来了,还真的是一波三折。


         至此我们根据官方文档的指示,在ubuntu16.04环境下完成了eos编译环境的搭建、eos编译工具获取安装、eos代码依赖库获取安装、eos代码的编译及运行,其中以eosiod为例简单的描述了运行中产生的问题及解决方案,当然我们也可以打开config.ini查看eosiod相关的配置信息。


        So Welcome to EOSIO!


        下一篇将围绕eos的代码结构进行相关分析。


©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,980评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,178评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,868评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,498评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,492评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,521评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,910评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,569评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,793评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,559评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,639评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,342评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,931评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,904评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,144评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,833评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,350评论 2 342

推荐阅读更多精彩内容