Skip to content

如何使用Chopsticks分叉Moonbeam

概览

Chopsticks提供了一种开发者友好型方法,让其可以在本地分叉现有的基于Substrate的链。它允许重放区块以轻松检查extrinsics是如何影响状态,或是为XCM测试进行多个区块分叉等等。这允许开发者在本地开发环境中测试和试验他们自己的自定义区块链配置时,无需部署实时网络。

整体来说,Chopsticks旨在简化在Substrate上构建区块链应用的流程并让其能够普及至更多开发者。

Forking Moonbeam用Chopsticks

要使用Chopsticks,您可以通过Node包管理器Yarn将其安装为包:

npm i @acala-network/chopsticks@latest

在安装完毕后,您可以通过Node包执行器运行指令。举例来说,以下部分运行Chopstick的基础指令:

npx @acala-network/chopsticks@latest

要运行Chopsticks,您需要某种配置,通常为通过文件进行配置。Chopsticks的源库包含一组 YAML配置文件,可用于创建各种Substrate链的本地副本。您可以从源库的configs文件夹下载配置文件。

Moonbeam、Moonriver和Moonbase Alpha都有可用的默认文件。下面的示例配置为Moonbeam网络当前使用的配置

endpoint: wss://wss.api.moonbeam.network
mock-signature-host: true
db: ./db.sqlite

import-storage:
  System:
    Account:
      -
        -
          - "0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac"
        - data:
            free: "100000000000000000000000"
  TechCommitteeCollective:
    Members: ["0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac"]
  CouncilCollective:
    Members: ["0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac"]
  TreasuryCouncilCollective:
    Members: ["0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac"]
  AuthorFilter:
    EligibleRatio: 100
    EligibleCount: 100
endpoint: wss://wss.moonriver.moonbeam.network
mock-signature-host: true
db: ./db.sqlite

import-storage:
  System:
    Account:
      -
        -
          - "0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac"
        - data:
            free: "100000000000000000000000"
  TechCommitteeCollective:
    Members: ["0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac"]
  CouncilCollective:
    Members: ["0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac"]
  TreasuryCouncilCollective:
    Members: ["0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac"]
  AuthorFilter:
    EligibleRatio: 100
    EligibleCount: 100
endpoint: wss://wss.api.moonbase.moonbeam.network
mock-signature-host: true
db: ./db.sqlite

import-storage:
  System:
    Account:
      -
        -
          - "0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac"
        - data:
            free: "100000000000000000000000"
  TechCommitteeCollective:
    Members: ["0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac"]
  CouncilCollective:
    Members: ["0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac"]
  TreasuryCouncilCollective:
    Members: ["0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac"]
  Sudo:
    Key: "0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac"
  AuthorFilter:
    EligibleRatio: 100
    EligibleCount: 100

可以包含在配置文件的设置:

选项 描述
genesis 构建分叉的指向平行链原始创世文件的链接,而非端点
timestamp 构建分叉的区块的时间戳
endpoint 进行分叉的平行链端点。
block 用于指定重放分叉的区块哈希或是区块号。
wasm-override 用作平行链的WASM路径,而非端点。
db 导向至储存或是将会储存平行链数据库的文件名称路径。
config 配置文件的路径或URL。
port 公开端点的端口。
build-block-mode 区块如何在分叉中被构建:批处理(batch)、手动(manual)、立即(instant)。
import-storage 预先定义的JSON/YAML存储文件路径以覆盖平行链存储。
allow-unresolved-imports 在使用WASM构建平行链时是否允许WASM未解析的导入。
html 包含此标志以生成区块之间存储差异的预览。
mock-signature-host 模拟签名主机,让任何以0xdeadbeef开头并由0xcd填充的签名都被认为是有效的。

您可以将配置文件与基本指令npx @acala-network/chopsticks@latest结合使用,通过为其提供--config标志来分叉资产。

