概述
本服务转发用户端发起请求到区块链相应的节点并在此期间提供最优节点,主要应用在提交交易、余额查阅,查询矿工费等场景
架构简述
1.网关由gin实现,负责接受客户端发起的请求,
2.收到请求并通过验证后,将请求转发到service中
3.判断区块链类型且选择最佳的节点
4.把请求数据 发送到最佳节点,且等待响应
5.把请求的最终结果,告知客户端
限制
Prerequisites
Building the source
(以linux系统为例)
-
mkdir easynode & cd easynode
-
git https://github.com/uduncloud/easynode_chain.git
-
cd easynode_chain
-
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o easynode_chain app.go
(mac下编译linux程序为例,其他交叉编译的命令请自行搜索)
-
./easynode_chain -config ./config.json
config.json 解释
{
"RootPath": "/api/chain", //api根目录
"Port": 9002, //端口
"BlockChain": [200,205], //支持的公链代码
"Cluster": {//区块链节点集群
"200": [{ //ether 节点配置
"NodeUrl": "https://eth-mainnet.g.alchemy.com/v2", //节点地址
"NodeToken": "************************" //节点需要token
}],
"205": [{ //tron 节点配置
"NodeUrl": "https://api.trongrid.io",//节点地址
"NodeToken": "********************"//节点需要token
}]
}
}
usages
//发送交易接口
curl -X POST \
http://127.0.0.1:9002/api/chain/200/tx/sendRawTransaction \
-H 'Content-Type: application/json' \
-H 'Postman-Token: 84336133-4ab2-47c4-b600-7b56bfdd79d9' \
-H 'cache-control: no-cache' \
-d '{
"signed_tx":"0xe5cB067E90D5Cd1F8052B83562Ae670bA4A211a8"
}'
//查询地址余额接口
curl -X POST \
http://127.0.0.1:9002/api/chain/200/account/balance \
-H 'Content-Type: application/json' \
-H 'Postman-Token: 3eac86c7-c5aa-4dd3-93d3-a3b23678512d' \
-H 'cache-control: no-cache' \
-d '{
"address":"0xe5cB067E90D5Cd1F8052B83562Ae670bA4A211a8",
"tag":"latest"
}'
curl -X POST \
http://127.0.0.1:9002/api/chain/205/account/balance \
-H 'Content-Type: application/json' \
-H 'Postman-Token: 7b49c120-1bfe-4223-9a7a-e1d2620f3099' \
-H 'cache-control: no-cache' \
-d '{
"address":"TUtAk64jJqdf1pY3SiHeooVikP2SFWXjZ6"
}'
//Ether 链的 nonce值
curl -X POST \
http://127.0.0.1:9002/api/chain/200/account/nonce \
-H 'Content-Type: application/json' \
-H 'Postman-Token: 8fe90095-369c-453c-8d59-6fa18b0a83a0' \
-H 'cache-control: no-cache' \
-d '{
"address":"0xe5cB067E90D5Cd1F8052B83562Ae670bA4A211a8",
"tag":"latest"
}'
// 区块链的最新区块高度
curl -X POST \
http://127.0.0.1:9002/api/chain/205/block/latest \
-H 'Content-Type: application/json' \
-H 'Postman-Token: 8d1d5eab-482a-4f0b-b31e-98ab59daf924' \
-H 'cache-control: no-cache'
// 代币余额查询
curl -X POST \
http://127.0.0.1:9002/api/chain/205/account/tokenBalance \
-H 'Content-Type: application/json' \
-H 'Postman-Token: 380f20a5-b023-42bd-961c-ac5f84c580e1' \
-H 'cache-control: no-cache' \
-d '{
"address":"TMuA6YqfCeX8EhbfYEg5y7S4DqzSJireY9",
"codeHash":"TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7",
}'
//区块链通用接口,基于区块链标准,以http-rpc协议实现
curl -X POST \
http://127.0.0.1:9002/api/chain/200/send \
-H 'Content-Type: application/json' \
-H 'Postman-Token: 3d6a170b-bd88-42b5-83d1-d3e5bec7babf' \
-H 'cache-control: no-cache' \
-d '{
"id": 1,
"jsonrpc": "2.0",
"params": [
"0xe5cB067E90D5Cd1F8052B83562Ae670bA4A211a8",
"latest"
],
"method": "eth_getBalance"
}'