leo_errors/errors/static_analyzer/
static_analyzer_warning.rs

1// Copyright (C) 2019-2025 Provable Inc.
2// This file is part of the Leo library.
3
4// The Leo library is free software: you can redistribute it and/or modify
5// it under the terms of the GNU General Public License as published by
6// the Free Software Foundation, either version 3 of the License, or
7// (at your option) any later version.
8
9// The Leo library is distributed in the hope that it will be useful,
10// but WITHOUT ANY WARRANTY; without even the implied warranty of
11// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12// GNU General Public License for more details.
13
14// You should have received a copy of the GNU General Public License
15// along with the Leo library. If not, see <https://www.gnu.org/licenses/>.
16
17use crate::create_messages;
18
19use std::fmt::Display;
20
21create_messages!(
22    /// ParserWarning enum that represents all the warnings for static analysis
23    StaticAnalyzerWarning,
24    code_mask: 4000i32,
25    code_prefix: "SAZ",
26
27    @formatted
28    some_paths_do_not_await_all_futures {
29        args: (num_total_paths: impl Display, num_unawaited_paths: impl Display),
30        msg: format!("Not all paths through the function await all futures. {num_unawaited_paths}/{num_total_paths} paths contain at least one future that is never awaited."),
31        help: Some("Ex: `f.await()` to await a future. Remove this warning by including the `--disable-conditional-branch-type-checking` flag.".to_string()),
32    }
33
34    @formatted
35    some_paths_contain_duplicate_future_awaits {
36        args: (num_total_paths: impl Display, num_duplicate_await_paths: impl Display),
37        msg: format!("Some paths through the function contain duplicate future awaits. {num_duplicate_await_paths}/{num_total_paths} paths contain at least one future that is awaited more than once."),
38        help: Some("Look at the times `.await()` is called, and try to reduce redundancies. Remove this warning by including the `--disable-conditional-branch-type-checking` flag.".to_string()),
39    }
40
41    @formatted
42    max_conditional_block_depth_exceeded {
43        args: (max: impl Display),
44        msg: format!("The type checker has exceeded the max depth of nested conditional blocks: {max}."),
45        help: Some("Re-run with a larger maximum depth using the `--conditional_block_max_depth` build option. Ex: `leo run main --conditional_block_max_depth 25`.".to_string()),
46    }
47
48    @formatted
49    future_not_awaited_in_order {
50        args: (future_name: impl Display),
51        msg: format!("The future `{}` is not awaited in the order in which they were passed in to the `async` function.", future_name),
52        help: Some("While it is not required for futures to be awaited in order, there is some specific behavior that arises, which may affect the semantics of your program. See `https://github.com/AleoNet/snarkVM/issues/2570` for more context.".to_string()),
53    }
54);