@trustbaseai/trustchaind

TrustChain 链节点二进制 (trustchaind, Cosmos SDK v0.53.6, CGO_ENABLED=0 纯静态) — npm 一键安装。

• 支持平台: linux x86_64 / aarch64 (darwin/win32 安装时跳过二进制, 不报错)
• 分发: 平台二进制随包打进 binaries/ (tarball 142.5 MB / 解包 366.1 MB, npm 200MB 限制内); postinstall 校验 sha256 后启用
  • 若未来 tarball 超 npm 体积限制, 切换为 postinstall 从 release URL 下载 (TRUSTCHAIND_DOWNLOAD_BASE 环境变量可覆盖镜像地址, install.js 已内置该路径)

快速开始

# 1. 安装 (需要 Node >= 14)
npm i -g @trustbaseai/trustchaind

# 2. 环境自检 (9 步, 全 PASS 再往下)
bash "$(npm root -g)/@trustbaseai/trustchaind/doctor.sh"

# 3. 初始化节点
export TRUSTCHAIN_HOME=/var/lib/trustchain
trustchaind init <my-moniker> --home "$TRUSTCHAIN_HOME"

# 4. systemd 启用
sudo cp "$(npm root -g)/@trustbaseai/trustchaind/trustchaind.service" /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now trustchaind
journalctl -u trustchaind -f

加入现有网络

# genesis (向网络运营者获取)
curl -s <GENESIS_URL> -o "$TRUSTCHAIN_HOME/config/genesis.json"

# config.toml 配置
#   seeds = "<SEED_NODE_ID>@<SEED_HOST>:26656"
#   persistent_peers = "<PEER1_ID>@<PEER1_HOST>:26656,<PEER2_ID>@<PEER2_HOST>:26656"
# 占位: 主网 seed/persistent_peers 列表见 scripts/ops/fleet.conf 或向运营者索取

trustchaind start --home "$TRUSTCHAIN_HOME"
# 同步进度: curl -s localhost:26657/status | jq .result.sync_info

节点角色

| 角色 | 说明 | 资源基线 | |---|---|---| | 验证者 (validator) | 出块投票, 需质押 + priv_validator_key; 务必配 sentry 或防火墙, 不直接暴露 p2p | 4C/8G/200G SSD | | 全节点 (full) | 中继 + RPC 服务, 不参与共识; indexer/业务后端挂它 | 2C/2G/100G (H618 实测可跑) | | 哨兵 (sentry) | 验证者的对外代理层, 挡 DDoS/扫描; 与验证者走内网 peering | 2C/4G |

运维脚本 (包根目录)

• doctor.sh — 9 步自检: 架构/OS/内核/glibc/init/依赖(jq,curl)/RPC 26657/磁盘/内存, 每步 PASS/FAIL + 修复建议
• watchdog.sh — 探活 RPC /status, 异常则 systemctl restart trustchaind, 写 /var/log/trustchaind-watchdog.log; 挂 systemd timer 或 cron 每分钟跑
• update-check.sh — 本地二进制 sha256 vs 远端 SHASUMS256.txt 清单对比, 提示可更新
• trustchaind.service — systemd unit 模板; 覆盖用 systemctl edit trustchaind

TRUSTCHAIN_ALLOW_STORE_HEAL (重要)

store 自愈闸门, 默认关。仅在协调升级窗口内通过 systemctl edit trustchaind 临时开启, 升级完成立即移除。Environment= 行书写规范见 unit 文件注释 —— 引号+前导空格会让闸门 静默失效 (2026-09-07 事故)。升级前用 scripts/ops/unit-lint.sh --require-heal 体检。

协调升级

多节点 fleet 升级不要手工逐台换二进制, 用链仓 scripts/ops/fleet-upgrade.sh: sha 预检 → 停服 → 快照 → 备份 → 换 binary → 启动 → app hash 比对。详见 scripts/ops/README.md。