#virtual-machine #contract #smart-contracts #machine #smart #virtual #wasm

nightly no-std piecrust-uplink

Build smart contracts directly on top of Dusk’s piecrust virtual machine

21 releases (12 breaking)

new 0.13.0 Jun 5, 2024
0.11.0 Feb 14, 2024
0.9.0 Dec 13, 2023
0.8.0 Oct 11, 2023
0.1.0 Mar 15, 2023

#2693 in Magic Beans

Download history 877/week @ 2024-02-12 1067/week @ 2024-02-19 492/week @ 2024-02-26 89/week @ 2024-03-04 86/week @ 2024-03-11 65/week @ 2024-03-18 44/week @ 2024-03-25 79/week @ 2024-04-01 2/week @ 2024-04-08 15/week @ 2024-04-15 3/week @ 2024-04-22 11/week @ 2024-04-29 127/week @ 2024-05-06 16/week @ 2024-05-13 37/week @ 2024-05-20 18/week @ 2024-05-27

198 downloads per month
Used in 6 crates (3 directly)

MPL-2.0 license

37KB
706 lines

π-crust Uplink

Repository Build Status Documentation

Piecrust Uplink is the library that allows you to build smart contracts directly on top of Dusk's Piecrust virtual machine.

Usage

The library allows users of the contract platform to manage the interface and state with the host environment of the contracts. The example below describes a barebones contract. For more detailed examples, see the contracts folder.

Add piecrust_uplink as a dependency to your contract project:

cargo install piecrust_uplink

To make use of uplink, import the dependency in your project and mark it as no_std:

#![no_std]

use piecrust_uplink as uplink;

To attach state to a contract:

/// Struct that describe the state for your contract
pub struct Counter {
    value: i64,
};

/// State of the contract
static mut STATE: Counter = Counter { value: 0x1 };

To define logic for your contract, define an implementation:

impl Counter {
    pub fn read_value(&self) -> i64 {
        self.value
    }

    pub fn increment(&mut self) {
        let value = self.value + 1;
    }
}

Read and write operations need to be exposed to the host. Add the following below the implementation:

unsafe fn read_value(arg_len: u32) -> u32 {
    uplink::wrap_call(arg_len, |_: ()| STATE.read_value())
}

#[no_mangle]
unsafe fn increment(arg_len: u32) -> u32 {
    uplink::wrap_call(arg_len, |panic: bool| STATE.increment(panic))
}

Release History

To see the release history for this crate, please see the CHANGELOG file.

License

This code is licensed under the Mozilla Public License Version 2.0 (MPL-2.0). Please see the LICENSE for further details.

Contribute

If you want to contribute to this project, please check the CONTRIBUTING file.

Dependencies

~4–11MB
~141K SLoC