接入区块链¶
完成了WeCross的部署，如何让它和一条真实的区块链交互，相信优秀的您一定在跃跃欲试。接下来的教程将以接入FISCO BCOS为例介绍如何体验WeCross+区块链。
搭链FISCO BCOS链¶
若已有搭建好的FISCO BCOS链，请忽略本小节。
FISCO BCOS官方提供了一键搭链的教程，详见单群组FISCO BCOS联盟链的搭建
详细步骤如下：
- 脚本建链
# 创建操作目录
cd ~ && mkdir -p fisco && cd fisco
# 下载build_chain.sh脚本
curl -LO https://github.com/FISCO-BCOS/FISCO-BCOS/releases/download/v2.2.0/build_chain.sh && chmod u+x build_chain.sh
# 搭建单群组4节点联盟链
# 在fisco目录下执行下面的指令，生成一条单群组4节点的FISCO链。请确保机器的30300~30303，20200~20203，8545~8548端口没有被占用。
# 命令执行成功会输出All completed。如果执行出错，请检查nodes/build.log文件中的错误信息。
bash build_chain.sh -l "127.0.0.1:4" -p 30300,20200,8545
- 启动所有节点
bash nodes/127.0.0.1/start_all.sh
启动成功会输出类似下面内容的响应。否则请使用netstat -an | grep tcp检查机器的30300~30303，20200~20203，8545~8548端口是否被占用。
try to start node0
try to start node1
try to start node2
try to start node3
node1 start successfully
node2 start successfully
node0 start successfully
node3 start successfully
部署HelloWeCross合约¶
通过FISCO BCOS控制台部署HelloWeCross合约，控制台的安装和使用详见官方文档配置及使用控制台
HelloWeCross.sol位于~/wecross/routers-payment/127.0.0.1-8250-25500/conf/stubs-sample/bcos/
控制台安装配置完后启动并部署HelloWeCross.sol，返回的合约地址在之后的WeCross配置中需要用到。详细步骤如下：
- 安装控制台
# 获取控制台并回到fisco目录
cd ~/fisco && bash <(curl -s https://raw.githubusercontent.com/FISCO-BCOS/console/master/tools/download_console.sh)
# 拷贝控制台配置文件
# 若节点未采用默认端口，请将文件中的20200替换成节点对应的channle端口。
cp -n console/conf/applicationContext-sample.xml console/conf/applicationContext.xml
# 配置控制台证书
cp nodes/127.0.0.1/sdk/* console/conf/
- 拷贝合约文件
将HelloWeCross合约拷贝至控制台目录（用控制台部署）
cp ~/wecross/routers-payment/127.0.0.1-8250-25500/conf/stubs-sample/bcos/HelloWeCross.sol console/contracts/solidity/
- 启动控制台
cd ~/fisco/console && bash start.sh
输出下述信息表明启动成功 否则请检查conf/applicationContext.xml中节点端口配置是否正确
=============================================================================================
Welcome to FISCO BCOS console(1.0.3)！
Type 'help' or 'h' for help. Type 'quit' or 'q' to quit console.
________ ______ ______ ______ ______ _______ ______ ______ ______
| \| \ / \ / \ / \ | \ / \ / \ / \
| $$$$$$$$ \$$$$$$| $$$$$$\| $$$$$$\| $$$$$$\ | $$$$$$$\| $$$$$$\| $$$$$$\| $$$$$$\
| $$__ | $$ | $$___\$$| $$ \$$| $$ | $$ | $$__/ $$| $$ \$$| $$ | $$| $$___\$$
| $$ \ | $$ \$$ \ | $$ | $$ | $$ | $$ $$| $$ | $$ | $$ \$$ \
| $$$$$ | $$ _\$$$$$$\| $$ __ | $$ | $$ | $$$$$$$\| $$ __ | $$ | $$ _\$$$$$$\
| $$ _| $$_ | \__| $$| $$__/ \| $$__/ $$ | $$__/ $$| $$__/ \| $$__/ $$| \__| $$
| $$ | $$ \ \$$ $$ \$$ $$ \$$ $$ | $$ $$ \$$ $$ \$$ $$ \$$ $$
\$$ \$$$$$$ \$$$$$$ \$$$$$$ \$$$$$$ \$$$$$$$ \$$$$$$ \$$$$$$ \$$$$$$
=============================================================================================
- 部署合约
[group:1]> deploy HelloWeCross
contract address: 0x04ae9de7bc7397379fad6220ae01529006022d1b
将HelloWeCross的合约地址记录下来，后续步骤中使用：contract address: 0x04ae9de7bc7397379fad6220ae01529006022d1b
配置FISCO BCOS Connection¶
完成了FISCO BCOS的搭建以及合约的部署，要完成WeCross和FISCO BCOS的交互，需要配置FISCO BCOS connection，即配置连接信息以及链上的资源。
- 生成stub配置文件
切换至跨链路由的目录，用 generate_connection.sh 脚本在conf目录下生成FISCO BCOS connection的配置文件框架。
cd ~/wecross/routers-payment/127.0.0.1-8250-25500
bash generate_connection.sh -t BCOS2.0 -n bcos
注解
- -n指定connection的名字（即此链在跨链分区中的名字），默认在跨链路由的conf/stubs目录下生成相关的配置框架。
命令执行成功会输出operator: connection type: BCOS2.0 path: conf/stubs//bcos；如果执行出错，请查看屏幕打印提示。
生成的目录结构如下：
my_bcos_connection/
└── stub.toml # 连接配置文件
之后只需要配置证书、群组以及资源信息。
- 配置证书
将FISCO BCOS节点的证书目录127.0.0.1/sdk下的ca.crt, sdk.key, sdk.crt文件拷贝到conf/stubs/bcos目录下。
cp ~/fisco/nodes/127.0.0.1/sdk/* conf/stubs/bcos/
- 配置群组
vi conf/stubs/bcos/stub.toml
如果搭FISCO BCOS链采用的都是默认配置，那么将会得到一条单群组四节点的链，群组ID为1，各个节点的channel端口分别为20200, 20201, 20202, 20203，则配置如下：
[channelService]
timeout = 60000 # millisecond
caCert = 'classpath:/stubs/bcos/ca.crt'
sslCert = 'classpath:/stubs/bcos/sdk.crt'
sslKey = 'classpath:/stubs/bcos/sdk.key'
groupId = 1
connectionsStr = ['127.0.0.1:20200','127.0.0.1:20201','127.0.0.1:20202','127.0.0.1:20203']
- 配置合约资源
在stub.toml文件中配置HelloWeCross合约资源信息，让此跨链路由能够访问此合约。并将配置中多余无用的举例删除。
在前面的步骤中，已经通过FISCO BCOS控制台部署了一个HelloWeCross合约，地址为0x04ae9de7bc7397379fad6220ae01529006022d1b
[[resources]]
# name cannot be repeated
name = 'HelloWeCross'
type = 'BCOS_CONTRACT'
contractAddress = '0x04ae9de7bc7397379fad6220ae01529006022d1b'
完成了上述的步骤，那么已经完成了FISCO BCOS stub的连接配置，并注册了一个合约资源，最终的stub.toml文件如下。参考此处获取更详尽的配置说明
[common]
type = 'BCOS2.0' # BCOS
[chain]
groupId = 1 # default 1
chainId = 1 # default 1
enableGM = false # default false
[channelService]
caCert = 'classpath:/stubs/bcos/ca.crt'
sslCert = 'classpath:/stubs/bcos/sdk.crt'
sslKey = 'classpath:/stubs/bcos/sdk.key'
timeout = 300000 # ms, default 60000ms
connectionsStr = ['127.0.0.1:20200','127.0.0.1:20201','127.0.0.1:20202','127.0.0.1:20203']
# resources is a list
[[resources]]
# name cannot be repeated
name = 'HelloWeCross'
type = 'BCOS_CONTRACT'
contractAddress = '0x04ae9de7bc7397379fad6220ae01529006022d1b'
- 重新启动跨链路由 启动跨链路由加载配置好的跨链资源。
# 若WeCross跨链路由未停止，需要先停止
bash stop.sh
# 重新启动
bash start.sh
控制台访问跨链资源¶
- 启动控制台
cd ~/wecross/WeCross-Console
bash start.sh
可以通过listResources命令查看当前连接的WeCross已配置的资源，可以通过call, sendTransaction等命令实现合约资源的调用。
具体的命令列表与含义详见控制台命令。
- 查看已有资源
可查看到，跨链分区中有一个跨链资源，其IPath是payment.bcos.HelloWeCross
[server1]> listResources
Resources{
errorCode=0,
errorMessage='',
resourceList=[
WeCrossResource{
checksum='0xee1892309d5367c1c3bf5e9d76f312b4134b3209d88048302950bf0dc9395a85',
type='BCOS_CONTRACT',
distance=0,
path='payment.bcos.HelloWeCross'
}
]
}
- 调用 HelloWeCross.sol 合约
用IPath调用部署到链上的HelloWeCross合约
# payment.bcos.HelloWeCross为跨链资源标识IPath
# String为返回值类型，多个返回值类型用逗号隔开，不能有空格
# getMessage为合约中的方法名
[server1]> call payment.bcos.HelloWeCross String getMessage
Receipt{
errorCode=0,
errorMessage='success',
hash='null',
result=[
Hello WeCross
]
}
# 方法名后面是参数列表，字符串需要有单引号或者双引号
[server1]> sendTransaction payment.bcos.HelloWeCross Int,String setNumAndMsg 123 "Hello World"
Receipt{
errorCode=0,
errorMessage='null',
hash='0x1905f928b980209288280c071ff3574bacc23bbc49538f24325ac07db20133b5',
result=[
123,
Hello World
]
}
[server1]> call payment.bcos.HelloWeCross Int,IntArray,String,StringArray getAll
Receipt{
errorCode=0,
errorMessage='success',
hash='null',
result=[
123,
[
1,
2,
3,
4,
5
],
Hello World,
[
Talk is cheap,
Show me the code
]
]
}
# 退出控制台
[server1]> q
停止跨链路由
cd ~/wecross/routers-payment/127.0.0.1-8250-25500
bash stop.sh