Release v17.2.0

Helm Release Notes

Date	Revision	Description
2026-02-19	0	Initial draft
2026-02-19	0	Initial release

0. Summary

Enhancements and breaking changes to the v17.1.0 Release, which includes:

Release summary points go here...

• Improved notification mechanism
• Inter-scheme discovery improvements
• FX error handling improvements
• Memory leak fixes to the TTK
• Fixes to the TTK in handling of spec / map files needed to run several test suites
• Improved logging (in select places not an overhaul, which is a work in progress, planned for post v17.2.0 release)

1. New Features

• mojaloop/#574 added validation of local destination for external source (mojaloop/#574), closes mojaloop/#574
• mojaloop/#578 improve inter-scheme discovery flow (mojaloop/#578), closes mojaloop/#578
• mojaloop/#604 updated deps (mojaloop/#604), closes mojaloop/#604
• mojaloop/#1207 enhance distributed lock management with automatic extension and fix metrics (mojaloop/#1207), closes mojaloop/#1207
• mojaloop/#610 add timeout to callback requests (mojaloop/#610), closes mojaloop/#610
• mojaloop/#447 updated central-service-shared (mojaloop/#447), closes mojaloop/#447
• mojaloop/#614 improve transfer status delivery effort (mojaloop/#614), closes mojaloop/#614
• mojaloop/#616 improved logging (mojaloop/#616), closes mojaloop/#616
• mojaloop/#617 improve certificate syncing (mojaloop/#617), closes mojaloop/#617

2. Bug Fixes

• mojaloop/#567 fixed handleError to set destination of errorCallback properly (mojaloop/#567), closes mojaloop/#567
• mojaloop/#568 updated delete party logic; added unit-test to check handleError failure (mojaloop/#568), closes mojaloop/#568
• mojaloop/#participants fixed PUT /participants/{ID} logic (mojaloop/#570), closes mojaloop/#participants
• mojaloop/#571 updated stream lib and event-sdk (mojaloop/#571), closes mojaloop/#571
• mojaloop/#581 returned only isActive proxies (mojaloop/#581), closes mojaloop/#581
• mojaloop/#599 updated deps (mojaloop/#599), closes mojaloop/#599
• mojaloop/#1210 added participantNotFound FSPIOP error (mojaloop/#1210), closes mojaloop/#1210
• mojaloop/#1212 use local lock with distlock (mojaloop/#1212), closes mojaloop/#1212
• mojaloop/#1218 participant limit cache could process transfer without erroring (mojaloop/#1218), closes mojaloop/#1218
• mojaloop/#1232 add condition on adjust limits (mojaloop/#1232), closes mojaloop/#1232
• mojaloop/#1253 do not modify the abort message in position handler #4317 (mojaloop/#1253), closes mojaloop/#1253
• mojaloop/#460 remove trailing zeros in response amounts #4302 (mojaloop/#460), closes mojaloop/#460
• mojaloop/#617 added generateHapiRoutes to avoid hapi routes manual definition (mojaloop/#617), closes mojaloop/#617
• mojaloop/#619 added process.on listeners; improved consumer healthCheck (mojaloop/#619), closes mojaloop/#619
• mojaloop/#626 updated deps (mojaloop/#626), closes mojaloop/#626
• mojaloop/#43 fixed missing Slack notifications of timeout (mojaloop/#43), closes mojaloop/#43
• mojaloop/#44 improved timeout Slack report (mojaloop/#44), closes mojaloop/#44
• mojaloop/#342 fix MyEmitter memory leak (mojaloop/#342), closes mojaloop/#342
• mojaloop/#349 added logs to output error (mojaloop/#349), closes mojaloop/#349
• mojaloop/#350 included ISO20022 messages in TTK report callbacks (mojaloop/#350), closes mojaloop/#350
• mojaloop/#371 download spec files issue #4197 (mojaloop/#371), closes mojaloop/#371
• mojaloop/#424 removed unneeded info from logs (mojaloop/#424), closes mojaloop/#424
• mojaloop/#fxTransfers logic of sending notifications ( changed PATCH transfers/fxTransfers logic of sending notifications (mojaloop/#605), closes [mojaloop/#fxTransfers logic of sending notifications (](https://github.com/mojaloop/project/issues/fxTransfers logic of sending notifications ()
• mojaloop/#607 updated deps (mojaloop/#607), closes mojaloop/#607
• mojaloop/#643 updated getTransfer to preserve existing transfer state in cache (mojaloop/#643), closes mojaloop/#643

3. Application Versions

1. central-event-processor: v12.1.1 -> v12.2.4 (Compare)
2. bulk-api-adapter: v17.2.2 -> v17.2.5 (Compare)
3. event-sidecar: v14.2.0 -> v14.2.1 (Compare)
4. ml-testing-toolkit-ui: v16.6.4 -> v16.7.4 (Compare)
5. als-oracle-pathfinder: v12.3.1 -> v12.3.4 (Compare)
6. ml-testing-toolkit: v18.15.0 -> v18.19.1 (Compare)
7. als-static-oracle-svc: -> v0.0.30 (Compare)
8. transaction-requests-service: v14.4.5 -> v14.4.7 (Compare)
9. ml-api-adapter: v16.5.9 -> v16.8.2 (Compare)
10. ml-testing-toolkit-client-lib: v1.10.3 -> v1.12.2 (Compare)
11. sdk-scheme-adapter: v24.10.5 -> v24.19.3 (Compare)
12. mojaloop-simulator: v15.4.2 -> v15.5.3 (Compare)
13. thirdparty-api-svc: v15.1.2 -> v15.1.5 (Compare)
14. als-consent-oracle: v1.1.4 -> v1.1.6 (Compare)
15. account-lookup-service: v17.12.2 -> v17.15.2 (Compare)
16. simulator: v12.3.2 -> v12.3.6 (Compare)
17. quoting-service: v17.12.1 -> v17.14.3 (Compare)
18. ml-ory-iam-services: -> "v0.1.1" (Compare)
19. central-ledger: v19.8.3 -> v19.12.8 (Compare)
20. central-settlement: v17.2.2 -> v17.3.3 (Compare)
21. email-notifier: v14.1.4 -> v14.1.7 (Compare)
22. auth-service: v15.2.7
23. als-msisdn-oracle-svc: v0.0.21
24. callback-handler-simulator-svc: v0.1.3
25. merchant-acquirer-backend: 1.0.1
26. merchant-acquirer-frontend: 1.0.1
27. inter-scheme-proxy-adapter: v1.3.3
28. merchant-registry-oracle: 1.0.1
29. thirdparty-sdk: v15.1.3
30. ml-core-test-harness: v2.3.0
31. event-stream-processor: v12.0.0-snapshot.14

4. API Versions

This release supports the following versions of the Mojaloop family of APIs:

API	Supported Versions	Notes
FSPIOP	v1.1, v1.0
Settlements	v2.0
Admin	v1.0
Oracle	v1.0
Thirdparty	v1.0

5. Testing notes

1. This release has been validated against the following Dependency Test Matrix:

   Dependency	Version	Notes
   Kubernetes	v1.29	AWS EKS, AWS EKS Supported Version Notes
   containerd	v1.6.19
   Nginx Ingress Controller	helm-ingress-nginx-4.7.0 / ingress-controller-v1.8.0
   Amazon Linux	v2
   MySQL	bitnami/mysql:8.0.32-debian-11-r0
   Kafka	bitnami/kafka:3.3.1-debian-11-r1
   Redis	bitnami/redis:7.0.5-debian-11-r7
   MongoDB	bitnami/mongodb:6.0.2-debian-11-r11
   Testing Toolkit Test Cases	v17.2.0
   example-mojaloop-backend	v17.2.0	README

2. It is recommended that all Mojaloop deployments are verified using the Mojaloop Testing Toolkit. More information can be found in the Mojaloop Deployment Guide.

3. The testing-toolkit-test-cases (See above Dependency Test Matrix for exact version required for this release) Golden Path collections expects:

   • the Quoting service operating mode to be set quoting-service.config.simple_routing_mode_enabled=true (in helm mojaloop/values.yaml under quoting-service config). If this is incorrectly configured, it will result in several failures in the quoting-service tests (7 expected failures). If this is disabled, ensure that you update the corresponding test-case environment variable parameter SIMPLE_ROUTING_MODE_ENABLED ( in helm mojaloop/values.yaml ml-testing-toolkit -> extraEnvironments.hub-k8s-default-environment.json.inputValues) to match.
   • the on-us transfers (in mojaloop/values.yaml "enable_on_us_transfers: false" under centralledger-handler-transfer-prepare -> config and cl-handler-bulk-transfer-prepare -> config) configuration to be disabled. The test-case environment variable parameter (ON_US_TRANSFERS_ENABLED (in helm mojaloop/values.yaml ml-testing-toolkit -> extraEnvironments.hub-k8s-default-environment.json.inputValues), the same name used on postman collections) must similarly match this value.

4. Simulators

   • We recommend using Testing Toolkit instead of Postman which is better suited for the async nature of the Mojaloop API specification (see above)
   • Mojaloop-Simulator is enabled by default (six instances used for single transfers usually and three more specific to bulk).
   • Ensure that correct Postman Scripts are used if you wish to test against the Mojaloop-Simulators:
     • Setup Mojaloop Hub: MojaloopHub_Setup
     • Setup Mojaloop Simulators for testing : MojaloopSims_Onboarding
     • Golden path tests: Golden_Path_Mojaloop
   • Legacy Simulators are still required and deployed by default; disabling this will cause issues since there is Account Lookup directory mocking functionality in this service.

5. Thirdparty Testing Toolkit Test Collections are not repeatable. Please refer to the following issue for more information #2717 - Thirdparty TTK Test-Collection is not repeatable. It is possible to manually cleanup persistent data to re-run the test if required.

6. Bulk API Helm Tests

   Refer to the Testing Deployments section in the main README for detailed information on how to enable bulk-api-adapter tests.

7. Thirdparty API Helm Tests

   Refer to thirdparty/README.md#validating-and-testing-the-3p-api on how to enabled and execute Thirdparty verification tests.

8. Testing the Bulk functionality including "sdk-scheme-adapter"

   For details regarding deployment and validation of simulators needed for bulk (for adoption provided in sdk-scheme-adapter) refer to deploying Mojaloop TTK simulators.

6. Breaking Changes

central-ledger

• migrations/310405_participantPositionChange-positionChange.js: (https://github.com/mojaloop/central-ledger/blob/be78a42de066e54995cd443a87743db87d100dcd/migrations%2F310405_participantPositionChange-positionChange.js)
• migrations/310406_participantPositionChange-positionChange-revert.js: (https://github.com/mojaloop/central-ledger/blob/be78a42de066e54995cd443a87743db87d100dcd/migrations%2F310406_participantPositionChange-positionChange-revert.js)
• migrations/961000_participantEndpoint_unique.js: (https://github.com/mojaloop/central-ledger/blob/be78a42de066e54995cd443a87743db87d100dcd/migrations%2F961000_participantEndpoint_unique.js)
• migrations/961001_transferForwarded.js: (https://github.com/mojaloop/central-ledger/blob/be78a42de066e54995cd443a87743db87d100dcd/migrations%2F961001_transferForwarded.js)
• migrations/961002_fxTransferForwarded.js: (https://github.com/mojaloop/central-ledger/blob/be78a42de066e54995cd443a87743db87d100dcd/migrations%2F961002_fxTransferForwarded.js)

ml-api-adapter

• config/default.json: (https://github.com/mojaloop/ml-api-adapter/blob/99d921942a5fd8f904516ad4e2dd41cbb69f9467/config%2Fdefault.json)

quoting-service

• config/default.json: (https://github.com/mojaloop/quoting-service/blob/e1f9ccc986f056b0bbe54545b690f94419b17f5a/config%2Fdefault.json)

account-lookup-service

• config/default.json: (https://github.com/mojaloop/account-lookup-service/blob/98989b58a03e3ab3d5a8856935217c45a4d87ed0/config%2Fdefault.json)
• docker/account-lookup-service/default.json: (https://github.com/mojaloop/account-lookup-service/blob/98989b58a03e3ab3d5a8856935217c45a4d87ed0/docker%2Faccount-lookup-service%2Fdefault.json)

7. Known Issues

1. #2119 - Idempotency for duplicate quote request
2. #2322 - Helm install failing with with "medium to large" release names
3. #2317 - Mojaloop Helm deployments are not compatible when deployed to ARM-arch based hosts
4. #2435 - Quoting-Service is incorrectly handling failed responses to FSPs when forwarding requests
5. Test issues causing instability/intermitant failures on Test Case Results
   1. #2717 - Thirdparty TTK Test-Collection is not repeatable
   2. #2925 - Helm Test Intermittent failure with 'Generic ID not found

8. Contributors

• Organizations: GF, InFiTX, MLF
• Individuals: @elnyry-sam-k, @geka-evk, @gibaros, @kalinkrustev, @kleyow, @oderayi, @shashi165, @s-prak, @vijayg10

Note: companies are in alphabetical order, individuals are in no particular order.

Full Changelog: v17.1.0...v17.2.0