Instance Method
getBootstrapStatus()
Fetch and parse Tor’s current bootstrap status.
func getBootstrapStatus() async throws -> BootstrapStatus?
Return Value
A BootstrapStatus populated with the current phase, or nil if the key is missing / unparsable.
Mentioned In
Discussion
Queries GETINFO status/bootstrap-phase (control-spec.txt §3.9) and runs the returned value through parseBootstrapStatus(_:). Returns nil when Tor hasn’t yet published a bootstrap phase (rare; typically observed immediately after start() resolves and before the Tor thread produces its first status).
Throws
Errors from getInfo(_:).
Note
waitUntilBootstrapped(timeout:) calls this method on a 1-second poll loop. Prefer the higher-level wait method unless you need custom polling cadence or progress UI.