您可以使用默认配置文件的原始GitHub URL、本地配置文件的路径,或者仅使用链的名称作为--config标志。例如,以下指令都以相同的方式使用Moonbeam的配置:

npx @acala-network/chopsticks@latest --config=moonbeam
npx @acala-network/chopsticks@latest \
--config=https://raw.githubusercontent.com/AcalaNetwork/chopsticks/master/configs/moonbeam.yml
npx @acala-network/chopsticks@latest --config=configs/moonbeam.yml

注意事项

如果使用文件路径,请确保您已下载Moonbeam配置文件,或已创建您自己的。

然而,配置文件不是必需的。所有设置(除了genesistimestamp)也可以作为标志传递,以在指令行中完全地配置环境。例如,以下指令为在区块100处分叉Moonbase Alpha:

npx @acala-network/chopsticks@latest --endpoint wss://wss.api.moonbase.moonbeam.network --block 100

Quick Start

分叉Moonbeam最简单的方法是通过存储在Chopsticks GitHub库中的配置文件进行:

npx @acala-network/chopsticks@latest \
--config=https://raw.githubusercontent.com/AcalaNetwork/chopsticks/master/configs/moonbeam.yml
npx @acala-network/chopsticks@latest \
--config=https://raw.githubusercontent.com/AcalaNetwork/chopsticks/master/configs/moonriver.yml
npx @acala-network/chopsticks@latest \
--config=https://raw.githubusercontent.com/AcalaNetwork/chopsticks/master/configs/moonbase-alpha.yml

与分叉交互

当您在运行分叉时,默认情况下,您可以在进行访问:

ws://localhost:8000

您将能够通过Polkadot.js等库及其它的用户界面Polkadot.js Apps与平行链进行交互。

您可以通过Polkadot.js Apps用户界面与Chopsticks交互。为此,请访问该页面并执行以下步骤

  1. 点击左上角的图标
  2. 在页面最底端打开Development
  3. 选择Custom端点并输入ws://localhost:8000
  4. 点击Switch按钮

Open WSS Switch WSS

您现在应当在Polkadot.js Apps的托管版本并且能够与分叉交互。

注意事项

如果您的浏览器无法连接到Chopsticks提供的WebSocket端点,您可能需要允许Polkadot.js APPs URL的不安全连接。另一种解决方案是运行Polkadot.js Apps的Docker版本

重放区块

如果您想重放一个区块并检索其信息以剖析extrinsic,您可以使用npx @acala-network/chopsticks@latest run-block命令。它有以下标志:

标志 描述
endpoint 进行分叉的平行链端点。
block 用于指定重放分叉的区块哈希或是区块号。
wasm-override 用作平行链的WASM路径,而非端点。
db 导向至储存或是将会储存平行链数据库的文件名称路径。
config 配置文件的路径或URL。
output-path=/[file_path] 用于把结果打印至一个JSON文件中而非在终端中打印出结果。
html 包含此标志以生成区块之间存储差异预览的HTML。
open 选择是否打开HTML。

举例来说,运行以下命令将会重新运行Moonbeam的区块1000,并在moonbeam-output.json文件中写入存储差异和其他数据:

npx @acala-network/chopsticks@latest run-block  \
--endpoint wss://wss.api.moonbeam.network  \
--output-path=./moonbeam-output.json  \
--block 1000

XCM测试

要在网络间测试XCM消息,您可以在本地分叉多个平行链和中继链。举例来说,假设你已经从的源Github repository下载了configs文件夹,以下命令将会分叉Moonriver、Karura和Kusama:

npx @acala-network/chopsticks@latest xcm \
--r=kusama.yml \
--p=moonriver.yml \
--p=karura.yml

您应当能看到类似于以下输出的内容:

