Substrate 运行时接口

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

在运行时接口中使用类型

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

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

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

这些特质已为大多数常见类型（如[T]、Vec<T>、数组和原始类型）实现。

对于自定义类型，我们提供了PassBy特质和策略，这些策略定义了类型如何在wasm运行时和node之间传递。每个策略还提供了一个derive宏以简化实现。

性能

为了在调用node时不浪费更多性能，当在wasm运行时和node之间传递参数时，并非所有类型都使用SCALE编码。对于大多数原始字节数据类型，如Vec<u8>、[u8]或[u8; N]，我们直接传递它们，而不在前面进行SCALE编码。每个类型的RIType实现提供了有关数据如何传递的更多信息。

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