TailscaleErrorCode enum
Structured category for operation failures.
Lets callers branch on common outcomes without string-matching
TailscaleException.message. Maps to the distinctions the Go
LocalAPI surface
exposes (e.g. IsAccessDeniedError, IsPreconditionsFailedError).
Values
- lifecycleBusy → const TailscaleErrorCode
-
Another start/stop transition currently owns the process lifecycle.
- runtimeCleanupFailed → const TailscaleErrorCode
-
Native teardown or state cleanup failed; restart before further use.
- configurationMismatch → const TailscaleErrorCode
-
Immutable active-runtime configuration differs from the request.
- staleRuntime → const TailscaleErrorCode
-
The operation belongs to a node runtime that has already stopped.
- dataPlaneNotReady → const TailscaleErrorCode
-
The node has not completed its Running/publication bootstrap gate.
- publicationBootstrapFailure → const TailscaleErrorCode
-
The mandatory first-Up publication reset failed for this runtime.
- serveConfigConflict → const TailscaleErrorCode
-
ServeConfig changed during all bounded mutation attempts.
- publicationNotApplied → const TailscaleErrorCode
-
The publication mutation conclusively did not reach ServeConfig.
- publicationCommitIndeterminate → const TailscaleErrorCode
-
A ServeConfig mutation may have applied before its result was lost.
- startupAbandoned → const TailscaleErrorCode
-
Native startup was quarantined before it could publish a runtime.
- stateLeaseBusy → const TailscaleErrorCode
-
Another process or isolate owns the persistent StateStore lease.
- invalidStateKey → const TailscaleErrorCode
-
The persistent StateStore DEK was not exactly 32 raw bytes.
- missingStateKey → const TailscaleErrorCode
-
An encrypted state envelope exists but its Keybay DEK is absent.
- orphanedStateKey → const TailscaleErrorCode
-
Keybay contains a DEK but the corresponding state envelope is absent.
- localResetIncomplete → const TailscaleErrorCode
-
A previously authorized local reset has not completed.
- conflictingStateFormats → const TailscaleErrorCode
-
Legacy plaintext SQLite/FileStore and encrypted artifacts coexist.
- legacyStateUnsupported → const TailscaleErrorCode
-
A pre-launch plaintext SQLite/FileStore requires explicit local forget.
- unexpectedStateResidue → const TailscaleErrorCode
-
The package state subtree contains unrecognized residual files.
- atomicPersistenceFailure → const TailscaleErrorCode
-
An interrupted atomic envelope write could not be safely recovered.
- stateAuthenticationFailed → const TailscaleErrorCode
-
The Keybay key did not authenticate the encrypted envelope.
- unsupportedStateFormat → const TailscaleErrorCode
-
The encrypted envelope uses a newer or unsupported format tuple.
- invalidStateFormat → const TailscaleErrorCode
-
The encrypted envelope or its security metadata is malformed.
- secureStorageLocked → const TailscaleErrorCode
-
The platform keystore is locked or requires unavailable interaction.
-
Keybay cannot safely access its platform-protected container.
- secureStorageBusy → const TailscaleErrorCode
-
Another live writer currently owns Keybay's mutation lock.
- startupTimeout → const TailscaleErrorCode
-
The caller deadline expired and the matching runtime was quarantined.
- logoutIndeterminate → const TailscaleErrorCode
-
Upstream logout may have completed; local recovery evidence was retained.
- workerTerminated → const TailscaleErrorCode
-
The supervised control isolate exited unexpectedly.
- notFound → const TailscaleErrorCode
-
Target does not exist (unknown node, waiting file, profile, route...).
- forbidden → const TailscaleErrorCode
-
Authenticated but the tailnet's ACLs disallow the action.
- conflict → const TailscaleErrorCode
-
Another concurrent writer landed first (ETag / version mismatch).
- preconditionFailed → const TailscaleErrorCode
-
A required precondition is not met — node not running, tailnet feature disabled, missing capability, etc.
- featureDisabled → const TailscaleErrorCode
-
The tailnet feature this call depends on is disabled by the operator (Funnel off, MagicDNS off, Taildrop off, …).
- unknown → const TailscaleErrorCode
-
Anything the runtime didn't categorize.
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
- index → int
-
A numeric identifier for the enumerated value.
no setterinherited
- name → String
-
Available on Enum, provided by the EnumName extension
The name of the enum value.no setter - runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toString(
) → String -
A string representation of this object.
inherited
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited
Constants
-
values
→ const List<
TailscaleErrorCode> - A constant List of the values in this enum, in order of their declaration.