feat: add an ant-core-powered direct browser client

.github/workflows/ci.yml

@@ -33,6 +33,49 @@ jobs:
       - uses: Swatinem/rust-cache@v2
       - run: cargo clippy --all-targets --all-features -- -D warnings
 
+  browser-wasm:
+    name: Browser WASM
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+      - uses: Swatinem/rust-cache@v2
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - name: Check the portable Rust library
+        run: >-
+          cargo check -p ant-core
+          --target wasm32-unknown-unknown
+          --no-default-features
+          --features browser-wasm
+      - name: Lint the portable Rust library
+        run: >-
+          cargo clippy -p ant-core
+          --target wasm32-unknown-unknown
+          --no-default-features
+          --features browser-wasm
+          -- -D warnings
+      - name: Install wasm-pack
+        run: cargo install wasm-pack --version 0.15.0 --locked
+      - name: Generate the browser bindings
+        working-directory: ant-core
+        run: >-
+          wasm-pack build
+          --target web
+          --out-dir wasm-tests/pkg
+          --release
+          .
+          --no-default-features
+          --features browser-wasm
+      - name: Test the generated browser bindings
+        working-directory: ant-core
+        run: >-
+          node --import ./wasm-tests/setup-wasm.mjs
+          --test ./wasm-tests/*.test.mjs
+
   test-unit:
     name: Unit Tests (${{ matrix.os }})
     runs-on: ${{ matrix.os }}

.gitignore

@@ -1,4 +1,5 @@
 /target
+/ant-core/wasm-tests/pkg/
 .cargo/config.toml
 .claude/plans/
 .claude/scheduled_tasks.lock

Cargo.toml

@@ -1,3 +1,7 @@
 [workspace]
 members = ["ant-core", "ant-cli"]
 resolver = "2"
+
+[patch.crates-io]
+saorsa-core = { git = "https://github.com/WithAutonomi/saorsa-core.git", rev = "1432fa9751d46887dc86767928bd3320a24c6367" }
+saorsa-transport = { git = "https://github.com/WithAutonomi/saorsa-transport.git", rev = "2c6e23cd6cd4db79f475676e25af9334a044a343" }

README.md

@@ -4,13 +4,29 @@ A unified CLI and Rust library for storing data on the Autonomi decentralized ne
 
 ## Overview
 
-This project provides two crates:
+This project provides two Rust crates:
 
-- **ant-core** — A headless Rust library containing all business logic: data storage/retrieval with self-encryption and EVM payments, node lifecycle management, and local devnet tooling. Designed to be consumed by any frontend (CLI, GUI, AI agents, REST clients).
+- **ant-core** — A headless Rust library containing the Autonomi business logic: data storage/retrieval with self-encryption and EVM payments, node lifecycle management, and local devnet tooling. Its `browser` module shares manifest validation, protocol framing, authenticated WebRTC Direct access, lookup, quote verification, and complete public-file workflows with browser applications through the `browser-wasm` feature.
 - **ant-cli** — A thin CLI binary (`ant`) built on `ant-core`.
 
 Data on Autonomi is **content-addressed**. Files are split into encrypted chunks (via [self-encryption](https://en.wikipedia.org/wiki/Convergent_encryption)), each stored at an XOR address derived from its content. A `DataMap` tracks which chunks belong to a file. Payments for storage are made on an EVM-compatible blockchain (Arbitrum).
 
+### Browser WebAssembly client
+
+Build `ant-core` for browsers without changing native callers:
+
+```bash
+wasm-pack build --target web ant-core \
+  --no-default-features --features browser-wasm
+```
+
+This produces the low-level `wasm-bindgen` API backed by the shared Rust
+implementation. The companion
+[`ant-client-browser-sdk`](https://github.com/WithAutonomi/ant-client-browser-sdk)
+project owns the TypeScript API, wallet adapters, browser storage and worker
+integration, media streaming bridge, runnable examples, and browser end-to-end
+tests.
+
 ## Installation
 
 ### Linux / macOS