5 分钟入门

本指南提供了在 Gear 网络上运行智能合约的一般概述。它指导您如何编写智能合约，将其编译为 Wasm，并部署到 Gear 网络。

在这个例子中，我们将使用一个模拟真实 Gear 去中心化网络的演示环境。

前期准备

为了方便起见，建议您为所有与 Gear 相关的内容创建一个专用目录。本文的其余部分将假设您使用的是所建议的路径。输入以下命令来在 Home 目录创建一个专用文件夹并跳转到文件夹中：

mkdir -p ~/gear
cd ~/gear

确保您已经安装了在 Rust 中构建智能合约所需的所有工具。我们将使用 Rustup 来安装 Rust 编译器。

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

现在，让我们为 rustup 安装一个 nightly 版本，因为 Gear 使用了一些 rustup 提供的最新功能。

rustup update
rustup update nightly

我们需要把 Rust 智能合约编译为 Wasm，所以我们需要一个 Wasm 编译器。让我们将 Wasm 编译器添加到工具链中。

rustup target add wasm32-unknown-unknown --toolchain nightly

注意如果你使用 Windows，请下载并安装 Build Tools for Visual Studio。

创建你的第一个 Gear 智能合约

现在让我们在 gear 文件夹内，创建 contracts 文件夹，然后通过 cd 切换进文件夹

mkdir -p ~/gear/contracts
cd ~/gear/contracts

下一步将是为合约建立一个 Rust 库。

cargo new first-gear-app --lib

gear/contracts 目录树应该是这样的：

└── first-gear-app
    ├── Cargo.toml
    └── src
        └── lib.rs

现在开始写一些代码。用你喜欢的编辑器打开 first-gear-app，我们使用VS Code。

code ~/gear/contracts/first-gear-app

创建 build.rs 文件，并粘贴以下代码：

fn main() {
    gear_wasm_builder::build();
}

同时配置Cargo.toml，可以使合约正确地创建。

[package]
name = "first-gear-app"
version = "0.1.0"
authors = ["Your Name"]
edition = "2021"
license = "GPL-3.0"

[dependencies]
gstd = { git = "https://github.com/gear-tech/gear.git", tag = "v1.1.1", features = ["debug"] }

[build-dependencies]
gear-wasm-builder = { git = "https://github.com/gear-tech/gear.git", tag = "v1.1.1" }

[dev-dependencies]
gtest = { git = "https://github.com/gear-tech/gear.git", tag = "v1.1.1" }

用我们的第一个智能合约的代码替换 lib.rs。在编辑器中打开 src/lib.rs 并粘贴以下代码：

#![no_std]

use gstd::{debug, msg, prelude::*};

static mut MESSAGE_LOG: Vec<String> = vec![];

#[no_mangle]
unsafe extern "C" fn handle() {
    let new_msg = String::from_utf8(msg::load_bytes().expect("Unable to load bytes"))
        .expect("Invalid message");

    if new_msg == "PING" {
        msg::reply_bytes("PONG", 0).expect("Error in sending reply");
    }

    MESSAGE_LOG.push(new_msg);

    debug!("{:?} total message(s) stored: ", MESSAGE_LOG.len());

}

这个合约发送了PING消息，会收到PONG消息作为回应。

然后，编译合约代码

cd ~/gear/contracts/first-gear-app/
cargo build --release

如果一切顺利，工作目录应该有一个 target 目录，如下所示的：

target
    ├── CACHEDIR.TAG
    ├── release
    │   ├── ...
    └── wasm32-unknown-unknown
        ├── CACHEDIR.TAG
        └── release
            ├── build
            │   └── ...
            ├── deps
            │   └── ...
            ├── examples
            ├── incremental
            ├── first_gear_app.d
            └── first_gear_app.wasm <---- this is our .wasm file

我们需要的是 target/wasm32-unknown-unknown/release 目录内的 first_gear_app.wasm 文件。现在知道它在哪里了，让我们进入下一步。

在测试网上部署你的第一个合约

Gear provides a demo environment that emulates the real Gear decentralized network, available in idea.gear-tech.io. Gear 提供了一个模拟真实 Gear 去中心化网络的 demo 环境，可以通过 idea.gear-tech.io 访问。

创建账户

通过 https://polkadot.js.org/extension/ 为您的浏览器下载 Polkadot 扩展插件。这个扩展插件可以管理账户并允许用这些账户签名交易。它是一个安全的工具，允许将你的账户注入到任何基于 Substrate 的应用程序。它不执行钱包功能，例如，发送资金。
下载完成后，点击 '+' 来创建新的账户：

img alt