如何在 Fuel 上开发智能合约程序

在 Amphitheatre 上运行 Web2 应用程序与 Web3 应用程序有所差异,因此,部署 Fuel 智能合约之前,您需要先构建合约,然后,将合约部署到集群内的 DevNet 上,以此查看合约的运行情况。

示例应用程序

您可以从 GitHub 存储库 获 取示例的代码。只需运行以下命令以获取本地副本:git clone https://github.com/amphitheatre-app/amp-example-sway

amp-example-sway 应用程序是一个小型示例,正如您所期望的那样。它是一个 Fuel 智能合约。

src/main.sw 代码如下所示:

contract;
 
storage {
    counter: u64 = 0,
}
 
abi Counter {
    #[storage(read, write)]
    fn increment();
 
    #[storage(read)]
    fn count() -> u64;
}
 
impl Counter for Contract {
    #[storage(read)]
    fn count() -> u64 {
        storage.counter.read()
    }
 
    #[storage(read, write)]
    fn increment() {
        let incremented = storage.counter.read() + 1;
        storage.counter.write(incremented);
    }
}

构建应用程序

与大多数 Fuel 应用程序一样,简单的 forc build 将创建一个可运行的二进制文件。因此, 原始应用程序可以正常运行。现在,将其打包以供 Amphitheatre 使用。

安装 Amphitheatre

我们已准备好开始使用 Amphitheatre,并且这意味着我们需要 amp,这是用于管理 Amphitheatre 上应用程序的 CLI 应用程序。如果您已经安装了它,请继续。如果没有,请 跳转到 我们的安装指南

在 .amp.toml 中

.amp.toml 文件现在包含用于部署您的 Character 的默认配置。如果我们查看 .amp.toml 文件,可以在其中看到:

name = "amp-example-sway"
version = "0.1.0"
edition = "v1"
description = "A simple Fuel example app"
readme = "README.md"
homepage = "https://github.com/amphitheatre-app/amp-example-sway"
repository = "https://github.com/amphitheatre-app/amp-example-sway"
license = "Apache-2.0"
license-file = "LICENSE"
keywords = ["example", "fuel", "sway", "getting-started"]
categories = ["example"]

[build]
builder = "ghcr.io/amp-buildpacks/sway-builder"

[partners]
fuel = { version = "latest", registry = "catalog" }

[build.env]
BP_ENABLE_FORC_DEPLOY = "true"
BP_HOME = "/layers/amp-buildpacks_forc/forc-amd64/fuel"

如果该文件存在,amp 命令将始终引用当前目录中的此文件,特别是开始时的 Character 名称值。该名称将用于标识 Character 到 Amphitheatre 平台。文件的其余部分包含部署 Character 时要应用的设置。

有关更多选项,请参阅 sway-builder 文档

部署到 Amphitheatre

要部署您的 Character,请运行:

amp run

这将查找我们的 .amp.toml 文件,并从中获取 Character 名称 amp-example-sway。然 后,amp 将开始部署 Character 到 Amphitheatre 平台。amp 将在完成时返回到命令