certora-cli-beta-mirror 7.28.0__py3-none-any.whl → 7.29.1__py3-none-any.whl

certora_cli/CertoraProver/certoraContext.py

@@ -120,9 +120,11 @@ def get_local_run_cmd(context: CertoraContext) -> List[str]:
     """
     run_args = []
 
-    if hasattr(context, 'rust_executables') and hasattr(context, 'rust_project_directory'):
-        run_args.append(os.path.join(context.rust_project_directory, context.rust_executables))
-    elif context.is_tac or Attrs.is_rust_app():
+    if Attrs.is_rust_app():
+        # For local runs, we want path to be relative to cwd instead of zip root.
+        rust_rel_path = os.path.relpath(Path(context.files[0]), os.getcwd())
+        run_args.append(rust_rel_path)
+    elif context.is_tac:
         # For Rust app we assume the files holds the executable for the prover, currently we support a single file
         try:
             run_args.append(context.files[0])
@@ -159,10 +161,16 @@ class ProverParser(AttrUtil.ContextAttributeParser):
 
     def format_help(self) -> str:
         console = Console()
-        console.print("\n\nThe Certora Prover - A formal verification tool for smart contracts")
+        if Attrs.is_ranger_app():
+            console.print("\n\nRanger - Certora’s bounded model checker for smart contracts")
+        else:
+            console.print("\n\nThe Certora Prover - A formal verification tool for smart contracts")
         # Using sys.stdout.write() as print() would color some of the strings here
         sys.stdout.write(f"\n\nUsage: {sys.argv[0]} <Files> <Flags>\n\n")
-        if Attrs.is_evm_app():
+        if Attrs.is_ranger_app():
+            sys.stdout.write("Ranger supports only Solidity (.sol) and configuration (.conf) files.\n"
+                             "Rust and Vyper contracts are not currently supported.\n\n")
+        elif Attrs.is_evm_app():
             sys.stdout.write("Acceptable files for EVM projects are Solidity files (.sol suffix), "
                              "Vyper files (.vy suffix), or conf files (.conf suffix)\n\n")
         elif Attrs.is_solana_app():
@@ -252,6 +260,8 @@ def get_args(args_list: Optional[List[str]] = None) -> CertoraContext:
         Cv.check_mode_of_operation(context)  # Here boolean run characteristics are set
 
     validator = Cv.CertoraContextValidator(context)
+    if Attrs.is_evm_app():
+        validator.handle_ranger_attrs()
     validator.validate()
     if Attrs.is_evm_app() or Attrs.is_rust_app():
         current_build_directory = Util.get_build_dir()
@@ -268,6 +278,8 @@ def get_args(args_list: Optional[List[str]] = None) -> CertoraContext:
     if Attrs.is_evm_app():
         validator.check_args_post_argparse()
         setup_cache(context)  # Here context.cache, context.user_defined_cache are set
+    if Attrs.is_rust_app():
+        validator.check_rust_args_post_argparse()
 
     attrs_to_relative(context)
     # Setup defaults (defaults are not recorded in conf file)

certora_cli/CertoraProver/certoraContextAttributes.py

@@ -351,7 +351,6 @@ class EvmAttributes(AttrUtil.Attributes):
 
     SOLC_EXPERIMENTAL_VIA_IR = AttrUtil.AttributeDefinition(
         arg_type=AttrUtil.AttrArgType.BOOLEAN,
-        help_msg="Pass the `--experimental-via-ir` flag to the Solidity compiler",
         default_desc="",
         argparse_args={
             'action': AttrUtil.STORE_TRUE
@@ -527,7 +526,7 @@ class EvmAttributes(AttrUtil.Attributes):
         affects_build_cache_key=True,
         disables_build_cache=False,
         config_data=AttributeJobConfigData(
-            main_section=MainSection.PACKAGES
+            main_section=MainSection.NEW_SECTION
         )
     )
 
@@ -545,9 +544,10 @@ class EvmAttributes(AttrUtil.Attributes):
 
     STRICT_SOLC_OPTIMIZER = AttrUtil.AttributeDefinition(
         arg_type=AttrUtil.AttrArgType.BOOLEAN,
-        help_msg="Allow Solidity compiler optimizations that can interfere with internal function finders",
-        default_desc="Disables optimizations that may invalidate the bytecode annotations that identify "
-                     "internal functions",
+        # This is a hidden flag, the following two attributes are left intentionally as comments to help devs
+        # help_msg="Allow Solidity compiler optimizations that can interfere with internal function finders",
+        # default_desc="Disables optimizations that may invalidate the bytecode annotations that identify "
+        #              "internal functions",
         argparse_args={
             'action': AttrUtil.STORE_TRUE
         },
@@ -573,7 +573,8 @@ class EvmAttributes(AttrUtil.Attributes):
 
     YUL_ABI = AttrUtil.AttributeDefinition(
         attr_validation_func=Vf.validate_json_file,
-        help_msg="An auxiliary ABI file for yul contracts",
+        # This is a hidden flag, the following two attributes are left intentionally as comments to help devs
+        # help_msg="An auxiliary ABI file for yul contracts",
         default_desc="",
         argparse_args={
             'action': AttrUtil.UniqueStore
@@ -604,7 +605,7 @@ class EvmAttributes(AttrUtil.Attributes):
         affects_build_cache_key=True,  # not sure, better be careful
         disables_build_cache=False,
         config_data=AttributeJobConfigData(
-            main_section=MainSection.LINKS
+            main_section=MainSection.NEW_SECTION
         )
     )
 
@@ -640,9 +641,10 @@ class EvmAttributes(AttrUtil.Attributes):
 
     STORAGE_EXTENSION_HARNESSES = AttrUtil.AttributeDefinition(
         attr_validation_func=Vf.validate_storage_extension_harness_attr,
-        help_msg="List of ContractA=ContractB where ContractB is the name of a 'storage extension prototype`. "
-                 "See the documentation for details",
-        default_desc="",
+        # The docs aren't ready yet. The flag is hidden; the lines below are commented to help us devs
+        # help_msg="List of ContractA=ContractB where ContractB is the name of a 'storage extension prototype`. "
+        #          "See the documentation for details",
+        # default_desc="",
         disables_build_cache=False,
         affects_build_cache_key=True,
         arg_type=AttrUtil.AttrArgType.LIST,
@@ -738,7 +740,8 @@ class EvmAttributes(AttrUtil.Attributes):
             'action': AttrUtil.UniqueStore
         },
         affects_build_cache_key=False,
-        disables_build_cache=False
+        disables_build_cache=False,
+        config_data=None
     )
 
     BUILD_CACHE = AttrUtil.AttributeDefinition(
@@ -751,11 +754,13 @@ class EvmAttributes(AttrUtil.Attributes):
         affects_build_cache_key=False,
         disables_build_cache=False
     )
+
     FUNCTION_FINDER_MODE = AttrUtil.AttributeDefinition(
         attr_validation_func=Vf.validate_function_finder_mode,
-        help_msg="Use `relaxed` mode to increase internal function finders precision, "
-                 "but may cause `stack too deep` errors unless using `via-ir`",
-        default_desc="Takes less stack space but internal functions may be missed",
+        # This is a hidden flag, the following two attributes are left intentionally as comments to help devs
+        # help_msg="Use `relaxed` mode to increase internal function finders precision, "
+        #          "but may cause `stack too deep` errors unless using `via-ir`",
+        # default_desc="Takes less stack space but internal functions may be missed",
         argparse_args={
             'nargs': AttrUtil.SINGLE_OR_NONE_OCCURRENCES,
             'action': AttrUtil.UniqueStore,
@@ -819,11 +824,17 @@ class EvmAttributes(AttrUtil.Attributes):
         disables_build_cache=False
     )
 
+    EQUIVALENCE_CONTRACTS = AttrUtil.AttributeDefinition(
+        attr_validation_func=Vf.validate_equivalence_contracts,
+        arg_type=AttrUtil.AttrArgType.STRING,
+        affects_build_cache_key=False,
+        disables_build_cache=False
+    )
+
     BYTECODE_JSONS = AttrUtil.AttributeDefinition(
         attr_validation_func=Vf.validate_json_file,
         arg_type=AttrUtil.AttrArgType.LIST,
         jar_flag='-bytecode',
-        help_msg="List of EVM bytecode JSON descriptors",
         default_desc="",
         argparse_args={
             'nargs': AttrUtil.ONE_OR_MORE_OCCURRENCES,
@@ -836,7 +847,6 @@ class EvmAttributes(AttrUtil.Attributes):
     BYTECODE_SPEC = AttrUtil.AttributeDefinition(
         attr_validation_func=Vf.validate_spec_file,
         jar_flag='-spec',
-        help_msg="Spec to use for the provided bytecodes",
         default_desc="",
         argparse_args={
             'action': AttrUtil.UniqueStore
@@ -961,6 +971,20 @@ class EvmAttributes(AttrUtil.Attributes):
         disables_build_cache=False
     )
 
+    EXCLUDE_METHOD = AttrUtil.AttributeDefinition(
+        attr_validation_func=Vf.validate_method_flag,
+        jar_flag='-excludeMethod',
+        arg_type=AttrUtil.AttrArgType.LIST,
+        help_msg="Filter out methods to be verified by their signature",
+        default_desc="Verifies all public or external methods. In invariants pure and view functions are ignored",
+        argparse_args={
+            'nargs': AttrUtil.ONE_OR_MORE_OCCURRENCES,
+            'action': AttrUtil.APPEND
+        },
+        affects_build_cache_key=False,
+        disables_build_cache=False
+    )
+
     OPTIMISTIC_CONTRACT_RECURSION = AttrUtil.AttributeDefinition(
         arg_type=AttrUtil.AttrArgType.BOOLEAN,
         help_msg="Assume the recursion limit is never reached in cases of "
@@ -1076,30 +1100,39 @@ class EvmAttributes(AttrUtil.Attributes):
         },
         affects_build_cache_key=True,
         disables_build_cache=False,
-        help_msg="Verify all foundry fuzz test in the current project",
+        help_msg="Verify all Foundry fuzz tests in the current project",
         default_desc="",
     )
 
-    BMC = AttrUtil.AttributeDefinition(
+    RANGE = AttrUtil.AttributeDefinition(
         attr_validation_func=Vf.validate_non_negative_integer,
         argparse_args={
             'action': AttrUtil.UniqueStore
         },
+        help_msg="The maximal length of function call sequences Ranger checks",
+        default_desc=f"The default value ('{Util.DEFAULT_RANGER_RANGE}') is used",
         jar_flag="-boundedModelChecking",
         affects_build_cache_key=False,
         disables_build_cache=False,
     )
 
-    BMC_FAILURE_LIMIT = AttrUtil.AttributeDefinition(
+    RANGER_FAILURE_LIMIT = AttrUtil.AttributeDefinition(
         attr_validation_func=Vf.validate_non_negative_integer,
         argparse_args={
             'action': AttrUtil.UniqueStore
         },
+        help_msg="Once this number of violations are found, no new Ranger call sequence checks will be started. Checks already in progress will continue.",
+        default_desc=f"Once {Util.DEFAULT_RANGER_FAILURE_LIMIT} violations are found, no new Ranger call sequence checks will be started.",
         jar_flag="-boundedModelCheckingFailureLimit",
         affects_build_cache_key=False,
         disables_build_cache=False,
     )
 
+    @classmethod
+    def hide_attributes(cls) -> List[str]:
+        # do not show these attributes in the help message
+        return [cls.RANGER_FAILURE_LIMIT.name, cls.RANGE.name]
+
 
 class InternalUseAttributes(AttrUtil.Attributes):
     '''
@@ -1451,6 +1484,16 @@ class BackendAttributes(AttrUtil.Attributes):
         disables_build_cache=False
     )
 
+    ENFORCE_REQUIRE_REASON = AttrUtil.AttributeDefinition(
+        arg_type=AttrUtil.AttrArgType.BOOLEAN,
+        jar_flag='-enforceRequireReasonInCVL',
+        argparse_args={
+            'action': AttrUtil.STORE_TRUE
+        },
+        affects_build_cache_key=False,
+        disables_build_cache=False
+    )
+
     # resource files are string of the form <label>:<path> the client will add the file to .certora_sources
     # and will change the path from relative/absolute path to
     PROVER_RESOURCE_FILES = AttrUtil.AttributeDefinition(
@@ -1611,6 +1654,15 @@ class RustAttributes(AttrUtil.Attributes):
         disables_build_cache=False
     )
 
+    CARGO_TOOLS_VERSION = AttrUtil.AttributeDefinition(
+        help_msg="Platform tools version to use",
+        default_desc="Platform tools version is chosen automatically",
+        argparse_args={
+            'action': AttrUtil.UniqueStore
+        },
+        affects_build_cache_key=False,
+        disables_build_cache=False
+    )
 
 class EvmProverAttributes(CommonAttributes, DeprecatedAttributes, EvmAttributes, InternalUseAttributes,
                           BackendAttributes):
@@ -1625,11 +1677,27 @@ class EvmProverAttributes(CommonAttributes, DeprecatedAttributes, EvmAttributes,
         affects_build_cache_key=True,
         disables_build_cache=False,
         config_data=AttributeJobConfigData(
-            main_section=MainSection.FILES
+            main_section=MainSection.NEW_SECTION
         )
     )
 
 
+class RangerAttributes(EvmProverAttributes):
+    @classmethod
+    def ranger_unsupported_attributes(cls) -> List[AttrUtil.AttributeDefinition]:
+        return [cls.PROJECT_SANITY, cls.RULE_SANITY, cls.COVERAGE_INFO, cls.FOUNDRY, cls.INDEPENDENT_SATISFY,
+                cls.MULTI_ASSERT_CHECK, cls.MULTI_EXAMPLE]
+
+    @classmethod
+    def ranger_true_by_default_attributes(cls) -> List[AttrUtil.AttributeDefinition]:
+        return [cls.OPTIMISTIC_LOOP, cls.OPTIMISTIC_FALLBACK, cls.AUTO_DISPATCHER, cls.OPTIMISTIC_HASHING]
+
+    @classmethod
+    def hide_attributes(cls) -> List[str]:
+        # do not show these attributes in the help message
+        combined_list = cls.ranger_unsupported_attributes() + cls.ranger_true_by_default_attributes()
+        return [attr.name for attr in combined_list] + [cls.LOOP_ITER.name, cls.RANGER_FAILURE_LIMIT.name]
+
 class SorobanProverAttributes(CommonAttributes, InternalUseAttributes, BackendAttributes, RustAttributes):
     FILES = AttrUtil.AttributeDefinition(
         attr_validation_func=Vf.validate_soroban_extension,
@@ -1642,7 +1710,7 @@ class SorobanProverAttributes(CommonAttributes, InternalUseAttributes, BackendAt
         affects_build_cache_key=True,
         disables_build_cache=False,
         config_data=AttributeJobConfigData(
-            main_section=MainSection.FILES
+            main_section=MainSection.NEW_SECTION
         )
     )
 
@@ -1660,14 +1728,13 @@ class SolanaProverAttributes(CommonAttributes, InternalUseAttributes, BackendAtt
         affects_build_cache_key=True,
         disables_build_cache=False,
         config_data=AttributeJobConfigData(
-            main_section=MainSection.FILES
+            main_section=MainSection.NEW_SECTION
         )
     )
 
     SOLANA_INLINING = AttrUtil.AttributeDefinition(
         attr_validation_func=Vf.validate_readable_file,
         arg_type=AttrUtil.AttrArgType.LIST,
-        jar_flag='-solanaInlining',
         help_msg="a list of paths for the inlining files of Solana contracts",
         argparse_args={
             'nargs': AttrUtil.ONE_OR_MORE_OCCURRENCES,
@@ -1680,7 +1747,6 @@ class SolanaProverAttributes(CommonAttributes, InternalUseAttributes, BackendAtt
     SOLANA_SUMMARIES = AttrUtil.AttributeDefinition(
         attr_validation_func=Vf.validate_readable_file,
         arg_type=AttrUtil.AttrArgType.LIST,
-        jar_flag='-solanaSummaries',
         help_msg="a list of paths for the summaries files of Solana contracts",
         argparse_args={
             'nargs': AttrUtil.ONE_OR_MORE_OCCURRENCES,
@@ -1782,6 +1848,12 @@ def is_soroban_app() -> bool:
 def is_rust_app() -> bool:
     return is_soroban_app() or is_solana_app()
 
-
+# Ranger will also return true for this function
 def is_evm_app() -> bool:
-    return get_attribute_class() == EvmProverAttributes
+    return issubclass(get_attribute_class(), EvmProverAttributes)
+
+def is_ranger_app() -> bool:
+    return get_attribute_class() == RangerAttributes
+
+def is_sophy_app() -> bool:
+    return False  # wait for the tool to be added

certora_cli/CertoraProver/certoraContextValidator.py

@@ -43,6 +43,39 @@ class CertoraContextValidator:
     def __init__(self, context: CertoraContext):
         self.context = context
 
+    def handle_ranger_attrs(self) -> None:
+        # unset unsupported attributes
+        if Attrs.is_ranger_app():
+            for attr in Attrs.RangerAttributes.ranger_unsupported_attributes():
+                attr_name = attr.get_conf_key()
+                if getattr(self.context, attr_name):
+                    if attr.arg_type == AttrUtil.AttrArgType.BOOLEAN:
+                        setattr(self.context, attr_name, False)
+                    else:
+                        setattr(self.context, attr_name, None)
+                    validation_logger.info(f"Ranger does not support {attr_name}, ignoring this attribute")
+
+            # setting the default Ranger attributes
+
+            self.context.range = self.context.range or Util.DEFAULT_RANGER_RANGE
+            self.context.ranger_failure_limit = self.context.ranger_failure_limit or Util.DEFAULT_RANGER_FAILURE_LIMIT
+            if self.context.loop_iter and self.context.loop_iter != Util.DEFAULT_RANGER_LOOP_ITER:
+                validation_logger.info(f"While running Ranger, loop iter is {Util.DEFAULT_RANGER_LOOP_ITER} "
+                                       f"ignoring the set value of {self.context.loop_iter}")
+            self.context.loop_iter = self.context.loop_iter or Util.DEFAULT_RANGER_LOOP_ITER
+
+            for attr in Attrs.RangerAttributes.ranger_true_by_default_attributes():
+                attr_name = attr.get_conf_key()
+                setattr(self.context, attr_name, True)
+
+        else:
+            if self.context.range:
+                # self.context.range = None
+                validation_logger.info("the 'range' attribute is ignored when not running from the Ranger App")
+            if self.context.ranger_failure_limit:
+                # self.context.ranger_failure_limit = None
+                validation_logger.info("the 'ranger_failure_limit' is ignored when not running from the Ranger App")
+
     def validate(self) -> None:
 
         for attr_def in Attrs.get_attribute_class().attribute_list():
@@ -121,6 +154,14 @@ class CertoraContextValidator:
         elif value not in [True, False]:
             raise Util.CertoraUserInputError(f"value of {conf_key} {value} is not a boolean (true/false)")
 
+    def check_rust_args_post_argparse(self) -> None:
+        context = self.context
+        if context.files:
+            if context.build_script:
+                raise Util.CertoraUserInputError("'files' and 'build_script' cannot be both set for Rust projects")
+            if len(context.files) > 1:
+                raise Util.CertoraUserInputError("Rust projects must specify exactly one executable in 'files'.")
+
     def check_args_post_argparse(self) -> None:
         """
         Performs checks over the arguments after basic argparse parsing
