本文面向零区块链基础入门XuperChain的开发者,介绍了如何部署XuperChain基础可用环境以及XuperChain服务部署基本操作和配置,帮助开发者们快速了解XuperChain部署流程和基本功能,完成上链第一步。
本文主要分为两大模块:XuperChain环境部署和Xuperchain服务部署。
XuperChain环境部署
第一步 准备环境
XuperChain主要由Golang语言开发,首先需要准备编译运行的环境:
(1)根据您使用的电脑操作系统,安装go语言编译环境 (推荐使用的版本为1.14或1.15):https://go.dev/dl/
(2)安装Git,帮助有效、高速地完成项目版本管理:https://git-scm.com/download
第二步 编译XuperChain
(1) 完成XuperChain编译运行环境后,使用Git将XuperChain源代码下载到本地:https://github.com/xuperchain...
文章图片
(2)完成源代码下载后,在XuperChain目录下执行以下命令:
$ cd xuperchain
$ git checkout v5.1.0
$ make
文章图片
执行命令后,在output目录可以得到bin、conf、data 三个文件夹以及一个 control.sh 脚本,各目录的功能如下表:
文章图片
经过以上的操作就已经完成对XuperChain编译环境的基本部署。
Xuperchain服务部署
【新手入门 | 上链第一步!如何完成XuperChain环境、服务部署】完成XuperChain基本环境部署后,接下来将对XuperChain服务进行部署,此部分内容将以XuperChain单节点single共识的链为例操作,教大家如何快速启动一条链,并在链上使用一些基本功能。
启动单节点 single 共识的链 XuperChain的最新版本为启动服务提供了方便的脚本,只需要在output下执行一条命令【controll.sh】即可启动单节点 single 共识的链。
# 启动xuper链
$ bash control.sh start
/home/ubuntu/go/src/github.com/xuperchain/output/bin/xchain
/home/ubuntu/go/src/github.com/xuperchain/output/conf/env.yaml
2021/08/10 19:26:57 start create chain.bc_name:xuper genesis_conf:./data/genesis/xuper.json env_conf:./conf/env.yaml
2021/08/10 19:26:57 create ledger succ.bc_name:xuper start xchain. cmd:nohup /home/ubuntu/go/src/github.com/xuperchain/output/bin/xchain startup --conf /home/ubuntu/go/src/github.com/xuperchain/output/conf/env.yaml >/home/ubuntu/go/src/github.com/xuperchain/output/logs/nohup.out 2>&1 &
.start proc succ.
start finish.pid:17242
Done!
【control.sh】脚本提供了 start、stop、restart、forcestop 四个命令,可以通过执行【bash control.sh help】命令查看。
按照默认配置,Xuperchain服务会监听37101端口,可以使用如下命令查看Xuperchain服务的运行状态:
# check服务运行状况
$ bin/xchain-cli status -H 127.0.0.1:37101
{
"blockchains": [
{
"name": "xuper",
"ledger": {
"rootBlockid": "d93c260ea5639a55e1fcad3df494495efad5c65d46e846b6db3a9194a4212886",
"tipBlockid": "9555ca5af579db67734f27013dfaae48d93e4c3e8adcf6ca8f3dc1adb06d0b6f",
"trunkHeight": 137
},
....
"9555ca5af579db67734f27013dfaae48d93e4c3e8adcf6ca8f3dc1adb06d0b6f"
]
}
],
"peers": null,
"speeds": {}
}
XuperChain基本功能使用
第一步 创建账号 在XuperChain中,账号类型分为“普通账号”和“合约账号”。
普通账号由程序离线生成,在本地保存;合约账号是XuperChain中用于智能合约管理的单元,由普通账户发起交易,在链上生成的一个16位数字的账户,存储在链上。发起合约相关交易,比如合约调用时,需要使用合约账户。
创建账号的操作如下:
# 创建普通用户, 生成的地址,公钥,私钥在--output 指定位置
$ bin/xchain-cli account newkeys --output data/bob
create account using crypto type default
create account in data/bob## 创建合约账号
bin/xchain-cli account new --account 1111111111111111 --fee 2000
账号创建完成后会在data/bob目录下会看到文件address,publickey,privatekey生成,这就是本次创建账号的地址、公钥和私钥,在下面的操作中将会用到。
第二步 查询资源余额 以普通账号为例,使用如下命令查询账号资源余额,其中-H参数为Xuperchain服务的地址。
# 根据账户存储的路径,查询该账户的余额。--keys为要查询的账户的地址
$ bin/xchain-cli account balance --keys data/keys
100000000000338000000# 根据地址查询该账户余额
$ bin/xchain-cli account balance TeyyPLpp9L7QAcxHangtcHTu7HUZ6iydY
100000000000401000000
第三步 转账 转账操作需要提供源账号的私钥目录,也就类似“创建新账号”中生成的目录,这里注意到并不需要提供目标账号的任何密钥,只需要提供地址即可。命令执行的返回是转账操作的交易id(txid)。
# --keys 从此地址 转给 --to地址 --amount 金额
$ bin/xchain-cli transfer --to czojZcZ6cHSiDVJ4jFoZMB1PjKnfUiuFQ --amount 10 --keys data/keys/ -H 127.0.0.1:37101
24d53ea6e61ede8dc4fe65a04fd30da17c079a359e700738f8795dfddc55ffb4
第四步 查询账号交易信息 通过以下命令可以查询交易的信息,包括交易状态、交易的目标账号、交易的金额、所在的区块(如果已上链)等内容。
# 可查询上一步生成的txid的交易信息
$ bin/xchain-cli tx query 24d53ea6e61ede8dc4fe65a04fd30da17c079a359e700738f8795dfddc55ffb4 -H 127.0.0.1:37101
{
"txid": "24d53ea6e61ede8dc4fe65a04fd30da17c079a359e700738f8795dfddc55ffb4",
"blockid": "e83eae0750d0f48cc2b45f25d853fb587d124552851bf6693757e0715837b377",
"txInputs": [
{
"refTxid": "2650aa0c0e8088def98093a327b475fa7577fa8e266c5775435f7c022fe0f463",
"refOffset": 0,
"fromAddr": "TeyyPLpp9L7QAcxHangtcHTu7HUZ6iydY",
"amount": "1000000"
}
],
......
"authRequireSigns": [
{
"publickey": "{\"Curvname\":\"P-256\",\"X\":36505150171354363400464126431978257855318414556425194490762274938603757905292,\"Y\":79656876957602994269528255245092635964473154458596947290316223079846501380076}",
"sign": "30460221009509e35b1341284b5d1f22b48c862ecfe2856056196c5650bc203b8a4ed0d454022100f8d286c63ad8eb3bc605bc08da4ff417aaff3c0433a31039f608bb47a90b1267"
}
],
"receivedTimestamp": 1628596303271475925,
"modifyBlock": {
"marked": false,
"effectiveHeight": 0,
"effectiveTxid": ""
}
}
第五步 查询block信息 通过block id可以查询区块的相关信息,包括区块内打包的交易、所在链的高度、前驱/后继区块的id等内容。
# 可查询上一步交易所在的block id信息
$ bin/xchain-cli block e83eae0750d0f48cc2b45f25d853fb587d124552851bf6693757e0715837b377 -H 127.0.0.1:37101{
"version": 1,
"blockid": "e83eae0750d0f48cc2b45f25d853fb587d124552851bf6693757e0715837b377",
"preHash": "41c74e22ccea7dcf1db6ba0d7e1eefd6cfbd7bac7659c3d8cd33d2a009201003",
"proposer": "TeyyPLpp9L7QAcxHangtcHTu7HUZ6iydY",
"sign": "3044021f349da2d5c238175a6e7df23262eeb122014f0a0040fc4ce109a3ab2c22b2700221009d92198061193fcd47e25c8f5c2b54e1ea2ffb4aaab675384c4d6408ab2b63de",
"pubkey": "{\"Curvname\":\"P-256\",\"X\":36505150171354363400464126431978257855318414556425194490762274938603757905292,\"Y\":79656876957602994269528255245092635964473154458596947290316223079846501380076}",
"merkleRoot": "d22d2423a93911e42f96370167d878f6780fea44fac6a13771c7532e1969c949",
"height": 492,
......
"txCount": 2,
"merkleTree": [
"4a7e42654cf79d6525f6b6d55673b57a92048ee96de950e962db99b102e048a4",
"24d53ea6e61ede8dc4fe65a04fd30da17c079a359e700738f8795dfddc55ffb4",
"d22d2423a93911e42f96370167d878f6780fea44fac6a13771c7532e1969c949"
],
"inTrunk": true,
"nextHash": "a541ed97789537166bec5778aad7ba0f68e52a04d1073b244ee1ea6cd38d8f63",
"failedTxs": null,
"curTerm": 0,
"curBlockNum": 0,
"justify": {}
}
到这里,你已经完成了XuperChain编译运行的环境部署,构建了第一条链并完成了建链后的一些基本操作!如果你对以上操作有任何疑问的,欢迎添加百度超级链小助手,进入技术交流群跟我们一同探讨!
推荐阅读
- 推动NFT走出监管困境,BSN推出支持NFT基础设施网络
- 腾讯|SaaS的收入模型有哪些(终于有人讲明白了)
- 就业方向上什么才是最重要的(--- 来自程序猿的迷茫。(C++?Java?or算法?))
- 区块链中加密货币的含义
- 波场万倍潜力币HYL23号21:09分 正式上线JustSwap
- 《瀚兰房地产开发区块链应用及案例分享》BSN培训精华回顾
- 对联盟链而言,跨链协议为什么重要()
- 区块链能够应用在哪些行业
- BSN区块链服务网络中密钥托管模式和公钥上传模式有啥区别()
- 币圈人物传|币圈大佬今何在 唯有一诺正当时