1 个不稳定版本
0.1.0 | 2023 年 10 月 17 日 |
---|
#54 在 #entry
59 每月下载量
用于 7 crates
14KB
299 行
CosmWasm Starter Pack
这是一个在所有启用它的链上运行 Rust 智能合约的模板。要更好地了解框架,请阅读 cosmwasm 仓库 中的概述,并深入了解 cosmwasm 文档。这假设你理解了理论,只想开始编码。
从模板创建新仓库
假设你已经安装了最新版本的 rust 和 cargo (v1.58.1+)(通过 rustup),那么以下操作应该会为你创建一个新的仓库以开始编写合约
安装 cargo-generate 和 cargo-run-script。除非你之前已经安装,否则现在运行以下命令
cargo install cargo-generate --features vendored-openssl
cargo install cargo-run-script
现在,使用它创建你的新合约。转到你想要放置它的文件夹,然后运行
最新版本:1.0.0-beta6
cargo generate --git https://github.com/CosmWasm/cw-template.git --name PROJECT_NAME
旧版本
将版本作为分支标志传递
cargo generate --git https://github.com/CosmWasm/cw-template.git --branch <version> --name PROJECT_NAME
示例
cargo generate --git https://github.com/CosmWasm/cw-template.git --branch 0.16 --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 branch -M main
git add .
git commit -m 'Initial Commit'
git remote add origin YOUR-GIT-URL
git push -u origin main
持续集成支持
在生成的项目中,我们提供了针对 GitHub Actions 和 Circle CI 的模板配置,因此你可以立即开始使用 CI。
请注意,CI使用cargo
命令的--locked
选项来确保它使用与您本地相同的版本。这也意味着您必须有一个最新的Cargo.lock
文件,该文件不是自动生成的。第一次设置项目(或添加任何依赖后),您应确保更新Cargo.lock
文件,以便CI能够正确测试。这可以通过运行cargo check
或cargo unit-test
来完成。
使用您的项目
一旦您有了自定义仓库,您应该检出开发来了解如何运行测试和开发代码。或者通过在线教程来更好地了解开发过程。
发布包含有关如何将您的合约发布到世界的有用信息,一旦您准备好在运行的区块链上部署它。而导入包含有关拉取已发布的其他合约或crate的信息。
请用您特定项目的相关信息替换此README文件。您可以保留Developing.md
和Publishing.md
文件作为有用的参考,但在README中请设置一些适当的描述。
Gitpod集成
Gitpod容器化开发平台将默认启用您的项目。
工作区包含
- rust:用于构建
- wasmd:用于本地节点设置和客户端
- jq:shell JSON操作工具
遵循Gitpod入门并启动您的开发环境。
依赖关系
~4–6MB
~124K SLoC