@verii/endpoints-event-processing 1.0.0-pre.1752076816

package/src/controllers/health-probes/controller.js

@@ -0,0 +1,117 @@
+const { flow, filter, first } = require('lodash/fp');
+
+const { subSeconds } = require('date-fns');
+const {
+  initGetSignerMetrics,
+  initGetBlockNumber,
+  initGetBlock,
+} = require('@verii/blockchain-functions');
+const {
+  toBigNumber,
+  fromBigNumber,
+  subtractBigNumbers,
+} = require('@verii/math');
+const { HealthStates } = require('../../entities');
+
+const blockGraceInterval = 6;
+const blocksDeltaMultiplier = 3;
+
+const signerMetricsController = async (fastify) => {
+  fastify.get(
+    '/consensus',
+    {
+      onRequest: fastify.basicAuth,
+      schema: fastify.autoSchema({
+        response: {
+          200: {
+            status: { type: 'string' },
+          },
+        },
+      }),
+    },
+    async (req) => {
+      const getBlockNumber = await initGetBlockNumber({
+        rpcUrl: req.config.rpcUrl,
+        authenticate: req.vnfBlockchainAuthenticate,
+      });
+      const getBlock = await initGetBlock({
+        rpcUrl: req.config.rpcUrl,
+        authenticate: req.vnfBlockchainAuthenticate,
+      });
+
+      const blockNumber = await getBlockNumber();
+      const block = await getBlock(blockNumber);
+
+      req.log.info({
+        blockNumber,
+        block,
+      });
+
+      const lastBLockTime = new Date(block.timestamp * 1000);
+      const status =
+        lastBLockTime < subSeconds(new Date(), blockGraceInterval)
+          ? { status: HealthStates.Down }
+          : { status: HealthStates.Up };
+
+      return status;
+    }
+  );
+
+  fastify.get(
+    '/node/:address',
+    {
+      onRequest: fastify.basicAuth,
+      schema: fastify.autoSchema({
+        response: {
+          200: {
+            status: { type: 'string' },
+          },
+        },
+      }),
+    },
+    async (req) => {
+      const { address } = req.params;
+      const getSignerMetrics = await initGetSignerMetrics({
+        rpcUrl: req.config.rpcUrl,
+        authenticate: req.vnfBlockchainAuthenticate,
+      });
+      const getBlockNumber = await initGetBlockNumber({
+        rpcUrl: req.config.rpcUrl,
+        authenticate: req.vnfBlockchainAuthenticate,
+      });
+
+      const metrics = await getSignerMetrics();
+      const nodeMetrics = flow(
+        filter((metric) => metric.address === address),
+        first
+      )(metrics);
+      const nodesCount = metrics.length;
+      const blockNumber = await getBlockNumber();
+
+      req.log.info({
+        nodeMetrics,
+        blockNumber,
+      });
+
+      const status =
+        fromBigNumber(
+          subtractBigNumbers(
+            toBigNumber(blockNumber),
+            toBigNumber(nodeMetrics.lastProposedBlockNumber, 16)
+          )
+        ) >
+        nodesCount * blocksDeltaMultiplier
+          ? { status: HealthStates.Down }
+          : { status: HealthStates.Up };
+
+      req.log.info({
+        address,
+        status,
+      });
+
+      return status;
+    }
+  );
+};
+
+module.exports = signerMetricsController;

package/src/entities/burned-coupons/index.js

@@ -0,0 +1,3 @@
+module.exports = {
+  ...require('./repo'),
+};

package/src/entities/burned-coupons/repo.js

@@ -0,0 +1,29 @@
+const {
+  autoboxIdsExtension,
+  repoFactory,
+} = require('@spencejs/spence-mongo-repos');
+const {
+  initObjectIdAutoboxExtension,
+} = require('@verii/spencer-mongo-extensions');
+
+module.exports = (app, options, next = () => {}) => {
+  next();
+  return repoFactory(
+    {
+      name: 'burnedCoupons',
+      entityName: 'burnedCoupons',
+      defaultProjection: {
+        _id: 1,
+        purchaseId: 1,
+        used: 1,
+        at: 1,
+        clientId: 1,
+      },
+      extensions: [
+        autoboxIdsExtension,
+        initObjectIdAutoboxExtension('clientId'),
+      ],
+    },
+    app
+  );
+};

