wasmforge

WasmForge — compila programas Go y C# a ejecutables nativos en un solo binario, con sandbox WASM y salida polimórfica.

El lado de C# es, en última instancia, más una prueba de concepto que una implementación. El proceso que se usa para compilar C# a WASM es demasiado experimental y significa que WasmForge a menudo necesita reescribir una parte considerable del programa de todos modos para que funcione. Al final, probablemente profundicé demasiado en esta capacidad y debería haber recomendado que la gente use un LLM para reescribir código C# como código Go. Probablemente sea menos doloroso de manejar. Dicho esto, el patrón general de C# -> Wasm -> WasmForge SÍ funciona y rompe una buena cantidad de detecciones específicas de C#.

En ese sentido, WasmForge está principalmente diseñado para lidiar con detecciones ESTÁTICAS. El proceso de transpilación rompe la mayoría de las detecciones, incluso para el escaneo en memoria, pero en última instancia, si tu binario tiene algunas cadenas muy obvias como mimikatz o sliver, hay algunos escaneos en memoria de bajo esfuerzo que causarán una detección. La ofuscación automática de cadenas probablemente se agregará en el futuro, ya que es una característica bastante fácil de automatizar, pero para la primera versión no quise agregar complejidad adicional al pipeline de compilación para mantener la depuración relativamente sencilla.

Si bien se han realizado algunos esfuerzos para limpiar/consolidar el código fuente en este repositorio, sigue estando bastante desorganizado. Hay varias carpetas diferentes para diferentes procesos de prueba. Las pruebas unitarias básicas tienden a vivir en examples/ y test/, mientras que algunas de las pruebas más complejas destinadas a ejecutarse en un entorno de laboratorio completo viven en testdata/. También hay una serie de herramientas solo para desarrollo/pruebas que viven en las carpetas scripts/ y internal/devtools. Estas solo serán necesarias si intentas configurar tu propio entorno de prueba para realizar más desarrollo. En general, cualquier desarrollo de LLM de algo tan complicado requiere una serie de casos de prueba muy explícitos para guiar la generación; de lo contrario, terminas con algo que no funciona en absoluto. El proyecto incluye estos harnesses para que cualquier persona curiosa pueda continuar su propio desarrollo de herramientas o contribuir al proyecto.

Espero que la comunidad encuentre estas herramientas relativamente fáciles de usar y con el tiempo continuaremos mejorándolas. Quizás algún día la compilación de C# funcione tan bien como la compilación de Go.

Inicio rápido (proyectos Go)

Hay tres formas de obtener wasmforge:

1. Binario precompilado. Descarga una versión de la página de Releases — hay compilaciones del CLI para Linux, macOS y Windows adjuntas a cada tag.

2. Imagen Docker. Para proyectos C# / .NET, la imagen incluida trae todos los prerrequisitos (.NET 10 SDK, workload NativeAOT-LLVM, WASI SDK 24.0, wasm-ld, osslsigncode) preinstalados. Constrúyela una vez con make docker-build y ejecútala con make docker-run — consulta docs/CSHARP.md para el flujo de trabajo completo. Esta es la ruta recomendada para C#.

3. Compilar desde el código fuente.

   root@kitploit:~

   make build
   

   make build regenera el archivo internal/build/build_assets.tar.gz incrustado y luego compila el CLI. Si solo ejecutas go build -o wasmforge ./cmd/wasmforge obtendrás un binario funcional, pero las compilaciones en modo distribución (cuando el CLI se ejecuta fuera de este árbol de fuentes) usarán un archivo incrustado obsoleto. Consulta CONTRIBUTING.md para una explicación más detallada.

El directorio examples/ contiene programas Go ejecutables que puedes compilar de inmediato. Consulta examples/README.md para la lista completa.

Para Windows

El puente de la API Win32 se activa automáticamente siempre que GOOS=windows — ya no necesitas pasar --win32-apis para el caso común.

--ghost traefik intercambia la distribución de símbolos gopclntab incrustada para que se parezca al proxy inverso Traefik. De los perfiles incluidos, este produce la tasa de detección más baja en VirusTotal. Otros perfiles e instrucciones para generar los tuyos propios están en docs/GHOST-PROFILES.md.

Los binarios para Windows se firman automáticamente con un certificado autofirmado de forma predeterminada. Usa --sign google.com para suplantar el certificado TLS de un dominio, o --no-sign para deshabilitar la firma por completo.

Para macOS

No se requieren banderas adicionales. El puente de frameworks de macOS se activa automáticamente siempre que GOOS=darwin. Consulta docs/MACOS.md para el puente de frameworks, soporte de purego/ObjC y otras notas específicas de Apple.

Banderas opcionales

Compilación de proyectos C# / .NET

Los proyectos C# (archivos .csproj) se detectan automáticamente. WasmForge ejecuta todo el pipeline de migración, parcheo y compilación NativeAOT-WASI en un solo comando:

Para trabajos en C#, recomendamos encarecidamente el entorno de compilación Docker. Incluye todos los prerrequisitos (.NET 10 SDK, workload NativeAOT-LLVM, WASI SDK 24.0, wasm-ld) para que no necesites instalar ninguno de ellos en el host. Las instrucciones completas están en docs/CSHARP.md.

Resumen del CLI

Características

WasmForge tiende un puente entre WASM y el host subyacente para que los programas invitados no tengan que hacerlo.

