co-api 0.1.0

COKIT API to implement a Core.
Documentation 
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

// SPDX-License-Identifier: AGPL-3.0-only
// Copyright (C) 2026 1io BRANDGUARDIAN GmbH

#[cfg(target_arch = "wasm32")]
#[link(wasm_import_module = "co_v1")]
extern "C" {
	/// Read block.
	///
	/// Returns the byte length of the block.
	/// If the buffer_size is smaller than the returned byte length only the the first bytes until buffer_size are
	/// placed in buffer. The caller may call this again with an larger buffer.
	/// Also it is possible to call it with buffer_size=0 to only retrieve the size of the block.
	pub fn storage_block_get(cid: *const u8, cid_size: u32, buffer: *mut u8, buffer_size: u32) -> u32;

	/// Write block.
	pub fn storage_block_set(cid: *const u8, cid_size: u32, buffer: *const u8, buffer_size: u32) -> u32;
}

/// Stub
///
/// # Safety
/// This is only a stub to prevent mistakes.
#[cfg(not(target_arch = "wasm32"))]
pub unsafe extern "C" fn storage_block_get(
	_cid: *const u8,
	_cid_size: u32,
	_buffer: *mut u8,
	_buffer_size: u32,
) -> u32 {
	panic!("only available for target_arch = \"wasm32\"");
}

/// Stub
///
/// # Safety
/// This is only a stub to prevent mistakes.
#[cfg(not(target_arch = "wasm32"))]
pub unsafe extern "C" fn storage_block_set(
	_cid: *const u8,
	_cid_size: u32,
	_buffer: *const u8,
	_buffer_size: u32,
) -> u32 {
	panic!("only available for target_arch = \"wasm32\"");
}