Skip to content

armgit / bla

Public Imported from GitHub
0

🛡️ 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.

feat(wasm): rename all non-preserved exports at maximum/bankrupt

qybaihe403ae5142261
diff --git a/src/engine/benchmark.ts b/src/engine/benchmark.ts
index 57e984c..bf3a276 100644
--- a/src/engine/benchmark.ts
+++ b/src/engine/benchmark.ts
@@ -236,8 +236,18 @@ export async function runShowcaseBenchmark(): Promise<BenchmarkReport> {
const origInst = new WebAssembly.Instance(origMod);
const protInst = new WebAssembly.Instance(protMod);
const origFn = origInst.exports.computeDigest as (a: number, b: number) => number;
- const protFn = protInst.exports.computeDigest as (a: number, b: number) => number;
- const functionalOk = validWasm && origFn(17, 29) === protFn(17, 29);
+ // Bankrupt renames non-preserved ABI by default (red-blue round-1); resolve
+ // the live export (decoy aliases share the same func index).
+ const protExportTable = protInst.exports as Record<string, unknown>;
+ const protFn = (
+ typeof protExportTable.computeDigest === "function"
+ ? protExportTable.computeDigest
+ : Object.values(protExportTable).find((v) => typeof v === "function")
+ ) as ((a: number, b: number) => number) | undefined;
+ const functionalOk =
+ validWasm &&
+ typeof protFn === "function" &&
+ origFn(17, 29) === protFn(17, 29);
cases.push(buildCaseResult("wasm-core", "WebAssembly Crypto Kernel (.wasm)", "REA inspect_wasm_artifact", res, functionalOk));
}
diff --git a/src/engine/protector.ts b/src/engine/protector.ts
index dd9a4e2..2dd674f 100644
--- a/src/engine/protector.ts
+++ b/src/engine/protector.ts
@@ -46,6 +46,11 @@ import { protectPcapCaptureBuffer } from "../shields/formats/pcap-capture.js";
import { protectGpuPtxText } from "../shields/formats/gpu-ptx.js";
import { protectUf2FirmwareBuffer } from "../shields/formats/firmware-uf2.js";
import { auditTarget } from "./auditor.js";
+import {
+ formatSupportsLaneIndependenceLint,
+ laneIndependenceRefuseMessage,
+ lintLaneIndependence,
+} from "./lane-independence-lint.js";
/**
* Crash-safe output write: write to a temp file in the same directory, then
@@ -209,6 +214,15 @@ function protectTargetInner(options: ProtectionOptions): ProtectionResult {
if (format === "javascript" || format === "typescript") {
const raw = readFileSync(absInput, "utf8");
+ if (
+ formatSupportsLaneIndependenceLint(format) &&
+ options.allowLaneIndependentGates !== true
+ ) {
+ const laneReport = lintLaneIndependence(raw);
+ if (laneReport.looksLaneIndependent) {
+ throw new Error(laneIndependenceRefuseMessage(laneReport, absInput));
+ }
+ }
const transformed = transformJavaScriptWithBlaShield(raw, {
intensity,
seed,
@@ -408,8 +422,8 @@ function protectTargetInner(options: ProtectionOptions): ProtectionResult {
const res = protectWasmBinary(rawWasm, {
intensity,
seed,
- // Issue #40.3: rename internal-looking exports at maximum/bankrupt by default;
- // wasmPreserveExports keeps the customer public ABI.
+ // Issue #40.3 / red-blue round-1: rename ALL non-preserved exports at
+ // maximum/bankrupt by default; wasmPreserveExports is the explicit ABI keep-list.
...(options.wasmPreserveExports && options.wasmPreserveExports.length > 0
? { preserveExports: options.wasmPreserveExports }
: {}),
diff --git a/src/shields/formats/wasm.ts b/src/shields/formats/wasm.ts
index 7a5a07f..e384507 100644
--- a/src/shields/formats/wasm.ts
+++ b/src/shields/formats/wasm.ts
@@ -144,7 +144,11 @@ export function renameWasmExports(
prng: SeededPrng,
options: {
readonly preserveExports?: readonly string[];
- /** When true (default), only rename internal-looking names. */
+ /**
+ * When true, only rename internal-looking names.
+ * Callers that want full non-preserved rename must pass `onlyInternal: false`
+ * (protectWasmBinary does this by default at maximum/bankrupt).
+ */
readonly onlyInternal?: boolean;
} = {},
): {
@@ -152,6 +156,8 @@ export function renameWasmExports(
readonly renames: readonly WasmExportRename[];
} {
const preserve = new Set(options.preserveExports ?? []);
+ // Library default remains conservative (internal-only) when called directly;
+ // protectWasmBinary passes onlyInternal:false at maximum/bankrupt.
const onlyInternal = options.onlyInternal !== false;
const entries = parseWasmExportSectionPayload(exportSectionPayload);
if (entries.length === 0) {
@@ -367,15 +373,15 @@ export function protectWasmBinary(
readonly preserveExports?: readonly string[];
/**
* When true, rename exports not listed in `preserveExports`.
- * Default: true at maximum/bankrupt for internal-looking names only;
- * pass `renameNonPublicExports: true` with an explicit preserve list to
- * rename every non-preserved export.
+ * Default: true at maximum/bankrupt (all non-preserved names).
+ * Keeping a stable public ABI requires an explicit `preserveExports` list
+ * (CLI `--wasm-preserve-exports` / MCP `wasm_preserve_exports` / `.blarc`).
*/
readonly renameNonPublicExports?: boolean;
/**
* When renaming, only touch internal-looking names (`__*`, `debug_*`, …).
- * Default true unless `renameNonPublicExports` is explicitly true AND
- * `preserveExports` is provided (then all non-preserved names rename).
+ * Default **false** at maximum/bankrupt (rename every non-preserved export).
+ * Set true only when you intentionally want the weaker internal-only pass.
*/
readonly renameInternalOnly?: boolean;
} = {},
@@ -434,13 +440,13 @@ export function protectWasmBinary(
options.renameNonPublicExports === true ||
(options.renameNonPublicExports !== false && intensityWantsRename);
if (renameRequested) {
+ // Red/Blue round-1: public ABI (`mix`/`seal`) surviving bankrupt enabled
+ // preload hooks. Default at maximum/bankrupt is full non-preserved rename;
+ // callers that need stable names must pass preserveExports explicitly.
const onlyInternal =
options.renameInternalOnly !== undefined
? options.renameInternalOnly
- : !(
- options.renameNonPublicExports === true &&
- (options.preserveExports?.length ?? 0) > 0
- );
+ : false;
const renamed = renameWasmExports(payload, prng, {
preserveExports: options.preserveExports,
onlyInternal,
diff --git a/tests/wasm-export-rename.test.ts b/tests/wasm-export-rename.test.ts
index 1ad4b90..27e4a20 100644
--- a/tests/wasm-export-rename.test.ts
+++ b/tests/wasm-export-rename.test.ts
@@ -60,7 +60,7 @@ describe("WASM export rename / semantic preservation (#40.3)", () => {
expect(after.map((e) => e.name)).toContain(renames[0]!.to);
});
- it("protectWasmBinary preserves public ABI by default; explicit rename rewrites non-preserved", () => {
+ it("balanced keeps public ABI; bankrupt renames non-preserved by default", () => {
const raw = fixtureComputeScore();
const balanced = protectWasmBinary(raw, {
intensity: "balanced",
@@ -70,37 +70,43 @@ describe("WASM export rename / semantic preservation (#40.3)", () => {
expect(inspectWasmBinary(balanced.buffer).exportNames).toContain("compute_score");
expect(WebAssembly.validate(new Uint8Array(balanced.buffer))).toBe(true);
- const renamed = protectWasmBinary(raw, {
- intensity: "balanced",
- seed: "wasm-rename-force",
- renameNonPublicExports: true,
- renameInternalOnly: false,
- preserveExports: [],
+ const bankrupt = protectWasmBinary(raw, {
+ intensity: "bankrupt",
+ seed: "wasm-rename-bankrupt-default",
});
- expect(renamed.exportsRenamed.length).toBeGreaterThanOrEqual(1);
- expect(renamed.exportsRenamed[0]!.from).toBe("compute_score");
- const names = inspectWasmBinary(renamed.buffer).exportNames;
+ expect(bankrupt.exportsRenamed.length).toBeGreaterThanOrEqual(1);
+ expect(bankrupt.exportsRenamed[0]!.from).toBe("compute_score");
+ const names = inspectWasmBinary(bankrupt.buffer).exportNames;
expect(names).not.toContain("compute_score");
- expect(names).toContain(renamed.exportsRenamed[0]!.to);
- expect(WebAssembly.validate(new Uint8Array(renamed.buffer))).toBe(true);
+ expect(names).toContain(bankrupt.exportsRenamed[0]!.to);
+ expect(WebAssembly.validate(new Uint8Array(bankrupt.buffer))).toBe(true);
- const mod = new WebAssembly.Module(new Uint8Array(renamed.buffer));
+ const mod = new WebAssembly.Module(new Uint8Array(bankrupt.buffer));
const inst = new WebAssembly.Instance(mod);
- const fn = inst.exports[renamed.exportsRenamed[0]!.to] as (x: number) => number;
+ const fn = inst.exports[bankrupt.exportsRenamed[0]!.to] as (x: number) => number;
expect(fn(10)).toBe(427);
});
- it("preserveExports keeps the named public ABI under forced rename", () => {
+ it("preserveExports keeps the named public ABI under bankrupt rename", () => {
const raw = fixtureComputeScore();
const res = protectWasmBinary(raw, {
intensity: "bankrupt",
seed: "wasm-rename-preserve",
- renameNonPublicExports: true,
- renameInternalOnly: false,
preserveExports: ["compute_score"],
});
expect(res.exportsRenamed).toHaveLength(0);
expect(inspectWasmBinary(res.buffer).exportNames).toContain("compute_score");
expect(WebAssembly.validate(new Uint8Array(res.buffer))).toBe(true);
});
+
+ it("renameInternalOnly:true keeps public names even at bankrupt", () => {
+ const raw = fixtureComputeScore();
+ const res = protectWasmBinary(raw, {
+ intensity: "bankrupt",
+ seed: "wasm-rename-internal-only",
+ renameInternalOnly: true,
+ });
+ expect(res.exportsRenamed).toHaveLength(0);
+ expect(inspectWasmBinary(res.buffer).exportNames).toContain("compute_score");
+ });
});
diff --git a/tests/wasm-preserve-exports-config.test.ts b/tests/wasm-preserve-exports-config.test.ts
index a42af6a..71c3830 100644
--- a/tests/wasm-preserve-exports-config.test.ts
+++ b/tests/wasm-preserve-exports-config.test.ts
@@ -118,4 +118,19 @@ describe("wasmPreserveExports .blarc / CLI / protect parity (#40.3)", () => {
(inst.exports as { add: (a: number, b: number) => number }).add(2, 3),
).toBe(5);
});
+
+ it("bankrupt without preserveExports renames public ABI names", () => {
+ const raw = minimalTwoExportWasm();
+ const res = protectWasmBinary(raw, {
+ intensity: "bankrupt",
+ seed: "wasm-no-preserve-renames-public",
+ });
+ const fromNames = res.exportsRenamed.map((r) => r.from);
+ expect(fromNames).toContain("add");
+ expect(fromNames).toContain("__bla_internal_x");
+ const mod = new WebAssembly.Module(new Uint8Array(res.buffer));
+ const inst = new WebAssembly.Instance(mod);
+ expect(Object.keys(inst.exports)).not.toContain("add");
+ expect(Object.keys(inst.exports)).not.toContain("__bla_internal_x");
+ });
});