Skip to content

fix(reticulum): make TCP Nomad page loads reliable after #756/#757 #759

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rinchen merged 4 commits into from
Aug 1, 2026
Merged

fix(reticulum): make TCP Nomad page loads reliable after #756/#757 #759

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
8952bd6
fix(reticulum): give TCP Nomad links a flat ~18s proof budget
rinchen Aug 1, 2026
5707bdd
fix(reticulum): scale TCP Nomad proof budget and clarify path retries
rinchen Aug 1, 2026
7354d43
fix(reticulum): prefer sidecar Nomad proof budget on retry countdown
rinchen Aug 1, 2026
a4dc126
fix(reticulum): keep Nomad path-probe accepts and oversized-link diags
rinchen Aug 1, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion docs/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1018,7 +1018,7 @@ In dev, **Start stack** now rebuilds when `reticulum-sidecar/src/**/*.rs` or `Ca
| ----------------------- | ------------------------------------------------------------------- |
| `path_timeout` | No route to the node (path lookup timed out) |
| `pubkey_not_found` | Destination identity key not cached yet — wait for a Nomad announce |
| `link_timeout` | Link could not be established in time |
| `link_timeout` | Link could not be established in time (UI may say path OK vs stale) |
| `response_timeout` | Link opened but page payload did not arrive in time |
| `missing_identity_hash` | No remembered identity for the node yet |
| `transport_unavailable` | Reticulum transport unavailable — restart stack |
Expand All @@ -1028,6 +1028,8 @@ In dev, **Start stack** now rebuilds when `reticulum-sidecar/src/**/*.rs` or `Ca

Unrecognized codes pass through unchanged.

TCP/network Nomad Links use path-scaled proof budgets (`link_hops = clamp(path_hops, 3, 7)` → ~18–42s), matching released v5.25.0 multi-hop behavior more closely than #756’s flat ~18s cap (a HEAD regression for slower hub peers). First attempts use a cached path when present (no DropPath storm); missing paths RequestPath briefly and may return `path_timeout`. Retries may DropPath + rediscover; `force_path_ok=true` means rediscovered after absence only (cache hits log `force_path_ok=false`). Failure logs (`[nomadNetworkStore] … fetch failed` and sidecar `Nomad Link query failed`) include `path_hops`, `link_hops`, `proof_budget_secs`, `force_path_ok`, `path_ensure`, `elapsed_ms`, and `raw=`. UI errors distinguish cached-path vs rediscovered-path link failures.

**Cause**: Older `LinkClient` always waited for a fresh path-response announce for the destination public key, even when Nomad announces had already cached it. Successful fetches could also deregister all `nomadnetwork.node` announce handlers. Distant/high-hop nodes can still time out at the path stage (expected RF/mesh reachability limits).

**Fix**:
Expand All @@ -1036,6 +1038,7 @@ Unrecognized codes pass through unchanged.
2. Rebuild sidecar: `pnpm run reticulum:sidecar:build`, restart stack.
3. Prefer low-hop nodes while testing; hop count is shown in the Nomad list.
4. Match the humanized message to the table above — `path_timeout` / high hops often mean RF reachability limits, not a mesh-client bug.
5. For TCP `link_timeout`, check log fields `path_hops` / `link_hops` / `proof_budget_secs` / `raw=` — UI hop counts can lag the path table; trust `path_hops`. Persistent fails after the full proof budget usually mean the peer/hub did not return LRPROOF.

### Reticulum sidecar stops during dev (Vite HMR)

Expand Down
Loading