certora-cli-beta-mirror 8.6.3__py3-none-any.whl → 8.8.0__py3-none-any.whl

certora_cli/CertoraProver/uncheckedOverflowInstrumenter.py

@@ -0,0 +1,152 @@
+#     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/>.
+from typing import Any
+
+from CertoraProver.Compiler.CompilerCollectorSol import CompilerCollectorSol
+from CertoraProver.castingInstrumenter import encode_type, iter_all_nodes_under
+from CertoraProver.certoraBuildDataClasses import SDC, Instrumentation, Replace, InsertBefore, InsertAfter
+from CertoraProver.certoraOffsetConverter import OffsetConverter
+from CertoraProver.certoraSourceFinders import find_char
+from Shared import certoraUtils as Util
+
+
+def is_unchecked_block(node: Any) -> bool:
+    return isinstance(node, dict) and node.get('nodeType') == 'UncheckedBlock'
+
+
+def is_possibly_overflowing_op(node: Any) -> bool:
+    return isinstance(node, dict) and node.get('operator') in {"*", "+", "-"}
+
+
+def find_unchecked(ast: dict[int, Any]) -> list[dict]:
+    function_nodes = [node for node in ast.values() if node.get('nodeType') == 'FunctionDefinition']
+    result = []
+    for func in function_nodes:
+        for node in iter_all_nodes_under(func, is_unchecked_block):
+            if is_possibly_overflowing_op(node):
+                result.append(node)
+    return result
+
+
+def func_name(counter: int) -> str:
+    return f"op_{counter}"
+
+
+def char_at(filepath: str, offset: int) -> str:
+    with open(filepath, 'r') as f:
+        f.seek(offset)
+        return f.read(1)
+
+
+def instrumentations(filename: str, lib_name: str, op: dict, counter: int) -> dict[int, Instrumentation]:
+    start_offset, src_len, file = op["src"].split(":")
+    left = op["leftExpression"]
+    operator = op["operator"]
+    result: dict[int, Instrumentation] = {}
+
+    start_offset_left, src_len_left, _ = left["src"].split(":")
+    where = find_char(filename, int(start_offset_left) + int(src_len_left), operator)
+    if where is None:
+        raise Exception(f"Could not find {start_offset_left}:{src_len_left} in {filename}")
+    result[where] = Instrumentation(expected=bytes(operator, 'utf-8'),
+                                    to_ins=",",
+                                    mut=Replace(1))
+    before = int(start_offset_left)
+    result[before] = Instrumentation(expected=bytes(char_at(filename, before), 'utf-8'),
+                                     to_ins=f"{lib_name}.{func_name(counter)}(",
+                                     mut=InsertBefore())
+    after = int(start_offset) + int(src_len)
+    result[after] = Instrumentation(expected=bytes(char_at(filename, after), 'utf-8'),
+                                    to_ins=")",
+                                    mut=InsertBefore())
+    return result
+
+
+def generate_overflow_function(offset_converter: OffsetConverter, assembly_prefix: str, op: dict, counter: int) -> str:
+    res_type = op["typeDescriptions"]["typeString"]
+    function_head = f"function {func_name(counter)}({res_type} x, {res_type} y) internal pure returns ({res_type})"
+    start_offset, _, _ = op["src"].split(":")
+    _, left_length, _ = op["leftExpression"]["src"].split(":")
+    line, column = offset_converter.offset_to_line_column(int(start_offset) + int(left_length))
+    encoded = ("0xffffff6e4604afefe123321beef1b04fffffffffffffffffff"
+               f"{'%0.5x' % line}{'%0.5x' % column}{'%0.4x' % encode_type(res_type)}")
+    return f"""
+               {function_head} {{
+                 unchecked {{
+                   {res_type} z = x {op['operator']} y;
+                   {assembly_prefix} {{
+                     mstore({encoded}, z)
+                   }}
+                   return z;
+                 }}
+               }}
+           """
+
+
+def add_instrumentation(inst_dict: dict[int, Instrumentation], k: int, v: Instrumentation) -> None:
+    if k in inst_dict:
+        old = inst_dict[k]
+        if isinstance(old.mut, InsertBefore) and isinstance(v.mut, InsertBefore):
+            inst_dict[k] = Instrumentation(expected=old.expected, mut=InsertBefore(),
+                                           to_ins=old.to_ins + v.to_ins)
+        elif isinstance(old.mut, InsertAfter) and isinstance(v.mut, InsertAfter):
+            inst_dict[k] = Instrumentation(expected=old.expected, mut=InsertAfter(),
+                                           to_ins=old.to_ins + v.to_ins)
+        elif isinstance(old.mut, Replace) and isinstance(v.mut, InsertBefore):
+            inst_dict[k] = Instrumentation(expected=old.expected, mut=old.mut,
+                                           to_ins=v.to_ins + old.to_ins)
+        elif isinstance(old.mut, InsertBefore) and isinstance(v.mut, Replace):
+            inst_dict[k] = Instrumentation(expected=old.expected, mut=v.mut,
+                                           to_ins=old.to_ins + v.to_ins)
+        else:
+            print(f"GOT A PROBLEM at {k} ::::  {old}   {v}")
+            # should warn here.
+            inst_dict[k] = v
+    else:
+        inst_dict[k] = v
+
+
+def generate_overflow_instrumentation(asts: dict[str, dict[str, dict[int, Any]]], contract_file: str, sdc: SDC,
+                                      offset_converters: dict[str, OffsetConverter]) \
+        -> tuple[dict[str, dict[int, Instrumentation]], dict[str, tuple[str, list[str]]]]:
+    """
+    Generates the instrumentation for uncheckedOverflow builtin rule.
+    It replaces each of the possibly overflowing operations: `*, +, -`, with a function call to a new function
+    we add in a library in the same file. This function does the exact same operation, but adds an mload instruction
+    encoding the location of the operation and the expected resulting type.
+    """
+    overflow_instrumentation: dict[str, dict[int, Instrumentation]] = dict()
+    op_funcs: dict[str, tuple[str, list[str]]] = dict()
+    if not isinstance(sdc.compiler_collector, CompilerCollectorSol):
+        raise Exception(f"Encountered a compiler collector that is not solc for file {contract_file}"
+                        " when trying to add casting instrumentation")
+    assembly_prefix = sdc.compiler_collector.gen_memory_safe_assembly_prefix()
+    counter = 0
+
+    original_files = sorted({Util.convert_path_for_solc_import(c.original_file) for c in sdc.contracts})
+    for file_count, solfile in enumerate(original_files, start=1):
+        main_ast = asts[contract_file]
+        libname, per_file_funcs = op_funcs.setdefault(solfile, (f"CertoraOverflowLib{file_count}", []))
+        curr_file_ast = main_ast.get(solfile, dict())
+        per_file_inst = overflow_instrumentation.setdefault(solfile, dict())
+
+        for op in find_unchecked(curr_file_ast):
+            counter += 1
+            for k, v in instrumentations(contract_file, libname, op, counter).items():
+                add_instrumentation(per_file_inst, k, v)
+            new_func = generate_overflow_function(offset_converters[solfile], assembly_prefix, op, counter)
+            per_file_funcs.append(new_func)
+
+    return overflow_instrumentation, op_funcs

