🛡️ BLA (Blind LLM Agents) — Adversarial defense shield that protects binaries, Electron apps, JS bundles, Python, and WebAssembly against AI reverse-engineering agents like REA. Poison -> Exhaust -> Hallucinate.
JavaScript adversarial-aiclaude-codecursorelectron-securityllm-securitymcpmcp-serverobfuscationreverse-engineeringwebassembly
docs(readme): improve Indonesian README translation
AldySan91035a958831
diff --git a/docs/readme/README_id.md b/docs/readme/README_id.mdindex 412cc83..b05ba5d 100644--- a/docs/readme/README_id.md+++ b/docs/readme/README_id.md@@ -1,12 +1,12 @@-<div align="center">+ <div align="center">[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · **Bahasa Indonesia** · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)# BLA: Blind LLM Agents-### Satu MCP untuk melindungi biner, aplikasi, dan perilaku runtime dari rekayasa balik AI.+### Satu MCP untuk melindungi biner, aplikasi, dan perilaku saat runtime dari rekayasa balik oleh AI.-**Rilis fitur yang Anda bangun. Butakan agen AI yang mencoba mengkloningnya hingga ke level biner.**+**Rilis fitur yang Anda bangun. Buat agen AI yang mencoba mengkloningnya kewalahan hingga ke tingkat biner.**[](https://www.npmjs.com/package/bla-agents)[](../cli-and-mcp.md)@@ -14,80 +14,82 @@[](#showcases)[](../../LICENSE)-[Mulai cepat](#quick-start) · [Cara kerja BLA](#how-bla-works) · [Apa yang dapat Anda lindungi](#what-you-can-protect) · [Showcase & Benchmark](#showcases) · [FAQ](#faq) · [Dokumentasi](#documentation)+[Mulai Cepat](#quick-start) · [Cara Kerja BLA](#how-bla-works) · [Apa Saja yang Dapat Dilindungi](#what-you-can-protect) · [Demo & Tolok Ukur](#showcases) · [FAQ](#faq) · [Dokumentasi](#documentation)-<code>npx bla-agents setup</code> · <code>npx bla-agents defend ./dist --manifest</code>+`npx bla-agents setup` · `npx bla-agents defend ./dist --manifest`</div>> [!IMPORTANT]-> Get BLA from [qybaihe/bla](https://github.com/qybaihe/bla) or the [bla-agents npm package](https://www.npmjs.com/package/bla-agents).+> Dapatkan BLA melalui [qybaihe/bla](https://github.com/qybaihe/bla) atau paket npm [bla-agents](https://www.npmjs.com/package/bla-agents).<div align="center"><br />--<img src="../assets/bla-vs-rea-showcase.svg" alt="Before BLA vs After npx bla-agents protect" width="1200" />-+<img src="../assets/bla-vs-rea-showcase.svg" alt="Perbandingan sebelum BLA dan sesudah perlindungan BLA" width="1200" /><br /></div>----Khawatir seseorang menggunakan REA untuk mengkloning aplikasi Anda dalam hitungan detik? Minta agen Anda melindunginya dengan BLA (`Poison → Exhaust → Hallucinate`).+Khawatir seseorang menggunakan REA untuk mengkloning aplikasi Anda hanya dalam hitungan detik? Minta agen AI Anda melindunginya menggunakan BLA (`Poison → Exhaust → Hallucinate`).-BLA menghubungkan agen Anda ke alat pelindung biner asli, aplikasi JavaScript & Electron, WebAssembly, bytecode Python, database SQLite, dan model AI secara lokal dengan mempertahankan 100% perilaku runtime.+BLA menghubungkan agen AI Anda dengan berbagai alat perlindungan untuk biner asli, aplikasi JavaScript & Electron, WebAssembly, bytecode Python, basis data SQLite, dan model AI. Semua proses berjalan secara lokal dengan tetap mempertahankan 100% perilaku aplikasi saat runtime.<a id="quick-start"></a>+## Mulai Cepat-## Mulai cepat--### Siapkan agen Anda+### Siapkan Agen AI Anda```bashnpx bla-agents setup```-### Minta agen Anda+### Berikan Instruksi kepada Agen AI Anda++- **1. Audit (Pemeriksaan Awal REA):**-- **1. Audit (`Pre-flight REA Audit`):**```text- Audit my ./dist directory against REA, show me every exposed module and IPC channel, and estimate how much it would cost Claude to reconstruct it.+ Audit direktori ./dist saya terhadap ancaman REA, tampilkan setiap modul dan kanal IPC yang terekspos, lalu perkirakan biaya yang diperlukan Claude untuk merekonstruksinya.```-- **2. Protect (`Poison + Exhaust + Hallucinate`):**++- **2. Lindungi (Poison + Exhaust + Hallucinate):**+```text- Protect ./dist/app.asar with BLA at bankrupt intensity, inject enclave chaff and algorithmic tarpits, and output to ./dist/app.shielded.asar.+ Lindungi ./dist/app.asar menggunakan BLA dengan tingkat intensitas bankrupt, sisipkan umpan enclave dan jebakan algoritmik, lalu simpan hasilnya sebagai ./dist/app.shielded.asar.```-- **3. Verify (`Verify Defense & Token Burn`):**++- **3. Verifikasi (Pemeriksaan Pertahanan & Penggunaan Token):**+```text- Verify ./dist/app.shielded.asar against the original ./dist/app.asar and confirm that REA's examination degrades to limited status.+ Verifikasi ./dist/app.shielded.asar terhadap berkas asli ./dist/app.asar dan pastikan proses analisis REA mengalami penurunan kemampuan hingga status terbatas.```-### Gunakan terminal+### Gunakan melalui Terminal```bash-# 1. Audit exposure+# 1. Periksa bagian yang tereksposnpx -y bla-agents@latest audit /absolute/path/to/app --json-# 2. Protect artifact+# 2. Lindungi artefak aplikasinpx -y bla-agents@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt-# 3. Verify Counter-REA resistance+# 3. Verifikasi ketahanan terhadap Counter-REAnpx -y bla-agents@latest verify /absolute/path/to/app.shielded /absolute/path/to/app-# 4. Run 8-target Counter-REA benchmark+# 4. Jalankan pengujian Counter-REA terhadap 8 targetnpx -y bla-agents@latest benchmark-# 5. Emit compile-time C/C++, Rust, or Go defense headers+# 5. Hasilkan header pertahanan C/C++, Rust, atau Go saat kompilasinpx -y bla-agents@latest emit-headers --lang c -o ./include/bla_shield.h-# Install globally+# Instal secara globalnpm install --global bla-agentsbla --help```-### Gunakan di bundler Anda+### Gunakan pada Bundler Anda```typescriptimport { defineConfig } from "vite";@@ -106,82 +108,81 @@ npx bla-agents@latest setup```<a id="how-bla-works"></a>+## Cara Kerja BLA-## Cara kerja BLA+1. **Poison (Umpan Arsitektur & Aset Pancingan):** Menyisipkan manifest delegasi perangkat keras enclave (`SGX` / `TPM2` / `Secure Enclave`), Honey Source Maps VLQ v3 (`enclave://tee-runtime/`), bagian `"name"` palsu pada WASM, serta tabel pancingan pada SQLite.-1. **Poison (`Architectural Chaff & Honey Assets`):** Embeds hardware enclave delegation manifests (`SGX` / `TPM2` / `Secure Enclave`), VLQ v3 Honey Source Maps (`enclave://tee-runtime/`), honey WASM `"name"` sections, and honey SQLite tables.-2. **Exhaust (`Semantic Budget Breakers & Algorithmic Tarpits`):** Trips `REA`'s internal analyzer limits (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) and weaves 14–36 Fake XRef state machines.-3. **Hallucinate (`Anti-CDP Runtime Deception & Fuse Hardening`):** Hardens Electron V1 fuse wires (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) and serves synthetic enclave telemetry to CDP/Inspector/Frida probes.+2. **Exhaust (Penguras Anggaran Analisis & Jebakan Algoritmik):** Memicu batas sumber daya internal REA (`primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512`, `primitive-bytes > 1 MiB`, `maximum_rustc_hashes > 64`, `maximumSentinelsPerSlice > 32`) serta menyisipkan 14–36 mesin status Fake XRef.-<a id="what-you-can-protect"></a>+3. **Hallucinate (Penyesatan Runtime Anti-CDP & Penguatan Fuse):** Memperkuat kabel fuse Electron V1 (`RunAsNode=0`, `EnableNodeCliInspectArguments=0`) dan menyajikan telemetri enclave sintetis untuk probe CDP/Inspector/Frida.-## Apa yang dapat Anda lindungi+<a id="what-you-can-protect"></a>+## Apa Saja yang Dapat Dilindungi-| Target | What BLA injects & how REA fails | Command / prompt & requirements |+| Target | Apa yang Disisipkan BLA & Bagaimana REA Terhambat | Perintah / Persyaratan || ----------------------- | ------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |-| JavaScript / TypeScript | Trips `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 tarpits | `bla protect app.js` · Built-in Babel AST engine |-| Electron `.asar` apps | De-literalizes IPC channels (`channel: null`), adds duplicate decoy IPC handlers & shadow module | `bla protect app.asar` · Built-in Chromium Pickle `.asar` unpacker & SHA-256 repacker |-| Electron binary fuses | Hardens real V1 fuses (`RunAsNode=0`, `Inspect=0`) + injects `34 > 32` decoy fuse sentinels | `bla protect ElectronApp` · Trips `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |-| Native / Rust / Go | Injects `68 > 64` `/rustc/<40-hex>/` paths, decoy `.dep-v0` crate graph & Go `dep\t` lines | `bla protect daemon.elf` · Built-in ELF64, Mach-O, and PE/COFF shield |-| Flutter / Dart AOT | Injects `66 > 64` Dart snapshot headers (`0xf5f5dcdc`) + `6 > 4` LLVM toolchain lines | `bla protect libapp.so` · Trips `SnapshotHashScanner (capped: true)` |-| WASM artifacts | Strips debug sections; injects honey `"name"` section (`tee_hardware_enclave_stub`) + custom chaff | `bla protect core.wasm` · Built-in LEB128 binary parser; 100% `WebAssembly.validate` |-| Python & `.pyc` | Injects Python tarpit state machines into `.py` & `TYPE_ASCII` marshal chaff into `.pyc` pools | `bla protect module.pyc` · Built-in CPython 3.7–3.14 `.pyc` marshal shield |-| SQLite databases | Injects 3 enclave honey tables with `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` traps | `bla protect data.sqlite` · Trips `SqliteColumnEvaluationFailure` on REA preview |-| Model artifacts | Injects `35 > 32` nested JSON/ARRAY headers into `.safetensors` and `.gguf` model headers | `bla protect weights.safetensors` · Trips `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |-| Android DEX & IL2CPP | Injects `Lcom/enclave/sgx/...` decoy classes into `classes.dex` (valid SHA-1/Adler32) & `Il2Cpp` | `bla protect classes.dex` or `global-metadata.dat` · Pollutes JADX/JEB & IL2CPP recovery |+| JavaScript / TypeScript | Memicu batas `primitive-candidates > 256`, `alias-selections > 512`, `getter-expansion > 512` + 36 jebakan algoritmik | `bla protect app.js` · Mesin Babel AST bawaan |+| Aplikasi Electron `.asar` | Menghilangkan literal kanal IPC (`channel: null`), menambahkan handler IPC umpan duplikat dan modul bayangan | `bla protect app.asar` · Pembongkar `.asar` Chromium Pickle dan pengemas ulang SHA-256 bawaan |+| Electron Binary Fuses | Memperkuat fuse V1 asli (`RunAsNode=0`, `Inspect=0`) + menyisipkan `34 > 32` sentinel fuse umpan | `bla protect ElectronApp` · Memicu `ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32)` |+| Native / Rust / Go | Menyisipkan `68 > 64` jalur `/rustc/<40-hex>/`, graf crate `.dep-v0` umpan, dan baris `dep\t` Go palsu | `bla protect daemon.elf` · Perlindungan ELF64, Mach-O, dan PE/COFF bawaan |+| Flutter / Dart AOT | Menyisipkan 66 header snapshot Dart (`0xf5f5dcdc`) + 6 baris toolchain LLVM, melampaui batas 4 baris | `bla protect libapp.so` · Memicu `SnapshotHashScanner (capped: true)` |+| Artefak WASM | Menghapus bagian debug; menyisipkan bagian `"name"` umpan (`tee_hardware_enclave_stub`) + data pengalih khusus | `bla protect core.wasm` · Parser biner LEB128 bawaan; validasi `WebAssembly.validate` tetap 100% |+| Python & `.pyc` | Menyisipkan mesin status jebakan Python ke `.py` dan data pengalih marshal `TYPE_ASCII` ke kumpulan `.pyc` | `bla protect module.pyc` · Perlindungan marshal `.pyc` CPython 3.7–3.14 bawaan |+| Basis Data SQLite | Menyisipkan 3 tabel enclave umpan dengan jebakan `GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL` | `bla protect data.sqlite` · Memicu `SqliteColumnEvaluationFailure` saat pratinjau REA |+| Artefak Model AI | Menyisipkan `35 > 32` header JSON/ARRAY bertingkat ke header model `.safetensors` dan `.gguf` | `bla protect weights.safetensors` · Memicu `ModelFormatFailure (json-nesting / metadata-nesting > 32)` |+| Android DEX & IL2CPP | Menyisipkan kelas umpan `Lcom/enclave/sgx/...` ke `classes.dex` (SHA-1/Adler32 tetap valid) dan `Il2Cpp` | `bla protect classes.dex` atau `global-metadata.dat` · Mengacaukan proses pemulihan JADX/JEB & IL2CPP |<a id="showcases"></a>+## Demo & Tolok Ukur-## Showcase & Benchmark--| Showcase Target | Before BLA (REA Alone) | After `npx bla-agents protect` | Token Burn | Runtime Check |+| Target Pengujian | Sebelum BLA (REA Saja) | Setelah `npx bla-agents protect` | Penggunaan Token | Pemeriksaan Runtime || :--- | :--- | :--- | :---: | :---: |-| **1. DX-Ball Sound-Pan Calculation** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |-| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Exact |-| **3. Enterprise Offline License Validator** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Exact |-| **4. WebAssembly Crypto Kernel** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |-| **5. Native ELF64 Binary** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Exact |-| **6. Local SQLite Entitlement Database** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Exact |-| **7. Proprietary Edge AI Weights** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Exact |-| **8. Android Dalvik Bytecode** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Exact |+| **1. Perhitungan Sound-Pan DX-Ball** (`.js`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,068` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Akurat |+| **2. Notion Electron Clipboard Bridge** (`.asar`) | `98/100` · `9,132` tok · **`$0.34`** (`COMPLETE`) | `2/100` · `23,125,000` tok · **`$358.28`** (`LIMITED`) | **2,532.3x** | ✅ 100% Akurat |+| **3. Validator Lisensi Offline Perusahaan** (`.ts`) | `84/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `2/100` · `10,182,169` tok · **`$160.64`** (`LIMITED`) | **2,121.3x** | ✅ 100% Akurat |+| **4. Kernel Kriptografi WebAssembly** (`.wasm`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,067` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Akurat |+| **5. Biner Native ELF64** (Rust / Go / Fuse / Dart) | `81/100` · `9,278` tok · **`$0.35`** (`COMPLETE`) | `2/100` · `3,698,135` tok · **`$59.72`** (`LIMITED`) | **398.6x** | ✅ 100% Akurat |+| **6. Basis Data Hak Akses SQLite Lokal** (`.sqlite`) | `81/100` · `10,568` tok · **`$0.29`** (`COMPLETE`) | `7/100` · `1,711,235` tok · **`$28.36`** (`LIMITED`) | **161.9x** | ✅ 100% Akurat |+| **7. Bobot Model AI Edge Proprietary** (`.safetensors`) | `81/100` · `4,800` tok · **`$0.20`** (`COMPLETE`) | `6/100` · `1,807,073` tok · **`$29.88`** (`LIMITED`) | **376.5x** | ✅ 100% Akurat |+| **8. Bytecode Android Dalvik** (`classes.dex`) | `81/100` · `8,900` tok · **`$0.34`** (`COMPLETE`) | `7/100` · `2,786,285` tok · **`$45.09`** (`LIMITED`) | **313.1x** | ✅ 100% Akurat |<a id="faq"></a>--## FAQ+## FAQ (Pertanyaan Umum)<details>-<summary><strong>Which agents can use BLA?</strong></summary>+<summary><strong>Agen AI apa saja yang dapat menggunakan BLA?</strong></summary>++Semua agen AI yang mendukung server MCP lokal atau alur kerja `SKILL.md`, seperti Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, dan GitHub Copilot CLI.-Any agent that supports local MCP servers or `SKILL.md` workflows (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, and GitHub Copilot CLI). Run `npx bla-agents setup`.+Jalankan `npx bla-agents setup` untuk melakukan konfigurasi.</details><details>-<summary><strong>Does BLA slow down my app or change its runtime output?</strong></summary>+<summary><strong>Apakah BLA memperlambat aplikasi atau mengubah hasil saat runtime?</strong></summary>-No. All semantic budget breakers and tarpits are guarded by $O(1)$ number-theoretic opaque predicates ($7x^2 - 1 \neq y^2 \pmod 7$) and preserve 100% input/output equivalence.+Tidak. Semua mekanisme penguras anggaran semantik dan jebakan algoritmik dilindungi oleh predikat opaque teori bilangan berkompleksitas $O(1)$ (`7x^2 - 1 \neq y^2 \pmod 7`) sehingga kesetaraan input/output tetap terjaga 100%.</details><details>-<summary><strong>Do I need Hopper, Ghidra, IDA, or WABT installed?</strong></summary>+<summary><strong>Apakah saya harus memasang Hopper, Ghidra, IDA, atau WABT terlebih dahulu?</strong></summary>-No. All 19 format shields are built directly into `bla-agents` with zero external dependencies.+Tidak. Seluruh 19 perlindungan format sudah tersedia langsung di dalam `bla-agents` tanpa memerlukan dependensi eksternal.</details><details>-<summary><strong>Does BLA upload my source code or binaries anywhere?</strong></summary>+<summary><strong>Apakah BLA mengunggah kode sumber atau biner saya ke suatu tempat?</strong></summary>-Never. All operations run 100% locally on your machine.+Tidak pernah. Seluruh operasi berjalan 100% secara lokal di perangkat Anda. Tidak ada kode sumber maupun biner yang diunggah ke server eksternal.</details><a id="documentation"></a>-## Dokumentasi-- [Installation and agent setup](../installation.md)-- [CLI and MCP contracts](../cli-and-mcp.md)-- [Counter-REA technical defense matrix](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)-- [Disclaimer](../../DISCLAIMER.md) · [MIT License](../../LICENSE)+- [Panduan Instalasi dan Konfigurasi Agen](../installation.md)+- [Referensi CLI dan MCP](../cli-and-mcp.md)+- [Matriks Pertahanan Teknis Counter-REA](../../.agents/skills/blind-llm-agents/references/counter-rea-matrix.md)+- [Pernyataan Penyangkalan (Disclaimer)](../../DISCLAIMER.md) · [Lisensi MIT](../../LICENSE)