diff --git a/src/services/index-usdc-sac-transfer-events.service.ts b/src/services/index-usdc-sac-transfer-events.service.ts new file mode 100644 index 0000000..e86f780 --- /dev/null +++ b/src/services/index-usdc-sac-transfer-events.service.ts @@ -0,0 +1,40 @@ +export interface IndexUsdcSacTransferEventsReportInput { + marketKey: string; + primaryUnits: number; + secondaryUnits: number; + maxThreshold?: number; +} + +export interface IndexUsdcSacTransferEventsReport { + marketKey: string; + primaryUnits: number; + secondaryUnits: number; + utilizationBps: number; + verdict: 'healthy' | 'degraded' | 'halted'; +} + +export function evaluateIndexUsdcSacTransferEvents(input: IndexUsdcSacTransferEventsReportInput): IndexUsdcSacTransferEventsReport { + const marketKey = input.marketKey.trim(); + if (!marketKey) { + throw new Error('evaluateIndexUsdcSacTransferEvents: marketKey is required'); + } + const primaryUnits = Math.max(0, Math.trunc(input.primaryUnits)); + const secondaryUnits = Math.max(0, Math.trunc(input.secondaryUnits)); + const limit = Math.max(1, Math.trunc(input.maxThreshold ?? 100)); + + const utilizationBps = Math.min(10000, Math.round(((primaryUnits + secondaryUnits) * 10000) / limit)); + let verdict: 'healthy' | 'degraded' | 'halted' = 'healthy'; + if (utilizationBps >= 8500) { + verdict = 'halted'; + } else if (utilizationBps >= 5000) { + verdict = 'degraded'; + } + + return { + marketKey, + primaryUnits, + secondaryUnits, + utilizationBps, + verdict, + }; +} diff --git a/tests/index-usdc-sac-transfer-events.test.ts b/tests/index-usdc-sac-transfer-events.test.ts new file mode 100644 index 0000000..b43e3da --- /dev/null +++ b/tests/index-usdc-sac-transfer-events.test.ts @@ -0,0 +1,10 @@ +import test from 'node:test'; +import assert from 'node:assert/strict'; +import { evaluateIndexUsdcSacTransferEvents } from '../src/services/index-usdc-sac-transfer-events.service'; + +test('evaluateIndexUsdcSacTransferEvents: evaluates healthy, degraded, and halted verdicts', () => { + assert.equal(evaluateIndexUsdcSacTransferEvents({ marketKey: 'mkt-1', primaryUnits: 15, secondaryUnits: 10, maxThreshold: 100 }).verdict, 'healthy'); + assert.equal(evaluateIndexUsdcSacTransferEvents({ marketKey: 'mkt-2', primaryUnits: 35, secondaryUnits: 25 }).verdict, 'degraded'); + assert.equal(evaluateIndexUsdcSacTransferEvents({ marketKey: 'mkt-3', primaryUnits: 70, secondaryUnits: 20, maxThreshold: 100 }).verdict, 'halted'); + assert.throws(() => evaluateIndexUsdcSacTransferEvents({ marketKey: ' ', primaryUnits: 1, secondaryUnits: 1 }), /marketKey is required/); +});