account-lookup-service 15.5.0-iso.0

package/src/models/participantEndpoint/facade.js

@@ -0,0 +1,238 @@
+/*****
+ License
+ --------------
+ Copyright © 2017 Bill & Melinda Gates Foundation
+ The Mojaloop files are made available by the Bill & Melinda Gates 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
+ Gates Foundation organization 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>.
+ * Gates Foundation
+ - Name Surname <name.surname@gatesfoundation.com>
+
+ - Rajiv Mothilal <rajiv.mothilal@modusbox.com>
+ - Juan Correa <juan.correa@modusbox.com>
+ - Miguel de Barros <miguel.debarros@modusbox.com>
+ --------------
+ ******/
+
+'use strict'
+
+const Logger = require('@mojaloop/central-services-logger')
+const Util = require('@mojaloop/central-services-shared').Util
+const Enums = require('@mojaloop/central-services-shared').Enum
+const ErrorHandler = require('@mojaloop/central-services-error-handling')
+const JwsSigner = require('@mojaloop/sdk-standard-components').Jws.signer
+const Metrics = require('@mojaloop/central-services-metrics')
+const Config = require('../../lib/config')
+const { hubNameRegex } = require('../../lib/util').hubNameConfig
+const uriRegex = /(?:^.*)(\/(participants|parties|quotes|transfers)(\/.*)*)$/
+
+/**
+ * @module src/models/participantEndpoint/facade
+ */
+
+const defineJwsSigner = (config, headers, requestedEndpoint) => {
+  let jwsSigner = null
+
+  if (config.JWS_SIGN && headers[Enums.Http.Headers.FSPIOP.SOURCE] === config.FSPIOP_SOURCE_TO_SIGN) {
+    // We need below 2 headers for JWS
+    headers[Enums.Http.Headers.FSPIOP.HTTP_METHOD] = headers[Enums.Http.Headers.FSPIOP.HTTP_METHOD] || Enums.Http.RestMethods.PUT
+    headers[Enums.Http.Headers.FSPIOP.URI] = headers[Enums.Http.Headers.FSPIOP.URI] || uriRegex.exec(requestedEndpoint)[1]
+    Logger.isDebugEnabled && Logger.debug('JWS is enabled, getting JwsSigner')
+    jwsSigner = new JwsSigner({
+      logger: Logger,
+      signingKey: config.JWS_SIGNING_KEY
+    })
+  }
+
+  return jwsSigner
+}
+
+/**
+ * @function sendRequest
+ *
+ * @description it gets the applicable endpoints and sends through the response to them
+ *
+ * @param {object} headers - incoming http request headers
+ * @param {string} requestedParticipant - the participant the request needs to be sent to
+ * @param {string} endpointType - the type of endpoint being requested
+ * @param {string} method - the http method
+ * @param {object} payload - payload of the request being sent out
+ * @param {object} options - the options to be used in the template
+ * @param {object} span
+ *
+ * @returns {object} - Returns http response from request endpoint
+ */
+exports.sendRequest = async (headers, requestedParticipant, endpointType, method = undefined, payload = undefined, options = undefined, span = undefined) => {
+  // Get endpoint for participant
+  let requestedEndpoint
+  const histTimerEndGetParticipantEndpoint = Metrics.getHistogram(
+    'egress_getParticipantEndpoint',
+    'Egress: Get Endpoint of participant',
+    ['success', 'endpointType', 'participantName']
+  ).startTimer()
+  try {
+    requestedEndpoint = await Util.Endpoints.getEndpoint(Config.SWITCH_ENDPOINT, requestedParticipant, endpointType, options || undefined)
+    histTimerEndGetParticipantEndpoint({ success: true, endpointType, participantName: requestedParticipant })
+    Logger.isDebugEnabled && Logger.debug(`participant endpoint url: ${requestedEndpoint} for endpoint type ${endpointType}`)
+  } catch (err) {
+    histTimerEndGetParticipantEndpoint({ success: false, endpointType, participantName: requestedParticipant })
+    Logger.isErrorEnabled && Logger.error(`error in getEndpoint: ${err?.stack}`)
+    throw ErrorHandler.Factory.reformatFSPIOPError(err)
+  }
+
+  // Send request to participant
+  const histTimerEndSendRequestToParticipant = Metrics.getHistogram(
+    'egress_sendRequestToParticipant',
+    'Egress: Send request to participant',
+    ['success', 'endpointType', 'participantName']
+  ).startTimer()
+  try {
+    // Injected Configuration for outbound Content-Type & Accept headers.
+    const protocolVersions = {
+      content: Config.PROTOCOL_VERSIONS.CONTENT.DEFAULT.toString(),
+      accept: Config.PROTOCOL_VERSIONS.ACCEPT.DEFAULT.toString()
+    }
+    const jwsSigner = defineJwsSigner(Config, headers, requestedEndpoint)
+
+    const resp = await Util.Request.sendRequest({
+      url: requestedEndpoint,
+      headers,
+      source: headers[Enums.Http.Headers.FSPIOP.SOURCE],
+      destination: headers[Enums.Http.Headers.FSPIOP.DESTINATION],
+      method,
+      payload,
+      responseType: Enums.Http.ResponseTypes.JSON,
+      span,
+      jwsSigner,
+      protocolVersions,
+      hubNameRegex,
+      apiType: Config.API_TYPE
+    })
+    histTimerEndSendRequestToParticipant({ success: true, endpointType, participantName: requestedParticipant })
+    return resp
+  } catch (err) {
+    histTimerEndSendRequestToParticipant({ success: false, endpointType, participantName: requestedParticipant })
+    Logger.isErrorEnabled && Logger.error(`error in sendRequest: ${err?.stack}`)
+
+    throw ErrorHandler.Factory.reformatFSPIOPError(err)
+  }
+}
+
+/**
+ * @function validateParticipant
+ *
+ * @description sends a request to central-ledger to retrieve participant details and validate that they exist within the switch
+ *
+ * @param {string} fsp The FSPIOP-Source fsp id
+ * @returns the participants info in a successful case and
+ */
+exports.validateParticipant = async (fsp) => {
+  const histTimerEnd = Metrics.getHistogram(
+    'egress_validateParticipant',
+    'Egress: Validate participant',
+    ['success']
+  ).startTimer()
+  try {
+    const resp = await Util.Participants.getParticipant(Config.SWITCH_ENDPOINT, fsp)
+    histTimerEnd({ success: true })
+    return resp
+  } catch (err) {
+    histTimerEnd({ success: false })
+    Logger.isErrorEnabled && Logger.error(`error in validateParticipant: ${err?.stack}`)
+    throw ErrorHandler.Factory.reformatFSPIOPError(err)
+  }
+}
+
+/**
+ * @function sendErrorToParticipant
+ *
+ * @description it gets the applicable endpoints and sends through an error message
+ *
+ * @param {string} participantName - the participant the request needs to be sent to
+ * @param {string} endpointType - the type of endpoint being requested
+ * @param {object} errorInformation - payload of the error information being sent out
+ * @param {object} headers - incoming http request headers
+ * @param {object} params - uri parameters of the http request
+ * @param {object} payload - payload of the request being sent out
+ * @param {object} span
+ *
+ * @returns {object} - Returns http response from request endpoint
+ */
+exports.sendErrorToParticipant = async (participantName, endpointType, errorInformation, headers, params = {}, payload = undefined, span = undefined) => {
+  // Get endpoint for participant
+  let requesterErrorEndpoint
+  const histTimerEndGetParticipantEndpoint = Metrics.getHistogram(
+    'egress_getParticipantEndpoint',
+    'Egress: Get Endpoint of participant',
+    ['success', 'endpointType', 'participantName']
+  ).startTimer()
+  try {
+    const { requestId } = payload || {}
+
+    requesterErrorEndpoint = await Util.Endpoints.getEndpoint(Config.SWITCH_ENDPOINT, participantName, endpointType, {
+      partyIdType: params.Type || undefined,
+      partyIdentifier: params.ID || undefined,
+      partySubIdOrType: params.SubId || undefined,
+      requestId
+    })
+    histTimerEndGetParticipantEndpoint({ success: true, endpointType, participantName })
+  } catch (err) {
+    histTimerEndGetParticipantEndpoint({ success: false, endpointType, participantName })
+    Logger.isWarnEnabled && Logger.warn(`error in getEndpoint: ${err?.message}`)
+    throw ErrorHandler.Factory.reformatFSPIOPError(err)
+  }
+
+  // Send error to participant
+  const histTimerEndSendRequestToParticipant = Metrics.getHistogram(
+    'egress_sendRequestToParticipant',
+    'Egress: Send request to participant',
+    ['success', 'endpointType', 'participantName']
+  ).startTimer()
+  try {
+    // Injected Configuration for outbound Content-Type & Accept headers.
+    const protocolVersions = {
+      content: Config.PROTOCOL_VERSIONS.CONTENT.DEFAULT.toString(),
+      accept: Config.PROTOCOL_VERSIONS.ACCEPT.DEFAULT.toString()
+    }
+
+    const clonedHeaders = { ...headers }
+
+    if (!clonedHeaders[Enums.Http.Headers.FSPIOP.DESTINATION] || clonedHeaders[Enums.Http.Headers.FSPIOP.DESTINATION] === '') {
+      clonedHeaders[Enums.Http.Headers.FSPIOP.DESTINATION] = clonedHeaders[Enums.Http.Headers.FSPIOP.SOURCE]
+      clonedHeaders[Enums.Http.Headers.FSPIOP.SOURCE] = Config.HUB_NAME
+    }
+
+    Logger.isDebugEnabled && Logger.debug(`participant endpoint url: ${requesterErrorEndpoint} for endpoint type ${endpointType}`)
+    const jwsSigner = defineJwsSigner(Config, clonedHeaders, requesterErrorEndpoint)
+
+    await Util.Request.sendRequest({
+      url: requesterErrorEndpoint,
+      headers: clonedHeaders,
+      source: clonedHeaders[Enums.Http.Headers.FSPIOP.SOURCE],
+      destination: clonedHeaders[Enums.Http.Headers.FSPIOP.DESTINATION],
+      method: Enums.Http.RestMethods.PUT,
+      payload: errorInformation,
+      responseType: Enums.Http.ResponseTypes.JSON,
+      hubNameRegex,
+      span,
+      jwsSigner,
+      protocolVersions,
+      apiType: Config.API_TYPE
+    })
+    histTimerEndSendRequestToParticipant({ success: true, endpointType, participantName })
+  } catch (err) {
+    histTimerEndSendRequestToParticipant({ success: false, endpointType, participantName })
+    Logger.isWarnEnabled && Logger.warn(`error in sendErrorToParticipant: ${err?.message}`)
+    throw ErrorHandler.Factory.reformatFSPIOPError(err)
+  }
+}

