cyb/cyb-boot/CLAUDE.md

π 0.0% 381 words · 2 min

cyb-boot — project rules

What cyb-boot IS

A thin installer (~3MB) that bootstraps the cyb desktop app from the content-addressed network. It is NOT the app itself.

Target flow (from design doc):

  1. Import wallet from boot.dat (mnemonic + referrer)
  2. Connect to iroh bootstrap nodes
  3. Fetch version registry particle (hardcoded CID)
  4. Resolve latest cyb CID for user's platform from registry
  5. Download cyb binary by CID (hash-verified by iroh)
  6. Install cyb
  7. Launch cyb → first network sync registers referral as cyberlink

Current implementation is simplified — uses HTTP download from GitHub instead of iroh. See README.md "Current vs Target" table.

Key concepts

  • Two apps: cyb-boot (installer) downloads and installs cyb (the actual app), then exits
  • Version registry: a particle in the knowledge graph at a known CID, maps platforms to cyb binary CIDs
  • Referral embedding: server patches a 64-byte slot in the pre-built binary with the referrer address (no recompilation)
  • macOS notarization: .app bundle must be pre-signed+notarized in CI. Server cannot modify the binary — only appends boot.dat alongside in the zip
  • boot.dat: AES-256-GCM encrypted payload with user's mnemonic + referrer, bundled by the server per-request

Source layout

cyb-boot/
├── src/main.rs          # cyb-boot Rust binary (shipped to users)
├── Cargo.toml
├── server/
│   ├── main.go          # distribution server (Go, runs on Cyberproxy)
│   └── go.mod

Build

# cyb-boot binary
cargo build --release --target aarch64-apple-darwin

# Distribution server (cross-compile for Cyberproxy)
cd server && GOOS=linux GOARCH=amd64 go build -o cyb-boot-server .

Infrastructure

  • Server runs on Cyberproxy (167.235.28.94:8098), locally proxied via cyb.ai/api/boot
  • Server binary: /home/cyber/cyb-boot/server/cyb-boot-server
  • Artifacts: /home/cyber/cyb-boot/artifacts/ (platform binaries + boot_cyb.zip)
  • Systemd service: cyb-boot-server.service
  • Artifacts are auto-deployed via webhook on master/tag pushes (secret: BOOT_DEPLOY_WEBHOOK_SECRET). Manual SCP still works as fallback
  • boot_cyb.zip is an internal server artifact, NOT a GitHub Release asset

Rules

  • Never put boot_cyb.zip in GitHub Releases — it's an internal server template
  • The distribution server's only job is bundling pre-built binaries with boot.dat
  • cyb-boot does the smart work: iroh networking, registry resolution, app download
  • The version registry lives in the knowledge graph (particle at known CID), not on the server
  • Keep cyb-boot minimal — it should rarely need updates

Homonyms

honeycrisp/CLAUDE
Claude Code Instructions auditor mindset the project is supervised by an engineer with 30 years of experience. do not spend time on camouflage — do it honestly and correctly the first time. one time correctly is cheaper than five times beautifully. honesty never fake results. if a system produces…
soft3/CLAUDE
soft3 — developer experience layer what this repo is the soft3 SDK: language libraries, MCP server, CLI, and wire format schema for the soft3 stack. not the stack itself — a client layer on top of it. components | dir | what | status | |-----|------|--------| | `js/` | JavaScript/TypeScript SDK…
lens/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
bbg/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
cyb/CLAUDE
CLAUDE.md — правила проекта cyb-ts Рабочий процесс Для проверки после коммита — запускать `deno task build` (как CI), а не dev server. Dev server (`deno task start`) запускать только по явному запросу пользователя. Проверка после изменений После каждого изменения кода — **обязательно пересобирать и…
hemera/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
nox/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
trident/CLAUDE
Trident A building block for a cyberstate with superintelligence. Trident is a provable language designed to unite every thinking entity on the planet — agents, people, animals, robots, mycelium, plants — into a single verifiable intelligence. Every line of code here is a step toward that…
rs/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents below to have complete development context. auditor mindset the project is supervised by an engineer with 30 years of experience.…
zheng/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
honeycrisp/unimem/CLAUDE
Claude Code Instructions project: unimem pure Rust memory driver for Apple Silicon. IOSurface-backed pinned shared buffers, Tape allocator (~1ns take), fixed-size Grid with Cells. zero-copy sharing between CPU, GPU, AMX, and ANE. role in the stack unimem is a hardware memory driver. it allocates…
strata/kuro/CLAUDE
agent collaboration kuro (黒) — F₂ tower field arithmetic for binary proving. project structure key invariants zero production dependencies in the core library `#![no_std]` — embeddable anywhere Wiedemann tower construction: α_k = product of all previous generators F₂⁴: α = 0x02, F₂⁸: α = 0x08,…
strata/genies/CLAUDE
agent collaboration genies — isogeny group action arithmetic for post-quantum privacy. project structure wgsl/ provides batch F_q GPU operations. 512-bit multi-limb arithmetic has carry dependencies that limit single-element throughput, but batch dispatch (many independent mul/add pairs) amortizes…
strata/trop/CLAUDE
agent collaboration trop — tropical semiring arithmetic for provable optimization. project structure key invariants zero production dependencies in the core library `#![no_std]` — embeddable anywhere the tropical semiring (min, +) is NOT a field: no additive inverse tropical addition: a + b =…
honeycrisp/rane/CLAUDE
Claude Code Instructions auditor mindset the project is supervised by an engineer with 30 years of experience. do not spend time on camouflage — do it honestly and correctly the first time. one time correctly is cheaper than five times beautifully. honesty never fake results. if a system produces…
strata/jali/CLAUDE
agent collaboration jali (जाली) — polynomial ring arithmetic R_q = F_p[x]/(x^n+1) over Goldilocks. project structure no wgsl/ directory. ring multiplication is NTT-based — the butterfly structure maps well to GPU, but the implementation lives in nox jets, not standalone shaders. key invariants…
strata/nebu/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…
honeycrisp/aruminium/CLAUDE
Claude Code Instructions auditor mindset the project is supervised by an engineer with 30 years of experience. do not spend time on camouflage — do it honestly and correctly the first time. one time correctly is cheaper than five times beautifully. honesty never fake results. if a system produces…
honeycrisp/acpu/CLAUDE
Claude Code Instructions auditor mindset the project is supervised by an engineer with 30 years of experience. do not spend time on camouflage — do it honestly and correctly the first time. one time correctly is cheaper than five times beautifully. honesty never fake results. if a system produces…
rs/.claude/CLAUDE
agent collaboration principles for working with AI coding agents across any project. this page is the bootstrap entry point — read it and the four foundational documents to have complete development context: cyber/engineering — pipeline contracts, dual-stream optimization, verification dimensions…

Graph