Cosmos-- 三.教程 -- 1.开始

cosmos主网即将上线，对文档做了大量更新。特地翻译了一下，方便小伙伴们阅览, 之后会持续更新

第三章教程:

1. 开始
2. 程序目标
3. 开始编写你的程序
4. Keeper
5. Msg和Handler
6. SetName
7. BuyName
8. Querier
9. Codec文件
10. Nameservice模块的CLI
11. nameservice模块的REST接口
12. 引入你的模块并完成程序
13. Entrypoint
14. 编译你的程序
15. 编译并运行程序
16. 运行REST路由

开始

在本教程中，你将构建一个功能性的Cosmos SDK应用。过程中能学习基本的概念和SDK的结构。该示例将展示如何快速，轻松地基于 Cosmos SDK 从头开始构建自己的区块链。

在本章教程结束时，你会得到一个功能性的nameservice应用，一个字符串对字符串的映射关系表(map[string]string)。类似于Namecoin，ENS，Handshake这些模仿传统的DNS系统（map[domain]zonefile）的应用。用户可以购买未被使用的域名，或是出售/交易这些域名。

本教程的所有最终源代码都在此目录（并编译）。但是，最好手动完成并尝试自己构建项目！

需要

• 安装go 1.11+
• 生效的$GOPATH
• 创建你自己的区块链的意愿！

教程

通过本章教程你将创建如下的文件来组成你的应用:

./nameservice
├── Gopkg.toml
├── Makefile
├── app.go
├── cmd
│   ├── nscli
│   │   └── main.go
│   └── nsd
│       └── main.go
└── x
    └── nameservice
        ├── client
        │   ├── cli
        │   │   ├── query.go
        │   │   └── tx.go
        │   ├── rest
        │   │   └── rest.go
        │   └── module_client.go
        ├── codec.go
        ├── handler.go
        ├── keeper.go
        ├── msgs.go
        └── querier.go

首先创建一个新的git仓库：

mkdir -p $GOPATH/src/github.com/{ .Username }/nameservice
cd $GOPATH/src/github.com/{ .Username }/nameservice
git init

然后继续！第一步描述了设计你的应用。如果要直接跳转到编码部分，你可以从第二步开始。

教程部分

1. 设计应用程序。
2. 从./app.go开始实现你的应用。
3. 开始用Keeper构建你的模块。
4. 通过Msg和Handler定义状态转变。
   • SetName
   • BuyName
5. 使用Querier给你的状态机创建视图。
6. 使用sdk.Codec注册你的types到编码格式中。
7. 创建你的模块的CLI交互。
8. 创建客户端访问你的nameservice的HTTP路径。
9. 导入你的模块并编译你的应用!
10. 创建你的应用的[nsd和nscli入口]。
11. 安装依赖管理工具dep。
12. 编译并启动示例项目。
13. 启动REST路径