com.blockether.vis.internal.gateway.pairing — com.blockether/vis 0.1.7

Gateway pairing helpers for remote clients.

The QR payload is deliberately tiny and URL-shaped so native apps can scan it without an HTTP round trip:

vis://gateway?url=http%3A%2F%2F100.64.0.10%3A7890&token=...

Tailscale fits naturally: if a 100.64.0.0/10 interface is present we prefer it over LAN addresses, otherwise we fall back to site-local IPv4 addresses.

candidate-hosts clj

(candidate-hosts bind-host)

Reachable hostnames/IPs worth showing in a pairing QR, in preference order. Tailscale addresses come first because they keep working off-LAN; then LAN; then the server's bind host when concrete.

pairing-json clj

(pairing-json {:keys [host port token require-token?] :as opts})

pairing-url clj

(pairing-url {:keys [host port token]})

print-pairing! clj

(print-pairing! {:keys [require-token? emit] :or {emit println} :as opts})

Emit the companion pairing block (title, reachable hosts, vis:// URL, and a terminal QR). Each line goes through emit (default println); CLI callers whose stdout is redirected to the log file pass a real-terminal writer so the QR is actually visible. Returns the pairing URL payload.

tailscale-hosts clj

(tailscale-hosts)

Tailscale (100.64/10) IPv4 addresses currently bound to a live interface, in discovery order. Empty when Tailscale is not up, so callers can fall back to LAN / 0.0.0.0 guidance.

terminal-qr clj

(terminal-qr text)

Render text as a terminal QR code using Unicode half-blocks. Returns a string so tests and CLI callers can decide where to print it.