Cumulus 项目教程

Cumulus 项目教程

cumulus Write Parachains on Substrate 项目地址: https://gitcode.com/gh_mirrors/cum/cumulus

1. 项目目录结构及介绍

Cumulus 项目的目录结构如下：

cumulus/
├── cargo/
├── github/
├── bridges/
├── client/
├── docker/
├── docs/
├── pallets/
├── parachain-template/
├── parachains/
├── polkadot-parachain/
├── primitives/
├── scripts/
├── templates/
├── test/
├── xcm/
│   └── xcm-emulator/
└── zombienet/

目录介绍

• cargo/: 包含与 Cargo 相关的文件，用于 Rust 项目的依赖管理。
• github/: 包含与 GitHub 相关的配置文件，如 GitHub Actions 的工作流文件。
• bridges/: 包含与跨链桥相关的代码和配置文件。
• client/: 包含客户端相关的代码和配置文件。
• docker/: 包含 Docker 相关的配置文件和脚本，用于容器化部署。
• docs/: 包含项目的文档文件，如用户手册、开发指南等。
• pallets/: 包含 Substrate 框架中的 Pallet（模块）代码。
• parachain-template/: 包含平行链模板的代码和配置文件。
• parachains/: 包含平行链相关的代码和配置文件。
• polkadot-parachain/: 包含 Polkadot 平行链相关的代码和配置文件。
• primitives/: 包含项目的基础数据结构和类型定义。
• scripts/: 包含项目的脚本文件，如自动化脚本、测试脚本等。
• templates/: 包含项目的模板文件，如代码模板、配置模板等。
• test/: 包含项目的测试代码和配置文件。
• xcm/: 包含与跨链消息（XCM）相关的代码和配置文件。
• zombienet/: 包含 Zombienet 相关的代码和配置文件，用于测试和模拟网络环境。

2. 项目启动文件介绍

Cumulus 项目的启动文件通常位于 polkadot-parachain/ 目录下。主要的启动文件是 polkadot-parachain 二进制文件，它负责启动平行链节点。

启动文件介绍

• polkadot-parachain: 这是平行链节点的启动文件，负责初始化节点、加载配置、启动网络服务等。

3. 项目的配置文件介绍

Cumulus 项目的配置文件主要位于 polkadot-parachain/ 目录下，常见的配置文件包括：

配置文件介绍

• config.toml: 这是平行链节点的配置文件，包含节点的网络配置、数据库路径、日志级别等。
• chainspec.json: 这是链的规范文件，定义了链的初始状态、创世块信息、共识算法等。
• node-key: 这是节点的私钥文件，用于节点的身份验证和加密通信。

配置文件示例

# config.toml 示例
[network]
port = 30333
bootnodes = ["/ip4/127.0.0.1/tcp/30333/p2p/Qm..."]

[database]
path = "/path/to/database"

[log]
level = "info"

// chainspec.json 示例
{
  "name": "My Parachain",
  "id": "my_parachain",
  "genesis": {
    "runtime": {
      "system": {
        "code": "0x..."
      }
    }
  }
}

通过以上配置文件，可以自定义平行链节点的行为和网络参数。

cumulus Write Parachains on Substrate 项目地址: https://gitcode.com/gh_mirrors/cum/cumulus