Tetcore 运行时接口

此软件包提供围绕运行时接口的类型、特性和宏。运行时接口是 Tetcore 运行时与 Tetcore 节点之间的一种固定接口。对于原生运行时，接口映射到实现的直接函数调用。对于 wasm 运行时，接口映射到外部函数调用。这些外部函数由 wasm 执行器导出，它们映射到与原生调用相同的实现。

在运行时接口中使用类型

任何应作为参数或返回值在运行时接口中使用的数据类型都需要实现 RIType。关联类型 FFIType 是在 FFI 函数中用于表示实际类型的类型。例如 [T] 由一个 u64 表示。切片指针和长度将映射到一个 u64 值。更多信息请参见此 表格。当从 wasm 运行时调用节点时使用 FFI 函数定义。

特性用于将类型转换为相应的 RIType::FFIType。根据类型应在函数签名中何处以及如何使用，需要实现以下特性的组合

1. 作为函数参数传递： wasm::IntoFFIValue 和 host::FromFFIValue
2. 作为函数的返回值： wasm::FromFFIValue 和 host::IntoFFIValue
3. 作为可变函数参数传递： host::IntoPreallocatedFFIValue

这些特质适用于大多数常见类型，如 [T]，Vec<T>，数组以及原始类型。

#[tp_runtime_interface::runtime_interface]
trait RuntimeInterface {
    fn some_function(value: &[u8]) -> bool {
        value.iter().all(|v| *v > 125)
    }
}