1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127

/*
 * Copyright 2020 Fluence Labs Limited
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

//! 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>`).
//! ```rust
//! use marine_rs_sdk::marine;
//!
//! #[marine]
//! struct T {
//!     pub field_1: i32,
//!     pub field_2: Vec<u8>,
//! }
//! ```
//!
//! Functions with `#[marine]` will be exported from this module:
//!
//! ```rust
//! use marine_rs_sdk::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:
//! ```rust
//! use marine_rs_sdk::marine;
//!
//! #[marine]
//! #[link(wasm_import_module = "wasm_curl.wasm")]
//! extern "C" {
//!     #[link_name = "get"]
//!     pub fn curl_get(url: String) -> String;
//! }
//! ```
#![doc(html_root_url = "https://docs.rs/sdk/0.14.0")] // x-release-please-version
#![deny(
    dead_code,
    nonstandard_style,
    unused_imports,
    unused_mut,
    unused_variables,
    unused_unsafe,
    unreachable_patterns
)]
#![warn(rust_2018_idioms)]

mod mounted_binary;

#[allow(unused_extern_crates)]
// sdk is used inside CallParameters and MountedBinaryResult glue code
extern crate self as marine_rs_sdk;

pub use marine_macro::marine;
pub use marine_macro::fce;

pub use marine_call_parameters::CallParameters;
pub use marine_call_parameters::ParticleParameters;
pub use marine_call_parameters::SecurityTetraplet;
pub use marine_call_parameters::get_call_parameters;

#[cfg(feature = "logger")]
pub use marine_rs_sdk_main::WasmLoggerBuilder;
#[cfg(feature = "logger")]
pub use marine_rs_sdk_main::TargetMap;

pub use mounted_binary::MountedBinaryResult;
pub use mounted_binary::MountedBinaryStringResult;
pub use mounted_binary::SUCCESS_CODE as BINARY_SUCCESS_CODE;

pub use marine_rs_sdk_main::module_manifest;

/// These API functions are intended for internal usage in generated code.
/// Normally, you shouldn't use them.
#[cfg(all(feature = "marine-abi", target_arch = "wasm32"))]
#[doc(hidden)]
pub mod internal {
    pub use marine_rs_sdk_main::get_result_ptr;
    pub use marine_rs_sdk_main::get_result_size;
    pub use marine_rs_sdk_main::set_result_ptr;
    pub use marine_rs_sdk_main::set_result_size;
    pub use marine_rs_sdk_main::add_object_to_release;
    pub use marine_timestamp_macro::build_timestamp;
}

#[cfg(not(feature = "no-explicit-ctors-call"))]
#[cfg(all(feature = "marine-abi", target_arch = "wasm32"))]
extern "C" {
    // For internal use. Not an API function.
    fn __wasm_call_ctors();
}

// Adds an explicit __wasm_call_ctors call to tell LLVM not to
// wrap every export in __wasm_call_ctors/__wasm_call_dtors calls.
// The most referenced issue about it is https://github.com/WebAssembly/WASI/issues/471
// For internal use. Not an API function.
#[cfg(not(feature = "no-explicit-ctors-call"))]
#[cfg(all(feature = "marine-abi", target_arch = "wasm32"))]
#[doc(hidden)]
#[no_mangle]
pub fn _initialize() {
    unsafe {
        __wasm_call_ctors();
    }
}