temporalio/temporal · error

invalid checksum payload version %v

Error message

invalid checksum payload version %v

What it means

Error "invalid checksum payload version %v" thrown in temporalio/temporal.

Source

Thrown at service/history/workflow/checksum.go:32

const (
	mutableStateChecksumPayloadV1 = int32(1)
)

func generateMutableStateChecksum(ms historyi.MutableState) (*persistencespb.Checksum, error) {
	payload := newMutableStateChecksumPayload(ms)
	csum, err := checksum.GenerateCRC32(payload, mutableStateChecksumPayloadV1)
	if err != nil {
		return nil, err
	}
	return csum, nil
}

func verifyMutableStateChecksum(
	ms historyi.MutableState,
	csum *persistencespb.Checksum,
) error {
	if csum.Version != mutableStateChecksumPayloadV1 {
		return fmt.Errorf("invalid checksum payload version %v", csum.Version)
	}
	payload := newMutableStateChecksumPayload(ms)
	return checksum.Verify(payload, csum)
}

func newMutableStateChecksumPayload(ms historyi.MutableState) *checksumspb.MutableStateChecksumPayload {
	executionInfo := ms.GetExecutionInfo()
	executionState := ms.GetExecutionState()
	payload := &checksumspb.MutableStateChecksumPayload{
		CancelRequested:              executionInfo.CancelRequested,
		State:                        executionState.State,
		LastFirstEventId:             executionInfo.LastFirstEventId,
		NextEventId:                  ms.GetNextEventID(),
		LastProcessedEventId:         executionInfo.LastCompletedWorkflowTaskStartedEventId,
		ActivityCount:                executionInfo.ActivityCount,
		ChildExecutionCount:          executionInfo.ChildExecutionCount,
		UserTimerCount:               executionInfo.UserTimerCount,
		RequestCancelExternalCount:   executionInfo.RequestCancelExternalCount,

View on GitHub (pinned to bde624efd1)

When it happens

Trigger: Thrown at service/history/workflow/checksum.go:32 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of temporalio/temporal@bde624efd1 (2026-09-01). Data as JSON: /api/errors/46afd81acbca7554. Report an issue: GitHub.