PexliFormation

Offline Windows app that turns a Rust smart contract into SBF — the format the Pexli v2 blockchain runs.

Think of it as a translator: on the left you drop your Rust contract, you click one button, and on the right you get the .so (SBF program) ready for the chain. No terminal, no commands — just a simple window.

Self-contained & verified on CI (Windows): the SBF toolchain is bundled inside the app, and CI proves the bundled compiler converts examples/hello_pexli.rs to a working hello_pexli.so offline, with a minimal PATH and an isolated cache — no system Rust, nothing installed. The one-click .exe installer builds green on every push; a clean uninstall removes everything.

---

What it does

• Input: a single .rs contract file, a Cargo.toml, or a whole Cargo project folder.
• Output: a program.so in SBF format (the Solana/Pexli Berkeley-Packet-Filter bytecode the runtime executes), plus its size and SHA-256.
• Offline: once the SBF toolchain is set up on the machine, no internet is needed to convert.
• Simple: one window, drag-and-drop, one Convert to SBF button, live build log.

Roman-Urdu quick note (aap ke liye)

• Ye ek Windows software hai — one-click install ho jata hai (.exe).
• Isme aap apna Rust contract dalen (jo Pexli v2 par chalta hai), aur Convert dabayen.
• Ye us ko SBF format (.so) me convert kar deta hai — bilkul kisi translator ki tarah.
• Terminal ki zarurat nahi, sab kuch UI se hota hai, aur offline chalta hai.
• Kuch bhi alag install nahi karna — SBF toolchain app ke andar hi bundled hai, apni alag files me. System ka koi Rust/setting ko haath nahi lagata.
• Uninstall karne par sab kuch saaf ho jata hai — kuch peeche nahi rehta.

---

Install (for users)

1. Download the installer from the project's Releases page (PexliFormation_1.0.0_x64-setup.exe or .msi).
2. Double-click → install (one click).
3. Open PexliFormation. That's it — the SBF toolchain is already inside the app; nothing else to install.

Use it

1. Choose file / project (or drag a .rs file onto the left panel).
2. (Optional) pick an Output folder — default is next to the input.
3. Click Convert to SBF →.
4. The right panel shows the resulting .so, its size and SHA-256. Click Open folder to reveal it.

Try the included examples/hello_pexli.rs.

---

Build it yourself (for developers)

PexliFormation is a Tauri v2 app — a Rust backend + a tiny build-free HTML/JS UI.

Prerequisites

• Rust (stable)
• Node.js 18+
• Windows: the MSVC build tools + WebView2 (preinstalled on Win10/11)
• The SBF toolchain for actually converting: run scripts/setup-toolchain.ps1

Commands

npm install
npm run dev          # run the app in dev mode
npm run build:win    # produce the one-click NSIS installer

The installer lands in src-tauri/target/release/bundle/nsis/.

Recommended: build via GitHub Actions. The workflow in .github/workflows/build-windows.yml downloads the SBF toolchain + a seed crate cache, bundles them inside the app, verifies the bundle converts offline, and produces the self-contained installer. Run it manually ("Run workflow") or push a v* tag to also publish a Release. Building the bundled installer locally requires the platform-tools in src-tauri/resources/platform-tools/ (see the workflow for how it stages them).

How the bundle stays isolated

• The compiler lives in resources/platform-tools/ inside the app — the installed program uses only that, never your system Rust.
• Crate downloads go to an app-private CARGO_HOME under %LOCALAPPDATA%\com.pexli.formation\toolchain\, seeded from a bundled cache so the common contract builds with no network.
• Your own ~/.cargo and any existing toolchain are never read or modified.
• Uninstall removes the app and that private cache (NSIS post-uninstall hook).

---

How the conversion works

 Rust source (.rs / Cargo project)
        │
        │  (single .rs → wrapped in a temp crate with solana-program)
        ▼
   cargo build-sbf        ← the SBF compiler (platform-tools)
        │
        ▼
 target/deploy/<name>.so  ← SBF program (this is your output)

The SBF .so is a small ELF the Pexli v2 / Solana runtime loads and executes on-chain. PexliFormation just drives that compiler for you behind a friendly window and copies the result where you want it.

Project layout

src/                 UI (index.html, styles.css, main.js) — no bundler needed
src-tauri/           Rust backend (Tauri)
  src/lib.rs         Tauri commands
  src/converter.rs   Rust → SBF build logic
  src/toolchain.rs   finds / sets up cargo-build-sbf
  tauri.conf.json    window + Windows installer config
scripts/             icon generator, Windows toolchain setup
examples/            a sample contract

License

MIT