程序初始化

初始化程序有几种方法

• 使用 Program::current 函数初始化当前程序

  let prog = Program::current(&sys);
  

• 使用 Program::from_file 函数从 Wasm 文件初始化程序，并使用默认 ID

  let prog = Program::from_file(
      &sys,
      "./target/wasm32-unknown-unknown/release/demo_ping.wasm",
  );
  

• 通过构建器初始化程序

  let prog = ProgramBuilder::from_file("your_gear_program.wasm")
      .with_id(105)
      .build(&sys);
  

  在这个库的任何地方，如果您需要指定一些 ID，它需要一个泛型类型 ID，该类型实现了 Into<ProgramIdWrapper>。

  ProgramIdWrapper 可以从以下构建

  • u64
  • [u8; 32]
  • String
  • &str
  • ProgramId (来自 gear_core 的，而不是来自 gstd).

  String 实现意味着输入作为十六进制数（带或不带 "0x"）。

从系统中获取程序

如果您在这个作用域、循环、其他条件（在这些条件下您没有保存结构）之外初始化程序，您可以通过 ID 从系统获取对象。

let prog = sys.get_program(105).unwrap();

初始化带样式的 env_logger

初始化带样式的 env_logger 以将日志（默认情况下仅为 gwasm）打印到 stdout

sys.init_logger();

要指定打印的日志，设置环境变量 RUST_LOG

RUST_LOG="target_1=logging_level,target_2=logging_level" cargo test

发送消息

向程序发送消息需要调用程序的两个函数之一

• Program::send（或者如果您需要发送带有资金的短信，则使用 Program::send_with_value）。
• Program::send_bytes（或者如果您需要发送带有资金的短信，则使用 Program::send_bytes_with_value）。

这两种方法都需要将发送者ID作为第一个参数，将有效载荷作为第二个参数。

它们之间的区别非常简单，类似于 gstd 函数 msg::send 和 msg::send_bytes。

第一个需要将有效载荷编码为 CODEC 可编码的，而第二个需要有效载荷实现 AsRef<[u8]>，这意味着可以表示为字节。

Program::send 使用 Program::send_bytes 在底层，使用来自 payload.encode() 的字节。

初始化程序结构后的第一条消息总是初始化消息。

let res = prog.send_bytes(100001, "INIT MESSAGE");

处理程序执行结果

库中的任何发送函数都返回 RunResult 结构。

它包含处理消息的最终结果以及其他在执行期间创建的内容。

它有 4 个主要功能

• RunResult::log — 返回用户消息产生的 Vec 的引用。您可以根据需要断言它们，遍历它们。
• RunResult::main_failed — 返回布尔值，表示在主消息执行期间发生 panic。
• RunResult::others_failed — 返回布尔值，表示在主执行期间创建的消息执行期间发生 panic。如果没有其他调用，则等于 false。
• RunResult::contains — 返回一个布尔值，表示日志中包含指定的日志。语法糖围绕 res.log().iter().any(|v| v == arg)。

为了构建断言日志，您需要使用 [Log] 结构及其构建器。这里所有字段都是可选的。使用核心 Log 结构进行的断言是在 Some(..) 字段上进行的。如果您尝试设置已指定的字段，将会遇到 panic。

// Constructor for success log.
let log = Log::builder();

// Constructor for error reply log.
let log = Log::error_builder(ErrorReplyReason::InactiveActor);
// Other fields are set optionally by `dest()`, `source()`, `payload()`, `payload_bytes()`.
let log = Log::builder()
    .source(prog.id())
    .dest(100001)
    .payload_bytes("PONG");

日志还具有来自 (ID, T) 和来自 (ID_1, ID_2, T) 的 From 实现，其中 ID: Into<ProgramIdWrapper>，T: AsRef<[u8]>。

let x = Log::builder().dest(5).payload_bytes("A");
let x_from: Log = (5, "A").into();
assert_eq!(x, x_from);

let y = Log::builder().dest(5).source(15).payload_bytes("A");
let y_from: Log = (15, 5, "A").into();
assert_eq!(y, y_from);

消耗区块

您可以通过消耗区块来控制系统中的时间。

它将作为参数传递的区块数量添加到系统的当前区块。同样适用于时间戳。注意，目前 Gear-based 网络中的 1 个区块持续 3 秒。

// Spend 150 blocks (7.5 mins for 3 sec block).
sys.spend_blocks(150);

请注意，处理消息（例如，使用 Program::send/Program::send_bytes 方法）不会消耗区块，也不会更改时间戳。如果您编写了依赖于时间的逻辑，您应该手动消耗区块。

余额

// If you need to send a message with value you have to mint balance for the message sender:
let user_id = 42;
sys.mint_to(user_id, 5000);
assert_eq!(sys.balance_of(user_id), 5000);

// To give the balance to the program you should use `mint` method:
let mut prog = Program::current(&sys);
prog.mint(1000);
assert_eq!(prog.balance(), 1000);