#tezos #rollup #smart #no-alloc #api-bindings #error-code

no-std tezos-smart-rollup-core

Low-level host function definitions & constants for Tezos Smart Rollups

4 releases

0.2.2 Nov 24, 2023
0.2.1 Jul 28, 2023
0.2.0 Jun 15, 2023
0.1.0 Apr 25, 2023

#20 in #tezos

Download history 46/week @ 2024-07-19 37/week @ 2024-07-26 41/week @ 2024-08-02 31/week @ 2024-08-09 31/week @ 2024-08-16 20/week @ 2024-08-23 30/week @ 2024-08-30 22/week @ 2024-09-06 22/week @ 2024-09-13 26/week @ 2024-09-20 24/week @ 2024-09-27 19/week @ 2024-10-04 24/week @ 2024-10-11 20/week @ 2024-10-18 13/week @ 2024-10-25 17/week @ 2024-11-01

77 downloads per month
Used in 11 crates (9 directly)

MIT license

27KB
386 lines

Core API for the virtual smart_rollup_core WASM module, exposed by Tezos Smart Rollups.

About

In order for a kernel to do useful work, it must be able to read input from users, respond with output, and update its internal state. To do so, rollups make a set of C-style host functions available to kernels, which enable:

  • reading from the inbox.
  • writing to the outbox.
  • manipulating durable storage.

This crate provides the definitions of these host functions, including linking to the smart_rollup_core WASM module. In addition, various constants (such as error codes) used when interacting with these host functions, are defined here.

Safety

This crate exposes the host functions through the SmartRollupCore trait, which is unsafe to use - as it makes no effort to provide a safe rust API. A safe API is defined in the tezos-smart-rollup-host crate, as the Runtime trait.

It's therefore recommended to use the Runtime trait directly from the tezos-smart-rollup-host crate, or alternatively directly through the tezos-smart-rollup top-level SDK crate.

Dependencies

~0–0.8MB
~16K SLoC