13 releases (8 stable)

new 2.0.0 May 27, 2025
1.5.1 Feb 28, 2025
1.5.0 Jan 7, 2025
1.4.0 Oct 18, 2024
0.8.1 Mar 1, 2024

#518 in Magic Beans

Download history 32/week @ 2025-02-08 6/week @ 2025-02-15 82/week @ 2025-02-22 68/week @ 2025-03-01 2/week @ 2025-03-08 4/week @ 2025-03-15 2/week @ 2025-04-12 2/week @ 2025-04-19 7/week @ 2025-05-10 1/week @ 2025-05-17 101/week @ 2025-05-24

109 downloads per month
Used in odra-modules

MIT license

305KB
6K SLoC

This crate provides a testing environment for the Odra VM.

It is meant to be used in the unit tests of the Odra contracts.

Example

#[test]
fn test() {
   let env = odra_test::env();
   let caller = env.get_account(0);

   // Test your contract here.
}

Odra - Smart contracts for Casper Network.

Docs | Installation | Tutorials | Cargo Odra | Discord | Blog

GitHub Workflow Status Code coverage Version License Language

Table of Contents

Usage

Use Cargo Odra to generate, build and test you code.

Example

use odra::prelude::*;

#[odra::module]
pub struct Flipper {
    value: Var<bool>,
}

#[odra::module]
impl Flipper {
    pub fn init(&mut self) {
        self.value.set(false);
    }

    pub fn set(&mut self, value: bool) {
        self.value.set(value);
    }

    pub fn flip(&mut self) {
        self.value.set(!self.get());
    }

    pub fn get(&self) -> bool {
        self.value.get_or_default()
    }
}

#[cfg(test)]
mod tests {
    use crate::flipper::Flipper;
    use odra::host::{Deployer, NoArgs};

    #[test]
    fn flipping() {
        let env = odra_test::env();
        let mut contract = Flipper::deploy(&env, NoArgs);
        assert!(!contract.get());
        contract.flip();
        assert!(contract.get());
    }
}

Checkout our examples. It shows most of Odra features.

Tests

Before running tests make sure you have following packages installed:

  • Rust toolchain (see rustup.rs) with wasm32-unknown-unknown target.
  • cargo-odra with its dependencies (see Cargo Odra)
  • just (see just)

Run tests:

$ just test

Contact

Need some help? Write to contract@odra.dev.

Dependencies

~29–42MB
~759K SLoC