EOSIO cleos get info 命令详解：获取区块链节点实时状态
【免费下载链接】eosAn open source smart contract platform项目地址: https://gitcode.com/gh_mirrors/eo/eos
cleos get info是 EOSIO 智能合约平台中最常用的命令之一，用于查询当前连接的 nodeos 节点的实时区块链状态，包括最新区块高度、不可逆区块高度、链 ID、资源限制等核心指标。本文将结合仓库源码深入讲解该命令的完整用法、返回字段语义及其底层实现原理，帮助你准确解读节点运行状态、排查同步问题并为交易签名提供必要的链上参考数据。
命令概览
cleos get info属于cleos get子命令族（用于"从区块链获取各类条目与信息"，见 programs/cleos/main.cpp），其功能是获取当前区块链信息。
语法：
cleos get info位置参数：无，该命令不接受任何位置参数。
选项：
| 选项 | 说明 |
|---|---|
-h,--help | 打印帮助信息并退出 |
命令本身没有业务参数，但 cleos 的全局参数对其同样生效，其中最常用的是指定连接节点：
cleos -u http://127.0.0.1:8888 get info-u/--url用于指定 nodeos 节点运行的 HTTP 地址，默认值为http://127.0.0.1:8888（见 programs/cleos/main.cpp）。
运行示例
在节点正常运行时，执行cleos get info会以美化后的 JSON 格式打印节点状态：
{ "server_version": "7451e092", "head_block_num": 6980, "last_irreversible_block_num": 6963, "head_block_id": "00001b4490e32b84861230871bb1c25fb8ee777153f4f82c5f3e4ca2b9877712", "head_block_time": "2017-12-07T09:18:48", "head_block_producer": "initp", "recent_slots": "1111111111111111111111111111111111111111111111111111111111111111", "participation_rate": "1.00000000000000000" }说明：以上示例出自 docs/02_cleos/03_command-reference/get/info.md，是文档编写时期的早期版本返回格式。在当前仓库源码对应的版本中，返回字段已大幅扩充（新增
chain_id、资源限制与分叉数据库等字段），同时recent_slots与participation_rate两个字段已在实现中被注释移除（见 plugins/chain_plugin/include/eosio/chain_plugin/chain_plugin.hpp），实际返回格式请以当前节点版本为准。
返回字段逐一解读
当前版本中cleos get info的完整返回结构由read_only::get_info_results定义（见 plugins/chain_plugin/include/eosio/chain_plugin/chain_plugin.hpp），各字段含义如下：
| 字段 | 类型 | 含义 |
|---|---|---|
server_version | string | 节点版本号的十六进制表示 |
server_version_string | string（可选） | 语义化版本字符串，如v2.1.0 |
server_full_version_string | string（可选） | 完整版本字符串，通常附带构建信息 |
chain_id | string | 当前链的 ID，是交易签名的必要参数 |
head_block_num | uint32 | 最新（头）区块高度 |
head_block_id | string | 最新区块的 ID（由区块号与区块哈希构成） |
head_block_time | string | 最新区块的生产时间 |
head_block_producer | string | 最新区块的生产者账户名 |
last_irreversible_block_num | uint32 | 最后不可逆区块的高度（LIB） |
last_irreversible_block_id | string | 最后不可逆区块的 ID |
last_irreversible_block_time | string（可选） | 最后不可逆区块的生产时间 |
fork_db_head_block_num | uint32（可选） | 分叉数据库中待定头区块高度（可能大于head_block_num） |
fork_db_head_block_id | string（可选） | 分叉数据库中待定头区块 ID |
virtual_block_cpu_limit | uint64 | 虚拟 CPU 资源限制（微秒） |
virtual_block_net_limit | uint64 | 虚拟网络带宽限制（字节） |
block_cpu_limit | uint64 | 当前区块 CPU 限制（微秒） |
block_net_limit | uint64 | 当前区块网络带宽限制（字节） |
其中，资源限制相关字段（virtual_block_cpu_limit等）来自节点的资源限制管理器（Resource Limits Manager），用于衡量当前区块可用的 CPU 与网络带宽余量，是判断链上资源使用压力、估算交易可用额度的重要参考。
典型判断场景
- 节点是否在同步：比较
head_block_num与last_irreversible_block_num，若两者持续增长但fork_db_head_block_num长期停滞，说明节点可能处于分叉或追块状态； - 链身份确认：
chain_id用于区分主网与各类测试网，错误的chain_id会导致交易签名后无法被目标网络接受； - 资源余量：
block_cpu_limit/block_net_limit接近 0 时，说明链上资源已高度紧张，提交交易可能因资源不足被拒绝。
底层实现：从 cleos 到 nodeos 的完整调用链
cleos get info并非本地读取，而是通过 HTTP 调用 nodeos 的 RPC 接口实现的，其完整链路如下：
子命令注册：在 programs/cleos/main.cpp 中注册
get info子命令，回调函数将get_info()的返回值以美化 JSON 输出：get->add_subcommand("info", localized("Get current blockchain information"))->callback([] { std::cout << fc::json::to_pretty_string(get_info()) << std::endl; });HTTP 请求构造：
get_info()（programs/cleos/main.cpp）调用call(url, get_info_func)，其中get_info_func定义为/v1/chain/get_info（见 programs/cleos/httpc.hpp）：eosio::chain_apis::read_only::get_info_results get_info() { return call(url, get_info_func).as<eosio::chain_apis::read_only::get_info_results>(); }节点端路由：nodeos 的
chain_api_plugin将该路径注册为只读接口，CHAIN_RO_CALL(get_info, 200, http_params_types::no_params_required)表明该接口不接收任何请求参数（见 plugins/chain_api_plugin/chain_api_plugin.cpp）。对应地，OpenAPI 描述中/get_info为 POST 接口，描述为"返回包含区块链各种细节的对象"（见 plugins/chain_api_plugin/chain.swagger.yaml）。数据组装：最终由
chain_plugin的只读接口实现完成（plugins/chain_plugin/chain_plugin.cpp），所有字段直接取自节点的控制器（controller）与资源限制管理器：read_only::get_info_results read_only::get_info(const read_only::get_info_params&) const { const auto& rm = db.get_resource_limits_manager(); return { itoh(static_cast<uint32_t>(app().version())), // server_version db.get_chain_id(), db.head_block_num(), db.last_irreversible_block_num(), db.last_irreversible_block_id(), db.head_block_id(), db.head_block_time(), db.head_block_producer(), rm.get_virtual_block_cpu_limit(), rm.get_virtual_block_net_limit(), rm.get_block_cpu_limit(), rm.get_block_net_limit(), // ... app().version_string(), db.fork_db_pending_head_block_num(), db.fork_db_pending_head_block_id(), app().full_version_string(), db.last_irreversible_block_time() }; }
从源码结构可以推断，该接口完全基于节点内存中的链状态数据返回，因此响应速度极快，且不需要额外的数据库查询。
深度应用：cleos 内部如何依赖 get info
get info不只是给用户查看的，它在 cleos 内部也是交易提交链路的关键依赖。在push_transaction流程中（programs/cleos/main.cpp），cleos 会先调用get_info()获取链上信息，用于：
- 设置交易过期时间：
trx.expiration = info.head_block_time + tx_expiration，以最新区块时间为基准加上用户指定的过期时间； - 设置 TAPoS 参考块：默认取
info.last_irreversible_block_id作为交易的参考区块（replay protection），用户可通过--ref-block覆盖； - 交易签名：使用
info.chain_id对交易进行签名，确保交易只对该链有效。
auto info = get_info(); if (trx.signatures.size() == 0) { trx.expiration = info.head_block_time + tx_expiration; block_id_type ref_block_id = info.last_irreversible_block_id; // ... trx.set_reference_block(ref_block_id); // ... } if (!tx_skip_sign) { // ... sign_transaction(trx, required_keys, info.chain_id); }此外，get_info()还用于cleos get block --info等场景获取当前高度作为查询上下文（见 programs/cleos/main.cpp、programs/cleos/main.cpp）。
进阶用法
与 jq 配合提取字段
cleos -u http://127.0.0.1:8888 get info | jq '.head_block_num, .last_irreversible_block_num'脚本化监控同步进度
cleos get info | jq -r '"head=\(.head_block_num) lib=\(.last_irreversible_block_num) producer=\(.head_block_producer)"'通过 curl 直接调用 RPC
由于cleos get info本质是对/v1/chain/get_info的无参数 POST 请求，也可以直接用 curl 获取等价结果：
curl -X POST http://127.0.0.1:8888/v1/chain/get_info -d '{}'小结
cleos get info是 EOSIO 节点运维与开发调试的"第一入口"：一条命令即可掌握链身份、同步进度、头区块与不可逆区块状态以及资源限制。理解其返回字段的来源（get_info_results结构体）与调用链（cleos →/v1/chain/get_info→ chain_plugin），不仅能更准确地解读输出，还能明白为什么交易提交前 cleos 必须先从该接口获取参考区块与链 ID——这背后正是 EOSIO 交易签名与 TAPoS 机制的基石。
【免费下载链接】eosAn open source smart contract platform项目地址: https://gitcode.com/gh_mirrors/eo/eos
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
