linera-core 0.15.17

The core Linera protocol, including client and server logic, node synchronization, etc.
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
84

// Copyright (c) Zefchain Labs, Inc.
// SPDX-License-Identifier: Apache-2.0

use assert_matches::assert_matches;
use linera_chain::{ChainError, ChainExecutionContext};
use linera_execution::ExecutionError;

use crate::{client::chain_client, local_node::LocalNodeError, worker::WorkerError};

/// Asserts that an error is due to insufficient balance during an operation.
pub fn assert_insufficient_balance_during_operation<T>(
    obtained_error: Result<T, chain_client::Error>,
    operation_index: u32,
) {
    let chain_client::Error::LocalNodeError(LocalNodeError::WorkerError(WorkerError::ChainError(
        error,
    ))) = obtained_error.err().unwrap()
    else {
        panic!("Expected a chain_client::Error::LocalNodeError with a WorkerError::ChainError");
    };

    let ChainError::ExecutionError(execution_error, context) = *error else {
        panic!("Expected a ChainError::ExecutionError, found: {error:#?}");
    };

    let ChainExecutionContext::Operation(index) = context else {
        panic!("Expected ChainExecutionContext::Operation, found: {context:#?}");
    };

    assert_eq!(index, operation_index, "Operation index mismatch");

    assert_matches!(
        *execution_error,
        ExecutionError::InsufficientBalance { .. },
        "Expected ExecutionError::InsufficientBalance, found: {execution_error:#?}"
    );
}

/// Asserts that an error is due to insufficient funding for fees.
pub fn assert_fees_exceed_funding<T>(obtained_error: Result<T, chain_client::Error>) {
    let chain_client::Error::LocalNodeError(LocalNodeError::WorkerError(WorkerError::ChainError(
        error,
    ))) = obtained_error.err().unwrap()
    else {
        panic!("Expected a chain_client::Error::LocalNodeError with a WorkerError::ChainError");
    };

    let ChainError::ExecutionError(execution_error, _context) = *error else {
        panic!("Expected a ChainError::ExecutionError, found: {error:#?}");
    };

    assert_matches!(
        *execution_error,
        ExecutionError::FeesExceedFunding { .. },
        "Expected ExecutionError::FeesExceedFunding, found: {execution_error:#?}"
    );
}

/// Asserts that an error is due to insufficient funding with a generic execution context.
pub fn assert_insufficient_funding<T>(
    obtained_error: Result<T, chain_client::Error>,
    expected_context: ChainExecutionContext,
) {
    let chain_client::Error::LocalNodeError(LocalNodeError::WorkerError(WorkerError::ChainError(
        error,
    ))) = obtained_error.err().unwrap()
    else {
        panic!("Expected a chain_client::Error::LocalNodeError with a WorkerError::ChainError");
    };

    let ChainError::ExecutionError(execution_error, context) = *error else {
        panic!("Expected a ChainError::ExecutionError, found: {error:#?}");
    };

    if std::mem::discriminant(&context) != std::mem::discriminant(&expected_context) {
        panic!("Expected execution context {expected_context:?}, but found {context:?}");
    }

    assert_matches!(
        *execution_error,
        ExecutionError::InsufficientBalance { .. },
        "Expected ExecutionError::InsufficientBalance, found: {execution_error:#?}"
    );
}