@merkl/api 0.20.167 → 0.20.168

package/dist/src/modules/v4/opportunity/opportunity.controller.js

@@ -84,6 +84,12 @@ export const OpportunityController = new Elysia({
     },
     detail: { description: "Get the count of opportunities corresponding to the query." },
     response: { 200: t.Number() },
+})
+    .get("/bins/apr", async ({ query }) => await OpportunityService.getAprBins(query), {
+    query: GetOpportunitiesQueryDto,
+})
+    .get("/bins/tvl", async ({ query }) => await OpportunityService.getTvlBins(query), {
+    query: GetOpportunitiesQueryDto,
 })
     // ─── Get An Opportunity By Id ────────────────────────────────────────
     .get("/:id", async ({ params, query }) => {

package/dist/src/modules/v4/opportunity/opportunity.repository.d.ts

@@ -131,10 +131,8 @@ export declare abstract class OpportunityRepository {
         TvlRecords: ({
             TvlBreakdown: {
                 type: import("@db/api").$Enums.TvlType;
-                id: string;
                 identifier: string;
                 value: number;
-                tvlRecordId: string;
             }[];
         } & {
             total: number;
@@ -145,10 +143,8 @@ export declare abstract class OpportunityRepository {
         AprRecords: ({
             AprBreakdown: {
                 type: import("@db/api").$Enums.AprType;
-                id: string;
                 identifier: string;
                 value: number;
-                aprRecordId: string;
             }[];
         } & {
             id: string;
@@ -281,10 +277,8 @@ export declare abstract class OpportunityRepository {
         TvlRecords: ({
             TvlBreakdown: {
                 type: import("@db/api").$Enums.TvlType;
-                id: string;
                 identifier: string;
                 value: number;
-                tvlRecordId: string;
             }[];
         } & {
             total: number;
@@ -295,10 +289,8 @@ export declare abstract class OpportunityRepository {
         AprRecords: ({
             AprBreakdown: {
                 type: import("@db/api").$Enums.AprType;
-                id: string;
                 identifier: string;
                 value: number;
-                aprRecordId: string;
             }[];
         } & {
             id: string;
@@ -490,10 +482,8 @@ export declare abstract class OpportunityRepository {
         TvlRecords: ({
             TvlBreakdown: {
                 type: import("@db/api").$Enums.TvlType;
-                id: string;
                 identifier: string;
                 value: number;
-                tvlRecordId: string;
             }[];
         } & {
             total: number;
@@ -504,10 +494,8 @@ export declare abstract class OpportunityRepository {
         AprRecords: ({
             AprBreakdown: {
                 type: import("@db/api").$Enums.AprType;
-                id: string;
                 identifier: string;
                 value: number;
-                aprRecordId: string;
             }[];
         } & {
             id: string;
@@ -647,10 +635,8 @@ export declare abstract class OpportunityRepository {
         TvlRecords: ({
             TvlBreakdown: {
                 type: import("@db/api").$Enums.TvlType;
-                id: string;
                 identifier: string;
                 value: number;
-                tvlRecordId: string;
             }[];
         } & {
             total: number;
@@ -661,10 +647,8 @@ export declare abstract class OpportunityRepository {
         AprRecords: ({
             AprBreakdown: {
                 type: import("@db/api").$Enums.AprType;
-                id: string;
                 identifier: string;
                 value: number;
-                aprRecordId: string;
             }[];
         } & {
             id: string;
@@ -858,10 +842,8 @@ export declare abstract class OpportunityRepository {
         TvlRecords: ({
             TvlBreakdown: {
                 type: import("@db/api").$Enums.TvlType;
-                id: string;
                 identifier: string;
                 value: number;
-                tvlRecordId: string;
             }[];
         } & {
             total: number;
@@ -872,10 +854,8 @@ export declare abstract class OpportunityRepository {
         AprRecords: ({
             AprBreakdown: {
                 type: import("@db/api").$Enums.AprType;
-                id: string;
                 identifier: string;
                 value: number;
-                aprRecordId: string;
             }[];
         } & {
             id: string;

package/dist/src/modules/v4/opportunity/opportunity.repository.js

@@ -111,8 +111,16 @@ export class OpportunityRepository {
     }
     static #getRecordInclusion(withTest = true, withPoints = true) {
         return {
-            AprRecords: { take: 1, orderBy: { timestamp: "desc" }, include: { AprBreakdown: true } },
-            TvlRecords: { take: 1, orderBy: { timestamp: "desc" }, include: { TvlBreakdown: true } },
+            AprRecords: {
+                take: 1,
+                orderBy: { timestamp: "desc" },
+                include: { AprBreakdown: { select: { identifier: true, type: true, value: true } } },
+            },
+            TvlRecords: {
+                take: 1,
+                orderBy: { timestamp: "desc" },
+                include: { TvlBreakdown: { select: { identifier: true, type: true, value: true } } },
+            },
             DailyRewardsRecords: {
                 take: 1,
                 orderBy: { timestamp: "desc" },

package/dist/src/modules/v4/opportunity/opportunity.service.d.ts

@@ -8,6 +8,19 @@ import { OpportunityRepository } from "./opportunity.repository";
 export declare abstract class OpportunityService {
     #private;
     static hashId(opportunity: OpportunityUnique): string;
+    static getAprBins(query: GetOpportunitiesQueryModel): Promise<{
+        min: number;
+        max: number;
+        overThreshold: number;
+        binWidth: number;
+        bins: any[];
+    }>;
+    static getTvlBins(query: GetOpportunitiesQueryModel): Promise<{
+        min: number;
+        max: number;
+        binWidth: number;
+        bins: any[];
+    }>;
     static override(id: string, data: OpportunityOverrideModel): Promise<{
         status: import("@db/api").$Enums.Status;
         type: string;
@@ -625,16 +638,12 @@ export declare abstract class OpportunityService {
             cumulated: number;
             timestamp: bigint;
             breakdowns: ({
-                id: string;
                 value: number;
-                aprRecordId: string;
                 distributionType: import("@db/api").$Enums.DistributionType;
                 identifier: string;
                 type: "CAMPAIGN";
             } | {
-                id: string;
                 value: number;
-                aprRecordId: string;
                 identifier: string;
                 type: import("@db/api").$Enums.AprType;
             })[];
@@ -645,10 +654,8 @@ export declare abstract class OpportunityService {
             timestamp: bigint;
             breakdowns: {
                 type: import("@db/api").$Enums.TvlType;
-                id: string;
                 identifier: string;
                 value: number;
-                tvlRecordId: string;
             }[];
         };
         rewardsRecord: {
@@ -815,16 +822,12 @@ export declare abstract class OpportunityService {
             cumulated: number;
             timestamp: bigint;
             breakdowns: ({
-                id: string;
                 value: number;
-                aprRecordId: string;
                 distributionType: import("@db/api").$Enums.DistributionType;
                 identifier: string;
                 type: "CAMPAIGN";
             } | {
-                id: string;
                 value: number;
-                aprRecordId: string;
                 identifier: string;
                 type: import("@db/api").$Enums.AprType;
             })[];
@@ -835,10 +838,8 @@ export declare abstract class OpportunityService {
             timestamp: bigint;
             breakdowns: {
                 type: import("@db/api").$Enums.TvlType;
-                id: string;
                 identifier: string;
                 value: number;
-                tvlRecordId: string;
             }[];
         };
         rewardsRecord: {
@@ -998,16 +999,12 @@ export declare abstract class OpportunityService {
             cumulated: number;
             timestamp: bigint;
             breakdowns: ({
-                id: string;
                 value: number;
-                aprRecordId: string;
                 distributionType: import("@db/api").$Enums.DistributionType;
                 identifier: string;
                 type: "CAMPAIGN";
             } | {
-                id: string;
                 value: number;
-                aprRecordId: string;
                 identifier: string;
                 type: import("@db/api").$Enums.AprType;
             })[];
@@ -1018,10 +1015,8 @@ export declare abstract class OpportunityService {
             timestamp: bigint;
             breakdowns: {
                 type: import("@db/api").$Enums.TvlType;
-                id: string;
                 identifier: string;
                 value: number;
-                tvlRecordId: string;
             }[];
         };
         rewardsRecord: {

package/dist/src/modules/v4/opportunity/opportunity.service.js

@@ -17,6 +17,67 @@ export class OpportunityService {
     static hashId(opportunity) {
         return Bun.hash(`${opportunity.chainId}${opportunity.type}${opportunity.identifier}`).toString();
     }
+    static async getAprBins(query) {
+        const BINS_COUNT = 20;
+        const opportunities = await OpportunityRepository.findMany({
+            ...query,
+            status: "LIVE",
+            sort: "apr",
+            order: "asc",
+            items: 0,
+        });
+        const mid = Math.floor(opportunities.length / 2);
+        const median = opportunities.length % 2 !== 0
+            ? opportunities[mid].apr
+            : (opportunities[mid - 1].apr + opportunities[mid].apr) / 2;
+        const threshold = 5 * median;
+        if (opportunities.length < 2)
+            throw new Error("Not enough opportunities");
+        const maxAprUnderThreshold = opportunities.filter(o => o.apr <= threshold).at(-1)?.apr ?? 0;
+        const minAprAbove0 = opportunities.find(o => o.apr > 0)?.apr ?? 0;
+        const binWidth = (maxAprUnderThreshold - minAprAbove0) / BINS_COUNT;
+        const bins = new Array(BINS_COUNT);
+        for (let i = 0; i < BINS_COUNT; i++)
+            bins[i] = 0;
+        let overThreshold = 0;
+        for (const opportunity of opportunities) {
+            if (opportunity.apr > 0 && opportunity.apr < threshold)
+                bins[Math.min(Math.floor(opportunity.apr / binWidth), BINS_COUNT - 1)]++;
+            else
+                overThreshold++;
+        }
+        return {
+            min: opportunities[0].apr,
+            max: opportunities[opportunities.length - 1].apr,
+            overThreshold,
+            binWidth,
+            bins,
+        };
+    }
+    static async getTvlBins(query) {
+        const BINS_COUNT = 20;
+        const opportunities = await OpportunityRepository.findMany({
+            ...query,
+            status: "LIVE,SOON",
+            sort: "tvl",
+            order: "asc",
+            items: 0,
+        });
+        if (opportunities.length < 2)
+            throw new Error("Not enough opportunities");
+        const binWidth = (opportunities[opportunities.length - 1].tvl - opportunities[0].tvl) / BINS_COUNT;
+        const bins = new Array(BINS_COUNT);
+        for (let i = 0; i < BINS_COUNT; i++)
+            bins[i] = 0;
+        for (const opportunity of opportunities)
+            bins[Math.min(Math.floor(opportunity.tvl / binWidth), BINS_COUNT - 1)]++;
+        return {
+            min: opportunities[0].tvl,
+            max: opportunities[opportunities.length - 1].tvl,
+            binWidth,
+            bins,
+        };
+    }
     static async override(id, data) {
         const opportunity = await OpportunityRepository.findUniqueOrThrow(id);
         const overrides = opportunity.manualOverrides ?? [];

package/dist/src/modules/v4/reward/reward.controller.js

@@ -129,6 +129,6 @@ export const RewardController = new Elysia({ prefix: "/rewards", detail: { tags:
     detail: { hide: true },
 })
     .get("/total/distributed", async ({ query }) => await RewardService.getTotalDistributed(query.since.getTime() / 1000))
-    .get("/total/distributed/by-chains", async ({ query }) => await CacheService.wrap(TTLPresets.DAY_1, RewardService.getTotalDistributedByChains, query.since.getTime() / 1000))
+    .get("/total/distributed/by-chains", async ({ query }) => await CacheService.wrap(TTLPresets.DAY_1, RewardService.getTotalDistributedByChain, query.since.getTime() / 1000))
     .get("/total/distributed/by-types", async ({ query }) => await CacheService.wrap(TTLPresets.DAY_1, RewardService.getTotalDistributedByType, query.since.getTime() / 1000))
     .get("/total/distributed/by-protocols", async ({ query }) => await CacheService.wrap(TTLPresets.DAY_1, RewardService.getTotalDistributedByProtocol, query.since.getTime() / 1000));

package/dist/src/modules/v4/reward/reward.service.d.ts

@@ -14,16 +14,12 @@ export declare abstract class RewardService {
             cumulated: number;
             timestamp: bigint;
             breakdowns: ({
-                id: string;
                 value: number;
-                aprRecordId: string;
                 distributionType: import("@db/api").$Enums.DistributionType;
                 identifier: string;
                 type: "CAMPAIGN";
             } | {
-                id: string;
                 value: number;
-                aprRecordId: string;
                 identifier: string;
                 type: import("@db/api").$Enums.AprType;
             })[];
@@ -34,10 +30,8 @@ export declare abstract class RewardService {
             timestamp: bigint;
             breakdowns: {
                 type: import("@db/api").$Enums.TvlType;
-                id: string;
                 identifier: string;
                 value: number;
-                tvlRecordId: string;
             }[];
         };
         rewardsRecord: {
@@ -192,7 +186,7 @@ export declare abstract class RewardService {
         dailyRewards: number;
     }, number>>;
     static getTotalDistributed(since: number): Promise<number>;
-    static getTotalDistributedByChains(since: number): Promise<any>;
+    static getTotalDistributedByChain(since: number): Promise<any>;
     static getTotalDistributedByProtocol(since: number): Promise<any>;
     static getTotalDistributedByType(since: number): Promise<any>;
     /**

package/dist/src/modules/v4/reward/reward.service.js

@@ -44,7 +44,7 @@ export class RewardService {
         const oppToDailyRewards = await RewardService.getTotalDistributedByOpportunities(since);
         return oppToDailyRewards.values().reduce((prev, curr) => prev + curr, 0);
     }
-    static async getTotalDistributedByChains(since) {
+    static async getTotalDistributedByChain(since) {
         const oppToDailyRewards = await RewardService.getTotalDistributedByOpportunities(since);
         const chainsToDailyRewards = new Map();
         for (const [opp, dr] of oppToDailyRewards.entries()) {