certora_cli/Shared/certoraValidateFuncs.py

@@ -92,6 +92,7 @@ class RunSources(Util.NoValEnum):
     BENCHMARK = auto()
     LIGHT_TEST = auto()
     REPORT = auto()
+    TIMEOUTER = auto()
 
 
 class WaitForResultOptions(Util.NoValEnum):
@@ -751,6 +752,36 @@ def validate_compiler_map(args: Dict[str, str]) -> None:
                                   "solc/vyper attribute can be used instead")
 
 
+def validate_vyper_custom_std_json_in_map(args: Dict[str, str]) -> None:
+    """
+    Checks that the argument is a dictionary of the form
+    <vy_file_1>=<stdjson_in_file_1>,<vy_file_2>=<stdjson_in_file_2>,...
+    and that all vyper files are valid: they were found
+
+    :param args: argument of --vyper_custom_std_json_in
+    :raises CertoraUserInputError if the format is wrong
+    """
+    if not isinstance(args, dict):
+        raise Util.CertoraUserInputError(f"vyper custom std json in should be stored as a map (type was {type(args).__name__})")
+
+    for source_file, json_file in args.items():
+        if not Util.is_vyper_file(source_file):
+            raise Util.CertoraUserInputError(f"{source_file} does not end with {Util.VY_EXT}")
+        source_file_path = Path(source_file)
+        if not source_file_path.exists():
+            raise Util.CertoraUserInputError(f"Source vyper file {source_file} does not exist")
+
+        if not Path(json_file).exists():
+            raise Util.CertoraUserInputError(f"Custom standard-json input file {json_file} does not exist")
+
+    values = args.values()
+    first = list(values)[0]
+
+    if all(x == first for x in values):
+        validation_logger.warning("All vyper files will be compiled with the same standard-json in. "
+                                  "Usually different standard-json in files are needed")
+
+
 def validate_git_hash(git_hash: str) -> str:
     """
     Validates that correct input was inserted as a git commit hash. It must be between 1 and 40 hexadecimal digits.

{certora_cli_beta_mirror-8.6.3.dist-info → certora_cli_beta_mirror-8.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: certora-cli-beta-mirror
-Version: 8.6.3
+Version: 8.8.0
 Summary: Runner for the Certora Prover
 Home-page: https://pypi.org/project/certora-cli-beta-mirror
 Author: Certora
@@ -38,4 +38,4 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-Commit c4459c1.                    Build and Run scripts for executing the Certora Prover on Solidity smart contracts.
+Commit 2cf089d.                    Build and Run scripts for executing the Certora Prover on Solidity smart contracts.

{certora_cli_beta_mirror-8.6.3.dist-info → certora_cli_beta_mirror-8.8.0.dist-info}/RECORD

@@ -12,9 +12,9 @@ certora_cli/certoraSorobanProver.py,sha256=SYJKz5Sw-N0bJrSa1njRCE53R9_PMz7IWLhfa
 certora_cli/certoraSuiProver.py,sha256=gRs-iihB35ZSEIQ5-hJN-wLgrHZlcfmpk76Wr6vza74,2827
 certora_cli/rustMutator.py,sha256=j1YdY5HOWQcRNbz7TOxp5c79J0YaaYHtWZ6m2mSTeGc,14865
 certora_cli/CertoraProver/__init__.py,sha256=QHNr-PJQAoyuPgTkO7gg23GRchiWSXglWNG7yLSQZvs,849
-certora_cli/CertoraProver/castingInstrumenter.py,sha256=4FDjQjnN9s8I3B9J-_G9rug9Jf3LnWnAuRngr50oTH4,7898
+certora_cli/CertoraProver/castingInstrumenter.py,sha256=maG3J0G2Bb8uT3_xA-AOo0gpBKmwhRJcEqvORD4JwNI,8412
 certora_cli/CertoraProver/certoraApp.py,sha256=7pkQnUYMzP9V-Yo0jszNV9Y9aB760Q6hMZtlcXuuRp8,1660
-certora_cli/CertoraProver/certoraBuild.py,sha256=h6lGjUyTcC0EnRCK1DXD26Qez4DEphpFjx_IoQRiuO8,231608
+certora_cli/CertoraProver/certoraBuild.py,sha256=eR35uOEWF3zw8O95-28gqnixgPMNzn6MBuE2-8VC3jU,236152
 certora_cli/CertoraProver/certoraBuildCacheManager.py,sha256=DnVd7w92xjmg0DIrMgoJnCvaU0yCz7ySy0M4RiHEXEM,13648
 certora_cli/CertoraProver/certoraBuildDataClasses.py,sha256=RGeoZCS4OztfbEUak0Oq02wIPgrmAOwLBad6-_XvX8c,14936
 certora_cli/CertoraProver/certoraBuildRust.py,sha256=ZPbNp4ttRmzcKhFsgHSiHDRExNPaLOzgxTRqu23o1D0,6061
@@ -25,27 +25,29 @@ certora_cli/CertoraProver/certoraCollectRunMetadata.py,sha256=wjP6m8W2rBka15vcj4
 certora_cli/CertoraProver/certoraCompilerParameters.py,sha256=v-MIt4sDJSQ7vpEFmCt9XBkKBhdBbZuZA4PWNErJwcU,1807
 certora_cli/CertoraProver/certoraConfigIO.py,sha256=-1EhJYsiheYvyCgOOWrRCQBjqtqNXrpMKJYRq5cKJ0Y,8171
 certora_cli/CertoraProver/certoraContext.py,sha256=ezdLmR-tSDLTtokhTyS9DacnB3W64Ke_6e714Vuug3c,29196
-certora_cli/CertoraProver/certoraContextAttributes.py,sha256=3NCjyNAkEI9ZVQD1BsNBoyHDeAYSbWWBN1gKkj-PqsA,73180
+certora_cli/CertoraProver/certoraContextAttributes.py,sha256=8dqlsKAwe3qcjnVLI2zRk4sIN-l5ICR3yFhzljVAAG8,75649
 certora_cli/CertoraProver/certoraContextClass.py,sha256=d7HDqM72K7YnswR7kEcAHGwkFNrTqRz5-_0m7cl2Mso,900
-certora_cli/CertoraProver/certoraContextValidator.py,sha256=II5xHZH5j2LIZ7XP08uybzAZ-HcW778qXcS7qhMAyv8,46901
-certora_cli/CertoraProver/certoraContractFuncs.py,sha256=IKe4xbDh0yFoYVCuLeAxnGg9h59rQCla3Qpy0GwS3HE,8236
+certora_cli/CertoraProver/certoraContextValidator.py,sha256=_dIga4q2r2_q4Nk9T9dolfHfRbeKpMpJRZx0KR0zdI0,47415
+certora_cli/CertoraProver/certoraContractFuncs.py,sha256=1CAA7Y9OEmdV-8Qlwk3SxEuOPBd15cd4T5lSv4NPYY8,8245
 certora_cli/CertoraProver/certoraExtensionInfo.py,sha256=YlShzdoqJQgXXj3r0TJ3fir1KntIR99Rk8JN5qii2lk,2026
 certora_cli/CertoraProver/certoraJobList.py,sha256=FBIYgJ60I0Ok7vchfTbcuJJbiXgnfAhrONoVeZoHti4,11464
 certora_cli/CertoraProver/certoraMiniSpecParser.py,sha256=NjjMwf5Rav3YWpoOJh4PZ-QOS8exC2cg4yIBSbZA6l0,9660
 certora_cli/CertoraProver/certoraNodeFilters.py,sha256=5Uk2mixZKeis_JVd3HkLgoEVklkAYBXAZiNHRlXOIfY,2830
+certora_cli/CertoraProver/certoraOffsetConverter.py,sha256=Z3ENmJQJpbBhb_Jyb9s-z27f4bV9ABzXrDweBySRWjs,2103
 certora_cli/CertoraProver/certoraParseBuildScript.py,sha256=l7KQA1poEjmbmuYbMskz0jOQg6cW0lM3vk5ruAGPjPI,4863
 certora_cli/CertoraProver/certoraProjectScanner.py,sha256=jT7FeWzcy8o83LrZRwsg_L4x6im6Fm_0LZFKVbKr3Jk,6862
-certora_cli/CertoraProver/certoraSourceFinders.py,sha256=qwJtwrQq3NUNYmdmn1UmANN4lmJFIUh4M-St2x1FJ2Y,19038
+certora_cli/CertoraProver/certoraSourceFinders.py,sha256=UwM4ROH-QML1mD0eF_dKRZysL__CxwM-6mxhRFsXCfg,19037
 certora_cli/CertoraProver/certoraType.py,sha256=inwaLkMVwtJnwkyQhDJs-wRxoyytu2Xa_BJ5MdGlZqY,29737
 certora_cli/CertoraProver/certoraVerifyGenerator.py,sha256=YMuzGj2RNOnADOx8UnV2ys1ptw_-2mermgC9ZLMWceo,11052
 certora_cli/CertoraProver/erc7201.py,sha256=BME5kBZsDx6lgqLn7EE91I1cEOZtsnZ8BlRVF62eEBE,1660
 certora_cli/CertoraProver/splitRules.py,sha256=dNhy05ShB_-rWYTnJH5m-Xc5A4HGStAvwLRs1BTu1GA,7627
 certora_cli/CertoraProver/storageExtension.py,sha256=nrCrbH8ne-yCYSDFzh3J9A7Q6h96WxhEfLbfxGSUCSc,14363
-certora_cli/CertoraProver/Compiler/CompilerCollector.py,sha256=cr-PIl7LY9VfNs4s4H3-EnSnomPiCgXudfwP9-KenMk,6740
+certora_cli/CertoraProver/uncheckedOverflowInstrumenter.py,sha256=0zgpQR0b08tdllI2kVwWMEIcsjer0b0L10FFEvTaKm0,7446
+certora_cli/CertoraProver/Compiler/CompilerCollector.py,sha256=JX-52BQgildY2WNlDW8yBM6o6ND4cN5Ih_1t4KTHuvc,6849
 certora_cli/CertoraProver/Compiler/CompilerCollectorFactory.py,sha256=drMPTUz9cabxqIu2ngGp0x1ZZ_Jqqn-Db2qql97PTaw,8544
 certora_cli/CertoraProver/Compiler/CompilerCollectorSol.py,sha256=7nAY2FLMUlGJn4f_YoZMqpa3rf7THqhJVjLwTaChcBc,5027
 certora_cli/CertoraProver/Compiler/CompilerCollectorSolBased.py,sha256=UasYWyu8Of6R84vXsqRNGpscYcFQghmSIY_dyaAWDYA,1350
-certora_cli/CertoraProver/Compiler/CompilerCollectorVy.py,sha256=kPzB_qbSbIFNmJd2cQ89ULwvgiGs7OdI9N_w9raaM4Y,69981
+certora_cli/CertoraProver/Compiler/CompilerCollectorVy.py,sha256=F7BoSVE8SzKh0uID6Vqs_osPRvKK1vqsxavmpalyVUo,72953
 certora_cli/CertoraProver/Compiler/CompilerCollectorYul.py,sha256=ZTyWIMtaf4gLPRM3_jjq58Gb0r5LE_giajz6sssIi0Y,5299
 certora_cli/CertoraProver/Compiler/__init__.py,sha256=tEFAmNyx9WL0kzpp_-4s7b6pLvxHmBWz6pQAq0yeROM,789
 certora_cli/EquivalenceCheck/Eq_default.conf,sha256=J-tMFzIuQa1NcklOh-wv2bpnikfAxFogpRFOl3qoSwM,164
@@ -67,15 +69,15 @@ certora_cli/Shared/__init__.py,sha256=s0dhvolFtsS4sRNzPVhC_rlw8mm194rCZ0WhOxInY4
 certora_cli/Shared/certoraAttrUtil.py,sha256=Nw8ban5Axp6c6dT-KJfCD9i9tKnGk1DbvRDDNH3--DU,8574
 certora_cli/Shared/certoraLogging.py,sha256=cV2UQMhQ5j8crGXgeq9CEamI-Lk4HgdiA3HCrP-kSR4,14013
 certora_cli/Shared/certoraUtils.py,sha256=WEvgDMqTeqC61Q0cW1inbTmGVEgFYawjq8H2vv26bmI,60574
-certora_cli/Shared/certoraValidateFuncs.py,sha256=gCM-YP0Tpngpasd2AWxhu90UNz1wtls3WqJYp18n_Q8,43503
+certora_cli/Shared/certoraValidateFuncs.py,sha256=7m1cZVVeN1UaGdPtvjxDJBlDQF0Oq3gIkSexQsHKxuU,44893
 certora_cli/Shared/proverCommon.py,sha256=DUB-uEKjOkZ-8qil6xukPqfTynpigXW-gcrm0_kRUZY,11383
-certora_jars/ASTExtraction.jar,sha256=WW6yieuw0g2v_obN8ta_UNCo-s36aXSTalGrNlVcVlk,22010491
-certora_jars/CERTORA-CLI-VERSION-METADATA.json,sha256=X52jjlrZ6HZa4glSelbBDKPXahSrm2zQLw8TGtVuCHU,144
-certora_jars/Typechecker.jar,sha256=kCONcIoiI34Pn0MQn_cBI4Jvpxm41o0gi7syqLDWVok,21972603
+certora_jars/ASTExtraction.jar,sha256=1VB1tRT5q5cgcN1fdnvMQVd5a0zhOhylkw118hU-wSI,22249062
+certora_jars/CERTORA-CLI-VERSION-METADATA.json,sha256=SdNMLPejAMnUasABM6lQEHAmlDxuPLmhvR10Wvu-liQ,144
+certora_jars/Typechecker.jar,sha256=PWub0uzszl8cMKGX7ymSNUUB30v85sBsrCf7BCdKIxA,22211174
 certora_jars/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-certora_cli_beta_mirror-8.6.3.dist-info/LICENSE,sha256=UGKSKIJSetF8m906JLKqNLkUS2CL60XfQdNvxBvpQXo,620
-certora_cli_beta_mirror-8.6.3.dist-info/METADATA,sha256=j_4UsqDWfNyvCbiTBjK_gU_OWAuWPpVkAxxmSy-1d28,1254
-certora_cli_beta_mirror-8.6.3.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
-certora_cli_beta_mirror-8.6.3.dist-info/entry_points.txt,sha256=YXGQmR4tGdYD9lLdG_TEJkmVNrRauCtCDE88HwvO2Jo,569
-certora_cli_beta_mirror-8.6.3.dist-info/top_level.txt,sha256=8C77w3JLanY0-NW45vpJsjRssyCqVP-qmPiN9FjWiX4,38
-certora_cli_beta_mirror-8.6.3.dist-info/RECORD,,
+certora_cli_beta_mirror-8.8.0.dist-info/LICENSE,sha256=UGKSKIJSetF8m906JLKqNLkUS2CL60XfQdNvxBvpQXo,620
+certora_cli_beta_mirror-8.8.0.dist-info/METADATA,sha256=dWNDZeGK0fCa2IM6ueE6dtYNpX41e52L3lP-ugQir7Q,1254
+certora_cli_beta_mirror-8.8.0.dist-info/WHEEL,sha256=jB7zZ3N9hIM9adW7qlTAyycLYW9npaWKLRzaoVcLKcM,91
+certora_cli_beta_mirror-8.8.0.dist-info/entry_points.txt,sha256=YXGQmR4tGdYD9lLdG_TEJkmVNrRauCtCDE88HwvO2Jo,569
+certora_cli_beta_mirror-8.8.0.dist-info/top_level.txt,sha256=8C77w3JLanY0-NW45vpJsjRssyCqVP-qmPiN9FjWiX4,38
+certora_cli_beta_mirror-8.8.0.dist-info/RECORD,,

certora_jars/CERTORA-CLI-VERSION-METADATA.json

@@ -1 +1 @@
-{"name": "certora-cli-beta-mirror", "tag": "8.6.3", "branch": "", "commit": "c4459c1", "timestamp": "20251218.13.53.990761", "version": "8.6.3"}
+{"name": "certora-cli-beta-mirror", "tag": "8.8.0", "branch": "", "commit": "2cf089d", "timestamp": "20260202.13.36.178104", "version": "8.8.0"}