# BCOS — Beacon Certified Open Source [![BCOS Certified](https://img.shields.io/badge/BCOS-Certified-brightgreen?style=flat)](https://rustchain.org/bcos/) This repository targets certification under the **Beacon Certified Open Source (BCOS)** program by [Elyan Labs](https://elyanlabs.ai). License: **AGPL-3.0** (+ commercial). ## Verification ```bash python3 -m pip install clawrtc clawrtc bcos scan . clawrtc bcos verify BCOS-xxxxxxxx ``` Verify at: **[rustchain.org/bcos/](https://rustchain.org/bcos/)** ## What BCOS Certifies | Check | Description | Status in this repo | |-------|-------------|---------------------| | License Compliance | SPDX headers + OSI-compatible deps | ✅ SPDX on **17/17** sources; `AGPLv3` LICENSE + `COMMERCIAL.md` | | Vulnerability Scan | OSV/CVE scan | ⏳ run via `clawrtc bcos scan` | | Static Analysis | Semgrep (3,800+ rules) | ⏳ run via `clawrtc bcos scan` | | SBOM | Software Bill of Materials | ⏳ generated by scan | | Dependency Freshness | % deps at latest | n/a — repo ships no package deps; runtime = AMD XRT/IRON/Peano (installed) + system LLVM | | Test Evidence | test infra / self-checks | ✅ **8 self-verifying examples** (bit-exact PASS/MISMATCH) + bring-up scripts | | Review Attestation | human/agent tier L0/L1/L2 | Scott Boudreaux (**L2, human**) | ## License boundary (important) - **Original work** (scripts, hand-authored AIE kernels in `examples/kernels/*.cc`, docs, benchmark harnesses): **AGPL-3.0-or-later** — `SPDX-License-Identifier: AGPL-3.0-or-later` on every source. A **commercial / proprietary license** is available (`COMMERCIAL.md`) — valid because this is fully-owned original work. - **AMD's XDNA/XRT driver and IRON/mlir-aie + Peano are NOT vendored.** They are built/installed from upstream (`amd/xdna-driver`, `Xilinx/mlir-aie`, `Xilinx/llvm-aie`), licensed separately under **Apache-2.0 WITH LLVM-exception**. No AMD code or NPU firmware is redistributed here. open-xdna *orchestrates* these tools; it does not derive from or embed them. ## What this repo proves (test evidence detail) Verified on a real Ryzen 7 8845HS (XDNA1 / `RyzenAI-npu1`), Ubuntu 25.10 / kernel 6.17 / GCC 15: - gen-1 NPU bring-up (open-source XRT + driver + firmware), DKMS-persistent - `512³` int16 matmul (~68 GFLOPS) and a 2-layer MLP forward pass on the NPU - hand-authored AIE collapse kernels (`collapse`, `collapse_rt`, `collapse_fused`), `aie::reverse` shuffle, cross-tile reduce, and dense stream compaction — each with a bit-exact self-check. ## Certification Details - **Reviewed By**: Scott Boudreaux ([@Scottcjn](https://github.com/Scottcjn)) - **Organization**: [Elyan Labs](https://elyanlabs.ai) - **Chain**: [RustChain](https://rustchain.org) (Proof of Antiquity) - **Engine**: BCOS v2 — Free & Open Source - **On-Chain Proof**: BLAKE2b-256 commitment anchored to the RustChain ledger — **pending**: run `clawrtc bcos scan .` to mint the `BCOS-xxxxxxxx` id and anchor it. > Status: **BCOS-ready** — SPDX coverage, AGPLv3 LICENSE, clean upstream license boundary, and > review attestation are in place. The on-chain certificate id is assigned when the scan runs.