区块链:雷电网络开发预览版 • 雷电网络开发预览版-初体验 – Raiden 环境搭建 1下载 Raiden 执行文件 2安装 Parity 客户端 3准备账号 4启动 Parity 同步 ropsten 测试网络 5在 Ropsten 给账号增加以太 balance 6启动 Raiden • 7. 检查是否运行正常 – 节点交互 1调用 RTT 合约转账给 A、B 账户使其先拥有 RTT 余额 2A、B 节点自动连接 RTT network(可选)
3与 B 建立直接的状态通道 4A 节点查看状态通道信息 5向状态通道 deposit(可选)
6A 向 B 节点 发起 RTT 转账 1 7查询通道的事件信息 8关闭状态通道 • 9. 节点离开 RTT network(可选)
– 其他 以下内容在 ubuntu 机器 ,Ropsten 测试网络实测 ok。
注意:随着 Raiden 开发的不断推进,本文内容有可能不适用未来最新版本
Raiden 环境搭建 1. 下载 Raiden 执行文件 wget https://github.com/raiden-network/raiden/releases/download/v0.1.0/raiden--x86_64.AppImage
mv raiden--x86_64.AppImage raiden
chmod +x raiden
2. 安装 Parity 客户端 wget https://parity-downloads-mirror.parity.io/v1.7.6/x86_64-unknown-linux-gnu/parity_1.7.6_amd64.deb
dpkg -i parity_1.7.6_amd64.deb
3. 准备账号 parity account new --chain ropsten --keys-path ~/.local/share/io.parity.ethereum/keys/ethereum/
新建两个 eth 账户。Raiden 节点使用 eth 地址来标识。
下文假设 A 账户为 0x607f1724469a0beeed74e1429c3c5adcf8290fa3,B 账户为0x17cb47f30f844b6969e8cc6cd3c506eb25f17819。
4. 启动 Parity 同步 ropsten 测试网络 #parity db kill --chain ropsten
parity --geth --keys-path ~/.local/share/io.parity.ethereum/keys/ethereum/ --chain ropsten --bootnodes "enode://20c9ad97c081d63397d7b685a412227a40e23c8bdc6688c6f37e97cfbc22d2b4d1db1510d8f61e6a8866ad7f0e17c02b14182d37ea7c3c8b9c2683aeb6b733a1@52.169.14.227:30303,enode://6ce05930c72abc632c58e2e4324f7c7ea478cec0ed4fa2528982cf34483094e9cbc9216e7aa349691242576d552a2a56aaeae426c5303ded677ce455ba1acd9d@13.84.180.240:30303"
parity 默认已开启 Warp sync。等待网络同步完成再执行后面的操作。否则 raiden启动的时候会报 Raiden 的 Registry 合约无法找到的错误。
5. 在 在 Ropsten 给账号增加以太 balance 因为 raiden 中加入网络和建立通道都需要发送交易,所以要求对应账户的 eth 余额不能为 0。
打开 http://faucet.ropsten.be:3001/ 给 4 中的账户发送 ether。
6. 启动 Raiden 配置不同的端口,启动两个节点:
./raiden --keystore-path ~/.local/share/io.parity.ethereum/keys/ethereum/test/ --api-address 0.0.0.0:9545 --listen-address 0.0.0.0:4001
./raiden --keystore-path ~/.local/share/io.parity.ethereum/keys/ethereum/test/ --api-address 0.0.0.0:9546 --listen-address 0.0.0.0:4002
选择不同的账户,并输入密码解锁。
正常启动情况下会输出 API 端口信息。
后面与 Raiden 都是通过 Restful API 来交互。
7. 检查是否运行正常 curl http://127.0.0.1:9545/api/1/address
#返回 {"our_address": "0x607f1724469a0beeed74e1429c3c5adcf8290fa3"}
curl http://127.0.0.1:9546/api/1/address
#返回 {"our_address": "0x17cb47f30f844b6969e8cc6cd3c506eb25f17819"}
输出的地址与启动时候所选择的账户地址一致,则已正常运行。
至此,两个节点的 Raiden 环境已经搭建起来了。
节点交互 通过 API 可以向网络注册新的 Token Network,也可以直接接入一个已注册的Token Network,可以与其他 Raiden 节点建立 Channel 并 Deposit 到 Channel,还有其他的一些相关操作。详细可以看 Raiden 的 API 说明 。
Raiden 提供了一个已注册好的 Raiden Testnet Token (RTT)。RTT 地址是0x0f114a1e9db192502e7856309cc899952b3db1ed 。
下面的内容是对部分 API 的简单体验过程。
1. 调用 RTT 合约转账给 A 、B 账户使其先拥有 RTT 余额 使用 web3.js 调用以下代码发起账户转账 RTT 代币�的交易。注意调用之前先解锁账户。
var addr="0x607f1724469a0beeed74e1429c3c5adcf8290fa3";#改成自己的账户地址
var rtt_token_abi = Contract ABI; #可以从 https://ropsten.etherscan.io/address/0x0f114a1e9db192502e7856309cc899952b3db1ed#code 获取
var rtt_token_address = "0x0f114a1e9db192502e7856309cc899952b3db1ed";
var rtt_token = web3.eth.contract(rtt_token_abi).at(rtt_token_address);
rtt_token.mint({from:addr}); // adjust to your raiden account and unlock first!
console.log(rtt_token.balanceOf(addr).toString());
每调用一次,RTT 增加 100。调用完之后,可以在https://ropsten.etherscan.io/address/账户地址 查看交易状态。如果交易上链了,账户的 RTT 代币余额就会增加,可以多调几次,使得余额充足,方便后面的通道转账。
2. A 、B 节点自动连接 RTT network (可选)
#对 A 节点
curl -X PUT -H "Content-Type: application/json" -d "{"funds":100}" http://127.0.0.1:9545/api/1/connection/0x0f114a1e9db192502e7856309cc899952b3db1ed
#对 B 节点
curl -X PUT -H "Content-Type: application/json" -d "{"funds":100}" http://127.0.0.1:9546/api/1/connection/0x0f114a1e9db192502e7856309cc899952b3db1ed
正常情况下输出状态变更事件消息:
INFO:raiden.network.rpc.client
new_netting_channel called peer1=a6c07564 netting_channel=4b644413 peer2=0f658429
INFO:raiden.event_handler
state_change received state_change=<raiden.transfer.mediated_transfer.state_change.ContractReceiveNewChannel object at 0x7fa497756bd0>
INFO:raiden.network.rpc.client
deposit called amount=400 contract=4b644413
INFO:raiden.event_handler
state_change received state_change=<raiden.transfer.mediated_transfer.state_change.ContractReceiveBalance object at 0x7fa497706f10>
INFO:raiden.network.rpc.client
new_netting_channel called peer1=a6c07564 netting_channel=ea955179 peer2=9598decb
INFO:raiden.event_handler
state_change received state_change=<raiden.transfer.mediated_transfer.state_change.ContractReceiveNewChannel object at 0x7fa497706ad0>
INFO:raiden.event_handler
state_change received state_change=<raiden.transfer.mediated_transfer.state_change.ContractReceiveBalance object at 0x7fa497730890>
INFO:raiden.network.rpc.client
deposit called amount=400 contract=ea955179
ERROR:raiden.tasks
alarm missed 1 blocks
ERROR:raiden.tasks
alarm missed 2 blocks
INFO:raiden.network.rpc.client
new_netting_channel called peer1=a6c07564 netting_channel=7c2bfbda peer2=82710a71
INFO:raiden.event_handler
state_change received state_change=<raiden.transfer.mediated_transfer.state_change.ContractReceiveNewChannel object at 0x7fa497730f90>
INFO:raiden.network.rpc.client
deposit called amount=400 contract=7c2bfbda
INFO:raiden.event_handler
state_change received state_change=<raiden.transfer.mediated_transfer.state_change.ContractReceiveBalance object at 0x7fa49773c1d0>
每个节点执行成功之后,节点就会自动加入 RTT network 并且与其他三个随机的节点建立状态通道,并且每个 channel 会 deposit 20%的 funds,剩余的 40%funds留给新加进来的节点来建立状态通道。
如果是 RTT 余额不足,Raiden 客户端会提示:
INFO:raiden.network.rpc.client
new_netting_channel called peer1=1fb444d0 netting_channel=fd0a1d0e peer2=82710a71
3. A 与 与 B 建立直接的状态通道 curl -X PUT -H "Content-Type: application/json" -d "{"partner_address": "0x17cb47f30f844b6969e8cc6cd3c506eb25f17819","token_address": "0x0f114a1e9db192502e7856309cc899952b3db1ed","balance": 100,"settle_timeout": 600}" http://127.0.0.1:9545/api/1/channels
其中 partner_address 是节点地址,即 B 节点地址,token_address 是 token 地址,即 RTT 的地址。
正常建立情况下会有类似提示:
INFO:raiden.event_handler
state_change received state_change=<raiden.transfer.mediated_transfer.state_change.ContractReceiveNewChannel object at 0x7f7f1ed34e50>
INFO:raiden.network.rpc.client
deposit called amount=100 contract=721d03ec
4. A 节点查看状态 通道信息 curl -X GET http://127.0.0.1:9545/api/1/channels
返回:
[
{
"balance": 100,
"channel_address": "0x721d03ec76ccbfdce0ad3fc4602b59d622304d25",
"partner_address": "0x17cb47f30f844b6969e8cc6cd3c506eb25f17819",
"reveal_timeout": 10,
"settle_timeout": 600,
"state": "opened",
"token_address": "0x0f114a1e9db192502e7856309cc899952b3db1ed"
}
]
curl -X GET http://127.0.0.1:9546/api/1/channels
返回:
[
{
"balance": 0,
"channel_address": "0x504750b7b1e0940119f3d0bad11e2fc766ab97a1",
"partner_address": "0x0c599ace7e0a7ff7c0ce6ba1c50f35ec58c04e86",
"reveal_timeout": 10,
"settle_timeout": 400,
"state": "opened",
"token_address": "0x0f114a1e9db192502e7856309cc899952b3db1ed"
}
]
从返回可以看出,state 为 opened,状态通道中 A 余额为 100,B 余额为 0。
5. 向状态通道 deposit (可选)
从 4 中可以看到 B 和 A 节点的状态通道的 balance。也可以 deposit。
curl -X PATCH -H "Content-Type: application/json" -d "{"balance":50}" http://127.0.0.1:9545/api/1/channels/0x721d03ec76ccbfdce0ad3fc4602b59d622304d25 #注意是 channel_address
6. A 向 向 B 节点 发起 RTT 转账 1 curl -H "Content-Type:application/json" -X POST --data "{"amount":1}" http://127.0.0.1:9545/api/1/transfers/0x0f114a1e9db192502e7856309cc899952b3db1ed/0x17cb47f30f844b6969e8cc6cd3c506eb25f17819# 节点地址
返回:
{
"amount": 1,
"identifier": 6913515701748887592,
"initiator_address": "0x607f1724469a0beeed74e1429c3c5adcf8290fa3",
"target_address": "0x17cb47f30f844b6969e8cc6cd3c506eb25f17819",
"token_address": "0x0f114a1e9db192502e7856309cc899952b3db1ed"
}
转账成功。
此时再次查询状态通道信息 curl -X GET http://127.0.0.1:9545/api/1/channels
[
{
"balance": 99,
"channel_address": "0x721d03ec76ccbfdce0ad3fc4602b59d622304d25",
"partner_address": "0x17cb47f30f844b6969e8cc6cd3c506eb25f17819",
"reveal_timeout": 10,
"settle_timeout": 600,
"state": "opened",
"token_address": "0x0f114a1e9db192502e7856309cc899952b3db1ed"
}
]
curl -X GET http://127.0.0.1:9546/api/1/channels
[
{
"balance": 1,
"channel_address": "0x721d03ec76ccbfdce0ad3fc4602b59d622304d25",
"partner_address": "0x607f1724469a0beeed74e1429c3c5adcf8290fa3",
"reveal_timeout": 10,
"settle_timeout": 600,
"state": "opened",
"token_address": "0x0f114a1e9db192502e7856309cc899952b3db1ed"
}
]
从返回可以看出,状态通道中 A 余额为 99,B 余额为 1。
7. 查询通道的事件信息 curl -X GET http://127.0.0.1:9545/api/1/events/channels/0x721d03ec76ccbfdce0ad3fc4602b59d622304d25#状态通道地址
返回
[{"block_number": 1892761, "participant": "607f1724469a0beeed74e1429c3c5adcf8290fa3", "event_type": "ChannelNewBalance", "balance": 100, "token_address": "0f114a1e9db192502e7856309cc899952b3db1ed"}, {"block_number": 1892768, "participant": "607f1724469a0beeed74e1429c3c5adcf8290fa3", "event_type": "ChannelNewBalance", "balance": 600, "token_address": "0f114a1e9db192502e7856309cc899952b3db1ed"}, {"block_number": 1892781, "participant": "607f1724469a0beeed74e1429c3c5adcf8290fa3", "event_type": "ChannelNewBalance", "balance": 650, "token_address": "0f114a1e9db192502e7856309cc899952b3db1ed"}, {"block_number": 1892786, "event_type": "EventTransferSentSuccess", "identifier": 6913515701748887592}]
会看到状态通道所有的事件消息。
8. 关闭状态通道 curl -X PATCH -H "Content-Type: application/json" -d "{"state":"closed"}" http://127.0.0.1:9545/api/1/channels/0x721d03ec76ccbfdce0ad3fc4602b59d622304d25 #注意是 channel_address
此时再次查询状态通道信息 curl -X GET http://127.0.0.1:9545/api/1/channels
9. 节点离开 RTT network (可选)
curl -X "DELETE" -H "Content-Type: application/json" -d "{"only_receiving_channels": false}" http://127.0.0.1:9546/api/1/connection/0x0f114a1e9db192502e7856309cc899952b3db1ed
其他 为了简化测试体验,Raiden 提供了一个特殊的 Raiden Echo Node。Raiden Echo Node 地址是 0x02f4b6bc65561a792836212ebc54434db0ab759a 。体验过程可以只建立一个节点与 Raiden Echo Node 交互。