Polkadex 项目教程

Polkadex 项目教程

PolkadexAn Orderbook-based Decentralized Exchange using the Substrate Blockchain Framework. 项目地址:https://gitcode.com/gh_mirrors/po/Polkadex

1. 项目的目录结构及介绍

Polkadex 项目的目录结构如下：

Polkadex/
├── bin/
│   └── polkadex
├── build/
│   ├── debug/
│   └── release/
├── docs/
│   ├── README.md
│   └── ...
├── node/
│   ├── src/
│   │   ├── chain_spec.rs
│   │   ├── cli.rs
│   │   ├── main.rs
│   │   └── ...
│   └── Cargo.toml
├── pallets/
│   ├── polkadex_core/
│   │   ├── src/
│   │   └── Cargo.toml
│   └── ...
├── runtime/
│   ├── src/
│   │   ├── lib.rs
│   │   └── ...
│   └── Cargo.toml
├── scripts/
│   ├── init.sh
│   └── ...
├── Cargo.toml
└── README.md

目录结构介绍

• bin/: 存放可执行文件的目录，通常包含项目的启动文件。
• build/: 编译生成的文件目录，包含调试和发布版本的编译结果。
• docs/: 项目文档目录，包含项目的说明文档和其他相关文档。
• node/: 节点相关代码目录，包含节点的源代码和配置文件。
  • src/: 节点源代码目录，包含节点的核心逻辑和启动文件。
    • chain_spec.rs: 链的配置文件，定义了链的初始状态和参数。
    • cli.rs: 命令行接口文件，定义了节点的命令行参数和选项。
    • main.rs: 节点的主启动文件，包含了节点的入口函数。
• pallets/: 存放 Polkadex 的自定义 pallet 目录，每个 pallet 对应一个子目录。
  • polkadex_core/: Polkadex 核心 pallet 的源代码目录。
• runtime/: 运行时代码目录，包含 Polkadex 的运行时逻辑。
  • src/: 运行时源代码目录，包含运行时的核心逻辑。
    • lib.rs: 运行时的主文件，定义了运行时的逻辑和模块。
• scripts/: 存放项目脚本的目录，包含初始化脚本等。
• Cargo.toml: 项目的依赖管理文件，定义了项目的依赖和构建配置。
• README.md: 项目的说明文档，包含项目的概述和使用说明。

2. 项目的启动文件介绍

Polkadex 项目的启动文件主要位于 node/src/main.rs 中。该文件是 Polkadex 节点的入口文件，负责启动节点并加载运行时逻辑。

main.rs 文件介绍

fn main() -> Result<(), Box<dyn std::error::Error>> {
    // 初始化日志
    env_logger::init();

    // 解析命令行参数
    let cli = Cli::from_args();

    // 启动节点
    match cli.run() {
        Ok(_) => Ok(()),
        Err(e) => Err(e),
    }
}

• main() 函数: 这是节点的入口函数，负责初始化日志、解析命令行参数并启动节点。
• Cli::from_args(): 解析命令行参数，生成 Cli 对象。
• cli.run(): 根据解析的参数启动节点。

3. 项目的配置文件介绍

Polkadex 项目的配置文件主要位于 node/src/chain_spec.rs 中。该文件定义了链的初始状态和参数，包括创世块的配置、节点配置等。

chain_spec.rs 文件介绍

pub fn testnet_config() -> Result<ChainSpec, String> {
    // 定义创世块配置
    let genesis = GenesisConfig {
        // 初始账户和余额
        balances: balances_config(),
        // 其他初始配置
        ...
    };

    // 生成链配置
    ChainSpec::from_genesis(
        "Testnet",
        "testnet",
        || genesis,
        vec![],
        None,
        None,
        None,
        None,
    )
}

• testnet_config() 函数: 定义了测试网的配置，包括创世块的初始状态和参数。
• GenesisConfig: 创世块的配置结构体，包含初始账户、余额等配置。
• ChainSpec::from_genesis(): 根据创世块配置生成链的配置。

通过以上配置文件，可以自定义链的初始状态和参数，以满足不同的需求。

PolkadexAn Orderbook-based Decentralized Exchange using the Substrate Blockchain Framework. 项目地址:https://gitcode.com/gh_mirrors/po/Polkadex