thruput-native-exec 0.58.0

Native execution environment for testing Thruput smart contracts
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83

use std::panic::panic_any;
use thruput_trace::ffi_enums::HostFnErrorCode;
use thruput_xdr::syserr::SysErr;

/// Perform one guest syscall against the mocked FFI handler, returning its
/// result code. Host-side terminations unwind with the matching
/// [`crate::invoke_error`] payload instead of returning.
#[allow(clippy::too_many_arguments)]
pub fn perform_mocked_syscall(
    syscall: i32,
    arg1: u64,
    arg2: u64,
    arg3: u64,
    arg4: u64,
    arg5: u64,
    arg6: u64,
    arg7: u64,
) -> i32 {
    let result: thruput_sys::ForeignHostFnResult = unsafe {
        thruput_sys::mock_syscall_entrypoint(
            syscall, arg1, arg2, arg3, arg4, arg5, arg6, arg7,
        )
    };

    match result.panic {
        x if x == HostFnErrorCode::NoneOrRecoverable.0 => result.result_code,
        x if x == HostFnErrorCode::OutOfGas.0 => {
            panic_any(crate::invoke_error::out_of_gas_error());
        }
        x if x == HostFnErrorCode::Unrecoverable.0 => {
            panic_any(crate::invoke_error::unrecoverable_error());
        }
        x if x == HostFnErrorCode::Return.0 => {
            panic_any(crate::invoke_error::control_flow_unwind());
        }
        // Exit is a deterministic frame revert on every runtime (rv32,
        // native precompiles): the `Exit` syscall and every host-side
        // rejection of `Return` (over-limit buffer, bad returned auth
        // tokens) raise it. Unwinding it as a completed frame would report
        // the caller an `Ok(Return)` with an empty buffer instead.
        x if x == HostFnErrorCode::Exit.0 => {
            panic_any(crate::invoke_error::deterministic_error());
        }
        x if x == HostFnErrorCode::ValidationFailure.0 => {
            panic_any(crate::invoke_error::validation_error());
        }
        x if x == HostFnErrorCode::Abandon.0 => {
            panic_any(crate::invoke_error::abort_transaction_error());
        }
        _ => {
            panic_any(crate::invoke_error::unrecoverable_error());
        }
    }
}

/// The symbol thruput-xdr's `syscalls_mock` extern declaration links
/// against; forwards to [`perform_mocked_syscall`].
#[unsafe(no_mangle)]
pub extern "C-unwind" fn syscall_wrapper_impl(
    // Matches thruput-xdr's `syscalls_mock` extern declaration, which passes
    // `SyscallNo` widened to a native `SyscallWord` (u64). `SyscallNo` itself is
    // now `repr(transparent)` over a `u32`, so taking it directly here would be
    // an ABI mismatch.
    syscall_no: u64,
    arg1: u64,
    arg2: u64,
    arg3: u64,
    arg4: u64,
    arg5: u64,
    arg6: u64,
    arg7: u64,
) -> SysErr {
    SysErr(perform_mocked_syscall(
        syscall_no as i32,
        arg1,
        arg2,
        arg3,
        arg4,
        arg5,
        arg6,
        arg7,
    ))
}