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

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,9 @@ 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

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():
@@ -549,15 +582,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 +658,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 +906,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")

certora_cli/certoraRanger.py

@@ -0,0 +1,71 @@
+#!/usr/bin/env python3
+#     The Certora Prover
+#     Copyright (C) 2025  Certora Ltd.
+#
+#     This program is free software: you can redistribute it and/or modify
+#     it under the terms of the GNU General Public License as published by
+#     the Free Software Foundation, version 3 of the License.
+#
+#     This program is distributed in the hope that it will be useful,
+#     but WITHOUT ANY WARRANTY; without even the implied warranty of
+#     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#     GNU General Public License for more details.
+#
+#     You should have received a copy of the GNU General Public License
+#     along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+
+import sys
+from pathlib import Path
+from rich.console import Console
+
+
+scripts_dir_path = Path(__file__).parent.resolve()  # containing directory
+sys.path.insert(0, str(scripts_dir_path))
+
+import CertoraProver.certoraContextAttributes as Attrs
+from Shared import certoraUtils as Util
+from certoraRun import run_certora, CertoraRunResult, CertoraFoundViolations
+
+from typing import List, Optional
+
+
+def run_ranger(args: List[str]) -> Optional[CertoraRunResult]:
+    return run_certora(args, Attrs.RangerAttributes, prover_cmd=sys.argv[0])
+
+def entry_point() -> None:
+    try:
+        run_ranger(sys.argv[1:])
+        sys.exit(0)
+    except KeyboardInterrupt:
+        Console().print("[bold red]\nInterrupted by user")
+        sys.exit(1)
+    except Util.TestResultsReady:
+        print("reached checkpoint")
+        sys.exit(0)
+    except CertoraFoundViolations as e:
+        try:
+            assert e.results
+            print(f"report url: {e.results.rule_report_link}")
+        except Exception:
+            pass
+        Console().print("[bold red]\nViolations were found\n")
+        sys.exit(1)
+    except Util.CertoraUserInputError as e:
+        if e.orig:
+            print(f"\n{str(e.orig).strip()}")
+        if e.more_info:
+            print(f"\n{e.more_info.strip()}")
+        Console().print(f"[bold red]\n{e}\n")
+        sys.exit(1)
+
+    except Util.ExitException as e:
+        Console().print(f"[bold red]{e}")
+        sys.exit(e.exit_code)
+
+    except Exception as e:
+        Console().print(f"[bold red]{e}")
+        sys.exit(1)
+
+if __name__ == '__main__':
+    entry_point()