IMPORTANT NOTE:
This article will be deprecated by February 28th, 2025. For all API Co-signer documentation, visit this overview article, which also links to updated Co-signer content in the Developer Portal.
Overview
Fireblocks regularly updates the API Co-Signer software with stability and feature improvements. This page includes information about the most recent API Co-Signer versions. It is always advisable to use the latest version published here.
Identifying the current API Co-Signer image version
To check your current API Co-Signer version, run the following command on your API Co-Signer server:
docker inspect cosigner | jq -r '.[0].Config.Image'
Image versions
3.7.1 (October 2024)
- Decreased signing latency along with general performance increases
- Remote management capabilities through Fireblocks Console
- Support for more types of approval requests
- Various fixed and improved handling of internal errors
- Timing details are logged after every outgoing network request
- The cosigner version will be reflected in the HTTP User-Agent header
3.6.5 (February 2024)
- Improved logging for easier problem-solving
- Improved stability, security, and performance
- More flexible deployment options
- Retry mechanism for callback
- Preliminary support for upcoming features
- Updated major and minor dependencies
3.5.0 (August 2023)
- The version includes the changes related to the MPC-CMP security enhancements
- Added support for co-signer retry mechanism enabling the callback handler to respond asynchronously
- Various bug fixes
3.3.0 (January 2022)
- Added support for HTTP network proxy on outbound requests
3.2.0 (December 2021)
- Upgrade the cosigner to a newer version
Older previous versions
- Upgrade the cosigner to a newer version
Validating your Cosigner Image
To check your current API Co-Signer version, run the following command on your API Co-Signer server:
docker inspect cosigner | jg -r '.[0].Config.Image +" " + .[0].Image'
Version | Image | Hash |
3.7.1 | registry.gitlab.com/customer-cosigner/v2/cosigner:3.7.1 | dee6ee331732 |
3.7.1 | registry.gitlab.com/customer-cosigner/v2/azure-cosigner:3.7.1 | aee652ba6fb2 |
3.6.5 | registry.gitlab.com/customer-cosigner/v2/cosigner:3.6.5 | 11c5f00e537f |
3.6.5 | registry.gitlab.com/customer-cosigner/v2/azure-cosigner:3.6.5 | b82921b1995b |
3.5.0 | registry.gitlab.com/customer-cosigner/v2/cosigner:3.5.0 | 87fd15ddac9b |
3.5.0 | registry.gitlab.com/customer-cosigner/v2/azure-cosigner:3.5.0 | f7e5eb2c73f2 |
3.4.0 | registry.gitlab.com/customer-cosigner/v2/cosigner:3.4.0 | 1bb0acc6d957 |
3.4.0 | registry.gitlab.com/customer-cosigner/v2/azure-cosigner:3.4.0 | 4dd4af752d62 |
3.3.0 | registry.gitlab.com/customer-cosigner/v2/cosigner:3.3.0 | 010a065c8220 |
3.3.0 | registry.gitlab.com/customer-cosigner/v2/azure-cosigner:3.3.0 | 6a0243327144 |
3.2.0 | registry.gitlab.com/customer-cosigner/v2/cosigner:3.2.0 | 8cd3fd63d420 |
3.2.0 | registry.gitlab.com/customer-cosigner/v2/azure-cosigner:3.2.0 | 901eb766e9aa |
3.1.0 | registry.gitlab.com/customer-cosigner/v2/azure-cosigner:3.1.0 | 1ddd4ec66b1e |
3.0.0 | registry.gitlab.com/customer-cosigner/v2/azure-cosigner:3.0.0 | 71da62e9ea1c |
Note
EU environment clients can expect different container images not present in this table.