package/src/entities/health-probes/domains/health-states.js

@@ -0,0 +1,8 @@
+const HealthStates = {
+  Up: 'UP',
+  Down: 'DOWN',
+};
+
+module.exports = {
+  HealthStates,
+};

package/src/entities/health-probes/domains/index.js

@@ -0,0 +1,3 @@
+module.exports = {
+  ...require('./health-states'),
+};

package/src/entities/health-probes/index.js

@@ -0,0 +1,3 @@
+module.exports = {
+  ...require('./domains'),
+};

package/src/entities/index.js

@@ -0,0 +1,23 @@
+/*
+ * Copyright 2025 Velocity Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file 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, software
+ * distributed under the License is 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.
+ *
+ */
+module.exports = {
+  ...require('./burned-coupons'),
+  ...require('./health-probes'),
+  ...require('./oauth'),
+  ...require('./purchases'),
+  ...require('./transactions'),
+};

package/src/entities/oauth/index.js

@@ -0,0 +1,19 @@
+/*
+ * Copyright 2025 Velocity Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file 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, software
+ * distributed under the License is 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.
+ *
+ */
+module.exports = {
+  ...require('./scopes'),
+};

package/src/entities/oauth/scopes.js

@@ -0,0 +1,21 @@
+/*
+ * Copyright 2025 Velocity Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file 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, software
+ * distributed under the License is 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.
+ *
+ */
+const EventProcessingScopes = {
+  EventsTrigger: 'events:trigger',
+};
+
+module.exports = { EventProcessingScopes };

package/src/entities/purchases/domain/constants.js

@@ -0,0 +1,64 @@
+const PurchaseStatus = {
+  COUPONS_RECONCILED: 'COUPONS_RECONCILED',
+  COUPONS_MINTED: 'COUPONS_MINTED',
+  PAYMENT_SUCCEEDED: 'PAYMENT_SUCCEEDED',
+  CREDITS_ORDERED: 'CREDITS_ORDERED',
+  CREDIT_ORDER_PLACED: 'CREDIT_ORDER_PLACED',
+  CREDIT_ORDER_FILLED: 'CREDIT_ORDER_FILLED',
+  EXCHANGE_TRANSFER_COMPLETED: 'EXCHANGE_TRANSFER_COMPLETED',
+  CASHIER_TRANSFER_COMPLETED: 'CASHIER_TRANSFER_COMPLETED',
+  PAYMENT_IN_PROGRESS: 'PAYMENT_IN_PROGRESS',
+  PAYMENT_ERROR: 'PAYMENT_ERROR',
+  QUOTE_ACCEPTED: 'QUOTE_ACCEPTED',
+  PAYMENT_INTENT_CREATED: 'PAYMENT_INTENT_CREATED',
+  PAYMENT_INTENT_ERROR: 'PAYMENT_INTENT_ERROR',
+  QUOTE_CREATED: 'QUOTE_CREATED',
+  INVOICE_VOIDED: 'INVOICE_VOIDED',
+  FEES_RECORDED: 'FEES_RECORDED',
+};
+
+const PurchaseError = {
+  PAYMENT_INSUFFICIENT_FUNDS: 'PAYMENT_INSUFFICIENT_FUNDS',
+  PAYMENT_VERIFICATION_ERROR: 'PAYMENT_VERIFICATION_ERROR',
+  PAYMENT_OTHER_ERROR: 'PAYMENT_OTHER_ERROR',
+  PAYMENT_TIMEOUT: 'PAYMENT_TIMEOUT',
+  COUPONS_MINTING_FAILED: 'COUPONS_MINTING_FAILED',
+  COUPONS_RECONCILE_FAILED: 'COUPONS_RECONCILE_FAILED',
+  CASHIER_TRANSFER_FAILED: 'CASHIER_TRANSFER_FAILED',
+  EXCHANGE_TRANSFER_FAILED: 'EXCHANGE_TRANSFER_FAILED',
+  CREDITS_ORDER_FAILED: 'CREDITS_ORDER_FAILED',
+  CREDITS_ORDER_INSUFFICIENT_LIQUIDITY: 'CREDITS_ORDER_INSUFFICIENT_LIQUIDITY',
+};
+
+const CouponStatus = {
+  EXPIRED: 'EXPIRED',
+  ACTIVE: 'ACTIVE',
+};
+
+const PurchaseErrorMessages = {
+  PURCHASE_NOT_FOUND_TEMPLATE: ({ purchaseId }) =>
+    `Purchase ${purchaseId} not found`,
+  PURCHASE_WITH_QUOTE_ID_NOT_FOUND_TEMPLATE: ({ quoteId }) =>
+    `Quote ${quoteId} not found`,
+  PURCHASE_WITH_PAYMENT_METHOD_NOT_FOUND: ({ quoteId, paymentMethodId }) =>
+    `Can't found payment method ${paymentMethodId} for quote ${quoteId}`,
+  QUOTE_HAS_EXPIRED: 'Quote has expired',
+  QUOTE_BELOW_MINIMUM_THRESHOLD: 'Quote is below minimum threshold',
+  QUOTE_EXCEEDS_MAXIMUM_THRESHOLD: 'Quote is exceeds maximum threshold',
+  PAYMENT_METHOD_IS_NOT_SET: 'Payment method is not set',
+  PRICE_TOO_LOW: 'The minimum price is 5$',
+};
+
+const PurchaseSystems = {
+  STRIPE: 'STRIPE',
+  FINERACT: 'FINERACT',
+  EXCHANGE: 'EXCHANGE',
+};
+
+module.exports = {
+  PurchaseError,
+  PurchaseStatus,
+  CouponStatus,
+  PurchaseErrorMessages,
+  PurchaseSystems,
+};

