您需要以下依赖项才能使包装器正常工作

ink-wrapper-types = "0.6.0"
scale = { package = "parity-scale-codec", version = "3", default-features = false, features = ["derive"] }
ink_primitives = "4.2.1"

# You only need this one if you have messages of the form `Trait::message`, like the ones generated by openbrush, for
# example.
async-trait = "0.1.68"

# This one is optional, but you most likely need it as well if you're using the default `aleph_client` implementation
# for actually making calls. Otherwise, you will need to implement `ink_wrapper_types::Connection` and
# `ink_wrapper_types::SignedConnection` yourself.
aleph_client = "3.0.0"

基本用法

有了这些，您就可以在代码中使用包装器了。生成的模块将有一个Instance结构体，表示您合约的一个实例。您可以通过将account_id转换为Instance来与现有的实例进行通信

let account_id: ink_primitives::AccountId = ...;
let instance: my_contract::Instance = account_id.into();

或者（假设合约代码已经被上传），使用生成的构造函数之一创建实例

let instance = conn.instantiate(my_contract::Instance::some_constructor(arg1, arg2)).await?;

然后调用合约上的方法

let result = conn.read(instance.some_getter(arg1, arg2)).await?;
let tx_info = conn.exec(instance.some_mutator(arg1, arg2)).await?;

请注意，任何具有类似Trait::method_name名称的方法都将被分组到生成的模块中的特性中。如果您使用openbrush，例如，它们的PSP22实现会生成类似PSP22::balance_of的方法名称。您需要使用生成的特性来访问这些

use my_contract::PSP22 as _;
conn.read(instance.balance_of(account_id)).await?

在上面的示例中，conn是实现ink_wrapper_types::Connection（如果您想使用构造函数或突变者，则还需要ink_wrapper_types::SignedConnection）的任何内容。在aleph_client中提供了连接的默认实现。

事件

ink_wrapper_types::Connection还允许您为给定的TxInfo检索事件

use ink_wrapper_types::Connection as _;

let tx_info = conn.exec(instance.some_mutator(arg1, arg2)).await?;
let all_events = conn.get_contract_events(tx_info).await?;
let contract_events = all_events.for_contract(instance);
let sub_contract_events = all_events.for_contract(sub_contract);

上面的all_events对象可能包含来自多个合约的事件，如果合约调用它们。在这种情况下，您可以通过调用for_contract来过滤和解析这些事件，它有各种您感兴趣的合约。

代码上传

如果您提供了编译时编译的WASM的路径

ink-wrapper -m my_contract.json --wasm-path ../contracts/target/ink/my_contract.wasm

您还将能够使用生成的包装器上传合约

conn.upload(my_contract::upload()).await

请注意，只要交易成功提交且元数据的代码哈希与上传的代码匹配，upload 函数就会返回 Ok(TxInfo)。如果代码已在链上存在，则不会返回错误。您可以自己通过查看返回的 TxInfo 中的事件来验证此条件，检查是否包含 CodeStored 事件。

示例

在项目的存储库中查看 tests 以获取更完整的示例。注意，tests/drink 缺少实际的包装器，这些包装器通常在测试时生成。重新生成它们的最简单方法是运行 make all-dockerized（需要 docker）- 更多信息请参阅 开发。

开发

使用 Makefile 中提供的命令来复制在 CI 上运行的构建过程

make help

最简便的方法是在 docker 中运行一切

make all-dockerized

如果您已在主机上安装了工具并自己启动了节点，您也可以在主机上运行构建

make all

如果在 all-dockerized 中有任何失控的容器，您可以杀死它们

make kill