traceRoute

abstract suspend fun traceRoute(dest: NodeId, hopLimit: Int = DEFAULT_HOP_LIMIT): AdminResult<RouteDiscovery>(source)

Send a RouteDiscovery request to dest and wait for the route_reply.

Return

on success, the RouteDiscovery populated with route (forward) + route_back plus per-hop SNR. On failure, an AdminResult error variant.

Parameters

dest

the destination NodeId.

hopLimit

maximum mesh hops the discovery may traverse. The mesh truncates the discovery if more nodes lie on the path. Default: 7 (firmware default).