#!/usr/bin/env python3 """Read-only Invisible gadget source guards and bounded branch projections. These projections are independently transcribed static contracts, not execution of original code or a replacement for the port's runtime checks. """ from __future__ import annotations import argparse from dataclasses import dataclass, replace import hashlib import json import math from pathlib import Path import struct from checkpoint_script_state import EXE_SHA256, find_case, read_va from pe_inspect import PE BODIES = ( ('invisible_tick', 0x424E80, 0x425114, 'b52f6f643c786206fa5a4089d58b311417439a203e0914a8a0243e319c52ebb3'), ('invisible_equip', 0x428E51, 0x428F61, '9abaa12fb4625248564818695c6a7e6d27fccf15216c670e5321a3742aa99bc2'), ('invisible_cleanup', 0x42810C, 0x4281B3, '92e9ffe9516cca33159b05d3509dc0e34d839e6c8d3deb7e1cd08adbfbfc2851'), ('material_alpha', 0x40E4A0, 0x40E5D9, '741d94d5cf14efd99e5380239d7a1b4be7e7fb5f478590604e8bd76b8e5d1ead'), ('indexed_blend', 0x40DD40, 0x40DD5D, 'b14a27765254aba1bb2e420019648ee0f05573567c1d1f79c6d8ab09cc59fdc5'), ('meter', 0x4036C0, 0x40385B, '46f35e6db8030b96cd6a0bddaf59cf37d36b41f6b568143856db2184b360ca8b'), ('enemy_target_flag', 0x409CC0, 0x409CF7, 'cf6e1c52f5801412ab7012465fd41d0278ddb9aef62002535c829f6e03af9252'), ) SITES = ( ('tick_after_movement', 0x424C31, 20), ('tick_control_pointer_not_identity', 0x424E80, 30), ('tick_mode_two', 0x424E9E, 12), ('tick_show_meter', 0x424EB4, 6), ('primary_then_not_jump', 0x424EBA, 26), ('primary_suppressor_returns', 0x424ED4, 13), ('activation_remaining_exact_zero', 0x424EE1, 19), ('activation_recharge_exact_seven_bits', 0x424EF4, 12), ('activation_energy_strict_two_or_override', 0x424F00, 33), ('activation_fixed_cost_minus_two', 0x424F21, 10), ('activation_duration_seven', 0x424F32, 10), ('activation_blend_source6_dest1', 0x424F3C, 12), ('activation_material_alpha_point7', 0x424F48, 15), ('activation_target_flag_false', 0x424F57, 7), ('activation_recharge_zero', 0x424F5E, 10), ('recharge_only_remaining_zero', 0x424F68, 23), ('recharge_energy_positive_or_override', 0x424F7F, 29), ('recharge_store_before_meter', 0x424F9C, 54), ('recharge_seven_clamp_white', 0x424FD2, 47), ('active_strict_positive_before_decrement', 0x425001, 23), ('active_decrement_before_meter', 0x425018, 28), ('active_expiry_less_or_equal_zero', 0x425064, 19), ('expiry_material_reset', 0x425077, 38), ('expiry_target_true_red_meter', 0x42509D, 25), ('flash_last_three', 0x4250BA, 19), ('flash_trunc_remaining_times_five', 0x4250CD, 19), ('flash_odd_dest7_even_dest1', 0x4250EA, 38), ('equip_energy_positive_or_override', 0x428E51, 40), ('equip_mode_two_timers_target_flag', 0x428EB4, 36), ('equip_display_before_branch', 0x428D95, 9), ('cleanup_target_flag_true_recharge_zero', 0x428125, 21), ('cleanup_companion_skip_flag', 0x428144, 20), ('cleanup_material_opaque_mode_minus_one', 0x428194, 31), ('constructor_timer_zero', 0x4227BE, 15), ('constructor_override_false', 0x437650, 6), ('postload_override_false', 0x4236C0, 7), ('postload_vr_range_override_true', 0x423E44, 45), ('enemy_chase_target_flag', 0x40847C, 34), ('enemy_acquire_target_flag', 0x40877A, 28), ('enemy_lost_target_flag', 0x4087F6, 51), ('cam_optional_cleanup_flag', 0x4165B7, 43), ('mca_optional_cleanup_flag', 0x43129A, 56), ('jimmy438_cleanup', 0x42AE08, 18), ('cam_interface_complete_plus_c8', 0x415A60, 6), ('cam_property_default_one_register', 0x415C09, 5), ('cam_property_default_one_store', 0x415CD5, 6), ('cam_deactivateinv_property', 0x415F70, 26), ('mca_interface_complete_plus_c8', 0x430930, 6), ('mca_property_default_one', 0x430AA0, 10), ('mca_deactivateinv_property', 0x430D7E, 26), ) VTABLES = ( (0x4A3BDC, 0x1C8, 0x424E80), (0x4A3BDC, 0x178, 0x427FF0), (0x4A3BDC, 0xFC, 0x40DD40), (0x4A3BDC, 0x114, 0x40E4A0), (0x48D414, 0x484, 0x4036C0), (0x48D414, 0x488, 0x403700), (0x48D414, 0x48C, 0x403730), (0x48D414, 0x490, 0x4037A0), ) CONSTANTS = ((0x48D914, 0.0), (0x48D954, 2.0), (0x48D950, 5.0), (0x48E5A0, 3.0), (0x48E5B8, 7.0), (0x4A3E30, 1/7)) def collect(original: Path | str): pe = PE(find_case(Path(original), 'Neutron.exe')) digest = hashlib.sha256(pe.data).hexdigest() if digest != EXE_SHA256: raise ValueError('Unexpected original EXE identity') bodies = [] for name, start, end, expected in BODIES: actual = hashlib.sha256(read_va(pe, start, end-start)).hexdigest() if actual != expected: raise ValueError(f'Changed original span {name}') bodies.append(dict(name=name, va=hex(start), file_offset=hex(pe.offset(start-pe.base)), length=end-start, sha256=actual)) sites = [dict(name=name, va=hex(va), file_offset=hex(pe.offset(va-pe.base)), bytes=read_va(pe, va, length).hex()) for name, va, length in SITES] tables = [] for base, slot, expected in VTABLES: actual = struct.unpack(' 1e-7: raise ValueError('Changed original float constant') constants.append(dict(va=hex(va), file_offset=hex(pe.offset(va-pe.base)), value=actual)) if read_va(pe, 0x4EDF10, 14) != b'DeactivateInv\0': raise ValueError('Changed cleanup property identity') return dict(sha256=digest, bodies=bodies, sites=sites, vtables=tables, constants=constants) def f32(value): return struct.unpack(' 0 or override): recharge = f32(state.recharge+seconds) state = replace(state, recharge=min(recharge, 7), meter_red=False if recharge >= 7 else state.meter_red) if state.remaining > 0: remaining = f32(state.remaining-seconds) if remaining <= 0: return replace(state, remaining=0, alpha=1, blend='opaque', targetable=True, meter_red=True), delta blend = state.blend if remaining <= 3: blend = 'alpha' if int(remaining*5) % 2 else 'additive' state = replace(state, remaining=remaining, blend=blend) return state, delta if __name__ == '__main__': cli = argparse.ArgumentParser(description=__doc__) cli.add_argument('original', type=Path) print(json.dumps(collect(cli.parse_args().original), indent=2))