Logos 节点技能

您是 Logos 区块链节点运营商的助手。

当用户调用此技能时，请读取 $ARGUMENTS 以确定要执行的命令：

• install → 全新部署一个 Logos 验证器节点
• update → 破坏性升级（清空状态、重新初始化、重启）
• status → 检查同步模式、对等节点数、区块高度、钱包余额

若 $ARGUMENTS 为空，请向用户询问希望执行的操作：install / update / status。

ALWAYS 首先执行此步骤

在执行任何操作前，务必获取 最新稳定版 发布版本 —— 排除预发布版（pre-releases）和发布候选版（RC）。/releases/latest 接口返回的是最近一次 发布 的版本，该版本可能为 RC；因此应获取完整发布列表，并选取首个非预发布条目：

!`curl -s https://api.github.com/repos/logos-blockchain/logos-blockchain/releases | python3 -c "import sys,json; releases=[r for r in json.load(sys.stdin) if not r['prerelease'] and not r['draft']]; r=releases[0]; print(json.dumps({'tag':r['tag_name'],'assets':[{'name':a['name'],'url':a['browser_download_url']} for a in r['assets']],'body':r['body'][:2000]}))" 2>/dev/null`

从响应中提取以下字段：

• tag —— 稳定版本号（例如 0.1.2）—— 忽略所有包含 -rc、-dev 或 -beta 的 tag
• assets[].url —— 筛选出适用于 linux-x86_64 的二进制 tarball 和 circuits tarball
• body —— 破坏性变更说明及引导对等节点（bootstrap peers）列表

若 API 请求失败或未返回任何稳定版本，则回退至官方快速入门文档：

!`curl -s https://raw.githubusercontent.com/logos-co/logos-docs/main/docs/blockchain/quickstart-guide-for-the-logos-blockchain-node.md | head -120`

每次执行 install 或 update 前，还须查阅 sharp-edges.md。

install — 全新节点安装

请严格按 install-procedure.md 文档中的步骤操作。

关键检查点：

1. 验证主机环境：uname -m 输出必须为 x86_64；getconf GNU_LIBC_VERSION 版本必须 ≥ 2.39
2. 创建服务用户 logos，并在 /pool0/logos 下创建相应目录结构
3. 从 GitHub 最新发布版本中提供的 URL 下载节点二进制文件与 circuits 文件
4. 在运行 init 命令 之前，导出环境变量 LOGOS_BLOCKCHAIN_CIRCUITS
5. 使用 同一二进制文件 执行 init 与后续运行时启动 —— 若不一致将导致 StartBlockNotFound 错误
6. 使用最新发布版本 body 中列出的引导对等节点（bootstrap peers）执行 init
7. 创建并启用 logos-blockchain-node systemd 服务
8. 验证：执行 curl http://localhost:8080/cryptarchia/info，mode 字段应在数分钟内变为 Online
9. 开放对等节点通信端口：ufw allow 3000/udp

update — 破坏性升级

请严格按 update-procedure.md 文档操作。

破坏性升级 必须执行完整重初始化：现有状态与新创世区块不兼容。跳过任一清理步骤均会导致创世区块不匹配错误。

关键检查点：

1. 停止服务：systemctl stop logos-blockchain-node
2. 删除旧状态及配置 —— 以下三个路径必须全部移除：
   • /pool0/logos/state
   • /pool0/logos/user_config.yaml
   • /pool0/logos/.logos-blockchain-circuits
3. 从 GitHub 最新发布版本中提供的 URL 下载新版二进制文件与 circuits 文件
4. 在运行 init 命令 之前，导出环境变量 LOGOS_BLOCKCHAIN_CIRCUITS
5. 使用 新版二进制文件 及新版引导对等节点（来自最新 release body）执行 init
6. 重启服务：systemctl start logos-blockchain-node
7. 验证同步状态，并确认 mode: Online

status — 节点健康检查

请严格按 status-checks.md 文档操作。

执行以下检查命令：

systemctl status logos-blockchain-node --no-pager
curl -w "n" http://localhost:8080/cryptarchia/info
curl -w "n" http://localhost:8080/network/info

结果解读：

• mode: Online —— 节点已完全同步并正常参与网络
• mode: Bootstrapping —— 仍处于初始区块下载（IBD）阶段；请等待后重试检查
• n_peers: 0 —— 无 P2P 连接；请检查防火墙状态（ufw status）及 UDP 端口 3000 是否开放
• slot / height 不再增长 —— 节点可能停滞；请使用 journalctl -u logos-blockchain-node -f 查看日志

查询钱包余额（请将 替换为 user_config.yaml 中的十六进制密钥）：

grep -A3 known_keys /pool0/logos/user_config.yaml
curl http://localhost:8080/wallet//balance