APIs de plataforma. TCP, UDP, DNS, HTTP, TLS y sockets sin procesar funcionan sin cambios en el código invitado tanto en Windows como en macOS. En Windows, WasmForge actúa como proxy de toda la superficie Win32: registro, E/S de archivos, procesos, carga de DLL y SyscallN con hasta 15 argumentos. La traducción de punteros es automática. Las cadenas vtable de COM se reflejan para que el CLR y otras APIs con uso intensivo de COM funcionen de extremo a extremo. En macOS, dlopen y dlsym alcanzan cualquier framework (Security, CoreGraphics, IOKit, etc.), y ebitengine/purego más el runtime de Objective-C funcionan de inmediato.

Hosting y migración de .NET. El CLR se carga a través de la cadena estándar (CoInitializeEx, CLRCreateInstance, Load_3, Invoke_3). AMSI se parchea al inicio para que Assembly.Load(byte[]) no bloquee herramientas conocidas. Un pipeline separado de NativeAOT-WASI toma proyectos .NET Framework existentes y produce binarios PE individuales para Windows sin necesidad de runtime .NET en el objetivo.

Memoria del host y shellcode. Un proxy de memoria del host respaldado por VirtualAlloc es accesible desde el invitado. Esto hace posibles los cargadores COFF/BOF y la ejecución de shellcode sin salir de la caja de arena WASM.

Ceder cooperativamente. Las APIs Win32 bloqueantes (Sleep, WaitForSingleObject, ReadFile y similares) no congelan las goroutines WASM. El host envía la llamada a una goroutine en segundo plano y señala al invitado que ceda hasta que el resultado esté listo.

Salida polimórfica. Cada compilación produce un binario estructuralmente único. Los opcodes WASM se permutan, los IDs de sección y los bytes mágicos se aleatorizan, y se eliminan todos los identificadores, importaciones PE, cadenas VERSIONINFO, bloques de licencia y nombres de archivos fuente. La bifurcación de wazero incluida se reescribe para que coincida con el bytecode permutado. El perfilado ghost reescribe los símbolos gopclntab para que coincidan con binarios Go empresariales reales (Traefik, Caddy, Terraform). Las salidas de Windows se firman con Authenticode de forma predeterminada, ya sea con autofirma o suplantando el certificado TLS de un dominio real mediante osslsigncode.

Arquitectura

El pipeline de compilación se ejecuta en seis etapas.

1. Preparar GOROOT parcheado. Enlaza simbólicamente la stdlib de Go y parchea syscall/ y net/ para redes WASM. Se almacena en caché en ~/.wasmforge/cache/.
2. Compilar Go a WASM. Compila con GOOS=wasip1 GOARCH=wasm contra la stdlib parcheada. Los stubs automáticos cubren las brechas específicas de la plataforma. Se inyectan sysshims para golang.org/x/sys y ebitengine/purego cuando esas importaciones están presentes.
3. Reasignar WASM. Permutación de opcodes por compilación, permutación de IDs de sección, bytes mágicos personalizados y una sustitución de bytes en toda la carga útil.
4. Generar binario del host. main.go polimórfico con identificadores aleatorios, una bifurcación de wazero correspondiente por compilación, recursos PE incrustados y -trimpath.
5. Post-procesamiento PE (solo Windows). Enriquecimiento de importaciones, checksum PE e inyección de carga útil como una sección PE con nombre.
6. Firma de código (opcional). Firma Authenticode mediante osslsigncode.

Validación en el mundo real

WasmForge compila y ejecuta proyectos Go de terceros sin modificar, incluidos aquellos con código complejo específico de la plataforma.

Programas .NET NativeAOT-WASI:

Consulta docs/BUILDING-SLIVER.md para un tutorial paso a paso de Sliver, y docs/CSHARP.md para el pipeline de C#.

Requisitos

WasmForge se ejecuta en hosts de compilación Linux, macOS o Windows. Se requiere Go 1.25 o más reciente.

Algunas características necesitan configuración adicional. Los sockets sin procesar necesitan CAP_NET_RAW o root. El puente Win32 necesita un objetivo Windows con --win32-apis (otros objetivos devuelven ENOSYS). El puente de frameworks de macOS necesita un objetivo macOS y se detecta automáticamente desde GOOS=darwin. La firma de código necesita osslsigncode en el PATH. Los proyectos C# necesitan el SDK de .NET 10, el workload NativeAOT-LLVM y WASI SDK 24.0. Alternativamente, la imagen Docker incluida (cubierta en docs/CSHARP.md) viene con todos ellos preinstalados.

El harness de pruebas de paridad (test/parity/) y los scripts de instalación de laboratorio en scripts/lab-setup/ asumen adicionalmente un rango de Active Directory montado con Ludus ejecutando GOAD (Game of Active Directory) — cada valor predeterminado sevenkingdoms.local / kingslanding / SEVENKINGDOMS-CA es un valor predeterminado de GOAD, que se puede anular mediante las variables de entorno WASMFORGE_PARITY_* (consulta test/parity/internal/lab/lab.go). Consulta docs/internals/PARITY-HARNESS.md y docs/internals/LAB-STABILITY.md para la configuración completa del laboratorio.

Documentación

Empieza aquí

Para profundizar

Referencias para mantenedores

Licencia

Licenciado bajo la Licencia Apache, Versión 2.0. Consulta LICENSE y NOTICE para más detalles.

Copyright (c) 2025-2026 Praetorian Security, Inc.