最为领先的内容公链,COS 公链的代码全部开源免费。开源地址:https://github.com/coschain/
“没有基础知识,不用担心!
零基础,开启 COS 公链本地化运行。”
本文从源代码编译开始,带领大家一步步搭建一个可运行的环境,直到可以正常运行 COS 公链并出块。
考虑到可能出现的编译错误,我们也提供了一个能正常运行本地链的 docker。不过,对于那些想要深入理解本地链的编译和运行原理的开发者来说,我们强烈建议从源码开始编译哦~
第一步: 获取源代码
从 github 上获取 master 分支的代码
git clone git@github.com:coschain/contentos-go.git
第二步: 编译
Go 的版本
内容公链 Contentos 的主要开发语言是 golang,并且使用了 golang 官方提供的 go modules 作为管理工具。所以,必须使用 Go 1.11 以上支持 go modules 功能的版本。由于 Go 1.12 对 modules 机制做出进一步的更新,推荐使用 Go 1.12 以后的版本(目前最标准的版本是 Go 1.11.4)。
编译 cosd
和 wallet
contentos-go 可以编译出的可执行文件均在 cmd
文件夹里,最重要的是 cosd
和 wallet-cli
。前者是 contentos 主链,后者是与主链交互的命令行工具。
cd build
go build ../cmd/cosd
go build ../cmd/wallet-cli
当然,你也可以通过 go build -o
指定名字和位置。
第三步: 运行
初始化
contentos 需要初始化 ~/.coschain
文件夹用于存放配置文件和数据,以下命令将会创建默认文件夹 ~/.coschain/cosd
。
cosd init
也可以指定文件夹名字,以下命令将会创建文件夹 ~/.coschain/testnode
。
cosd init -n testnode
指定配置文件名字的意义在于,可以通过这种方式实现本地同时运行多个节点。它们会读取不同的配置文件,并创建互相独立的 db 数据。
启动
启动 cosd
并完成正常出块的流程较为繁琐,如果只是需要启动并快速继续后面的操作,我们提供了一键启动的脚本,以便完成多个节点启动并且正常出块。当然,如果想要了解整个启动流程,建议跳过“一键启动”的方式。
单节点
初始化完成之后,通过执行 start
命令启动 cosd
。
cosd start
上述命令会使用 ~/.coschain/cosd
下的配置文件,并写入数据到该文件夹下。
同样,也可以指定配置文件夹。
cosd start -n testnode
会使用 ~/.coschain/testnode
下的配置文件,并且写入数据到这个文件夹下。
执行后,cosd
节点就可以正常启动了。
多节点
虽然我们可以手动创建多个配置文件并启动,但是这个过程比较繁琐。对于此,我们提供了 multinodetester
用于批量创建和启动。
multinodetester
存储在 cmd
文件下,需要编译。
cd build
go build ../cmd/multinodetester
批量初始化
multinodetester init 4
可以初始化 4 个配置文件夹。该命令可以在 ~/.coschain
下找到,分别为 testcosd_0
、testcosd_1
、testcosd_2
、testcosd_3
,对应 4 个节点。
批量启动
multinodetester start path/to/cosd 4
path/to/cosd 是 cosd 可执行文件的路线,如果 mltinodetester 和 cosd 都在 build 文件夹下,那么路径就是 ./cosd
。
通过以上步骤,本地就会有 4 个节点运行啦。
手动选择第一轮出块节点
即使有多个节点在本地运行,但如果没有选择出块节点,默认的只有 testcosd_0
这个特殊节点 (也就是 initminer) 出块,其他节点都处于同步模式。所以,我们需要手动选择出块节点。
一般情况下,节点需要通过 wallet
去注册节点,节点投票之后才能成为出块节点,这个过程同样繁琐。在本地环境下,简化了这个流程,在 wallet
下提供了同名 multinodetester
的方法来批量注册和选举出块节点。
如果严格按照上文的流程,那么现在本地应该有 wallet-cli
这个可执行文件。
执行 wallet-cli
文件,进入交互界面。输入 multinodetester 4
来批量注册选举出块节点。也可以通过非交互模式完成,执行:
wallet-cli multinodetester 4
经过以上操作步骤,contentos 主链就已经成功在本地运行起来了。
欢迎加入 COS 技术社群,领取 bounty 奖励!