@merkl/api 0.20.98 → 0.20.99

package/dist/src/modules/v4/router.d.ts

@@ -132,6 +132,23 @@ export declare const v4: Elysia<"/v4", false, {
                         };
                         response: {
                             200: {
+                                id: string;
+                                name: string;
+                                type: string;
+                                status: import("@db/api").$Enums.Status;
+                                tags: string[];
+                                identifier: string;
+                                action: import("@db/api").$Enums.OpportunityAction;
+                                manualOverrides: import("@db/api").$Enums.OpportunityManualOverride[];
+                                chainId: number;
+                                depositUrl: string | null;
+                                explorerAddress: string | null;
+                                mainProtocolId: string | null;
+                                tvl: number;
+                                apr: number;
+                                dailyRewards: number;
+                                lastCampaignCreatedAt: Date;
+                            } | {
                                 id: string;
                                 chainId: number;
                                 type: string;
@@ -158,7 +175,7 @@ export declare const v4: Elysia<"/v4", false, {
                                 depositUrl: any;
                                 explorerAddress: string | undefined;
                                 tags: string[];
-                            };
+                            } | null;
                         };
                     };
                 };
@@ -179,6 +196,23 @@ export declare const v4: Elysia<"/v4", false, {
                     };
                     response: {
                         200: {
+                            id: string;
+                            name: string;
+                            type: string;
+                            status: import("@db/api").$Enums.Status;
+                            tags: string[];
+                            identifier: string;
+                            action: import("@db/api").$Enums.OpportunityAction;
+                            manualOverrides: import("@db/api").$Enums.OpportunityManualOverride[];
+                            chainId: number;
+                            depositUrl: string | null;
+                            explorerAddress: string | null;
+                            mainProtocolId: string | null;
+                            tvl: number;
+                            apr: number;
+                            dailyRewards: number;
+                            lastCampaignCreatedAt: Date;
+                        } | {
                             id: string;
                             chainId: number;
                             type: string;
@@ -205,7 +239,7 @@ export declare const v4: Elysia<"/v4", false, {
                             depositUrl: any;
                             explorerAddress: string | undefined;
                             tags: string[];
-                        };
+                        } | null;
                     };
                 };
             };
@@ -1842,6 +1876,23 @@ export declare const v4: Elysia<"/v4", false, {
                         };
                         response: {
                             200: {
+                                id: string;
+                                name: string;
+                                type: string;
+                                status: import("@db/api").$Enums.Status;
+                                tags: string[];
+                                identifier: string;
+                                action: import("@db/api").$Enums.OpportunityAction;
+                                manualOverrides: import("@db/api").$Enums.OpportunityManualOverride[];
+                                chainId: number;
+                                depositUrl: string | null;
+                                explorerAddress: string | null;
+                                mainProtocolId: string | null;
+                                tvl: number;
+                                apr: number;
+                                dailyRewards: number;
+                                lastCampaignCreatedAt: Date;
+                            } | {
                                 id: string;
                                 chainId: number;
                                 type: string;
@@ -1868,7 +1919,7 @@ export declare const v4: Elysia<"/v4", false, {
                                 depositUrl: any;
                                 explorerAddress: string | undefined;
                                 tags: string[];
-                            };
+                            } | null;
                         };
                     };
                 };
@@ -1888,6 +1939,23 @@ export declare const v4: Elysia<"/v4", false, {
                         };
                         response: {
                             200: {
+                                id: string;
+                                name: string;
+                                type: string;
+                                status: import("@db/api").$Enums.Status;
+                                tags: string[];
+                                identifier: string;
+                                action: import("@db/api").$Enums.OpportunityAction;
+                                manualOverrides: import("@db/api").$Enums.OpportunityManualOverride[];
+                                chainId: number;
+                                depositUrl: string | null;
+                                explorerAddress: string | null;
+                                mainProtocolId: string | null;
+                                tvl: number;
+                                apr: number;
+                                dailyRewards: number;
+                                lastCampaignCreatedAt: Date;
+                            } | {
                                 id: string;
                                 chainId: number;
                                 type: string;
@@ -1914,7 +1982,7 @@ export declare const v4: Elysia<"/v4", false, {
                                 depositUrl: any;
                                 explorerAddress: string | undefined;
                                 tags: string[];
-                            };
+                            } | null;
                         };
                     };
                 };
