发布源代码

tar 归档打算发布，并且其链接应嵌入到放入链中的源代码中。在将模块注册到链上之前，应将 tar 文件上传到可通过 http GET 请求访问的位置。然后应使用 edit-build-info 命令将链接嵌入到 wasm.v1 文件中。

cargo concordium edit-build-info --module contract.wasm.v1 --source-link https://domain.com/contract.wasm.v1.tar --verify

--verify 标志是可选的，如果设置了该标志，则 cargo concordium 将下载提供的链接中的内容，并验证其是否与模块中已嵌入的构建元数据匹配。如果匹配，则将链接添加到元数据中。

验证构建

要验证部署的模块是否由给定的源代码构建，可以使用 cargo concordium verify-build 命令。此命令需要一个模块的路径，以及可选的源 tar 归档的路径。如果没有提供 tar 归档，则如果模块中存在链接，将从该链接下载。源代码链接也可能指向压缩的 tar 归档。

例如

cargo concordium verify-build --module contract.wasm.v1

打印构建信息

cargo concordium print-build-info --module contract.wasm.v1

将打印任何嵌入的构建信息。

限制

• 为了可重复构建，必须保持 Cargo.lock 文件是最新的。
• 合同源代码必须位于远程包仓库上，例如 crates.io，或者完全位于包根目录下。
• 不支持 crypto-primitives 功能。此功能仅用于运行测试，可以在构建时禁用。

本地执行合同

以下是一些对 cargo concordium 二进制文件的子命令 run 的示例调用。

cargo concordium run init --context init-context.json --parameter parameter.bin --source ./simple_game.wasm --out state.bin --amount 123

使用输入文件

{
    "metadata": {
        "slotNumber": 1,
        "blockHeight": 1,
        "finalizedHeight": 1,
        "slotTime": "2021-01-01T00:00:01Z"
    },
    "initOrigin": "3uxeCZwa3SxbksPWHwXWxCsaPucZdzNaXsRbkztqUUYRo1MnvF"
}

和 parameter.bin 作为

00001111aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa

(作为一个没有换行的文本文件)。

cargo concordium run receive --context receive-context.json --parameter parameter-receive.bin --source ./simple_game.wasm --state state-in.bin --amount 0 --name "receive_help_yourself" --balance 13 --out state-out.bin

其中示例接收上下文是

{
    "metadata": {
        "slotNumber": 1,
        "blockHeight": 1,
        "finalizedHeight": 1,
        "slotTime": "2021-01-01T00:00:01Z"
    },
    "invoker": "3uxeCZwa3SxbksPWHwXWxCsaPucZdzNaXsRbkztqUUYRo1MnvF",
    "selfAddress": {"index": 0, "subindex": 0},
    "selfBalance": 0,
    "sender": {
        "type": "Account",
        "address": "3uxeCZwa3SxbksPWHwXWxCsaPucZdzNaXsRbkztqUUYRo1MnvF"
    },
    "owner": "3uxeCZwa3SxbksPWHwXWxCsaPucZdzNaXsRbkztqUUYRo1MnvF"
}

请参阅 --help 或 help 选项来解释 cargo concordium run 的选项。

从二进制中移除主机信息

默认情况下，从 rust crate 编译的二进制文件包含来自主机的一些信息，例如 rust 相关路径，如 .cargo 的路径。这可以通过检查生成的二进制文件来看到。

假设您的用户名为 tom，并且您在主目录中有一个名为 foo 的智能合约，您已经以发布模式将其编译成 WASM32。在 foo 文件夹内运行以下命令后，您将能够看到二进制文件中的路径：strings target/wasm32-unknown-unknown/release/foo.wasm | grep tom

要删除主机信息，可以使用编译器提供的标志来重映射路径前缀。RUSTFLAGS=--remap-path-prefix=/home/tom=secret cargo build --release --target wasm32-unknown-unknown，其中 /home/tom 是您想要更改的前缀，将其改为 secret。该标志可以多次指定以重映射多个前缀。

标志还可以在您的包的 .cargo/config 文件的 build 部分中永久设置

[build]
rustflags = ["--remap-path-prefix=/home/tom=secret"]