1 个不稳定版本

0.2.0 2021 年 11 月 23 日

#4#pylon


用于 pylon-token

Apache-2.0

11KB
143 代码行

CosmWasm 入门包

这是一个在所有支持它的链上的 Cosmos SDK 模块内运行智能合同的 Rust 模板。为了更好地了解框架,请阅读 cosmwasm 仓库 中的概述,并深入研究 cosmwasm 文档。这假设您已经理解了理论,只想开始编码。

从模板创建新仓库

假设您已安装了最新版本的 rust 和 cargo(通过 rustup),那么以下命令将为您创建一个新的仓库以开始编写合同:

首先,安装 cargo-generate。除非您之前已经安装,否则现在运行以下命令:

cargo install cargo-generate --features vendored-openssl

现在,使用它来创建您的合同。转到您希望放置它的文件夹,然后运行:

0.10(最新版)

cargo generate --git https://github.com/CosmWasm/cosmwasm-template.git --name PROJECT_NAME

0.9

cargo generate --git https://github.com/CosmWasm/cosmwasm-template.git --branch 0.9 --name PROJECT_NAME

0.8

cargo generate --git https://github.com/CosmWasm/cosmwasm-template.git --branch 0.8 --name PROJECT_NAME

现在,您将有一个名为 PROJECT_NAME(我希望您已经将其更改为其他名称)的新文件夹,其中包含一个简单的工作合同和构建系统,您可以对其进行自定义。

创建仓库

生成后,您将有一个初始化的本地 git 仓库,但没有提交,也没有远程仓库。转到服务器(例如 github)并创建一个新的上游仓库(称为 YOUR-GIT-URL 以下)。然后运行以下命令:

# this is needed to create a valid Cargo.lock file (see below)
cargo check
git checkout -b master # in case you generate from non-master
git add .
git commit -m 'Initial Commit'
git remote add origin YOUR-GIT-URL
git push -u origin master

CI 支持

我们在生成的项目中提供了 GitHub ActionsCircle CI 的模板配置,因此您可以立即开始使用 CI。

需要注意的是,CI会使用带有--locked的命令运行所有cargo命令,以确保它使用与您本地完全相同的版本。这也意味着您必须有一个最新的Cargo.lock文件,该文件不是自动生成的。第一次设置项目(或添加任何依赖后),您应该确保Cargo.lock文件已更新,以便CI可以正确测试。这可以通过简单地运行cargo checkcargo unit-test来实现。

使用您的项目

一旦您有了自定义仓库,您应该检出Developing以了解如何运行测试和开发代码。或者通过在线教程来更好地了解开发过程。

Publishing包含了有关如何将合约发布到世界各地的有用信息,一旦您准备好在运行的区块链上部署它。而Importing包含了有关引入已发布的其他合约或crate的信息。

请将此README文件替换为有关您特定项目的信息。您可以保留Developing.mdPublishing.md文件作为有用的参考,但请在README中设置一些适当的描述。

依赖项

~3–4.5MB
~96K SLoC