@@ -4442,6 +4510,7 @@ export declare const v4: Elysia<"/v4", false, {
                             blacklist?: string[] | undefined;
                             poolAddress?: string | undefined;
                             contract?: string | undefined;
+                            tokenId?: string | undefined;
                             marketId?: string | undefined;
                             strategy?: string | undefined;
                             poolId?: string | undefined;
@@ -5000,6 +5069,54 @@ export declare const v4: Elysia<"/v4", false, {
             };
         };
     };
+} & {
+    v4: {
+        turtle: {
+            tac: {
+                total: {
+                    get: {
+                        body: unknown;
+                        params: {};
+                        query: unknown;
+                        headers: unknown;
+                        response: {
+                            200: {
+                                total: number;
+                                breakdown: {
+                                    [key: string]: number;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    } & {
+        turtle: {
+            tac: {
+                ":address": {
+                    get: {
+                        body: unknown;
+                        params: {
+                            address: string;
+                        };
+                        query: unknown;
+                        headers: unknown;
+                        response: {
+                            200: {
+                                [x: string]: {
+                                    vaultSymbol: string;
+                                    balance: number;
+                                    maxBalance: number;
+                                    turtle: number;
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
 }, {
     derive: {};
     resolve: {};

package/dist/src/modules/v4/router.js

@@ -32,6 +32,7 @@ import { AlwaysOffSampler, BatchSpanProcessor } from "@opentelemetry/sdk-trace-n
 import { PrismaInstrumentation } from "@prisma/instrumentation";
 import Elysia from "elysia";
 import { ReferralController } from "./referral/referral.controller";
+import { TurtleController } from "./turtle/turtle.controller";
 // ─── V4 Router ───────────────────────────────────────────────────────────────
 export const v4 = new Elysia({ tags: ["v4"], prefix: "/v4" })
     // ─── OpenTelemetry ───────────────────────────────────────────────────
@@ -88,4 +89,5 @@ export const v4 = new Elysia({ tags: ["v4"], prefix: "/v4" })
     .use(ComputedValueController)
     .use(CreatorController)
     .use(ReferralController)
-    .use(UniswapController);
+    .use(UniswapController)
+    .use(TurtleController);

package/dist/src/modules/v4/turtle/turtle.controller.d.ts

@@ -0,0 +1,68 @@
+import Elysia from "elysia";
+export declare const TurtleController: Elysia<"/turtle", false, {
+    decorator: {};
+    store: {};
+    derive: {};
+    resolve: {};
+}, {
+    type: {};
+    error: {};
+}, {
+    schema: {};
+    macro: {};
+    macroFn: {};
+}, {
+    turtle: {
+        tac: {
+            total: {
+                get: {
+                    body: unknown;
+                    params: {};
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: {
+                            total: number;
+                            breakdown: {
+                                [key: string]: number;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    turtle: {
+        tac: {
+            ":address": {
+                get: {
+                    body: unknown;
+                    params: {
+                        address: string;
+                    };
+                    query: unknown;
+                    headers: unknown;
+                    response: {
+                        200: {
+                            [x: string]: {
+                                vaultSymbol: string;
+                                balance: number;
+                                maxBalance: number;
+                                turtle: number;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+}, {
+    derive: {};
+    resolve: {};
+    schema: {};
+}>;

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

@@ -0,0 +1,20 @@
+import { throwOnInvalidRequiredAddress } from "@/utils/throw";
+import Elysia from "elysia";
+import { UserUniqueDto } from "../user/user.model";
+import { TurtleService } from "./turtle.service";
+// ─── Claim Controller ───────────────────────────────────────────────────────
+export const TurtleController = new Elysia({ prefix: "/turtle", detail: { tags: ["Turtle"] } })
+    .get("/tac/total", async () => await TurtleService.getTotalDistributed(), {
+    detail: {
+        description: "Get total TAC distributed and the associated breakdown",
+    },
+})
+    .get("/tac/:address", async ({ params }) => await TurtleService.getUserData(params), {
+    params: UserUniqueDto,
+    beforeHandle: ({ params }) => {
+        params.address = throwOnInvalidRequiredAddress(params.address);
+    },
+    detail: {
+        description: "Get the max balance and balance of the user for its turtle vaults",
+    },
+});

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

@@ -0,0 +1,14 @@
+export declare class TurtleRepository {
+    static fetchUserBalances(address: string): Promise<{
+        balance: string;
+        maxBalance: string;
+        tokenSymbol: string;
+        token: string;
+        turtleDepositBonus: string;
+        user: string;
+    }[]>;
+    static fetchTotals(): Promise<{
+        amount: number;
+        id: string;
+    }[]>;
+}

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

@@ -0,0 +1,40 @@
+import request, { gql } from "graphql-request";
+const TURTLE_SUBGRAPH_URL = "https://api.goldsky.com/api/public/project_cltpyx1eh5g5v01xi0a5h5xea/subgraphs/merkl-tacTurtle-mainnet/prod/gn";
+export class TurtleRepository {
+    static async fetchUserBalances(address) {
+        try {
+            return (await request(TURTLE_SUBGRAPH_URL, gql `query UserBalances($where: UserBalance_filter) {
+            userBalances(where: $where) {
+              balance
+              maxBalance
+              tokenSymbol
+              token
+              turtleDepositBonus
+              user
+            }
+          }
+    `, {
+                where: {
+                    user: address.toLowerCase(),
+                },
+            })).userBalances;
+        }
+        catch {
+            return [];
+        }
+    }
+    static async fetchTotals() {
+        try {
+            return (await request(TURTLE_SUBGRAPH_URL, gql `query TurtleDistributeds {
+            turtleDistributeds {
+              amount
+              id
+            }
+          }
+    `, {})).turtleDistributeds;
+        }
+        catch {
+            return [];
+        }
+    }
+}

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

@@ -0,0 +1,17 @@
+import type { UserUniqueModel } from "../user/user.model";
+export declare abstract class TurtleService {
+    static getUserData(params: UserUniqueModel): Promise<{
+        [key: string]: {
+            vaultSymbol: string;
+            balance: number;
+            maxBalance: number;
+            turtle: number;
+        };
+    }>;
+    static getTotalDistributed(): Promise<{
+        total: number;
+        breakdown: {
+            [key: string]: number;
+        };
+    }>;
+}

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

@@ -0,0 +1,28 @@
+import { TurtleRepository } from "./turtle.repository";
+export class TurtleService {
+    // ─── Get Turtle User data ─────────────────────────────────────────────────
+    static async getUserData(params) {
+        const userBalances = await TurtleRepository.fetchUserBalances(params.address);
+        return userBalances.reduce((acc, userBalance) => {
+            acc[userBalance.token] = {
+                vaultSymbol: userBalance.tokenSymbol,
+                balance: Number(userBalance.balance),
+                maxBalance: Number(userBalance.maxBalance),
+                turtle: Number(userBalance.turtleDepositBonus),
+            };
+            return acc;
+        }, {});
+    }
+    // ─── Get Total Turtle Distributed ─────────────────────────────────────────
+    static async getTotalDistributed() {
+        const totals = await TurtleRepository.fetchTotals();
+        return totals.reduce((acc, item) => {
+            if (item.id === "total") {
+                acc.total = Number(item.amount);
+                return acc;
+            }
+            acc.breakdown[item.id] = Number(item.amount);
+            return acc;
+        }, { total: 0, breakdown: {} });
+    }
+}