SkyRelay Node Operator Onboarding & Operations Guide
This technical documentation is intended for all Starlink dish owners and developers, detailing how to connect dishes to the SkyRelay space-based Doppler verification network via the local gRPC interface and receive automatic BSC on-chain gas subsidies and protocol reserve incentives.
01. Physical Operating Principles & Verification Architecture
SkyRelay never treats Starlink as a conventional internet router for tunneling blockchain packets. That merely shifts traffic from terrestrial fiber to a commercial ISP, providing no decentralization or cryptographic novelty.
What we actually do: directly listen to and extract the downlink Ku-band space microwave carrier signals (11.325 GHz) broadcast by LEO satellites.
- LEO Orbital Dynamics: Satellites pass overhead at approximately 7.6 km/s. The relative range rate between the spacecraft and the ground station generates an authentic, continuous, and physically unforgeable Doppler S-curve frequency shift (±25 kHz).
- Phased Array RF Front-End: Your Starlink dish contains hundreds of microstrip patch antenna elements whose high-frequency RF front-end continuously tracks downlink carrier beams every second.
- Local LAN gRPC Telemetry: SpaceX factory firmware exposes an unauthenticated gRPC telemetry endpoint on the local LAN (
192.168.100.1:9200) for local diagnostics to read elevation, azimuth, and physical carrier states.
02. Supported Hardware & Compatibility Matrix
Built-in Gigabit Ethernet port, 12V-48V DC power support. Ultra-low power consumption (20-40W), ideal for offshore islands, remote high-altitude stations, or mobile relay deployments.
Large-aperture high-performance phased array. Router includes 2 Gigabit Ethernet RJ-45 ports; plug-and-play with no extra adapters required.
Motor-actuated pointing edition. If using the OEM Wi-Fi router, connect the official Starlink Ethernet Adapter to expose an RJ-45 LAN port.
Enterprise/maritime high-gain wide-FOV phased array. 140° hemispherical sky dome visibility for highest-precision multi-satellite parallel tracking.
03. Step-by-Step Deployment
Connect your host machine (industrial PC, Raspberry Pi, home server, or desktop) to the Starlink local network via Ethernet. Run a ping probe in the terminal to verify connectivity with the dish diagnostic gateway:
ping 192.168.100.1
*Note: If using a third-party router with Bypass mode enabled, ensure your static route table routes 192.168.100.1 to the WAN dish interface.
Clone protocol repository from GitHub and install dependencies:
git clone https://github.com/SkyRelay/protocol cd protocol pnpm install
Provide your station callsign (e.g. NODE-BERLIN-01) and operator BSC wallet address for automated gas rebates and token rewards, then launch:
pnpm run node:start \ --dish-ip=192.168.100.1:9200 \ --station=YOUR_STATION_CALLSIGN \ --operator=YOUR_BSC_WALLET_ADDRESS \ --interval=60
04. Perturbation Doppler Invariants & EIP-712 Signatures
Once launched, the daemon autonomously executes the physical verification pipeline in the background:
Fetches verified Celestrak TLE ephemerides every 60s, computing 3D satellite state vectors and ground relative range rate vᵣ.
Evaluates theoretical frequency shift using downlink carrier f₀ = 11.325 GHz: Δf = -f₀ · (vᵣ / c).
Measured Doppler must converge with theoretical prediction within |Δf_obs - Δf_theo| < 12.0 Hz physical tolerance.
Upon verification, the node private key signs standard EIP-712 Typed Data, batched into multi-station Merkle Quorums for BSC submission.
05. Gas Subsidies & Protocol Rewards Mechanism
SkyRelay allocates a dedicated 1.25% Hardware & Verification Reserve in its tokenomics:
- 100% Automated Gas Rebate: Whenever your node's EIP-712 attestation is committed into a BSC block, the protocol contract automatically reimburses transaction gas to your
operatorwallet. - Station Weighting & Staking Rewards: Stations with high uptime, low phase jitter, and unobstructed sky views (obstruction < 15°) receive higher consensus weight and proportional monthly reward allocations.
06. v0.3.0 Protocol Capabilities & Developer Guide
Starlink satellites travel at 7.56 km/s at 550 km altitude, producing a net relativistic time dilation of -22.72 μs/day (special relativity slowing + gravitational acceleration) and a fixed transit Doppler inflection slope of -4,050 Hz/s. DeFi protocols attach this physical anchor to transactions to permanently eliminate timestamp manipulation and Time-Bandit MEV.
import { createRelativisticTimeAnchor } from "@skyrelay/core";
const anchor = createRelativisticTimeAnchor({
noradId: 47352, timestampSec: 1789934703,
elevationDeg: 65.2, rangeKm: 620.0, dopplerHz: -4680
});
// anchor.timeAnchorDigestHex provides unforgeable microsecond physical timestampsRelay nodes stake BNB in SkyRelayBond.sol to qualify as attesters. If a node signs conflicting telemetry within the same second, any observer can submit proof to slashEquivocation: the offender's bond is slashed to zero and 20%–50% of the bond is awarded directly to the hunter!
import { evaluateEquivocation, formatSlashEquivocationCall } from "@skyrelay/core";
const result = evaluateEquivocation(attA, sigA, attB, sigB, domain);
if (result.isSlashable) {
const call = formatSlashEquivocationCall(result.proof);
await bondContract.slashEquivocation(...call.args); // Hunter receives BNB bounty on-chain
}Supplies BNB Chain AI Agents with real LEO orbital state geometry (elevation, azimuth, range) and 256-bit unmanipulable physical space entropy extracted from multi-station microwave phase noise.
import { AutonomousAIGateway } from "@skyrelay/core";
const state = aiGateway.querySpaceState({ noradId: 47352, timestampSec, station });
const entropy = aiGateway.resolvePhysicalEntropy({ round, revealedSecrets });pnpm add @skyrelay/core ethersView Full Developer Guide on GitHub ↗07. Frequently Asked Questions (FAQ)
Not at all. The daemon only periodically queries the antenna's local read-only interface for lightweight telemetry metrics (< 1 KB) and clock status. It never routes normal user web traffic, using negligible resources (CPU < 1%, RAM < 50MB).
No hardware modifications or firmware changes are required or recommended. SpaceX factory firmware natively exposes this gRPC diagnostic endpoint on the local LAN as standard diagnostics.
With the Genesis 50 baseline mesh fully active worldwide, you can navigate to Node Portal under "Channel B" to apply for Phase II Infrastructure Grants. Phase II will fund additional Starlink units for operators in high-latitude, island, or remote regions to expand spatial mesh density toward 200 nodes.
Visit the Node Portal to use the interactive command generator or test local dish connectivity.