package/src/models/partyIdType/index.js

@@ -0,0 +1,32 @@
+/*****
+ License
+ --------------
+ Copyright © 2017 Bill & Melinda Gates Foundation
+ The Mojaloop files are made available by the Bill & Melinda Gates 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
+ Gates Foundation organization 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>.
+ * Gates Foundation
+ - Name Surname <name.surname@gatesfoundation.com>
+
+ - Rajiv Mothilal <rajiv.mothilal@modusbox.com>
+
+ --------------
+ ******/
+
+'use strict'
+
+const partyIdType = require('./partyIdType')
+
+module.exports = {
+  getPartyIdTypeByName: partyIdType.getPartyIdTypeByName
+}

package/src/models/partyIdType/partyIdType.js

@@ -0,0 +1,41 @@
+/*****
+ License
+ --------------
+ Copyright © 2017 Bill & Melinda Gates Foundation
+ The Mojaloop files are made available by the Bill & Melinda Gates 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
+ Gates Foundation organization 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>.
+ * Gates Foundation
+ - Name Surname <name.surname@gatesfoundation.com>
+
+ * Rajiv Mothilal <rajiv.mothilal@modusbox.com>
+
+ --------------
+ ******/
+
+'use strict'
+
+const Db = require('../../lib/db')
+const ErrorHandler = require('@mojaloop/central-services-error-handling')
+
+const getPartyIdTypeByName = async (name) => {
+  try {
+    return Db.from('partyIdType').findOne({ name, isActive: true })
+  } catch (err) {
+    throw ErrorHandler.Factory.reformatFSPIOPError(err)
+  }
+}
+
+module.exports = {
+  getPartyIdTypeByName
+}

