{"record":{"id":"7da8f83de3983a44","repo":"tailscale/tailscale","slug":"checkpoint-aums-must-specify-the-state","errorCode":null,"errorMessage":"Checkpoint AUMs must specify the state","messagePattern":"Checkpoint AUMs must specify the state","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"tka/aum.go","lineNumber":207,"sourceCode":"\t\tif len(a.KeyID) == 0 {\n\t\t\treturn errors.New(\"RemoveKey AUMs must specify a key ID\")\n\t\t}\n\t\tif a.Key != nil || a.State != nil || a.Votes != nil || a.Meta != nil {\n\t\t\treturn errors.New(\"RemoveKey AUMs may only specify a KeyID\")\n\t\t}\n\tcase AUMUpdateKey:\n\t\tif len(a.KeyID) == 0 {\n\t\t\treturn errors.New(\"UpdateKey AUMs must specify a key ID\")\n\t\t}\n\t\tif a.Meta == nil && a.Votes == nil {\n\t\t\treturn errors.New(\"UpdateKey AUMs must contain an update to votes or key metadata\")\n\t\t}\n\t\tif a.Key != nil || a.State != nil {\n\t\t\treturn errors.New(\"UpdateKey AUMs may only specify KeyID, Votes, and Meta\")\n\t\t}\n\tcase AUMCheckpoint:\n\t\tif a.State == nil {\n\t\t\treturn errors.New(\"Checkpoint AUMs must specify the state\")\n\t\t}\n\t\tif a.KeyID != nil || a.Key != nil || a.Votes != nil || a.Meta != nil {\n\t\t\treturn errors.New(\"Checkpoint AUMs may only specify State\")\n\t\t}\n\n\tcase AUMNoOp:\n\tdefault:\n\t\t// An AUM with an unknown message kind was received! That means\n\t\t// that a future version of tailscaled added some feature we don't\n\t\t// understand.\n\t\t//\n\t\t// The future-compatibility contract for AUM message types is that\n\t\t// they must only add new features, not change the semantics of existing\n\t\t// mechanisms or features. As such, old clients can safely ignore them.\n\t}\n\n\treturn nil\n}","sourceCodeStart":189,"sourceCodeEnd":225,"githubUrl":"https://github.com/tailscale/tailscale/blob/6e0912f97994f927632b34ae9e63b53d6516a6ac/tka/aum.go#L189-L225","documentation":"AUM.StaticValidate requires a Checkpoint message to carry the full authority State it snapshots. It fires when State is nil.","triggerScenarios":"Thrown at tka/aum.go:207 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Populate State with the state being checkpointed"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"6e0912f97994f927632b34ae9e63b53d6516a6ac","analyzedAt":"2026-08-18T08:17:25.280Z","contentChangedAt":"2026-08-18T08:17:25.280Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}