介绍

FaaS 是一个专为 web3 开发人员提供的 Serverless 工具。

它有如下特点：

• 所有代码都是存储在区块链上
• 开发者拥有代码的主权
• Typescript 优先，可快速上手

安装

前置需要安装 rust 环境。

$ cargo install --force --locked --git https://github.com/faas3/faas3-cli.git faas3

安装完毕之后，可以执行如下命令进行测试：

$ faas3 --help
Usage: faas3 [COMMAND]

Commands:
  create  create the function
  deploy  deploy the function to runtime and blockchain
  run     local run
  call    remote call the function
  list    list the functions
  verify  verify the runtime function, which should equal to the on-chain code
  help    Print this message or the help of the given subcommand(s)

Options:
  -h, --help     Print help
  -V, --version  Print version

创建一个函数

$ faas3 create dao-example
🎉 Awesome, The [dao-demo] function is created!
🚑 Please change the owner to your Sui address!

$ cd dao-example

注意： 首先需要将 config.toml 的里的 owner 地址替换成你自己本地的 Sui active-address。 如何创建 Sui 地址可以参考：https://sui.io/

在里面编写自己的逻辑

比如，cowsay 函数：

import * as o from "https://deno.land/x/cowsay/mod.ts";

export async function handler(payload = {}) {
  let m = o.say({
    text: "hello every one",
  });
  console.log(m);
  return m;
}

部署函数

在项目目录下面执行 deploy 命令：

$ faas3 deploy
📖 Your Config is Config {
    basic: BasicConfig {
        version: "0.0.1",
        name: "dao-demo",
        description: "",
        owner: "0x5d547ccd49f6f35fc0dd66fb76e032e8fbf570ff",
    },
}
🚀 Deploying it to blockchain...
the object id is 0x51af0788a403c61fdc10450bd0971a57544dda31
🚀 Loading it to remote db...
Ok(
    DeployResponse {
        error: None,
        status: 201,
    },
)

测试调用

$ faas3 call dao-example
✅ Your resp is:
 "\" _________________\\n< hello every one >\\n -----------------\\n   \\\\   ^__^\\n    \\\\  (oo)\\\\_______\\n       (__)\\\\       )\\\\/\\\\\\n           ||----w |\\n           ||     ||\""

通过 http 访问

注意：目前仅支持 post 方法

$ curl --location --request POST 'https://faas3.deno.dev/api/moverun' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "dao-demo"
}'

验证函数

为了加速函数的执行速度，降低冷启动时间，我们在 runtime 中缓存了一份链上函数。

我们可以验证在 runtime 中的函数是否和链上的代码一致：

$ faas3 verify dao-example

卸载

$ cargo uninstall faas3