Skip to content

Capsulith 0.1: compiled features, portable calls

Latest

Choose a tag to compare

@nazeeh111 nazeeh111 released this 12 Oct 21:28

Capsulith turns a supported compiled native function into a portable callable capsule. It retains original ARM64 instructions, gathers direct helpers and readonly data, exposes dependencies and execution evidence, and runs from Node or a browser without the original application.

This release includes a local upload/extract/contract Studio, bounded worker execution and cancellation, original-byte/disassembly inspectors, independently runnable Node/browser exports, real LZ4 and independently compiled xxHash specimens, original notices and the pinned emulator's full upstream source/build scripts.

Verified at e6bd3f1: all three release-gate jobs passed. Each ran27 Python tests,14 Node tests including128 independently native LZ4 controls,1,100 actual xxHash Wasm calls across two optimization builds, and a clean installed-wheel/portable-export check. macOS additionally rebuilt both native xxHash controls and verified4,400 native calls. Actual local Studio execution and downloaded portable LZ4 output also matched controls. These finite checks support the declared scope, not universal correctness.

Start with the wheel: python3 -m pip install capsulith-0.1.0-py3-none-any.whl, then capsulith studio and open http://127.0.0.1:6359. Python3.10+ and Capstone are needed for extraction; Node20+ is needed for CLI execution. The portable ZIPs need only Node or an HTTP-served browser. Run node run.cjs inside either ZIP, or serve its index.html. No API key or paid service.

First scope: zero-preferred-base ordinary ARM64 Mach-O dylibs with function-start metadata, direct control flow, static non-relocated readonly data and caller-declared integer/buffer contracts. Unsupported state/imports/relocations/indirect control receive diagnostics. No inferred ABI, source reconstruction, whole-application cloning or emulator security-isolation claim. Artifact hashes describe provenance, not authenticity.

GPL-2.0-only combined runtime, established Unicorn/Unicorn.js emulation credited, BSD LZ4/xxHash notices preserved. Exact pinned upstream emulator source/build scripts accompany the unchanged published bundle; a byte-identical local backend rebuild is not established. Development assisted by Codex. No outside adoption or achievement badge is claimed.