thruput-sdk 0.58.0

Thruput smart-contract SDK for Rust (rv32 guest runtime and native test harness)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

/// Extension trait for replacing an error with a contract exception.
pub trait OrThrow<T> {
    /// On `Err`, throw `exn` as a contract exception. On `Ok`, return the value.
    fn or_throw<E: crate::Exn>(self, exn: E) -> T;
}

impl<T, Err> OrThrow<T> for Result<T, Err> {
    #[cfg_attr(not(target_arch = "riscv32"), track_caller)]
    fn or_throw<E: crate::Exn>(self, exn: E) -> T {
        match self {
            Ok(v) => v,
            Err(_) => throw(exn),
        }
    }
}

impl<T> OrThrow<T> for Option<T> {
    #[cfg_attr(not(target_arch = "riscv32"), track_caller)]
    fn or_throw<E: crate::Exn>(self, exn: E) -> T {
        match self {
            Some(v) => v,
            None => throw(exn),
        }
    }
}

#[cfg_attr(not(target_arch = "riscv32"), track_caller)]
pub fn throw<E>(exn: E) -> !
where
    E: crate::Exn,
{
    let exn = crate::exn::cross_exn::ContractExn::new(exn);
    crate::contract_abort_encoded(&exn)
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::exn::Exn;
    use crate::xdr::*;

    #[derive(Debug, Clone, PartialEq, ReadXDR, WriteXDR)]
    #[repr(i32)]
    enum TestExn {
        Boom = 1,
    }
    impl Exn for TestExn {
        const SELECTOR: u64 = 0xDEAD;
    }

    #[test]
    fn or_throw_ok_returns_value() {
        let result: Result<i32, &str> = Ok(42);
        assert_eq!(result.or_throw(TestExn::Boom), 42);
    }
}