Cosmos SDK 项目运行节点完整指南

Cosmos SDK 项目运行节点完整指南

cosmos-sdk :chains: A Framework for Building High Value Public Blockchains :sparkles: 项目地址: https://gitcode.com/gh_mirrors/co/cosmos-sdk

前言

Cosmos SDK 是一个用于构建区块链应用的模块化框架。本文将详细介绍如何在 Cosmos SDK 环境中运行一个完整的区块链节点。我们将以 simapp 应用为例，讲解从初始化到实际运行的完整流程。

节点运行前准备

在开始运行节点前，需要确保已完成以下准备工作：

1. 已构建好应用二进制文件（本文示例中为 simd）
2. 已设置好密钥环（keyring）并创建了至少一个账户
3. 了解 Cosmos SDK 应用的基本结构

初始化区块链

初始化命令

使用以下命令初始化区块链：

simd init <moniker> --chain-id my-test-chain

其中：

• <moniker> 是节点的自定义名称，应使用易读的标识符
• chain-id 是区块链的唯一标识符

生成的文件结构

初始化后会在 ~/.simapp 目录下生成以下文件结构：

./
├── data/                  # 节点使用的数据库
└── config/
    ├── app.toml           # 应用相关配置
    ├── config.toml        # CometBFT 相关配置
    ├── genesis.json       # 初始状态定义文件
    ├── node_key.json      # P2P 协议节点认证私钥
    └── priv_validator_key.json  # 共识协议验证者私钥

配置调整

常用配置修改

可以通过以下工具修改配置文件：

1. 使用 jq 修改 JSON 文件：

jq '.chain_id = "testing"' genesis.json > temp.json && mv temp.json genesis.json

2. 使用 sed 修改 TOML 文件：

sed -i '/\[api\]/,+3 s/enable = false/enable = true/' app.toml

重要配置项

1. 最小 Gas 价格（app.toml）：

minimum-gas-prices = "0stake"

2. 内存池配置（非验证节点可设置）：

[mempool]
max-txs = "-1"  # 禁用交易插入内存池

初始账户设置

添加初始账户

1. 首先在密钥环中创建账户
2. 为账户分配初始代币：

simd genesis add-genesis-account $MY_VALIDATOR_ADDRESS 100000000000stake

创建验证者

1. 生成 gentx 交易：

simd genesis gentx my_validator 100000000stake --chain-id my-test-chain --keyring-backend test

2. 收集 gentx 到创世文件：

simd genesis collect-gentxs

gentx 交易主要完成三件事：

1. 注册验证者操作账户
2. 进行自我委托
3. 将操作账户与节点公钥关联

运行节点

单节点运行

简单启动命令：

simd start

多节点本地网络

对于开发测试，可以使用 Docker Compose 运行多节点网络。建议参考 Cosmos SDK 提供的示例配置。

独立运行模式

默认情况下，应用与 CometBFT 同进程运行。如需分离：

1. 启动应用时添加 --with-comet=false 标志
2. 在 config.toml 中设置 rpc.laddr 为 CometBFT 节点的 RPC 地址

日志配置

默认日志级别为 info。可通过 config.toml 自定义模块日志级别：

log_level = "state:info,p2p:info,consensus:info,x/staking:info,x/ibc:info,*error"

状态同步

状态同步允许节点快速同步到最新状态，而无需处理所有历史区块。

本地状态同步步骤

1. 在 config.toml 中设置高度和哈希
2. 恢复本地数据：

simd snapshot restore <height> <format>

3. 引导 Comet 状态：

simd comet bootstrap-state

数据管理命令

Cosmos SDK 提供完整的数据管理命令集：

• list: 列出本地数据
• load: 加载数据存档文件
• restore: 从数据恢复应用状态
• export: 导出应用状态为数据
• dump: 将数据转储为便携存档格式
• delete: 删除本地数据

安全建议

1. GRPC 和 REST 服务默认绑定到 localhost，避免直接暴露到公网
2. 如需公开访问，建议使用 nginx 等反向代理，并配置负载均衡和认证
3. 验证者节点应配置适当的最小 Gas 价格以防止垃圾交易

通过以上步骤，您应该已经能够成功运行一个 Cosmos SDK 区块链节点。根据实际需求调整配置参数，可以优化节点性能和安全性。

cosmos-sdk :chains: A Framework for Building High Value Public Blockchains :sparkles: 项目地址: https://gitcode.com/gh_mirrors/co/cosmos-sdk