{"id":50584247,"url":"https://github.com/veiluxlabs/veilux-binary","last_synced_at":"2026-06-05T05:00:36.952Z","repository":{"id":362601702,"uuid":"1259872898","full_name":"VeiluxLabs/Veilux-Binary","owner":"VeiluxLabs","description":"VEILUX - a featherweight, privacy-first, AI-native modular blockchain. Canton-style privacy, pluggable Prisms (AI/Ollama, Token, NFT, PhotonVM contracts).","archived":false,"fork":false,"pushed_at":"2026-06-05T03:57:56.000Z","size":159,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-05T04:14:38.345Z","etag":null,"topics":["ai","blockchain","canton","fintech","modular-blockchain","nft","ollama","privacy","rust","smart-contracts","web3","zero-knowledge"],"latest_commit_sha":null,"homepage":"https://github.com/VeiluxLabs/Veilux-Binary","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VeiluxLabs.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/security.md","support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-05T00:20:22.000Z","updated_at":"2026-06-05T03:58:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/VeiluxLabs/Veilux-Binary","commit_stats":null,"previous_names":["veiluxlabs/veilux-binary"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/VeiluxLabs/Veilux-Binary","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VeiluxLabs%2FVeilux-Binary","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VeiluxLabs%2FVeilux-Binary/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VeiluxLabs%2FVeilux-Binary/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VeiluxLabs%2FVeilux-Binary/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VeiluxLabs","download_url":"https://codeload.github.com/VeiluxLabs/Veilux-Binary/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VeiluxLabs%2FVeilux-Binary/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33930311,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-05T02:00:06.157Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","blockchain","canton","fintech","modular-blockchain","nft","ollama","privacy","rust","smart-contracts","web3","zero-knowledge"],"created_at":"2026-06-05T05:00:20.784Z","updated_at":"2026-06-05T05:00:36.943Z","avatar_url":"https://github.com/VeiluxLabs.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VEILUX\n\n[![CI](https://github.com/VeiluxLabs/Veilux-Binary/actions/workflows/ci.yml/badge.svg)](https://github.com/VeiluxLabs/Veilux-Binary/actions/workflows/ci.yml)\n[![Release](https://github.com/VeiluxLabs/Veilux-Binary/actions/workflows/release.yml/badge.svg)](https://github.com/VeiluxLabs/Veilux-Binary/actions/workflows/release.yml)\n[![npm](https://img.shields.io/npm/v/@veilux/sdk?label=%40veilux%2Fsdk\u0026color=cb3837\u0026logo=npm)](https://www.npmjs.com/package/@veilux/sdk)\n[![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue.svg)](#license)\n\n\u003e **Veil** (privacy by default) + **Lux** (light / illumination) — a featherweight, privacy-first, AI-native modular blockchain.\n\nRepository: **[github.com/VeiluxLabs/Veilux-Binary](https://github.com/VeiluxLabs/Veilux-Binary)** \u0026nbsp;·\u0026nbsp; TypeScript SDK: **[npmjs.com/package/@veilux/sdk](https://www.npmjs.com/package/@veilux/sdk)** \u0026nbsp;·\u0026nbsp; Releases: **[binaries](https://github.com/VeiluxLabs/Veilux-Binary/releases)**\n\nVEILUX is built around three ideas:\n\n1. **A featherweight core.** The *Photon* kernel knows almost nothing. It defines the data shapes, one extension trait (`Prism`), a pipeline (`Cascade`), and a content-addressed state. That's it. Everything heavy is an add-on you compile in only if you need it. Release binaries are optimized for size (`opt-level = \"z\"`, LTO, stripped).\n\n2. **Everything is a Prism (add-on).** A *Prism* is a self-contained capability. Shipped Prisms: **AI** (+ optional Ollama), **Storage**, **Token** (ERC-20-like), **NFT** (ERC-721-like), **Contract** (PhotonVM), and **Bridge** (cross-chain to Cosmos/Solana/EVM). They **cascade**: one Prism can trigger another (the AI Prism offloads large results to the Storage Prism automatically). Add your own by implementing one trait.\n\n3. **Privacy by ledger (VeilLedger).** The *Veil* layer gives you one logically shared ledger where **no participant sees data they aren't a stakeholder of**. Every node agrees on the same Merkle root of *blinded commitments*, while contents are sealed per-party into encrypted **views** and stored in per-party **sub-ledgers**.\n\n```\n            ╦  ╦╔═╗╦╦  ╦ ╦═╗ ╦\n            ╚╗╔╝║╣ ║║  ║ ║╔╩╦╝\n             ╚╝ ╚═╝╩╩═╝╚═╝╩ ╚═\n   featherweight · privacy-first · AI-native\n```\n\n## Token\n\n| | |\n|---|---|\n| Ticker | `LUX` |\n| Subunit | `lumen` (1 LUX = 10¹⁸ lumen) |\n\n## What is VEILUX?\n\nVEILUX is an original **Layer-1 blockchain**, written entirely in **Rust** and\ncompiled to a single, native, featherweight binary (`veilux`). It is not a fork\nand does not embed a third-party EVM — it is built from the ground up around\nthree principles: **a tiny core, everything-as-a-module, and privacy by\ndefault.**\n\n### The technology\n\n- **100% Rust, native binary.** Compiles straight to machine code (no\n  interpreter, no VM runtime). Memory-safe with no garbage collector, and\n  deterministic — every node computes identical results, which is what BFT\n  consensus requires.\n- **Featherweight.** Release binaries are size-optimized (`opt-level=\"z\"`, LTO,\n  stripped, `panic=\"abort\"`) and typically only ~0.6–0.9 MB per platform. The\n  core kernel depends on just four small crates — no heavyweight database or\n  networking framework.\n- **Multi-platform.** One codebase ships to six targets: Linux (glibc + static\n  musl, x86_64 + ARM64), Windows x86_64, and macOS (Intel + Apple Silicon).\n- **Modular by construction.** Capabilities are *Prisms* you compile in only\n  when needed, so you never pay for what you don't run.\n\n### How it works\n\n| Layer | What it does |\n|-------|--------------|\n| **Photon** (kernel) | Data shapes, the `Prism` trait, the cascade pipeline, and a BLAKE3 content-addressed state. Deliberately minimal. |\n| **Aurora** (consensus) | Stake-weighted Byzantine fault-tolerant consensus: 2/3+ finality, deterministic proposer selection, quorum-synchronized proposer failover, equivocation detection. |\n| **Veil** (privacy) | One logically shared ledger; each event is sealed per-party with ChaCha20-Poly1305, while all nodes agree on a Merkle root of blinded commitments. Includes scoped selective disclosure for auditors/regulators. |\n| **Store** | Persistent block log + atomic state snapshots; the chain reloads on restart. |\n| **Network** | Lightweight TCP gossip for proposals, votes, blocks, and sync. |\n\n### Features\n\n**Built-in Prisms (add-ons):**\n\n| Prism | Capability |\n|-------|------------|\n| **Token** | Fungible tokens (ERC-20-style): transfer, approve, mint, burn |\n| **NFT** | Non-fungible tokens \u0026 collections (ERC-721-style) |\n| **Contract** | PhotonVM — a deterministic stack-based smart-contract VM |\n| **AI** | On-chain model registry + deterministic inference, with optional local LLM execution via Ollama |\n| **Storage** | Content-addressed blob storage with reference-counted pinning |\n| **Bridge** | Guardian-attested cross-chain transfers to Cosmos, Solana, and EVM chains |\n\n**Developer experience:**\n\n- **JSON-RPC API** (`veilux serve`) — a local dev node, like Anvil/Ganache\n- **WebSocket subscriptions** — real-time block notifications\n- **SDKs** — Rust (`veilux-sdk`) and TypeScript (`@veilux/sdk`, on npm), with\n  byte-compatible signing so clients in either language verify on-chain\n- **Full CI/CD** — multi-platform release binaries, Docker images, and automatic\n  npm publishing\n\n### What makes it different\n\n1. **AI-native.** AI is a first-class Prism with deterministic, verifiable\n   inference — not a bolt-on. It can also drive local LLMs through Ollama.\n2. **Banking-grade privacy.** The VeilLedger model keeps data confidential from\n   competitors while remaining provably transparent to authorized regulators,\n   enforced by cryptography rather than policy.\n3. **Featherweight \u0026 modular.** A tiny core plus opt-in Prisms means stronger\n   security, smaller binaries, and long-term maintainability.\n4. **Cross-chain by design.** The Bridge Prism connects VEILUX to other\n   ecosystems out of the box.\n\n### Who it's for\n\n- **Financial institutions** building confidential finance and tokenized assets\n- **Decentralized AI** applications needing verifiable on-chain inference\n- **Enterprises** coordinating multi-party workflows over private-but-verifiable data\n- **Web3 developers** shipping dApps with the Rust or TypeScript SDK\n\n### Status\n\nVEILUX is a fully functional chain: live multi-node BFT consensus, persistence,\nnetworking, privacy, six Prisms, and JSON-RPC + WebSocket APIs with Rust and\nTypeScript SDKs — all covered by tests and continuous integration.\n\n## Workspace layout\n\n```\nveilux/\n├── kernel/            # Photon: featherweight core (no EVM, ~zero heavy deps)\n│   ├── crypto.rs      #   BLAKE3 hashing + Merkle roots\n│   ├── types.rs       #   Command / Event / Block / PartyId / Visibility\n│   ├── prism.rs       #   the Prism trait — the one extension point\n│   ├── cascade.rs     #   the Prism pipeline / executor\n│   └── state.rs       #   content-addressed authenticated state\n├── veil/              # VeilLedger privacy\n│   ├── view.rs        #   encrypted per-party views (ChaCha20-Poly1305)\n│   ├── identity.rs    #   Ed25519 signing identities\n│   ├── disclosure.rs  #   scoped selective disclosure (auditor/regulator)\n│   ├── projection.rs  #   split a block into per-party views\n│   └── ledger.rs      #   per-party sub-ledgers\n├── consensus/         # Aurora — stake-weighted BFT (validators, votes, quorum)\n├── store/             # append-only block log + state snapshots (persistence)\n├── network/           # lightweight TCP gossip (blocks, votes, commands)\n├── rpc/               # JSON-RPC contract types + featherweight HTTP server\n├── sdk/               # veilux-sdk: Rust client (identity + builders + RPC)\n├── sdk-ts/            # @veilux/sdk: TypeScript/JS client for web \u0026 Node\n├── prisms/\n│   ├── ai/            # AI Prism: model registry + inference (+ optional Ollama)\n│   ├── storage/       # Storage Prism: content-addressed blobs + pinning\n│   ├── token/         # Token Prism: fungible tokens (ERC-20-like)\n│   ├── nft/           # NFT Prism: non-fungible tokens (ERC-721-like)\n│   ├── contract/      # Contract Prism: PhotonVM smart contracts\n│   └── bridge/        # Bridge Prism: cross-chain transfers (Cosmos, Solana, EVM)\n└── node/              # assembles kernel + veil + consensus + store + prisms\n```\n\n## The cascade\n\nA command is routed to its Prism, which emits events **and** optional derived\ncommands. Derived commands flow back into the pipeline (bounded depth), so\ncapabilities compose:\n\n```\nsubmit(ai.infer) ─► AI Prism ─► InferenceCommitted event\n                                 └─(large result)─► storage.put ─► Storage Prism ─► Stored event\n```\n\n## Privacy model (the VeilLedger design)\n\n- Each event declares a `Visibility`: `Public` or `Parties([...])`.\n- The block commits to a Merkle root over **commitments** (blinded hashes), so\n  every node — even non-stakeholders — agrees on the same global root.\n- For each stakeholder, the event is sealed into an **EncryptedView**\n  (ChaCha20-Poly1305, key derived per party + view).\n- Each party keeps a **SubLedger**: the decrypted events it's entitled to, plus\n  the validated global root.\n\nResult: a non-stakeholder can prove a transaction *happened* without learning\n*what* happened.\n\n## Download (prebuilt binaries)\n\nEvery tagged release publishes ready-to-run binaries on the\n[Releases page](https://github.com/VeiluxLabs/Veilux-Binary/releases):\n\n| Platform | Asset |\n|----------|-------|\n| Linux x86_64 (glibc) | `veilux-\u003cver\u003e-x86_64-unknown-linux-gnu.tar.gz` |\n| Linux x86_64 (static musl) | `veilux-\u003cver\u003e-x86_64-unknown-linux-musl.tar.gz` |\n| Linux ARM64 | `veilux-\u003cver\u003e-aarch64-unknown-linux-gnu.tar.gz` |\n| Windows x86_64 | `veilux-\u003cver\u003e-x86_64-pc-windows-msvc.zip` |\n| macOS Intel | `veilux-\u003cver\u003e-x86_64-apple-darwin.tar.gz` |\n| macOS Apple Silicon | `veilux-\u003cver\u003e-aarch64-apple-darwin.tar.gz` |\n\nEach asset ships with a `.sha256` checksum. Example (Linux):\n\n```bash\ntar xzf veilux-v0.1.0-x86_64-unknown-linux-gnu.tar.gz\ncd veilux-v0.1.0-x86_64-unknown-linux-gnu\n./veilux info\n```\n\nOr pull the container image:\n\n```bash\ndocker run --rm ghcr.io/veiluxlabs/veilux-binary:latest info\n```\n\n## Build \u0026 run\n\n\u003e Requires the Rust toolchain (`rustup`, stable 1.85+). The workspace compiles\n\u003e cleanly and all tests pass.\n\n```bash\ncd veilux\ncargo build --release          # featherweight, size-optimized binaries\ncargo test --workspace         # kernel/veil/prism unit tests (all green)\ncargo run --bin veilux -- info # show kernel + installed prisms\ncargo run --bin veilux -- demo # private AI + storage + audit demo\ncargo run --bin veilux -- run  # persistent node (BFT consensus + disk store)\ncargo run --bin veilux -- serve # dev RPC + WebSocket node (http :8645, ws :8646)\n```\n\nThe `run` command opens a data directory (default `./veilux-data`), loads any\nexisting chain from disk, produces+persists a block, and reports the Aurora BFT\nproposer slot. Re-running it shows the chain growing across restarts.\n\nFor a live multi-node BFT network, use `veilux validator` (see\n`docs/consensus-networking.md`) — three validators reach 2/3+ finality over TCP\nand stay byte-for-byte in sync.\n\nSee **`docs/INSTALL.md`** for a full setup, troubleshooting, and library quick-start.\n\n## Documentation\n\n| Doc | What's inside |\n|-----|---------------|\n| `docs/INSTALL.md` | Install, build, run, troubleshoot, CI/CD, Docker |\n| `docs/architecture.md` | System design, cascade, state model |\n| `docs/add-ons.md` | Per-Prism specs (AI, Storage, Token, NFT, Contract) + how to build your own |\n| `docs/consensus-networking.md` | Aurora BFT consensus, persistence, and gossip transport |\n| `docs/rpc-sdk.md` | JSON-RPC API + Rust \u0026 TypeScript SDKs for building applications |\n| `docs/ai-ollama.md` | Running real AI models via Ollama |\n| `docs/privacy-model.md` | Deep VeilLedger banking-grade privacy research |\n| `docs/security.md` | Threat model + exploitation review + what runs safely |\n| `docs/roadmap.md` | Future add-ons the chain needs next |\n| `CHANGELOG.md` | Version history (Keep a Changelog format) |\n\n## Writing your own Prism\n\n```rust\nuse veilux_kernel::{Command, Event, Prism, PrismError, PrismInfo, PrismOutput, StateTree};\n\nstruct HelloPrism;\n\nimpl Prism for HelloPrism {\n    fn info(\u0026self) -\u003e PrismInfo {\n        PrismInfo { name: \"hello\", description: \"says hi\", version: \"1.0\" }\n    }\n    fn handle(\u0026self, cmd: \u0026Command, _state: \u0026mut StateTree) -\u003e Result\u003cPrismOutput, PrismError\u003e {\n        let event = Event {\n            source_command: cmd.id(),\n            prism: \"hello\".into(),\n            visibility: cmd.visibility.clone(),\n            payload: b\"hi\".to_vec(),\n        };\n        Ok(PrismOutput::single(event, 100))\n    }\n}\n```\n\nInstall it with `cascade.install(Box::new(HelloPrism))` and it's live. Full spec\nand checklist in `docs/add-ons.md`.\n\n## SDKs\n\nBuild apps against VEILUX in Rust or TypeScript:\n\n- **TypeScript / JavaScript** — [`@veilux/sdk`](https://www.npmjs.com/package/@veilux/sdk)\n  [![npm version](https://img.shields.io/npm/v/@veilux/sdk?color=cb3837\u0026logo=npm)](https://www.npmjs.com/package/@veilux/sdk)\n  [![npm downloads](https://img.shields.io/npm/dm/@veilux/sdk?color=cb3837)](https://www.npmjs.com/package/@veilux/sdk)\n\n  Source in [`sdk-ts/`](sdk-ts). Byte-compatible signing with the node, command\n  builders, typed RPC client, and WebSocket block subscriptions.\n\n  ```bash\n  npm install @veilux/sdk\n  ```\n\n  ```ts\n  import { Client, PartyIdentity, builders, subscribeBlocks } from \"@veilux/sdk\";\n\n  const client = new Client(\"http://127.0.0.1:8645\");\n  const alice = PartyIdentity.fromSeed(\"alice\", new Uint8Array(32).fill(1));\n  await client.submit(alice.sign(\n    builders.tokenCreate(\"alice\", \"Public\", 0, \"Gold\", \"GLD\", 18, 1_000_000n, true)));\n\n  subscribeBlocks(\"ws://127.0.0.1:8646\", { onBlock: (b) =\u003e console.log(b.height) });\n  ```\n\n- **Rust** — [`veilux-sdk`](sdk) crate. Same surface, native types.\n\nSee [`docs/rpc-sdk.md`](docs/rpc-sdk.md) for the full API.\n\n## Contributing\n\nContributions are welcome! Open PRs against the **`develop`** branch. See\n[`CONTRIBUTING.md`](CONTRIBUTING.md) for the branching model, commit conventions,\nand the checks CI runs. Adding a capability is as simple as writing a Prism —\nno kernel fork required (see [`docs/add-ons.md`](docs/add-ons.md)).\n\n## License\n\nLicensed under either of:\n\n- MIT license ([LICENSE-MIT](LICENSE-MIT))\n- Apache License 2.0 ([LICENSE-APACHE](LICENSE-APACHE))\n\nat your option.\n\n## Contact\n\n- Telegram: [@Winnodexx](https://t.me/Winnodexx)\n- Email: [nathan@winnode.xyz](mailto:nathan@winnode.xyz)\n\n## Author\n\nCreated and maintained by **nathan**. Original work — © 2026 nathan.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fveiluxlabs%2Fveilux-binary","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fveiluxlabs%2Fveilux-binary","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fveiluxlabs%2Fveilux-binary/lists"}