@@ -549,15 +590,16 @@ def check_mode_of_operation(context: CertoraContext) -> None:
     context.is_verify = context.verify is not None and len(context.verify) > 0
     context.is_assert = context.assert_contracts is not None and len(context.assert_contracts) > 0
     context.is_bytecode = context.bytecode_jsons is not None and len(context.bytecode_jsons) > 0
+    context.is_equivalence = context.equivalence_contracts is not None
 
-    if (context.project_sanity or context.foundry) and (context.is_verify or context.is_assert or context.is_bytecode):
+    if (context.project_sanity or context.foundry) and (context.is_verify or context.is_assert or context.is_bytecode or context.is_equivalence):
         raise Util.CertoraUserInputError("The 'project_sanity' and 'foundry' options cannot coexist with the 'verify', 'assert_contract' or 'bytecode_jsons' options")
 
     if context.project_sanity and context.foundry:
         raise Util.CertoraUserInputError("The 'project_sanity' and 'foundry' options cannot coexist")
 
-    if context.is_verify and context.is_assert:
-        raise Util.CertoraUserInputError("only one option of 'assert_contracts' and 'verify' can be used")
+    if len(list(filter(None, [context.is_verify, context.is_assert, context.is_equivalence]))) > 1:
+        raise Util.CertoraUserInputError("only one option of 'assert_contracts', 'verify', 'equivalence' can be used")
 
     has_bytecode_spec = context.bytecode_spec is not None
     if has_bytecode_spec != context.is_bytecode:
