门外汉自学系列:[ 三、 cURL查询功能 ]


#1

cURL查询功能

什么是cURL?

cURL是一个利用URL语法在命令行下工作的文件传输工具,支持http、https、ftp等30多种类型协议的传输,常用于对web页面进行访问;

如何获取 CITA 服务端口信息?

在文档快速部署CITA服务中,成功部署了默认参数的 CITA 服务,初始化环境中会运行4个 CITA 共识节点,默认共运行了28个进程;

netstat -nutlp | grep ‘cita-jsonrpc’
#查看当前主机上运行的 CITA 节点的 RPC 服务端口号

Tips:
默认情况下,cita-jsonrpc 服务的端口号起始于1337,如果单台主机部署多个节点,该端口号将逐个递增;
通过访问该进程提供的端口号,可对 CITA 服务的运行状态进行查询;默认情况下防火墙未放行非知名端口号,所以如果需对外提供该端口的访问,请务必打开防火墙,放行相应端口;

netstat -nutlp | grep ‘cita-network’
#查看当前主机上运行的 CITA 节点的 Network 服务端口号

Tips:
默认情况下,cita-network 服务的端口号起始于4000,如果单台主机部署多个节点,该端口号将逐个递增;
通过访问该进程提供的端口号,CITA 服务中的节点可通过 P2P 网络进行数据同步和共识计算,如果在多台主机上部署多节点进行共识计算,请务必放行该进程的相应端口;

访问 CITA 服务的 cURL 常用指令

推荐使用 python 的 json.tool 模块查看 json 格式的回执信息

查询节点数量(共识节点 + 普通节点)

curl -s -X POST --data ‘{“jsonrpc”:“2.0”,“method”:“peerCount”,“params”:[],“id”:1}’ 127.0.0.1:1337 | python -m json.tool

or

curl -s -X POST --data ‘{“jsonrpc”:“2.0”,“method”:“peerCount”,“params”:[],“id”:1}’ 127.0.0.1:1337

查看区块高度

curl -s -X POST --data ‘{“jsonrpc”:“2.0”,“method”:“blockNumber”,“params”:[],“id”:1}’ 127.0.0.1:1337 | python -m json.tool

or

curl -s -X POST --data ‘{“jsonrpc”:“2.0”,“method”:“blockNumber”,“params”:[],“id”:1}’ 127.0.0.1:1337

Tips:
区块高度值会依据区块产出时间逐个递增,当 CITA 服务中的共识节点满足大于2/3在进行共识计算,则 CITA 服务将会正常运行,区块产出时会根据经济模型的不同对节点进行经济激励;


:grinning: 很感谢您能够看到这里,如果文中的内容有描述不当,请您在本章节下方指出,我会尽快修改;