Bindings to the Internet Computer system API.

The raw bindings can be found in the [sys] module. The functions in the crate root provide slightly higher-level bindings in terms of slices instead of pointers/lengths, accurately typed pointers, etc., but otherwise does not adapt the API. Where this is all that is needed for the functions to be safe, they are marked as safe, but function pointers cannot be made safe and as such call_new is still unsafe.

Any function ic0.foo that would write to a user buffer has two versions, foo which takes &mut [u8] and foo_uninit which takes &mut [MaybeUninit<u8>].

ic0

Internet Computer System API binding.

What

ic0 is simply a safe Rust translation of the System API as described in the IC interface specification. The unsafe direct imports can be found in the ic0::sys module.

Update

ic0 keeps in step with the IC interface specification. Particularly, ic0 is directly generated from the system API in that repo.

When interface-spec releases a new version that modify system API:

1. replace ic0.txt in the root of this project;
2. copy any new function headers to manual_safety_comments.txt, and add a safety comment for the function;
3. execute cargo run --example=ic0build;

src/sys.rs should be updated.