package/src/plugins.js

@@ -0,0 +1,139 @@
+/*****
+ License
+ --------------
+ Copyright © 2017 Bill & Melinda Gates Foundation
+ The Mojaloop files are made available by the Bill & Melinda Gates 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
+ Gates Foundation organization 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>.
+ * Gates Foundation
+
+ * Rajiv Mothilal <rajiv.mothilal@modusbox.com>
+ * Vijay Kumar Guthi <vijaya.guthi@infitx.com>
+
+ --------------
+ ******/
+'use strict'
+
+const Config = require('./lib/config')
+const Inert = require('@hapi/inert')
+const Vision = require('@hapi/vision')
+const Blipp = require('blipp')
+const ErrorHandling = require('@mojaloop/central-services-error-handling')
+const CentralServices = require('@mojaloop/central-services-shared')
+const RawPayloadToDataUri = require('@mojaloop/central-services-shared').Util.Hapi.HapiRawPayload
+const OpenapiBackendValidator = require('@mojaloop/central-services-shared').Util.Hapi.OpenapiBackendValidator
+const APIDocumentation = require('@mojaloop/central-services-shared').Util.Hapi.APIDocumentation
+const MetricsPlugin = require('./metrics/plugin')
+
+const registerPlugins = async (server, openAPIBackend) => {
+  await server.register(OpenapiBackendValidator)
+
+  if (Config.API_DOC_ENDPOINTS_ENABLED) {
+    await server.register({
+      plugin: APIDocumentation,
+      options: {
+        document: openAPIBackend.document
+      }
+    })
+  }
+
+  if (!Config.INSTRUMENTATION_METRICS_DISABLED) {
+    await server.register({
+      plugin: MetricsPlugin
+    })
+  }
+
+  await server.register({
+    plugin: {
+      name: 'openapi',
+      version: '1.0.0',
+      multiple: true,
+      register: function (server, options) {
+        server.expose('openapi', options.openapi)
+      }
+    },
+    options: {
+      openapi: openAPIBackend
+    }
+  })
+
+  await server.register({
+    plugin: require('@hapi/good'),
+    options: {
+      ops: {
+        interval: 10000
+      }
+    }
+  })
+
+  await server.register({
+    plugin: require('@hapi/basic')
+  })
+
+  await server.register({
+    plugin: require('@now-ims/hapi-now-auth')
+  })
+
+  await server.register({
+    plugin: require('hapi-auth-bearer-token')
+  })
+
+  // Helper to construct FSPIOPHeaderValidation option configuration
+  const getOptionsForFSPIOPHeaderValidation = () => {
+    // configure supported FSPIOP Content-Type versions
+    const supportedProtocolContentVersions = []
+    for (const version of Config.PROTOCOL_VERSIONS.CONTENT.VALIDATELIST) {
+      supportedProtocolContentVersions.push(version.toString())
+    }
+
+    // configure supported FSPIOP Accept version
+    const supportedProtocolAcceptVersions = []
+    for (const version of Config.PROTOCOL_VERSIONS.ACCEPT.VALIDATELIST) {
+      supportedProtocolAcceptVersions.push(version.toString())
+    }
+
+    // configure FSPIOP resources
+    const resources = [
+      'participants',
+      'parties'
+    ]
+
+    // return FSPIOPHeaderValidation plugin options
+    return {
+      resources,
+      supportedProtocolContentVersions,
+      supportedProtocolAcceptVersions,
+      apiType: Config.API_TYPE
+    }
+  }
+
+  await server.register([
+    Inert,
+    Vision,
+    ErrorHandling,
+    RawPayloadToDataUri,
+    CentralServices.Util.Hapi.HapiEventPlugin,
+    {
+      plugin: CentralServices.Util.Hapi.FSPIOPHeaderValidation.plugin,
+      options: getOptionsForFSPIOPHeaderValidation()
+    }
+  ])
+
+  if (Config.DISPLAY_ROUTES === true) {
+    await server.register([Blipp])
+  }
+}
+
+module.exports = {
+  registerPlugins
+}