package/src/entities/purchases/domain/index.js

@@ -0,0 +1,3 @@
+module.exports = {
+  ...require('./constants'),
+};

package/src/entities/purchases/index.js

@@ -0,0 +1,4 @@
+module.exports = {
+  ...require('./repo'),
+  ...require('./domain'),
+};

package/src/entities/purchases/repo.js

@@ -0,0 +1,39 @@
+const {
+  repoFactory,
+  autoboxIdsExtension,
+} = require('@spencejs/spence-mongo-repos');
+const {
+  initObjectIdAutoboxExtension,
+} = require('@verii/spencer-mongo-extensions');
+
+module.exports = (app, options, next = () => {}) => {
+  next();
+  return repoFactory(
+    {
+      name: 'purchases',
+      entityName: 'purchase',
+      defaultProjection: {
+        _id: 1,
+        purchaseId: 1,
+        userId: 1,
+        purchaseEvents: 1,
+        quoteMetadata: 1,
+        couponBundle: 1,
+        creditReceipt: 1,
+        fiatReceipt: 1,
+        clientId: 1,
+        at: 1,
+        updatedAt: 1,
+        purchaseStatus: 1,
+        purchaseType: 1,
+        exchangeOrderId: 1,
+      },
+      timestampKeys: { createdAt: 'at', updatedAt: 'updatedAt' },
+      extensions: [
+        autoboxIdsExtension,
+        initObjectIdAutoboxExtension('clientId'),
+      ],
+    },
+    app
+  );
+};

package/src/entities/transactions/domain/constants.js

@@ -0,0 +1,31 @@
+const TransactionTypes = {
+  NODE_OPERATOR_REWARD: 'NODE_OPERATOR_REWARD',
+  CAO_ISSUING_REWARD: 'CAO_ISSUING_REWARD',
+  ISSUER_ISSUING_REWARD: 'ISSUER_ISSUING_REWARD',
+  CAO_ISSUING_REWARD_REVERSAL: 'CAO_ISSUING_REWARD_REVERSAL',
+  ISSUER_ISSUING_REWARD_REVERSAL: 'ISSUER_ISSUING_REWARD_REVERSAL',
+  REDEEMVOUCHER: 'REDEEMVOUCHER',
+  REDEEMFIAT: 'REDEEMFIAT',
+  REWARD: 'REWARD',
+  REVERSAL: 'REVERSAL',
+  SELL: 'SELL',
+  STAKE: 'STAKE',
+  UNSTAKE: 'UNSTAKE',
+  HOLD: 'HOLD',
+  UNHOLD: 'UNHOLD',
+};
+
+const TransactionReasons = {
+  NODE_OPERATOR_REWARD: 'NODE_OPERATOR_REWARD',
+  CAO_ISSUING_REWARD: 'CAO_ISSUING_REWARD',
+  ISSUER_ISSUING_REWARD: 'ISSUER_ISSUING_REWARD',
+  CREDIT_SALE: 'CREDIT_SALE',
+  COUPON_PURCHASE: 'COUPON_PURCHASE',
+  CAO_ISSUING_REWARD_REVERSAL: 'CAO_ISSUING_REWARD_REVERSAL',
+  ISSUER_ISSUING_REWARD_REVERSAL: 'ISSUER_ISSUING_REWARD_REVERSAL',
+};
+
+module.exports = {
+  TransactionTypes,
+  TransactionReasons,
+};

