Crate fluence

Source
Expand description

Rust backend SDK for applications on the Fluence network. This crate defines the procedure macro #[marine] that could be applied to a function, structure or extern block.

Structures with #[marine] (hereinafter they’ll be called records) could be used then in function arguments and values. All fields of a record should be public and have one of the following primitive Rust types (bool, u8, u16, u32, u64, i8, i16, i32, i64, f32, f64, String, Vec<u8>).

use fluence::marine;

#[marine]
struct T {
    pub field_1: i32,
    pub field_2: Vec<u8>,
}

Functions with #[marine] will be exported from this module:

use fluence::marine;

#[marine]
pub fn get(url: String) {
    // ...
}

At now, such functions could have arguments with primitive Rust types and record and only one return argument with such type could be used.

Finally, to import other wasm modules to your project use similar code:

use fluence::marine;

#[marine]
#[link(wasm_import_module = "wasm_curl.wasm")]
extern "C" {
    #[link_name = "get"]
    pub fn curl_get(url: String) -> String;
}

Modules§

internal
These API functions are intended for internal usage in generated code. Normally, you shouldn’t use them.

Macros§

module_manifest

Structs§

CallParameters
This struct contains parameters that would be accessible by Wasm modules.
MountedBinaryResult
Describes result of calling a CLI service.
MountedBinaryStringResult
The same as the MountedBinaryResult, but stdout and stderr are utf8 strings.
SecurityTetraplet
Describes an origin that set an argument.
WasmLoggerBuilder
The Wasm logger builder.

Constants§

BINARY_SUCCESS_CODE

Functions§

get_call_parameters

Type Aliases§

TargetMap
Mapping from logging namespace string to its bitmask. TODO: use i64 for bitmask when wasmpack/bindgen issue with i64 is fixed. Currently, i64 doesn’t work on some versions of V8 because log_utf8_string function isn’t marked as #[wasm_bindgen]. In result, TS/JS code throws ‘TypeError’ on every log.

Attribute Macros§

fce
marine