cosmos-starport模块开发

最新推荐文章于 2024-08-21 09:47:15 发布

盐水煮毛豆

最新推荐文章于 2024-08-21 09:47:15 发布

阅读量665

点赞数

文章标签： go 后端区块链 cosmos starport

本文链接：https://blog.csdn.net/lk2684753/article/details/113849531

版权

starport模块开发

目录结构

Cosmos SDK的典型目录结构如下所示：

x/{module}
├── client
│   ├── cli
│   │   ├── query.go
│   │   └── tx.go
│   └── rest
│       ├── query.go
│       └── tx.go
├── exported
│   └── exported.go
├── keeper
│   ├── invariants.go
│   ├── genesis.go
│   ├── keeper.go
│   ├── ...
│   └── querier.go
│   └── grpc_query.go
├── types
│   ├── codec.go
│   ├── errors.go
│   ├── events.go
│   ├── expected_keepers.go
│   ├── genesis.go
│   ├── keys.go
│   ├── msgs.go
│   ├── params.go
│   ├── types.proto
│   ├── ...
│   └── querier.go
│   └── {module_name}.pb.go
│   └── query.pb.go
│   └── genesis.pb.go
├── simulation
│   ├── decoder.go
│   ├── genesis.go
│   ├── operations.go
│   ├── params.go
│   └── proposals.go
├── abci.go
├── handler.go
├── ...
└── module.go

abci.go：模块的BeginBlocker和EndBlocker实现（如果有）。

client/：模块的CLI和REST客户端功能的实现和测试。

exported/：模块的导出类型-通常是类型接口。如果一个模块依赖于其他模块维护者，则它希望通过Expected_keepers.go（在下面进行详细介绍）设计作为接口协定来接收它们，以避免直接依赖于实现模块。但是，这些合同可以定义对合同的实现模块特定的操作和/或返回类型的方法，这是导出/起作用的地方。此处定义的类型允许其他模块中的Expected_keepers.go定义使用单个规范类型的合同。这种模式可以使代码保持DRY状态，还可以减轻导入周期的混乱。

handler.go：模块的消息处理程序。

keeper/：模块的keeper实现以及查询器和不变式之类的任何辅助实现。

types/：模块的类型定义，例如消息，KVStore密钥，参数类型，协议缓冲区定义和Expected_keepers.go合同。

module.go：AppModule和AppModuleBasic接口的模块实现。

标准模块

什么是模块

在Cosmos SDK中，模块是区块链逻辑的基础。每个模块都有特定的用途和功能。Cosmos SDK提供了各种本地模块来使区块链工作。这些模块处理用户的身份验证，令牌传输，管理功能，令牌抵押，令牌供应等等。

如果您想更改模块的默认功能或仅更改某些硬编码参数，则可以派生一个模块并对其进行更改，因此拥有自己的区块链逻辑。在分叉和编辑模块时应谨慎进行，但这种方法将Cosmos SDK标记为功能特别强大，因为您可以按照标准实现的建议尝试不同的参数。

模块不必由特定的公司或个人创建。它们可以由任何人创建，并提供给公众使用。尽管确实存在一些在将模块集成到其区块链之前需要研究的标准。建议模块具有易于理解的规范，处理好一件事情并经过良好测试-在实时区块链上经过最佳测试。当变得越来越复杂时，有时有两个模块而不是试图“解决所有问题”的模块会更有意义，这种考虑可以使其他项目在其区块链项目中使用模块更具吸引力。

在使用starport创建区块链或使用Cosmos SDK手动创建区块链时，应使用一组模块，以便首先具有一组定义区块链的规则。这些模块是

认证

该auth模块负责区块链上的账户以及账户可以使用的基本交易类型。

它引入了Gas and Fees作为概念，以防止区块链因无法识别的账户而膨胀，因为在公共区块链上，您没有关于账户的更多信息（作为公共密钥或账户余额或以前的交易历史记录）。

帐户的界面定义为

// BaseAccount defines a base account type. It contains all the necessary fields
// for basic account functionality. Any custom account type should extend this
// type for additional functionality (e.g. vesting).
message BaseAccount {
  option (gogoproto.goproto_getters)  = false;
  option (gogoproto.goproto_stringer) = false;
  option (gogoproto.equal)            = false;

  option (cosmos_proto.implements_interface) = "AccountI";

  string              address = 1;
  google.protobuf.Any pub_key = 2
      [(gogoproto.jsontag) = "public_key,omitempty", (gogoproto.moretags) = "yaml:\"public_key\""];
  uint64 account_number = 3 [(gogoproto.moretags) = "yaml:\"account_number\""];
  uint64 sequence       = 4;
}

该auth模块向帐户管理员公开可以存储或更改帐户的位置。此外，它还公开了标准交易，费用，签名或防止重放的类型。它还允许归属帐户，因为可以在一段时间内使实体访问某些硬币。归属逻辑主要用于放样的绑定，但也可以用于其他目的。

银行

该bank模块之所以有其名称，是因为它充当允许令牌传输并检查每次传输有效性的模块。此外，它还负责检查整个链的供应，所有帐户余额的总和。

性能

如ICS 5所述，要完全实施IBC规范，就需要具有在运行时（即在事务执行期间）创建和验证对象密钥的能力，如ICS 5中所述。在IBC规范中，将为每个新初始化的端口和通道创建能力密钥，并且用于验证端口或通道的将来使用。由于可以在事务执行期间初始化通道和潜在的端口，因此状态机此时必须能够创建对象功能密钥。