Consensys/web3signer 25.12.0

on GitHub

Breaking Changes

Java25 Docker image

• Java 25, which is the latest Long-Term Support release, is used in the docker image instead of previous LTS version, Java 21.

/reload Endpoint Response Format Changed

• Now returns HTTP 202 Accepted (previously 200 OK) with JSON response body
• Returns 409 Conflict with error message if reload already in progress
• Migration: Update automation to expect 202 status code instead of 200

Removed Swagger UI CLI Option

• --swagger-ui-enabled option removed
• Access OpenAPI specs at https://consensys.github.io/web3signer/

Features Added

• Enhanced /reload endpoint with status monitoring:
  • New GET /reload endpoint to check reload operation status
  • Reports detailed status: idle, running, completed, completed_with_errors, failed
  • Exposes error counts when individual signer configurations fail to load
  • Distinguishes between complete success and partial success (some signers failed)
  • Provides timestamps and error messages for last reload operation
• Virtual thread-based signer loading for improved performance
• New file system signer loading configuration:
  • --signer-load-timeout (default: 60 sec) - Timeout per file during parallel processing
  • --signer-load-batch-size (default: 500) - Files processed per batch in parallel mode
  • --signer-load-sequential-threshold (default: 100) - Minimum files to trigger parallel processing
  • --signer-load-parallel (default: true) - Enable/disable parallel processing
• New /reload endpoint configuration:
  • --reload-timeout (default: 30 min) - Maximum time for entire reload operation
• Improved reload concurrency control prevents multiple simultaneous reloads
• Include Log4J JSON Template Layout library that provides predefined event templates such as ECS and GCP layouts in log4j configuration file. PR #1140.

Bugs Fixed

• Fix memory leak during reload API endpoint. Issue #1073 via PR #1135.
• Fix race condition in reload flag management when executor initialization fails synchronously

Downloads

Binaries

Docker

docker pull consensys/web3signer:25.12.0

Full Changelog: 25.11.0...25.12.0