TL;DR: Erosion-CN is a Swift-based system configuration and MobileGestalt research utility for iOS and iPadOS. It replaces unsafe system modification scripts by using atomic writes with F_FULLFSYNC, dynamic runtime offset calculation, and dual SHA-256 backups to prevent white-apple bootloops.
Best for: iOS developers and advanced security researchers modifying local system configurations.
Repository snapshot: ⭐ 2 678 stars · 🍴 464 forks · Swift · GPL-3.0
Daily picks: Follow GitHub Open Source on Telegram

What it is

Erosion-CN is a Swift-based utility designed for iOS and iPadOS system configuration and MobileGestalt research. It provides a safer alternative to traditional system modification scripts, specifically targeting the ability to bypass regional restrictions on iOS 27. The project focuses on preventing the dreaded 'white-apple' bootloop by implementing atomic write operations and robust backup mechanisms.

How it works

Unlike legacy tools that rely on potentially destructive file overwrites, Erosion-CN utilizes pwrite combined with F_FULLFSYNC to ensure atomic operations. It dynamically calculates runtime offsets from libMobileGestalt.dylib rather than relying on hardcoded addresses, which makes it more resilient to minor system updates. The tool operates within a sandboxed application container, requiring deployment via AltStore or SideStore.

Key features

  • Atomic Operations: Uses F_FULLFSYNC to ensure data integrity during plist and MobileGestalt overwrites.
  • Dynamic Offsets: Calculates addresses at runtime, reducing the need for constant hardcoded updates.
  • Safety Vaults: Maintains dual SHA-256 backups (sandbox and system) for one-click recovery.
  • Web Interface: Exposes a dark-mode WebUI via NWListener with PIN authentication, allowing configuration management over Wi-Fi.
  • APFS Management: Handles zero-space APFS clonefile staging for safer file manipulation.

Getting started

  1. Ensure your device is running a supported iOS 27 version.
  2. Download the latest .ipa release from the repository.
  3. Deploy the application using AltStore or SideStore.
  4. Launch the app and connect to the provided local URL via your browser to access the configuration dashboard.

When not to use it

This tool is intended for research and advanced configuration. Do not use it if you are not comfortable with the risks associated with modifying system plists. Furthermore, this utility will become obsolete if Apple patches the underlying sandbox escape paths, rendering the tool unable to access the necessary system files.

Discuss

Which iOS version are you currently using for your device testing?

Curated from the repository README and metadata. No hands-on test is claimed; evaluate it in a sandbox before production use.