@@ -624,7 +666,7 @@ def check_mode_of_operation(context: CertoraContext) -> None:
                     raise Util.CertoraUserInputError(
                         f"Option 'assert_contracts' cannot be used with a {special_file_type} file {input_file}")
 
-    if not any([context.is_assert, context.is_verify, context.is_bytecode,
+    if not any([context.is_assert, context.is_verify, context.is_bytecode, context.equivalence_contracts,
                 special_file_type]) and not context.build_only:
         raise Util.CertoraUserInputError("You must use 'verify' when running the Certora Prover")
 
@@ -872,7 +914,7 @@ def set_wait_for_results_default(context: CertoraContext) -> None:
 
 
 def mode_has_spec_file(context: CertoraContext) -> bool:
-    return not context.is_assert and not context.is_tac
+    return not context.is_assert and not context.is_tac and not context.is_equivalence
 
 
 def to_relative_paths(paths: Union[str, List[str]]) -> Union[str, List[str]]:

certora_cli/CertoraProver/certoraParseBuildScript.py

@@ -17,6 +17,7 @@ import subprocess
 import json
 import logging
 import os
+from typing import List
 
 from CertoraProver.certoraContextClass import CertoraContext
 from Shared import certoraUtils as Util
@@ -56,17 +57,11 @@ def add_solana_files_to_context(context: CertoraContext, json_obj: dict) -> None
                 update_metadata(context, solana_files_attr)
 
 
-def run_script_and_parse_json(context: CertoraContext) -> None:
-    if not context.build_script:
-        return
+def run_rust_build(context: CertoraContext, build_cmd: List[str]) -> None:
+
     try:
-        build_script_logger.info(f"Building from script {context.build_script}")
-        run_cmd = [context.build_script, '--json']
-        if context.cargo_features is not None:
-            run_cmd.append('--cargo_features')
-            for feature in context.cargo_features:
-                run_cmd.append(feature)
-        result = subprocess.run(run_cmd, capture_output=True, text=True)
+        build_script_logger.info(f"Building by calling {build_cmd}")
+        result = subprocess.run(build_cmd, capture_output=True, text=True)
 
         # Check if the script executed successfully
         if result.returncode != 0:
@@ -97,6 +92,8 @@ def run_script_and_parse_json(context: CertoraContext) -> None:
 
         if context.test == str(Util.TestValue.AFTER_BUILD_RUST):
             raise Util.TestResultsReady(context)
+        assert not context.files, f"run_rust_build: expecting files to be empty, got: {context.files}"
+        context.files = [os.path.join(context.rust_project_directory, context.rust_executables)]
 
     except Util.TestResultsReady as e:
         raise e

certora_cli/CertoraProver/certoraVerifyGenerator.py

@@ -51,6 +51,18 @@ class CertoraVerifyGenerator:
             contract_to_check_asserts_for = self.context.assert_contracts
             self.certora_verify_struct = {"type": "assertion",
                                           "primaryContracts": contract_to_check_asserts_for}
+        elif self.context.equivalence_contracts is not None:
+            if self.context.method is None:
+                raise Util.CertoraUserInputError("Argument `method` is required for equivalence checks")
+            if len(self.context.method) != 1:
+                raise Util.CertoraUserInputError("Can only check equivalence on one method")
+            equivalence_query = context.equivalence_contracts
+            equiv_contracts = equivalence_query.split("=")
+            self.certora_verify_struct = {
+                "type": "equivalence",
+                "primary_contract": equiv_contracts[0],
+                "secondary_contract": equiv_contracts[1]
+            }
 
     def update_certora_verify_struct(self, in_certora_sources: bool) -> None:
         """

certora_cli/CertoraProver/splitRules.py

@@ -96,6 +96,8 @@ class SplitRulesHandler():
         rule_flag = Attrs.EvmProverAttributes.RULE.get_flag()
         split_rules_flag = Attrs.EvmProverAttributes.SPLIT_RULES.get_flag()
         msg_flag = Attrs.CommonAttributes.MSG.get_flag()
+        # it is important to use the cache, when the difference between the runs is only the rules that apply
+        build_cache_flag = Attrs.EvmProverAttributes.BUILD_CACHE.get_flag()
         group_id_flag = Attrs.EvmProverAttributes.GROUP_ID.get_flag()
         disable_local_typechecking_flag = Attrs.EvmProverAttributes.DISABLE_LOCAL_TYPECHECKING.get_flag()
 
@@ -137,7 +139,7 @@ class SplitRulesHandler():
                 self.context.msg = ''
 
             cmd = [get_cmd()] + args + [group_id_flag, self.context.group_id, disable_local_typechecking_flag,
-                                        split_rules_flag]
+                                        build_cache_flag, split_rules_flag]
 
             if self.split_rules:
                 for rule in self.split_rules:

certora_cli/Mutate/mutateApp.py

@@ -496,7 +496,7 @@ class WebUtils:
             mutation_test_domain = MConstants.MUTATION_TEST_REPORT_DEV
         else:
             raise Util.CertoraUserInputError(f"Invalid server name {args.server}")
-        self.mutation_test_id_url = f"https://{domain}/mutationTesting/initiate/"
+        self.mutation_test_id_url = f"https://{domain}/v1/domain/mutation-tests/initiate/"
         self.mutation_test_submit_final_result_url = f"https://{domain}/mutationTesting/getUploadInfo/"
         self.mutation_test_final_result_url = f"https://{mutation_test_domain}"
         mutation_logger.debug(f"Using server {args.server} with mutation_test_id_url {self.mutation_test_id_url}")
@@ -542,8 +542,8 @@ class WebUtils:
             try:
                 return requests.put(url, json=body, timeout=self.request_timeout,
                                     headers=headers)
-            except Exception:
-                mutation_logger.debug(f"attempt {i} failed to put url {url}.")
+            except Exception as e:
+                mutation_logger.debug(f"attempt {i} failed to put url {url}. {e}")
         return None
 
     def get_response_with_timeout(self, url: str,

certora_cli/Shared/certoraAttrUtil.py

@@ -168,6 +168,8 @@ class Attributes:
         table.add_column(Text("Default"), width=default_col_width)
 
         for name in dir(cls):
+            if name in cls.hide_attributes():
+                continue
             if name.isupper():
                 attr = getattr(cls, name, None)
                 assert isinstance(attr, AttributeDefinition), "print_attr_help: type(attr) == Attribute"
@@ -193,3 +195,11 @@ class Attributes:
             cls._all_conf_names = [attr.name.lower() for attr in cls.attribute_list()]
             #  'compiler_map' does not have a matching 'compiler' attribute
             cls._all_map_attrs = [attr for attr in cls._all_conf_names if attr.endswith(Util.MAP_SUFFIX)]
+
+    @classmethod
+    def hide_attributes(cls) -> List[str]:
+        """
+        This function is used to hide attributes from the help message.
+        :return: A list of attribute names to be hidden.
+        """
+        return []

certora_cli/Shared/certoraUtils.py

@@ -95,7 +95,6 @@ RECENT_JOBS_FILE = Path(".certora_recent_jobs.json")
 LAST_CONF_FILE = Path("run.conf")
 EMV_JAR = Path("emv.jar")
 CERTORA_SOURCES = Path(".certora_sources")
-SOLANA_DEFAULT_COMMAND = "cargo +solana build-sbf"
 SOLANA_INLINING = "solana_inlining"
 SOLANA_SUMMARIES = "solana_summaries"
 
@@ -122,6 +121,9 @@ MAP_SUFFIX = '_map'
 SUPPRESS_HELP_MSG = "==SUPPRESS=="
 MAX_FLAG_LENGTH = 31
 HELP_TABLE_WIDTH = 97
+DEFAULT_RANGER_RANGE = '5'
+DEFAULT_RANGER_LOOP_ITER = '3'
+DEFAULT_RANGER_FAILURE_LIMIT = '1'
 
 T = TypeVar('T')
 
@@ -296,6 +298,10 @@ class ImplementationError(Exception):
 class BadMutationError(Exception):
     pass
 
+class ExitException(Exception):
+    def __init__(self, message: str, exit_code: int):
+        super().__init__(message)
+        self.exit_code = exit_code  # Store the integer data
 
 MIN_JAVA_VERSION = 11  # minimal java version to run the local type checker jar
 
@@ -1269,6 +1275,8 @@ class TestValue(NoValEnum):
     AFTER_GENERATE_COLLECT_REPORT = auto()
     AFTER_BUILD_RUST = auto()
     AFTER_RULE_SPLIT = auto()
+    SOLANA_BUILD_CMD = auto()
+    CHECK_ZIP = auto()
 
 class FeValue(NoValEnum):
     PRODUCTION = auto()

certora_cli/Shared/certoraValidateFuncs.py

@@ -550,6 +550,13 @@ def validate_assert_contracts(contract: str) -> str:
     return contract
 
 
+def validate_equivalence_contracts(equiv_string: str) -> str:
+    if not re.match(f'^{Util.SOLIDITY_ID_SUBSTRING_RE}={Util.SOLIDITY_ID_SUBSTRING_RE}$', equiv_string):
+        raise Util.CertoraUserInputError(
+            f"Equivalence check must be ContractA=ContractB, got {equiv_string}"
+        )
+    return equiv_string
+
 def validate_packages(package: str) -> str:
     if not re.search("^[^=]+=[^=]+$", package):
         raise Util.CertoraUserInputError("a package must have the form name=path")