Merge pull request #2654 from Roasbeef/build/go-1.27.3
What changed, and why it matters
This commit updates the Go programming language toolchain used to build btcd from version 1.27.2 to 1.27.3, and bumps the minimum required Go version from 1.26.9 to 1.26.10. The README explicitly says this is to include a mitigation for CVE-2026-111943, which affects Go 1.27.0 through 1.27.2. The commit itself only changes version numbers and documentation; it does not contain the actual Go security fix. It is a routine dependency/security maintenance patch.
Verify that production builds, release pipelines, and developer environments are using Go 1.27.3 (or 1.26.10 on the 1.26 branch) or newer. Review the Go 1.27.3 release notes and CVE-2026-111943 details to understand the underlying vulnerability and whether running binaries compiled with older Go versions require recompilation or rotation of sensitive material.
Security signals we found
Toolchain point-release upgrade
README references CVE-2026-111943 mitigation
Minimum Go version bumped across all go.mod files
Docker/CI image digests updated to patched Go release
No direct code-level vulnerability fix present in diff
Evidence from the diff
The diff updates Docker base images, CI workflow GO_VERSION, go.mod language version directives across all submodules, and README/release documentation from Go 1.27.2/1.26.9 to Go 1.27.3/1.26.10. The README adds a note that Go 1.27.0-1.27.2 lack the CVE-2026-111943 mitigation. No application code is modified. The security effect is indirect: it ensures builds use a patched Go runtime/compiler and signals to downstream users the minimum safe Go version.
Changed components
Build toolchain (Go compiler/runtime)CI/CD configuration (.github/workflows/main.yml, .github/workflows/Dockerfile)Release build DockerfileAll go.mod modules (minimum Go language version)Documentation (README.md, release/README.md)Inspect captured patch +24 / −19
### .github/workflows/Dockerfile
@@ -5,7 +5,7 @@
###########################
# Build binaries stage
###########################
-FROM --platform=$BUILDPLATFORM golang:1.27.2-alpine3.24@sha256:85dc1069ac644ea3c527b177303a406eb3358192816cd7f9e5848eb658851673 AS build
+FROM --platform=$BUILDPLATFORM golang:1.27.3-alpine3.24@sha256:f2c872bcee949b7be9c490efd02b48a8a2fbf947cdf533f1c58525ec9d8170fd AS build
ADD . /app
WORKDIR /app
# Arguments required to build binaries targetting the correct OS and CPU architectures
### .github/workflows/main.yml
@@ -6,7 +6,7 @@ env:
GOCACHE: /home/runner/work/go/pkg/build
GOPATH: /home/runner/work/go
GOBIN: /home/runner/work/go/bin
- GO_VERSION: 1.27.2
+ GO_VERSION: 1.27.3
jobs:
build:
### Dockerfile
@@ -19,11 +19,11 @@ ARG ARCH=amd64
# https://github.com/opencontainers/image-spec/blob/main/descriptor.md#digests
# https://cloud.google.com/architecture/using-container-images
# https://github.com/google/go-containerregistry/blob/main/cmd/crane/README.md
-# ➜ ~ crane digest golang:1.27.2-alpine3.24
-# sha256:85dc1069ac644ea3c527b177303a406eb3358192816cd7f9e5848eb658851673
+# ➜ ~ crane digest golang:1.27.3-alpine3.24
+# sha256:f2c872bcee949b7be9c490efd02b48a8a2fbf947cdf533f1c58525ec9d8170fd
# Build on the host platform and cross-compile for ARCH, so no emulation is
# needed for other architectures.
-FROM --platform=$BUILDPLATFORM golang@sha256:85dc1069ac644ea3c527b177303a406eb3358192816cd7f9e5848eb658851673 AS build-container
+FROM --platform=$BUILDPLATFORM golang@sha256:f2c872bcee949b7be9c490efd02b48a8a2fbf947cdf533f1c58525ec9d8170fd AS build-container
ARG ARCH
### README.md
@@ -36,18 +36,23 @@ which are both under active development.
## Requirements
-[Go](http://golang.org) 1.26.9 or newer.
+[Go](http://golang.org) 1.26.10 or newer.
### Go version policy
btcd is built with the newest Go release and requires the previous one, which
still receives point releases. Both are kept at the latest point release of
their branch:
-- CI, the Docker images and release binaries are built with Go 1.27.2, the
+- CI, the Docker images and release binaries are built with Go 1.27.3, the
`GO_VERSION` in `.github/workflows/main.yml`.
- The `go` line in every `go.mod`, which sets the minimum Go version and the
- language version, is Go 1.26.9.
+ language version, is Go 1.26.10.
+
+The `go` directive sets only a minimum version, so it cannot encode the
+patched release floor for each supported Go branch. Use Go 1.26.10 or newer
+on the Go 1.26 branch, and Go 1.27.3 or newer on the Go 1.27 branch. Go
+1.27.0 through 1.27.2 do not include the CVE-2026-111943 mitigation.
Both are bumped when Go publishes a point release, and both move up a branch
when a new major version of Go is released. A weekly CI job checks this against
### address/go.mod
@@ -1,6 +1,6 @@
module github.com/btcsuite/btcd/address/v2
-go 1.26.9
+go 1.26.10
require (
github.com/btcsuite/btcd/btcec/v2 v2.5.0
### btcec/go.mod
@@ -1,6 +1,6 @@
module github.com/btcsuite/btcd/btcec/v2
-go 1.26.9
+go 1.26.10
require (
github.com/btcsuite/btcd/chainhash/v2 v2.0.0
### btcutil/go.mod
@@ -1,6 +1,6 @@
module github.com/btcsuite/btcd/btcutil/v2
-go 1.26.9
+go 1.26.10
require (
github.com/aead/siphash v1.0.1
### chaincfg/go.mod
@@ -1,6 +1,6 @@
module github.com/btcsuite/btcd/chaincfg/v2
-go 1.26.9
+go 1.26.10
require (
github.com/btcsuite/btcd/chainhash/v2 v2.0.0
### chainhash/go.mod
@@ -1,3 +1,3 @@
module github.com/btcsuite/btcd/chainhash/v2
-go 1.26.9
+go 1.26.10
### go.mod
@@ -1,6 +1,6 @@
module github.com/btcsuite/btcd
-go 1.26.9
+go 1.26.10
require (
github.com/btcsuite/btcd/address/v2 v2.0.0
### psbt/go.mod
@@ -1,6 +1,6 @@
module github.com/btcsuite/btcd/psbt/v2
-go 1.26.9
+go 1.26.10
require (
github.com/btcsuite/btcd/address/v2 v2.0.0
### release/README.md
@@ -100,7 +100,7 @@ Release binaries are built with the same Go version as CI, the `GO_VERSION` in
`.github/workflows/main.yml` (see the Go version policy in the
[README](../README.md#go-version-policy)). `release.sh` refuses to run with any
other version. If a different Go is installed, let the `go` command fetch the
-right one, for example `GOTOOLCHAIN=go1.27.2 ./release/release.sh <TAG>`.
+right one, for example `GOTOOLCHAIN=go1.27.3 ./release/release.sh <TAG>`.
### Pushing a release (for maintainers)
### txscript/go.mod
@@ -1,6 +1,6 @@
module github.com/btcsuite/btcd/txscript/v2
-go 1.26.9
+go 1.26.10
require (
github.com/btcsuite/btcd/address/v2 v2.0.0
### v2transport/go.mod
@@ -1,6 +1,6 @@
module github.com/btcsuite/btcd/v2transport
-go 1.26.9
+go 1.26.10
require (
github.com/btcsuite/btcd/btcec/v2 v2.5.0
### wire/go.mod
@@ -1,6 +1,6 @@
module github.com/btcsuite/btcd/wire/v2
-go 1.26.9
+go 1.26.10
require (
github.com/btcsuite/btcd/chainhash/v2 v2.0.0Why this scored 44/100
Community notes
Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.
The AI analysis stands alone for now. Submit a note if you can add evidence or important context.