Skip to content
This repository was archived by the owner on Jul 12, 2026. It is now read-only.

SNAPKITTYWEST/bob-voyager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BOB VOYAGER — Forth ISS Orbital Oracle

Live ISS telemetry · Forth stack machine · WORM-sealed audit chain · Apache 2.0

"No syntax. Just a stack. NASA runs Forth. So does BOB."

NORAD 25544 · ISS ZARYA · SnapKitty Collective · 2026


What it is

A real-time aerospace telemetry system tracking the International Space Station via a Forth stack machine. Every orbital calculation — vis-viva velocity, delta-v, orbital period, ground footprint — runs as a Forth word on a live stack. All telemetry is WORM-sealed with SHA-256 chained hashes.

Architecture

wheretheiss.at API
       ↓ (every 4.5s)
  src/server.mjs          ← Node.js backend (zero dependencies)
       ├── /api/telemetry  ← ISS position + full Keplerian elements + 6 ground stations
       ├── /api/worm       ← WORM chain audit log (last 50 seals)
       ├── /api/track      ← Historical positions (last 200 points)
       ├── /api/orbital    ← Pure orbital mechanics endpoint
       ├── /api/groundstations  ← Contact angles + distances to SF/JSC/TsUP/JAXA/ESA/Baikonur
       └── /api/health     ← Service status + WORM head
       ↓
  public/index.html        ← Forth interpreter + Canvas globe
  data/worm_chain.jsonl    ← Cryptographic audit log (append-only)
  data/telemetry.jsonl     ← Full telemetry history (append-only)

API Endpoints

Endpoint Description
GET /api/telemetry Live ISS position + orbital elements + ground station distances
GET /api/worm Last 50 WORM chain entries (SHA-256 chained)
GET /api/track Last 200 telemetry positions for orbit trail
GET /api/groundstations SF · JSC · TsUP · JAXA · ESA · Baikonur contact status
GET /api/orbital Keplerian elements (no external call)
GET /api/health Service health + WORM count + uptime

Orbital Mechanics

All physics uses standard aerospace constants:

  • μ = 398,600.4418 km³/s² (Earth gravitational parameter)
  • Vis-Viva: v² = μ(2/r − 1/a)
  • Period: T = 2π√(a³/μ)
  • Inclination: 51.6° (ISS orbital plane)
  • Eccentricity: 0.0001698 (near-circular)
  • NORAD ID: 25544 (ISS ZARYA, launched 1998-11-20)

Forth Words (client)

Word Description
ISS.LAT / LON / ALT / VEL Push live ISS telemetry onto stack
ORBITAL.PERIOD T = 2π√(r³/μ) in minutes
VIS.VIVA Instantaneous orbital velocity (km/s)
SEMI.MAJOR Semi-major axis (km)
MEAN.MOTION Revolutions per day
APOGEE / PERIGEE Orbit extremes (km)
FOOTPRINT Ground visibility radius (km)
ECLIPSE ISS in Earth shadow? (1/0)
DELTA.V Delta-v to reboost to 420km nominal
DIST.SF / JSC / TSUP / JAXA Distance to ground stations
ELEV.SF Elevation angle from San Francisco
WORM.SEAL Cryptographically seal top-of-stack

WORM Chain

Every telemetry update is cryptographically chained:

hash_n = SHA-256( hash_{n-1} | event | timestamp )

Written to data/worm_chain.jsonl. Append-only. Tamper-evident. Same principle as blockchain finality — applied to mission data.

Running

node src/server.mjs
# → http://localhost:4299

No npm install needed. Zero dependencies. Node 18+ only.

SEIT Educational Layer

BOB VOYAGER is deployed by Saint Errant Digital Institute (SEIT) as live aerospace curriculum.

A student types VIS.VIVA . → gets the actual orbital velocity of the ISS. They type DELTA.V . → see the fuel cost to raise the orbit. They type FOOTPRINT . → understand why ISS sees 2,800 km in every direction.

No textbook. No simulation. Real NORAD telemetry. Real physics. Real audit trail.


Apache License 2.0 — SnapKitty Collective · Bel Esprit D'Accord Trust · 2026 snapkittywest.github.io · Evidence or Silence

About

[ARCHIVED] BOB VOYAGER — Forth ISS Orbital Oracle. Live telemetry · WORM-sealed · Apache 2.0 · SnapKitty Collective — SSL v3.0

Topics

Resources

License

Stars

3 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors