Helm Release Notes

Date	Revision	Description
2025-10-21	0	Initial draft

0. Summary

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

Release summary points go here...

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/#1207 enhance distributed lock management with automatic extension and fix metrics (mojaloop/#1207), closes mojaloop/#1207
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/#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/#342 fix MyEmitter memory leak (mojaloop/#342), closes mojaloop/#342
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

3. Application Versions

central-event-processor: v12.1.1 -> v12.2.2 (Compare)
ml-testing-toolkit-ui: v16.6.4 -> v16.7.4 (Compare)
als-oracle-pathfinder: v12.3.1 -> v12.3.2 (Compare)
ml-testing-toolkit: v18.15.0 -> v18.16.2 (Compare)
transaction-requests-service: v14.4.5 -> v14.4.6 (Compare)
ml-testing-toolkit-client-lib: v1.10.3 -> v1.11.0 (Compare)
sdk-scheme-adapter: v24.10.5 -> v24.15.2 (Compare)
mojaloop-simulator: v15.4.2 -> v15.5.0 (Compare)
thirdparty-api-svc: v15.1.2 -> v15.1.3 (Compare)
als-consent-oracle: v1.1.4 -> v1.1.5 (Compare)
account-lookup-service: v17.12.2 -> v17.14.3 (Compare)
simulator: v12.3.2 -> v12.3.3 (Compare)
quoting-service: v17.12.1 -> v17.13.6 (Compare)
central-ledger: v19.8.3 -> v19.11.2 (Compare)
central-settlement: v17.2.2 -> v17.2.3 (Compare)
email-notifier: v14.1.4 -> v14.1.5 (Compare)
bulk-api-adapter: v17.2.2
event-sidecar: v14.2.0
auth-service: v15.2.7
als-msisdn-oracle-svc: v0.0.21
ml-api-adapter: v16.5.9
callback-handler-simulator-svc: v0.1.3
merchant-acquirer-backend: 1.0.1
merchant-acquirer-frontend: 1.0.1
inter-scheme-proxy-adapter: v1.3.3
merchant-registry-oracle: 1.0.1
thirdparty-sdk: v15.1.3
ml-core-test-harness: v2.3.0
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

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

It is recommended that all Mojaloop deployments are verified using the Mojaloop Testing Toolkit. More information can be found in the Mojaloop Deployment Guide.
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.
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.
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.
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.
Thirdparty API Helm Tests

Refer to thirdparty/README.md#validating-and-testing-the-3p-api on how to enabled and execute Thirdparty verification tests.
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/50f5efdfb9c6104808d5dda66ea1753f9d7253fb/migrations%2F310405_participantPositionChange-positionChange.js)
migrations/310406_participantPositionChange-positionChange-revert.js: (https://github.com/mojaloop/central-ledger/blob/50f5efdfb9c6104808d5dda66ea1753f9d7253fb/migrations%2F310406_participantPositionChange-positionChange-revert.js)
migrations/961000_participantEndpoint_unique.js: (https://github.com/mojaloop/central-ledger/blob/50f5efdfb9c6104808d5dda66ea1753f9d7253fb/migrations%2F961000_participantEndpoint_unique.js)

account-lookup-service

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

7. Known Issues

#2119 - Idempotency for duplicate quote request
#2322 - Helm install failing with with "medium to large" release names
#2317 - Mojaloop Helm deployments are not compatible when deployed to ARM-arch based hosts
#2435 - Quoting-Service is incorrectly handling failed responses to FSPs when forwarding requests
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: BMGF, InFiTX, MLF
Individuals: @devarsh10, @elnyry-sam-k, @geka-evk, @gibaros, @kalinkrustev, @kleyow, @oderayi, @shashi165, @vijayg10

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

Full Changelog: https://github.com/mojaloop/helm/compare/v17.1.0...v17.2.0

Oct 21 '25 08:10 mojaloopci

Removed the Kiwigrid Helm repository from general dependencies as the public repo (https://kiwigrid.github.io) has been deleted and is no longer maintained. This change is made to ensure smooth deployment and release without broken Helm dependencies. Kiwigrid previously provided Helm charts for Kubernetes utilities such as logging, monitoring, and configuration sidecars. A suitable replacement should be evaluated and added later if required.