Repository navigation
Releases
Releases · heyethan/macattacc
macattacc 0.2.1
0.2.1 - 2026-11-09
Changed
- Obfuscation no longer ships the raw XOR key next to the ciphertext. Each literal's key is
derived at runtime asSHA256(seed || salt || counter)(counter mode) from a per-build master
seed (emitted per call site in masked form) and a per-call-site salt. The expansion stores
cipher + salt + masked seed + mask — no full-length key adjacent to the cipher. Same honest
ceiling: a debugger/dump still recovers the value. - One hardened code-signature validation path (strict + all-architectures + nested-code, optional
requirement / Team ID) is now shared by the library self-check and the CLIshield check, which
previously used the weaker bareSecCSFlags().checkgains a--requirementoption. Heuristics.matchesInstrumentationThreadis token-anchored like the image matcher, sogmain
no longer matchesdiagmaintenance. Still report-only / high-FP.shield verifyreports a missingnm/otool/sizetool clearly, and PASSes on a local-symbol
count at/below a small threshold instead of requiring strict zero (a stripped binary can retain
a stray local). The reflection-metadata size report is unchanged.
Added
shield harden --write-project(opt-in): wiresShield.xcconfiginto the single.xcodeproj's
app-target Release config via a conservative, non-destructive.pbxprojedit — timestamped
backup first, refuses on anything ambiguous (not exactly one app target, already configured),
never touches other targets. Default behaviour (print instructions) is unchanged.
Docs
PRIOR-ART.md: the commit-order claim is replaced with a dated (2026-11-08) clean-room
attestation that does not depend on visible commit order.
macattacc 0.2.0
0.2.0 - 2026-11-09
Added
MacattaccObfuscation: a compile-time string-literal obfuscator, a separate library product so
it can be adopted without the runtime detectors. The freestanding macro#obfuscated("literal")
XOR-encodes the literal at build time against a per-literal random key, so the plaintext is absent
from the expansion and the binary's__TEXTstring table, and identical strings differ across
call sites. Backed by a SwiftSyntax.macrotarget (MacattaccObfuscationMacros).- Tests: macro-expansion (no plaintext in the expansion), runtime round-trip (empty, unicode, long),
and a strings-absence check that a sentinel routed through#obfuscatedis absent from the
compiled test binary.
Notes
- Honest ceiling: obfuscation defeats naive
strings/static scraping and raises the static-recovery
bar, but a debugger or runtime memory dump still recovers the decrypted value — one layer, not a
wall. IR-level obfuscation is not bundled: Obscura is PolyForm Noncommercial, so it cannot ship in
this MIT repo or run on commercial apps; it stays a non-commercial-only option. - Integrity is handled by macOS code signing (the signature self-check +
shield verify), not a
hand-rolled Mach-O hash baseline.
macattacc 0.1.0
Initial release: runtime tamper/debug/instrumentation detection library (MacOSShield), build-hardening presets + xcconfig, and the shield CLI (check, doctor, harden, verify). Report-only by default. See README for honest limits.