19 releases (9 breaking)

0.13.1 Nov 12, 2024
0.12.1 Sep 14, 2024
0.11.3 May 22, 2024
0.10.1 Mar 28, 2024
0.2.0 Jun 27, 2023

#725 in Magic Beans

Download history 8/week @ 2024-07-29 8/week @ 2024-08-05 10/week @ 2024-08-12 5/week @ 2024-08-19 4/week @ 2024-08-26 181/week @ 2024-09-02 164/week @ 2024-09-09 88/week @ 2024-09-16 90/week @ 2024-09-23 37/week @ 2024-09-30 5/week @ 2024-10-07 36/week @ 2024-10-14 15/week @ 2024-10-21 140/week @ 2024-10-28 50/week @ 2024-11-04 133/week @ 2024-11-11

341 downloads per month
Used in 2 crates

Apache-2.0

1.5MB
34K SLoC

This module provides an SDK for developing Linera applications using Rust.

A Linera application consists of two WebAssembly binaries: a contract and a service. Both binaries have access to the same application and chain specific storage. The service only has read-only access, while the contract can write to it. The storage should be used to store the application state, which is persisted across blocks. The state can be a custom type that uses linera-views, a framework that allows lazily loading selected parts of the state. This is useful if the application's state is large and doesn't need to be loaded in its entirety for every execution.

The contract binary should create a type to implement the Contract trait. The type can store the ContractRuntime and the state, and must have its implementation exported by using the contract! macro.

The service binary should create a type to implement the Service trait. The type can store the ServiceRuntime and the state, and must have its implementation exported by using the service! macro.

Examples

The examples directory contains some example applications.

Contributing

See the CONTRIBUTING file for how to help out.

License

This project is available under the terms of the Apache 2.0 license.

Dependencies

~26–49MB
~895K SLoC