[13:50:57.807] INFO (rpc/64805): Loading config file https://raw.githubusercontent.com/AcalaNetwork/chopsticks/master/configs/moonriver.yml
[13:50:59.655] INFO (rpc/64805): Moonriver RPC listening on port 8000
[13:50:59.656] INFO (rpc/64805): Loading config file https://raw.githubusercontent.com/AcalaNetwork/chopsticks/master/configs/karura.yml
[13:51:03.275] INFO (rpc/64805): Karura RPC listening on port 8001
[13:51:03.586] INFO (xcm/64805): Connected parachains [2000,2023]
[13:51:03.586] INFO (rpc/64805): Loading config file https://raw.githubusercontent.com/AcalaNetwork/chopsticks/master/configs/kusama.yml
[13:51:07.241] INFO (rpc/64805): Kusama RPC listening on port 8002
[13:51:07.700] INFO (xcm/64805): Connected relaychain 'Kusama' with parachain 'Moonriver'
[13:51:08.386] INFO (xcm/64805): Connected relaychain 'Kusama' with parachain 'Karura'

您可以自行决定是否要包含r标志作为中继链,因Chopsticks将会自动在网络之间模仿中继链。您同样可以使用原始的GitHub URL或是知名分支的名称,如同使用基础指令一般。

WebSocket命令

Chopsticks的内部websocket服务器有特殊的端点,允许操作本地Substrate链。这些是可以调用的方法:

方法 参数 描述
dev_newBlock options 生成一个或多个新区块。
dev_setStorage values, blockHash 创建或覆盖任何存储的值。
dev_timeTravel date 将区块的时间戳设置为date值。
dev_setHead hashOrNumber 将区块链的块头设置为特定的哈希值或区块号。

The parameters above are formatted in the following ways:

参数 格式 示例
options { "to": number, "count": number } { "count": 5 }
values Object { "Sudo": { "Key": "0x6Be02d1d3665660d22FF9624b7BE0551ee1Ac91b" } }
blockHash string "0x1a34506b33e918a0106b100db027425a83681e2332fe311ee99d6156d2a91697"
date Date "2030-08-15T00:00:00"
hashOrNumber number | string
  • options { "to": number, "count": number } - 可选,保留null以创建一个区块。使用"to"创建达到特定值的区块,使用"count"增加特定数量的区块
  • values Object - 类似于存储值路径的JSON对象,类似于您通过Polkadot.js检索的内容
  • blockHash string - 可选,存储值发生变更的区块哈希
  • date string - 一个日期字符串(与JavaScript日期库兼容),它将更改时间戳,从该时间戳开始创建下一个区块。所有未来的区块将在该时间点之后依次出现
  • hashOrNumber number | string - 如果找到,链头将被设置为具有该值的区块号或区块哈希的区块

每个方法都可以通过连接到websocket(默认为ws://localhost:8000)并以以下格式发送数据和参数来调用。将METHOD_NAME替换为方法名称,将PARAMETER_1PARAMETER_2替换或删除为与方法相关的参数数据:

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "METHOD_NAME",
    "params": ["PARAMETER_1", "PARAMETER_2", "..."]
}
本网站的所有信息由第三方提供,仅供参考之用。Moonbeam文档网站(https://docs.moonbeam.network/)上列出和描述的任何项目与Moonbeam立场无关。Moonbeam Foundation不保证网站信息的准确性、完整性或真实性。如使用或依赖本网站信息,需自行承担相关风险,Moonbeam Foundation不承担任何责任和义务。这些材料的所有陈述和/或意见由提供方个人或实体负责,与Moonbeam Foundation立场无关,概不构成任何投资建议。对于任何特定事项或情况,应寻求专业权威人士的建议。此处的信息可能会包含或链接至第三方提供的信息与/或第三方服务(包括任何第三方网站等)。这类链接网站不受Moonbeam Foundation控制。Moonbeam Foundation对此类链接网站的内容(包括此类链接网站上包含的任何信息或资料)概不负责也不认可。这些链接内容仅为方便访客而提供,Moonbeam Foundation对因您使用此信息或任何第三方网站或服务提供的信息而产生的所有责任概不负责。
Last update: January 25, 2024
| Created: March 29, 2023