account-lookup-service 17.7.1 → 17.8.0-snapshot.100

package/CHANGELOG.md

@@ -2,13 +2,6 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-### [17.7.1](https://github.com/mojaloop/account-lookup-service/compare/v17.7.0...v17.7.1) (2025-03-27)
-
-
-### Chore
-
-* **csi-1248:** update transform-lib, others ([#543](https://github.com/mojaloop/account-lookup-service/issues/543)) ([7a0a5c4](https://github.com/mojaloop/account-lookup-service/commit/7a0a5c402e8f8f28661540ea5982b1ac9a97a8dd))
-
 ## [17.7.0](https://github.com/mojaloop/account-lookup-service/compare/v17.6.0...v17.7.0) (2025-03-26)
 
 

package/docker/mock-proxy/src/server.ts

@@ -38,24 +38,26 @@ app.get('/health', (req: Request, res: Response) => {
 app.get('/parties/:type/:id', (req: Request, res: Response) => {
   const { type, id } = req.params;
   const headers = hubCbHeaders(req.headers);
-  console.log('parties request details:', { type, id, headers, CL_HOST, CL_PORT });
+  const statusCode = detectStatusCode(req);
+  console.log('parties request details:', { type, id, headers, CL_HOST, CL_PORT, statusCode });
 
   // todo: reply to CL with party info
 
   res
     .set(headers)
-    .status(202)
+    .status(statusCode)
     .json({ success: true });
 });
 
 app.put('/parties/:type/:id/error', (req: Request, res: Response) => {
   const { type, id } = req.params;
   const headers = dfspCbHeaders(req.headers);
-  console.log('parties put error request details:', { type, id, headers, CL_HOST, CL_PORT });
+  const statusCode = detectStatusCode(req);
+  console.log('parties put error request details:', { type, id, headers, CL_HOST, CL_PORT, statusCode });
 
   res
     .set(headers)
-    .status(200)
+    .status(statusCode)
     .json({ success: true });
 });
 
@@ -92,3 +94,10 @@ const httpsServer = http.createServer(app);
 httpsServer.listen(PROXY_PORT, () => {
   console.log(`Mock proxyAdapter "${PROXY_NAME}" is running on port ${PROXY_PORT}...`);
 });
+
+const X_RESPONSE_STATUS_HEADER = 'x-response-status';
+
+const detectStatusCode = (req: Request) =>
+  typeof req.headers[X_RESPONSE_STATUS_HEADER] === 'string'
+    ? parseInt(req.headers[X_RESPONSE_STATUS_HEADER], 10)
+    : (req.method === 'GET' ? 202 : 200);

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "account-lookup-service",
   "description": "Account Lookup Service is used to validate Party and Participant lookups.",
-  "version": "17.7.1",
+  "version": "17.8.0-snapshot.100",
   "license": "Apache-2.0",
   "author": "ModusBox",
   "contributors": [
+    "Eugen Klymniuk <eugen.klymniuk@infitx.com>",
     "Rajiv Mothilal <rajiv.mothilal@modusbox.com>",
     "Matt Kingston <matt.kingston@modusbox.com>",
     "Lewis Daly <lewisd@crosslaketech.com>",
@@ -44,10 +45,8 @@
     "start:api": "node src/index.js server --api",
     "start:admin": "node src/index.js server --admin",
     "start:handlers": "node src/handlers/index.js handlers --timeout",
-    "standard": "standard",
-    "standard:fix": "standard --fix",
-    "lint": "npm run standard",
-    "lint:fix": "npm run standard:fix",
+    "lint": "standard",
+    "lint:fix": "standard --fix",
     "dev": "nodemon src/index.js server",
     "test": "npm run test:unit",
     "test:unit": "NODE_OPTIONS='--experimental-vm-modules --max-old-space-size=8192' jest --runInBand",
@@ -93,21 +92,21 @@
     "@hapi/vision": "7.0.3",
     "@mojaloop/central-services-error-handling": "13.0.7",
     "@mojaloop/central-services-health": "15.0.4",
-    "@mojaloop/central-services-logger": "11.8.0",
+    "@mojaloop/central-services-logger": "11.8.1",
     "@mojaloop/central-services-metrics": "12.5.0",
-    "@mojaloop/central-services-shared": "18.23.1",
+    "@mojaloop/central-services-shared": "18.23.2",
     "@mojaloop/central-services-stream": "11.5.2",
     "@mojaloop/database-lib": "11.1.4",
     "@mojaloop/event-sdk": "14.4.0",
     "@mojaloop/inter-scheme-proxy-cache-lib": "2.4.0",
     "@mojaloop/ml-schema-transformer-lib": "2.7.0",
-    "@mojaloop/sdk-standard-components": "19.11.2",
+    "@mojaloop/sdk-standard-components": "19.11.3-snapshot.0",
     "@now-ims/hapi-now-auth": "2.1.0",
     "ajv": "8.17.1",
     "ajv-keywords": "5.1.0",
     "blipp": "4.0.2",
     "commander": "13.1.0",
-    "cron": "4.1.1",
+    "cron": "4.1.3",
     "fast-safe-stringify": "^2.1.1",
     "hapi-auth-bearer-token": "8.0.0",
     "joi": "17.13.3",
@@ -190,5 +189,9 @@
     "scripts": {
       "postchangelog": "replace '\\[mojaloop/#(\\d+)\\]\\(https://github.com/mojaloop/(.*)/issues/(\\d+)\\)' '[mojaloop/#$1](https://github.com/mojaloop/project/issues/$1)' CHANGELOG.md"
     }
+  },
+  "imports": {
+    "#src/*": "./src/*.js",
+    "#test/*": "./test/*.js"
   }
 }

package/src/constants.js

@@ -1,9 +1,41 @@
+/*****
+ License
+ --------------
+ Copyright © 2020-2025 Mojaloop Foundation
+ The Mojaloop files are made available by the Mojaloop Foundation under the Apache License, Version 2.0 (the "License") and you may not use these files except in compliance with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, the Mojaloop files are distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+
+ Contributors
+ --------------
+ This is the official list of the Mojaloop project contributors for this file.
+ Names of the original copyright holders (individuals or organizations)
+ should be listed with a '*' in the first column. People who have
+ contributed from an organization can be listed under the organization
+ that actually holds the copyright for their contributions (see the
+ Mojaloop Foundation for an example). Those individuals should have
+ their names indented and be marked with a '-'. Email address can be added
+ optionally within square brackets <email>.
+
+ * Mojaloop Foundation
+ * Eugen Klymniuk <eugen.klymniuk@infitx.com>
+
+ --------------
+ ******/
+
+const { API_TYPES } = require('@mojaloop/central-services-shared').Util.Hapi
+
 const ERROR_MESSAGES = Object.freeze({
+  emptyFilteredPartyList: 'Empty oracle partyList, filtered based on callbackEndpointType',
+  failedToCacheSendToProxiesList: 'Failed to cache sendToProxiesList',
+  noDiscoveryRequestsForwarded: 'No discovery requests forwarded to participants',
   sourceFspNotFound: 'Requester FSP not found',
   partyDestinationFspNotFound: 'Destination FSP not found',
   partyProxyNotFound: 'Proxy not found',
-  proxyConnectionError: 'Proxy connection error',
-  failedToCacheSendToProxiesList: 'Failed to cache sendToProxiesList'
+  proxyConnectionError: 'Proxy connection error - no successful requests sent to proxies',
+  noSuccessfulProxyDiscoveryResponses: 'No successful proxy discovery responses'
 })
 
 const HANDLER_TYPES = Object.freeze({
@@ -11,6 +43,7 @@ const HANDLER_TYPES = Object.freeze({
 })
 
 module.exports = {
+  API_TYPES,
   ERROR_MESSAGES,
   HANDLER_TYPES
 }

package/src/domain/parties/deps.js

@@ -25,18 +25,25 @@
  --------------
  ******/
 
-const { proxies } = require('@mojaloop/central-services-shared').Util
+const { Util } = require('@mojaloop/central-services-shared')
+const { logger } = require('../../lib')
+const config = require('../../lib/config')
 const oracle = require('../../models/oracle/facade')
 const participant = require('../../models/participantEndpoint/facade')
-const config = require('../../lib/config')
 const partiesUtils = require('./partiesUtils')
 
-const createDeps = ({ cache, proxyCache, childSpan, log, stepState }) => Object.freeze({
+/** @returns {PartiesDeps} */
+const createDeps = ({
+  cache,
+  proxyCache,
+  proxies = Util.proxies,
+  childSpan = null,
+  log = logger
+}) => Object.freeze({
   cache,
   proxyCache,
   childSpan,
   log,
-  stepState,
   config,
   oracle,
   participant,

package/src/domain/parties/getPartiesByTypeAndID.js

@@ -50,26 +50,22 @@ const getPartiesByTypeAndID = async (headers, params, method, query, span, cache
     ['success']
   ).startTimer()
   const childSpan = span ? span.getChild(component) : undefined
-  const log = logger.child({ component, params })
-  const stepState = libUtil.initStepState()
-
-  const deps = createDeps({ cache, proxyCache, childSpan, log, stepState })
-  const service = new GetPartiesService(deps)
-  const results = {}
+  const deps = createDeps({ cache, proxyCache, childSpan })
+  const service = new GetPartiesService(deps, { headers, params, query })
+  let fspiopError
 
   try {
-    await service.handleRequest({ headers, params, query, results })
-    log.info('getPartiesByTypeAndID is done')
+    await service.handleRequest()
+    logger.info('getPartiesByTypeAndID is done')
     histTimerEnd({ success: true })
   } catch (error) {
-    const { requester } = results
-    results.fspiopError = await service.handleError({ error, requester, headers, params })
+    fspiopError = await service.handleError(error)
     histTimerEnd({ success: false })
-    if (results.fspiopError) {
-      libUtil.countFspiopError(results.fspiopError, { operation: component, step: stepState.step })
+    if (fspiopError) {
+      libUtil.countFspiopError(fspiopError, { operation: component, step: service.currenStep })
     }
   } finally {
-    await libUtil.finishSpanWithError(childSpan, results.fspiopError)
+    await libUtil.finishSpanWithError(childSpan, fspiopError)
   }
 }
 

package/src/domain/parties/partiesUtils.js

@@ -25,13 +25,9 @@
  --------------
  ******/
 
-const { Enum, Util: { Hapi } } = require('@mojaloop/central-services-shared')
-const { MojaloopApiErrorCodes } = require('@mojaloop/sdk-standard-components').Errors
-// todo: check why do we need sdk-standard-components deps here !!!
-const ErrorHandler = require('@mojaloop/central-services-error-handling')
-
-const participant = require('../../models/participantEndpoint/facade')
+const { Enum } = require('@mojaloop/central-services-shared')
 const { TransformFacades } = require('../../lib')
+const { API_TYPES } = require('../../constants')
 
 const { FspEndpointTypes } = Enum.EndPoints
 const { Headers } = Enum.Http
@@ -50,7 +46,7 @@ const errorPartyCbType = (partySubId) => partySubId
 
 const makePutPartiesErrorPayload = async (config, fspiopError, headers, params) => {
   const body = fspiopError.toApiErrorObject(config.ERROR_HANDLING)
-  return config.API_TYPE === Hapi.API_TYPES.iso20022
+  return config.API_TYPE === API_TYPES.iso20022
     ? (await TransformFacades.FSPIOP.parties.putError({ body, headers, params })).body
     : body
 }
@@ -81,38 +77,12 @@ const swapSourceDestinationHeaders = (headers) => {
   }
 }
 
-// todo: check if we need this function
-const createErrorHandlerOnSendingCallback = (config, logger) => async (err, headers, params, requester) => {
-  try {
-    logger.error('error in sending parties callback: ', err)
-    const sendTo = requester || headers[Headers.FSPIOP.SOURCE]
-    const errorCallbackEndpointType = errorPartyCbType(params.SubId)
-    const fspiopError = ErrorHandler.Factory.reformatFSPIOPError(err)
-    const errInfo = await makePutPartiesErrorPayload(config, fspiopError, headers, params)
-
-    await participant.sendErrorToParticipant(sendTo, errorCallbackEndpointType, errInfo, headers, params)
-
-    logger.info('handleErrorOnSendingCallback in done', { sendTo, params, errInfo })
-    return fspiopError
-  } catch (exc) {
-    // We can't do anything else here- we _must_ handle all errors _within_ this function because
-    // we've already sent a sync response- we cannot throw.
-    logger.error('failed to handleErrorOnSendingCallback. No further processing! ', exc)
-  }
-}
-
-function isNotValidPayeeCase (payload) {
-  return payload?.errorInformation?.errorCode === MojaloopApiErrorCodes.PAYEE_IDENTIFIER_NOT_VALID.code
-}
-
 module.exports = {
   getPartyCbType,
   putPartyCbType,
   errorPartyCbType,
   makePutPartiesErrorPayload,
-  createErrorHandlerOnSendingCallback,
   alsRequestDto,
   partiesRequestOptionsDto,
-  swapSourceDestinationHeaders,
-  isNotValidPayeeCase
+  swapSourceDestinationHeaders
 }

package/src/domain/parties/putParties.js

@@ -29,7 +29,6 @@
 
 'use strict'
 
-const { Headers } = require('@mojaloop/central-services-shared').Enum.Http
 const Metrics = require('@mojaloop/central-services-metrics')
 const libUtil = require('../../lib/util')
 const { logger } = require('../../lib')
@@ -37,9 +36,7 @@ const { createDeps } = require('./deps')
 const services = require('./services')
 
 /**
- * @function putPartiesByTypeAndID
- *
- * @description This sends a callback to inform participant of successful lookup
+ * Sends a callback to inform participant of successful lookup
  *
  * @param {object} headers - incoming http request headers
  * @param {object} params - uri parameters of the http request
@@ -58,45 +55,25 @@ const putPartiesByTypeAndID = async (headers, params, method, payload, dataUri,
     ['success']
   ).startTimer()
   // const childSpan = span ? span.getChild(component) : undefined
-  const log = logger.child({ component, params })
-  const stepState = libUtil.initStepState()
-
-  const deps = createDeps({ cache, proxyCache, log, stepState })
-  const service = new services.PutPartiesService(deps)
-  const results = {}
-
-  const source = headers[Headers.FSPIOP.SOURCE]
-  const destination = headers[Headers.FSPIOP.DESTINATION]
-  const proxy = headers[Headers.FSPIOP.PROXY]
-  log.info('putPartiesByTypeAndID start', { source, destination, proxy })
+  const deps = createDeps({ cache, proxyCache })
+  const service = new services.PutPartiesService(deps, { headers, params, payload, dataUri })
+  let fspiopError
 
   try {
-    await service.validateSourceParticipant({ source, proxy })
-
-    if (proxy) {
-      await service.checkProxySuccessResponse({ destination, source, headers, params })
-    }
-
-    const sendTo = await service.identifyDestinationForSuccessCallback(destination)
-    results.requester = sendTo
-    await service.sendSuccessCallback({ sendTo, headers, params, dataUri })
-
-    log.info('putPartiesByTypeAndID callback was sent', { sendTo })
+    await service.handleRequest()
+    logger.info('putPartiesByTypeAndID is done')
     histTimerEnd({ success: true })
   } catch (error) {
-    const { requester } = results
-    results.fspiopError = await service.handleError({ error, requester, headers, params })
-    if (results.fspiopError) {
-      libUtil.countFspiopError(results.fspiopError, { operation: component, step: stepState.step })
+    fspiopError = await service.handleError(error)
+    if (fspiopError) {
+      libUtil.countFspiopError(fspiopError, { operation: component, step: service.currenStep })
     }
     histTimerEnd({ success: false })
   }
 }
 
 /**
- * @function putPartiesErrorByTypeAndID
- *
- * @description This populates the cache of endpoints
+ * Sends error callback to inform participant of failed lookup
  *
  * @param {object} headers - incoming http request headers
  * @param {object} params - uri parameters of the http request
@@ -114,53 +91,31 @@ const putPartiesErrorByTypeAndID = async (headers, params, payload, dataUri, spa
     ['success']
   ).startTimer()
   const childSpan = span ? span.getChild(component) : undefined
-  const log = logger.child({ component, params })
-  const stepState = libUtil.initStepState()
-
-  const deps = createDeps({ cache, proxyCache, childSpan, log, stepState })
-  const service = new services.PutPartiesErrorService(deps)
-  const results = {}
-
-  const destination = headers[Headers.FSPIOP.DESTINATION]
-  const proxy = headers[Headers.FSPIOP.PROXY]
-  const proxyEnabled = !!(deps.config.PROXY_CACHE_CONFIG.enabled && proxyCache)
-  log.info('putPartiesErrorByTypeAndID start', { destination, proxy, proxyEnabled })
+  const deps = createDeps({ cache, proxyCache, childSpan })
+  const inputs = { headers, params, payload, dataUri }
+  const service = new services.PutPartiesErrorService(deps, inputs)
+  let fspiopError
 
   try {
-    if (proxyEnabled && proxy) {
-      const notValid = await service.checkPayee({ headers, params, payload, proxy })
-      if (notValid) {
-        const getPartiesService = new services.GetPartiesService(deps)
-        // todo: think, if we need to remove destination header before starting new discovery
-        await getPartiesService.handleRequest({ headers, params, results })
-        log.info('putPartiesErrorByTypeAndID triggered new discovery flow')
-        histTimerEnd({ success: true })
-        return
-      }
-
-      const isLast = await service.checkLastProxyCallback({ destination, proxy, params })
-      if (!isLast) {
-        log.info('putPartiesErrorByTypeAndID proxy callback was processed', { proxy })
-        histTimerEnd({ success: true })
-        return
-      }
+    const needDiscovery = await service.handleRequest()
+    if (needDiscovery) {
+      const getPartiesService = new services.GetPartiesService(deps, inputs)
+      await getPartiesService.triggerInterSchemeDiscoveryFlow(
+        services.GetPartiesService.headersWithoutDestination(headers)
+      )
+      // think, if we need to start the whole processing with getPartiesService.handleRequest() ?
     }
 
-    const sendTo = await service.identifyDestinationForErrorCallback(destination)
-    results.requester = sendTo
-    await service.sendErrorCallbackToParticipant({ sendTo, headers, params, dataUri })
-
-    log.info('putPartiesErrorByTypeAndID callback was sent', { sendTo })
+    logger.info('putPartiesErrorByTypeAndID is done')
     histTimerEnd({ success: true })
   } catch (error) {
-    const { requester } = results
-    results.fspiopError = await service.handleError({ error, requester, headers, params })
-    if (results.fspiopError) {
-      libUtil.countFspiopError(results.fspiopError, { operation: component, step: stepState.step })
+    fspiopError = await service.handleError(error)
+    if (fspiopError) {
+      libUtil.countFspiopError(fspiopError, { operation: component, step: service.currenStep })
     }
     histTimerEnd({ success: false })
   } finally {
-    await libUtil.finishSpanWithError(childSpan, results.fspiopError)
+    await libUtil.finishSpanWithError(childSpan, fspiopError)
   }
 }
 

package/src/domain/parties/services/BasePartiesService.js

@@ -26,33 +26,94 @@
  ******/
 
 const ErrorHandler = require('@mojaloop/central-services-error-handling')
-const { decodePayload } = require('@mojaloop/central-services-shared').Util.StreamingProtocol
 const { Enum } = require('@mojaloop/central-services-shared')
+const { decodePayload } = require('@mojaloop/central-services-shared').Util.StreamingProtocol
+const { initStepState } = require('../../../lib/util')
+const { createCallbackHeaders } = require('../../../lib/headers')
 
 const { FspEndpointTypes, FspEndpointTemplates } = Enum.EndPoints
 const { Headers, RestMethods } = Enum.Http
 
+/**
+ * @typedef {Object} PartiesDeps
+ * @property {Object} cache
+ * @property {Object} proxyCache
+ * @property {Object} log
+ * @property {Object} config
+ * @property {Object} oracle
+ * @property {Object} participant
+ * @property {Proxies} proxies
+ * @property {Object} partiesUtils
+ * @property {Object} [childSpan]
+ */
+
+/**
+ * Input parameters from party lookup request
+ *
+ * @typedef {Object} PartiesInputs
+ * @property {Object} headers - incoming http request headers.
+ * @property {Object} params - uri parameters of the http request.
+ * @property {Object} [payload] - payload of the request being sent out.
+ * @property {Object} [query] - uri query parameters of the http request
+ * @property {string} [dataUri] - encoded payload of the request being sent out.
+ */
+
+/**
+ * Any calculated values we get during request processing
+ *
+ * @typedef {Object} PartiesModelState
+ * @property {string} destination - The destination DFSP ID from headers
+ * @property {string} source - The source DFSP ID from headers
+ * @property {string} [proxy] - The proxy DFSP ID from headers, if present
+ * @property {string} requester - The entity initiating the request (either a DFSP in scheme or a proxy)
+ * @property {boolean} proxyEnabled - Indicates whether proxy functionality is enabled in the current configuration
+ * @property {StepState} stepState - Processing steps state
+ */
+
 class BasePartiesService {
-  constructor (deps) {
-    this.deps = deps
-    this.log = this.deps.log.child({ component: this.constructor.name })
-    this.proxyEnabled = !!(deps.config.PROXY_CACHE_CONFIG?.enabled && deps.proxyCache)
+  #deps // see PartiesDeps
+  #inputs // see PartiesInputs
+  #state // see PartiesModelState
+
+  /**
+   * @param {PartiesDeps} deps - The dependencies required by the class instance.
+   * @param {PartiesInputs} inputs - The input parameters from incoming http request.
+   * @return {void}
+   */
+  constructor (deps, inputs) {
+    this.#deps = Object.freeze(deps)
+    this.#inputs = Object.freeze(inputs)
+    this.#state = this.#initiateState()
+    this.log = this.deps.log.child({
+      component: this.constructor.name,
+      params: this.inputs.params
+    })
   }
 
-  // async handleRequest () {
-  //   throw new Error('handleRequest must be implemented by subclass')
-  // }
+  /** @returns {PartiesDeps} */
+  get deps () { return this.#deps }
+
+  /** @returns {PartiesInputs} */
+  get inputs () { return this.#inputs }
 
-  async handleError ({ error, requester, headers, params }) {
+  /** @returns {PartiesModelState} */
+  get state () { return this.#state }
+
+  async handleError (error) {
+    const { params } = this.inputs
     const log = this.log.child({ method: 'handleError' })
     try {
       log.error('error in processing parties request: ', error)
-      const sendTo = requester || headers[Headers.FSPIOP.SOURCE]
       const fspiopError = ErrorHandler.Factory.reformatFSPIOPError(error)
-      const errorInfo = await this.deps.partiesUtils.makePutPartiesErrorPayload(this.deps.config, fspiopError, headers, params)
-
-      await this.sendErrorCallback({ sendTo, errorInfo, headers, params })
-      log.info('handleError in done', { sendTo, errorInfo })
+      const callbackHeaders = BasePartiesService.createErrorCallbackHeaders(this.inputs.headers, params)
+      const errorInfo = await this.deps.partiesUtils.makePutPartiesErrorPayload(this.deps.config, fspiopError, callbackHeaders, params)
+
+      await this.sendErrorCallback({
+        errorInfo,
+        headers: callbackHeaders,
+        params
+      })
+      log.info('handleError in done')
       return fspiopError
     } catch (exc) {
       // We can't do anything else here- we _must_ handle all errors _within_ this function because
@@ -62,26 +123,94 @@ class BasePartiesService {
   }
 
   async validateParticipant (participantId) {
+    this.stepInProgress('validateParticipant')
     return this.deps.participant.validateParticipant(participantId)
   }
 
-  async sendErrorCallback ({ sendTo, errorInfo, headers, params, payload = undefined }) {
+  async sendErrorCallback ({ errorInfo, headers, params }) {
+    this.stepInProgress('sendErrorCallback')
+    const sendTo = this.state.requester || this.state.source
     const endpointType = this.deps.partiesUtils.errorPartyCbType(params.SubId)
+
     await this.deps.participant.sendErrorToParticipant(
-      sendTo, endpointType, errorInfo, headers, params, payload, this.deps.childSpan
+      sendTo, endpointType, errorInfo, headers, params, undefined, this.deps.childSpan
     )
-    this.log.verbose('sendErrorCallback is done', { sendTo, errorInfo })
+    this.log.info('sendErrorCallback is done', { sendTo, errorInfo })
   }
 
   async sendDeleteOracleRequest (headers, params) {
+    this.stepInProgress('sendDeleteOracleRequest')
     return this.deps.oracle.oracleRequest(headers, RestMethods.DELETE, params, null, null, this.deps.cache)
   }
 
+  async removeProxyGetPartiesTimeoutCache (alsReq) {
+    const isRemoved = await this.deps.proxyCache.removeProxyGetPartiesTimeout(alsReq, this.state.proxy)
+    this.log.debug('removeProxyGetPartiesTimeoutCache is done', { isRemoved, alsReq })
+    return isRemoved
+  }
+
+  createFspiopIdNotFoundError (errMessage, log = this.log) {
+    log.warn(errMessage)
+    return ErrorHandler.Factory.createFSPIOPError(ErrorHandler.Enums.FSPIOPErrorCodes.ID_NOT_FOUND, errMessage)
+  }
+
+  stepInProgress (stepName) {
+    this.log.debug('step is in progress', { stepName })
+    this.state.stepState?.inProgress(stepName)
+  }
+
+  get currenStep () {
+    return this.state.stepState?.step
+  }
+
+  /** @returns {PartiesModelState} */
+  #initiateState () {
+    const { headers } = this.inputs
+    return {
+      destination: headers[Headers.FSPIOP.DESTINATION],
+      source: headers[Headers.FSPIOP.SOURCE],
+      proxy: headers[Headers.FSPIOP.PROXY],
+      requester: '', // dfsp in scheme  OR  proxy
+      proxyEnabled: !!(this.deps.config.PROXY_CACHE_CONFIG?.enabled && this.deps.proxyCache),
+      stepState: initStepState()
+    }
+  }
+
   static decodeDataUriPayload (dataUri) {
     const decoded = decodePayload(dataUri, { asParsed: false })
     return decoded.body.toString()
   }
 
+  static headersWithoutDestination (headers) {
+    const { [Headers.FSPIOP.DESTINATION]: _, ...restHeaders } = headers || {}
+    return restHeaders
+  }
+
+  static overrideDestinationHeader (headers, destination) {
+    return {
+      ...BasePartiesService.headersWithoutDestination(headers),
+      ...(destination && { [Headers.FSPIOP.DESTINATION]: destination })
+    }
+  }
+
+  static createErrorCallbackHeaders (headers, params) {
+    return createCallbackHeaders({
+      requestHeaders: headers,
+      partyIdType: params.Type,
+      partyIdentifier: params.ID,
+      endpointTemplate: params.SubId
+        ? FspEndpointTemplates.PARTIES_SUB_ID_PUT_ERROR
+        : FspEndpointTemplates.PARTIES_PUT_ERROR
+    })
+  }
+
+  static createHubErrorCallbackHeaders (hubName, destination) {
+    return {
+      [Headers.FSPIOP.SOURCE]: hubName,
+      [Headers.FSPIOP.DESTINATION]: destination
+    }
+  }
+
   static enums () {
     return {
       FspEndpointTypes,