multi: bump Go toolchain to 1.25, build CI with 1.26.3
What changed, and why it matters
This commit simply updates the Go programming language version required to build the project from 1.22/1.23.2 to 1.25, and updates the continuous integration build environment to use Go 1.26.3. It also fixes documentation that incorrectly stated the minimum version. There are no code logic changes and no security vulnerability is introduced or fixed.
No security action required. Treat as routine maintenance. Reviewers may want to verify that Go 1.25/1.26.3 do not introduce build or compatibility issues for downstream consumers, but this is a normal dependency/toolchain management concern, not a security issue.
Security signals we found
No strong security signals were identified.
Evidence from the diff
The patch is a pure toolchain/version bump across 11 files: go.mod files for the root module and submodules (btcec, btcutil, btcutil/psbt, chaincfg/chainhash, v2transport) are changed from ‘go 1.22’ or ‘go 1.23.2’ to ‘go 1.25’. CI configuration (.github/workflows/main.yml) now uses GO_VERSION 1.26.3, and the Dockerfile uses golang:1.26-alpine. README.md and docs are updated to state Go 1.25 as the minimum. No source code, algorithms, or security-sensitive behavior is modified.
Changed components
go.mod version directivesCI build configuration (.github/workflows/main.yml)Docker build image (.github/workflows/Dockerfile)README.mddocs/code_contribution_guidelines.mddocs/installation.mdInspect captured patch +11 / −11
diff --git a/.github/workflows/Dockerfile b/.github/workflows/Dockerfile
index baf7f7f..81fff52 100644
--- a/.github/workflows/Dockerfile
+++ b/.github/workflows/Dockerfile
@@ -5,7 +5,7 @@
###########################
# Build binaries stage
###########################
-FROM --platform=$BUILDPLATFORM golang:1.23-alpine AS build
+FROM --platform=$BUILDPLATFORM golang:1.26-alpine AS build
ADD . /app
WORKDIR /app
# Arguments required to build binaries targetting the correct OS and CPU architectures
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index 4ae3f2b..f290248 100644
--- a/.github/workflows/main.yml
+++ b/.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.22.11
+ GO_VERSION: 1.26.3
jobs:
build:
diff --git a/README.md b/README.md
index b5d9146..53e7887 100644
--- a/README.md
+++ b/README.md
@@ -36,7 +36,7 @@ which are both under active development.
## Requirements
-[Go](http://golang.org) 1.22 or newer.
+[Go](http://golang.org) 1.25 or newer.
## Installation
diff --git a/btcec/go.mod b/btcec/go.mod
index 8f00b8a..6e27d27 100644
--- a/btcec/go.mod
+++ b/btcec/go.mod
@@ -1,6 +1,6 @@
module github.com/btcsuite/btcd/btcec/v2
-go 1.22
+go 1.25
require (
github.com/btcsuite/btcd/chaincfg/chainhash v1.2.0
diff --git a/btcutil/go.mod b/btcutil/go.mod
index 00cd4d9..1e57a54 100644
--- a/btcutil/go.mod
+++ b/btcutil/go.mod
@@ -1,6 +1,6 @@
module github.com/btcsuite/btcd/btcutil
-go 1.23.2
+go 1.25
require (
github.com/aead/siphash v1.0.1
diff --git a/btcutil/psbt/go.mod b/btcutil/psbt/go.mod
index b1c4ac1..26a6057 100644
--- a/btcutil/psbt/go.mod
+++ b/btcutil/psbt/go.mod
@@ -1,6 +1,6 @@
module github.com/btcsuite/btcd/btcutil/psbt
-go 1.23.2
+go 1.25
require (
github.com/btcsuite/btcd v0.24.2
diff --git a/chaincfg/chainhash/go.mod b/chaincfg/chainhash/go.mod
index 538221a..3f7b82a 100644
--- a/chaincfg/chainhash/go.mod
+++ b/chaincfg/chainhash/go.mod
@@ -1,3 +1,3 @@
module github.com/btcsuite/btcd/chaincfg/chainhash
-go 1.22
+go 1.25
diff --git a/docs/code_contribution_guidelines.md b/docs/code_contribution_guidelines.md
index ecfa0f9..d9c8e79 100644
--- a/docs/code_contribution_guidelines.md
+++ b/docs/code_contribution_guidelines.md
@@ -316,7 +316,7 @@ Rejoice as you will now be listed as a [contributor](https://github.com/btcsuite
## Contribution Checklist
-- [ ] All changes are Go version 1.22 compliant
+- [ ] All changes are Go version 1.25 compliant
- [ ] The code being submitted is commented according to the
[Code Documentation and Commenting](#CodeDocumentation) section
- [ ] For new code: Code is accompanied by tests which exercise both
diff --git a/docs/installation.md b/docs/installation.md
index 71a6e01..565d0d5 100644
--- a/docs/installation.md
+++ b/docs/installation.md
@@ -5,7 +5,7 @@ details on how to install on the supported operating systems.
## Requirements
-[Go](http://golang.org) 1.22 or newer.
+[Go](http://golang.org) 1.25 or newer.
## GPG Verification Key
diff --git a/go.mod b/go.mod
index 83ec4d3..04fe6ce 100644
--- a/go.mod
+++ b/go.mod
@@ -66,6 +66,6 @@ retract (
v0.13.0-beta
)
-go 1.23.2
+go 1.25
replace github.com/btcsuite/btcd/btcutil => ./btcutil
diff --git a/v2transport/go.mod b/v2transport/go.mod
index 30b1505..d41bbea 100644
--- a/v2transport/go.mod
+++ b/v2transport/go.mod
@@ -1,6 +1,6 @@
module github.com/btcsuite/btcd/v2transport
-go 1.23.2
+go 1.25
require (
github.com/btcsuite/btcd/btcec/v2 v2.4.0
Why this scored 15/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.