package/src/server.js

@@ -0,0 +1,199 @@
+/*****
+ License
+ --------------
+ Copyright © 2017 Bill & Melinda Gates Foundation
+ The Mojaloop files are made available by the Bill & Melinda Gates 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
+ Gates Foundation organization 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>.
+ * Gates Foundation
+
+ * Rajiv Mothilal <rajiv.mothilal@modusbox.com>
+
+ --------------
+ ******/
+'use strict'
+
+const { randomUUID } = require('node:crypto')
+const Hapi = require('@hapi/hapi')
+const Boom = require('@hapi/boom')
+
+const ErrorHandler = require('@mojaloop/central-services-error-handling')
+const Logger = require('@mojaloop/central-services-logger')
+const Metrics = require('@mojaloop/central-services-metrics')
+const { Endpoints, Participants, proxies, OpenapiBackend } = require('@mojaloop/central-services-shared').Util
+const { createProxyCache } = require('@mojaloop/inter-scheme-proxy-cache-lib')
+
+const { name, version } = require('../package.json')
+const Db = require('./lib/db')
+const Util = require('./lib/util')
+const Plugins = require('./plugins')
+const RequestLogger = require('./lib/requestLogger')
+const Migrator = require('./lib/migrator')
+const APIHandlers = require('./api')
+const Routes = require('./api/routes')
+const Cache = require('./lib/cache')
+const OracleEndpointCache = require('./models/oracle/oracleEndpointCached')
+const Handlers = require('./handlers/register')
+
+const connectDatabase = async (dbConfig) => {
+  return Db.connect(dbConfig)
+}
+
+const migrate = async () => {
+  return Migrator.migrate()
+}
+
+const createConnectedProxyCache = async (proxyCacheConfig) => {
+  const proxyCache = createProxyCache(
+    proxyCacheConfig.type,
+    proxyCacheConfig.proxyConfig
+  )
+  await proxyCache.connect()
+  return proxyCache
+}
+
+/**
+ * @function createServer
+ *
+ * @description Create HTTP Server
+ *
+ * @param {number} port Port to register the Server against
+ * @param {object} api to check if admin or api server
+ * @param {array} routes array of API routes
+ * @returns {Promise<Server>} Returns the Server object
+ */
+const createServer = async (port, api, routes, isAdmin, proxyCacheConfig, proxyMap) => {
+  const server = await new Hapi.Server({
+    port,
+    routes: {
+      validate: {
+        options: ErrorHandler.validateRoutes(),
+        failAction: async (request, h, err) => {
+          throw Boom.boomify(err)
+        }
+      },
+      payload: {
+        parse: true,
+        output: 'stream'
+      }
+    }
+  })
+  server.app.isAdmin = isAdmin
+
+  server.app.cache = Cache.registerCacheClient({
+    id: 'serverGeneralCache',
+    preloadCache: async () => Promise.resolve()
+  })
+
+  if (!isAdmin && proxyCacheConfig.enabled) {
+    server.app.proxyCache = await createConnectedProxyCache(proxyCacheConfig)
+    if (proxyMap) {
+      for (const [dfspId, proxyId] of Object.entries(proxyMap)) {
+        await server.app.proxyCache.addDfspIdToProxyMapping(dfspId, proxyId)
+      }
+    }
+  }
+
+  await server.ext([
+    {
+      type: 'onPreHandler',
+      method: (request, h) => {
+        request.headers.traceid = request.headers.traceid || randomUUID()
+        RequestLogger.logRequest(request)
+        return h.continue
+      }
+    },
+    {
+      type: 'onPreResponse',
+      method: (request, h) => {
+        RequestLogger.logResponse(request)
+        return h.continue
+      }
+    }
+  ])
+  await Plugins.registerPlugins(server, api, isAdmin)
+
+  server.route(routes)
+  // TODO: follow instructions https://github.com/anttiviljami/openapi-backend/blob/master/DOCS.md#postresponsehandler-handler
+  await server.start()
+
+  Logger.isInfoEnabled && Logger.info(`${name}${isAdmin ? '-admin' : ''}@${version} is running on port ${server.info.port}...`)
+  return server
+}
+
+const initializeInstrumentation = (metricsConfig) => {
+  Metrics.setup(metricsConfig)
+}
+
+const initializeApi = async (appConfig) => {
+  const {
+    INSTRUMENTATION_METRICS_DISABLED,
+    INSTRUMENTATION_METRICS_CONFIG,
+    CENTRAL_SHARED_ENDPOINT_CACHE_CONFIG,
+    CENTRAL_SHARED_PARTICIPANT_CACHE_CONFIG,
+    DATABASE,
+    API_PORT,
+    PROXY_CACHE_CONFIG,
+    proxyMap
+  } = appConfig
+
+  if (!INSTRUMENTATION_METRICS_DISABLED) {
+    initializeInstrumentation(INSTRUMENTATION_METRICS_CONFIG)
+  }
+  await connectDatabase(DATABASE)
+  const OpenAPISpecPath = Util.pathForInterface({ isAdmin: false, isMockInterface: false })
+  const api = await OpenapiBackend.initialise(OpenAPISpecPath, APIHandlers.ApiHandlers)
+
+  await Promise.all([
+    Endpoints.initializeCache(CENTRAL_SHARED_ENDPOINT_CACHE_CONFIG, Util.hubNameConfig),
+    Participants.initializeCache(CENTRAL_SHARED_PARTICIPANT_CACHE_CONFIG, Util.hubNameConfig),
+    proxies.initializeCache(CENTRAL_SHARED_PARTICIPANT_CACHE_CONFIG, Util.hubNameConfig),
+    OracleEndpointCache.initialize(),
+    Cache.initCache()
+  ])
+
+  return createServer(API_PORT, api, Routes.APIRoutes(api), false, PROXY_CACHE_CONFIG, proxyMap)
+}
+
+const initializeAdmin = async (appConfig) => {
+  const {
+    INSTRUMENTATION_METRICS_DISABLED,
+    INSTRUMENTATION_METRICS_CONFIG,
+    DATABASE,
+    RUN_MIGRATIONS,
+    ADMIN_PORT,
+    PROXY_CACHE_CONFIG
+  } = appConfig
+
+  if (!INSTRUMENTATION_METRICS_DISABLED) {
+    initializeInstrumentation(INSTRUMENTATION_METRICS_CONFIG)
+  }
+  await connectDatabase(DATABASE)
+  RUN_MIGRATIONS && await migrate()
+  const OpenAPISpecPath = Util.pathForInterface({ isAdmin: true, isMockInterface: false })
+  const api = await OpenapiBackend.initialise(OpenAPISpecPath, APIHandlers.AdminHandlers)
+
+  return createServer(ADMIN_PORT, api, Routes.AdminRoutes(api), true, PROXY_CACHE_CONFIG)
+}
+
+const initializeHandlers = async (handlers, appConfig, logger) => {
+  const proxyCache = await createConnectedProxyCache(appConfig.PROXY_CACHE_CONFIG)
+  const options = { proxyCache, batchSize: appConfig.HANDLERS_TIMEOUT_BATCH_SIZE, logger }
+  await Handlers.registerHandlers(handlers, options)
+}
+
+module.exports = {
+  initializeApi,
+  initializeAdmin,
+  initializeHandlers
+}