package/src/entities/transactions/domain/index.js

@@ -0,0 +1,3 @@
+module.exports = {
+  ...require('./constants'),
+};

package/src/entities/transactions/index.js

@@ -0,0 +1,3 @@
+module.exports = {
+  ...require('./domain'),
+};

package/src/event-processing-endpoints.js

@@ -0,0 +1,57 @@
+/*
+ * Copyright 2025 Velocity Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file 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, software
+ * distributed under the License is 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.
+ *
+ */
+
+/*
+ * Copyright 2025 Velocity Team
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file 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, software
+ * distributed under the License is 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.
+ *
+ */
+const AutoLoad = require('@fastify/autoload');
+const fp = require('fastify-plugin');
+const path = require('path');
+
+const eventProcessingEndpoints = async (fastify) =>
+  fastify
+    .register(AutoLoad, {
+      dir: path.join(__dirname, 'entities'),
+      indexPattern: /.*repo(\.ts|\.js|\.cjs|\.mjs)$/,
+      scriptPattern: /.*repo(\.ts|\.js|\.cjs|\.mjs)$/,
+    })
+    .register(AutoLoad, {
+      dir: path.join(__dirname, 'controllers'),
+      indexPattern: /^.*controller(\.ts|\.js|\.cjs|\.mjs)$/,
+      scriptPattern: /.*controller(\.ts|\.js|\.cjs|\.mjs)$/,
+      routeParams: true,
+      autoHooks: true,
+      cascadeHooks: true,
+      options: { prefix: '/api/v0.6' },
+    });
+
+module.exports = {
+  eventProcessingEndpoints: fp(eventProcessingEndpoints),
+};

package/src/handlers/handle-coupons-burned-logging-event.js

@@ -0,0 +1,58 @@
+const { map, forEach } = require('lodash/fp');
+const { initVerificationCoupon } = require('@verii/metadata-registration');
+const { initDocumentFunctions, mapCouponBurned } = require('../helpers');
+
+const task = 'coupons-burned-logging';
+
+const initReadEventsFromBlock = async (context) => {
+  const { config } = context;
+  const { pullBurnCouponEvents } = await initVerificationCoupon(
+    {
+      contractAddress: config.couponContractAddress,
+      rpcProvider: context.rpcProvider,
+    },
+    context
+  );
+
+  return async (block) => {
+    return pullBurnCouponEvents(block);
+  };
+};
+
+const handleCouponsBurnedLoggingEvent = async (context) => {
+  const { log } = context;
+  const { readLastSuccessfulBlock, writeLastSuccessfulBlock } =
+    initDocumentFunctions({ eventName: task }, context);
+
+  const readEventsFromBlock = await initReadEventsFromBlock(context);
+
+  const lastReadBlock = await readLastSuccessfulBlock();
+
+  log.info({ task, lastReadBlock });
+
+  const { eventsCursor, latestBlock } = await readEventsFromBlock(
+    lastReadBlock + 1
+  );
+
+  let numberOfEventsRead = 0;
+  for await (const events of eventsCursor()) {
+    numberOfEventsRead += events.length;
+    const mappedEvents = map((evt) => mapCouponBurned(evt, context), events);
+    forEach((event) => {
+      log.info(event);
+    }, mappedEvents);
+  }
+
+  log.info({
+    task,
+    lastReadBlock,
+    numberOfEventsRead,
+  });
+
+  log.info({ task, latestBlock });
+  await writeLastSuccessfulBlock(latestBlock);
+};
+
+module.exports = {
+  handleCouponsBurnedLoggingEvent,
+};