26 releases (8 breaking)

0.14.0 Feb 21, 2024
0.12.0 Feb 8, 2024
0.10.3 Dec 28, 2023
0.10.1 Oct 24, 2023
0.6.10 Jun 15, 2021

#29 in #marine

Download history 634/week @ 2024-12-08 496/week @ 2024-12-15 308/week @ 2024-12-22 33/week @ 2024-12-29 228/week @ 2025-01-05 308/week @ 2025-01-12 382/week @ 2025-01-19 181/week @ 2025-01-26 349/week @ 2025-02-02 419/week @ 2025-02-09 256/week @ 2025-02-16 314/week @ 2025-02-23 177/week @ 2025-03-02 300/week @ 2025-03-09 330/week @ 2025-03-16 248/week @ 2025-03-23

1,119 downloads per month
Used in 40 crates (4 directly)

Apache-2.0

145KB
3K SLoC

Defines the #[marine] macro that should be used with all export functions, extern blocks. At now, It supports the following types that could be used as parameters in export or foreign functions: i8, i16, i32, i64, u8, u16, u32, u64, f32, f64, bool, String, Vec. Also struct where all fields are public and have aforementioned types could be used as parameters. In this case #[marine] should be also applied to this structs.

Examples

This example shows how a function could be exported:

#[marine]
pub fn greeting(name: String) -> String {
    format!("Hi {}", name)
}

This more complex example shows how a function could be imported from another Wasm module and how a struct could be passed:

use marine_rs_sdk::MountedBinaryResult;

#[marine]
pub fn read_ipfs_file(file_path: String) -> MountedBinaryResult {
    let hash = calculate_hash(file_path);
    ipfs(vec![hash])
}

#[marine]
#[link(wasm_import_module = "ipfs_node")]
extern "C" {
    pub fn ipfs(file_hash: Vec<String>) -> MountedBinaryResult;
}

Dependencies

~0.7–1.6MB
~34K SLoC