@merkl/api 0.10.215 → 0.10.216

package/dist/src/eden/index.d.ts

@@ -2084,13 +2084,15 @@ declare const eden: {
         claims: ((params: {
             address: string | number;
         }) => {
-            get: (options?: {
+            get: (options: {
                 headers?: Record<string, unknown> | undefined;
-                query?: Record<string, unknown> | undefined;
+                query: {
+                    chainIds?: number[] | undefined;
+                };
                 fetch?: RequestInit | undefined;
-            } | undefined) => Promise<import("@elysiajs/eden").Treaty.TreatyResponse<{
+            }) => Promise<import("@elysiajs/eden").Treaty.TreatyResponse<{
                 200: (import("../modules/v4/claims").ClaimModel & {
-                    token: import("../modules/v4").Token["model"];
+                    token: import("../modules/v4").Token["model"] | null;
                 })[];
             }>>;
         }) & {};
@@ -2207,9 +2209,9 @@ declare const eden: {
                 headers?: Record<string, unknown> | undefined;
                 query: {
                     types?: string | number | string[] | number[] | undefined;
+                    chainIds?: string | string[] | undefined;
                     creatorTag?: string | undefined;
                     live?: boolean | undefined;
-                    chainIds?: string | string[] | undefined;
                     hideTestTokens?: string | undefined;
                 };
                 fetch?: RequestInit | undefined;
@@ -2276,8 +2278,8 @@ declare const eden: {
             get: (options: {
                 headers?: Record<string, unknown> | undefined;
                 query: {
-                    creatorTag?: string | undefined;
                     chainIds?: string | string[] | undefined;
+                    creatorTag?: string | undefined;
                     byReason?: boolean | undefined;
                     user: string;
                 };
@@ -2577,8 +2579,8 @@ declare const eden: {
             get: (options: {
                 headers?: Record<string, unknown> | undefined;
                 query: {
-                    creatorTag?: string | undefined;
                     chainIds?: string | string[] | undefined;
+                    creatorTag?: string | undefined;
                     user: string;
                 };
                 fetch?: RequestInit | undefined;
@@ -5335,11 +5337,13 @@ export declare const MerklApi: (domain: string | import("elysia").default<"", fa
                     params: {
                         address: string;
                     };
-                    query: unknown;
+                    query: {
+                        chainIds?: number[] | undefined;
+                    };
                     headers: unknown;
                     response: {
                         200: (import("../modules/v4/claims").ClaimModel & {
-                            token: import("../modules/v4").Token["model"];
+                            token: import("../modules/v4").Token["model"] | null;
                         })[];
                     };
                 };
@@ -5495,9 +5499,9 @@ export declare const MerklApi: (domain: string | import("elysia").default<"", fa
                 params: {};
                 query: {
                     types?: string | number | string[] | number[] | undefined;
+                    chainIds?: string | string[] | undefined;
                     creatorTag?: string | undefined;
                     live?: boolean | undefined;
-                    chainIds?: string | string[] | undefined;
                     hideTestTokens?: string | undefined;
                 };
                 headers: unknown;
@@ -5589,8 +5593,8 @@ export declare const MerklApi: (domain: string | import("elysia").default<"", fa
                 body: unknown;
                 params: {};
                 query: {
-                    creatorTag?: string | undefined;
                     chainIds?: string | string[] | undefined;
+                    creatorTag?: string | undefined;
                     byReason?: boolean | undefined;
                     user: string;
                 };
@@ -5990,8 +5994,8 @@ export declare const MerklApi: (domain: string | import("elysia").default<"", fa
                 body: unknown;
                 params: {};
                 query: {
-                    creatorTag?: string | undefined;
                     chainIds?: string | string[] | undefined;
+                    creatorTag?: string | undefined;
                     user: string;
                 };
                 headers: unknown;
@@ -8262,13 +8266,15 @@ export declare const MerklApi: (domain: string | import("elysia").default<"", fa
         claims: ((params: {
             address: string | number;
         }) => {
-            get: (options?: {
+            get: (options: {
                 headers?: Record<string, unknown> | undefined;
-                query?: Record<string, unknown> | undefined;
+                query: {
+                    chainIds?: number[] | undefined;
+                };
                 fetch?: RequestInit | undefined;
-            } | undefined) => Promise<import("@elysiajs/eden").Treaty.TreatyResponse<{
+            }) => Promise<import("@elysiajs/eden").Treaty.TreatyResponse<{
                 200: (import("../modules/v4/claims").ClaimModel & {
-                    token: import("../modules/v4").Token["model"];
+                    token: import("../modules/v4").Token["model"] | null;
                 })[];
             }>>;
         }) & {};
@@ -8385,9 +8391,9 @@ export declare const MerklApi: (domain: string | import("elysia").default<"", fa
                 headers?: Record<string, unknown> | undefined;
                 query: {
                     types?: string | number | string[] | number[] | undefined;
+                    chainIds?: string | string[] | undefined;
                     creatorTag?: string | undefined;
                     live?: boolean | undefined;
-                    chainIds?: string | string[] | undefined;
                     hideTestTokens?: string | undefined;
                 };
                 fetch?: RequestInit | undefined;
@@ -8454,8 +8460,8 @@ export declare const MerklApi: (domain: string | import("elysia").default<"", fa
             get: (options: {
                 headers?: Record<string, unknown> | undefined;
                 query: {
-                    creatorTag?: string | undefined;
                     chainIds?: string | string[] | undefined;
+                    creatorTag?: string | undefined;
                     byReason?: boolean | undefined;
                     user: string;
                 };
@@ -8755,8 +8761,8 @@ export declare const MerklApi: (domain: string | import("elysia").default<"", fa
             get: (options: {
                 headers?: Record<string, unknown> | undefined;
                 query: {
-                    creatorTag?: string | undefined;
                     chainIds?: string | string[] | undefined;
+                    creatorTag?: string | undefined;
                     user: string;
                 };
                 fetch?: RequestInit | undefined;

package/dist/src/index.d.ts

@@ -2599,11 +2599,13 @@ declare const app: Elysia<"", false, {
                     params: {
                         address: string;
                     };
-                    query: unknown;
+                    query: {
+                        chainIds?: number[] | undefined;
+                    };
                     headers: unknown;
                     response: {
                         200: (import("./modules/v4/claims").ClaimModel & {
-                            token: import("./modules/v4").Token["model"];
+                            token: import("./modules/v4").Token["model"] | null;
                         })[];
                     };
                 };
@@ -2759,9 +2761,9 @@ declare const app: Elysia<"", false, {
                 params: {};
                 query: {
                     types?: string | number | string[] | number[] | undefined;
+                    chainIds?: string | string[] | undefined;
                     creatorTag?: string | undefined;
                     live?: boolean | undefined;
-                    chainIds?: string | string[] | undefined;
                     hideTestTokens?: string | undefined;
                 };
                 headers: unknown;
@@ -2853,8 +2855,8 @@ declare const app: Elysia<"", false, {
                 body: unknown;
                 params: {};
                 query: {
-                    creatorTag?: string | undefined;
                     chainIds?: string | string[] | undefined;
+                    creatorTag?: string | undefined;
                     byReason?: boolean | undefined;
                     user: string;
                 };
@@ -3254,8 +3256,8 @@ declare const app: Elysia<"", false, {
                 body: unknown;
                 params: {};
                 query: {
-                    creatorTag?: string | undefined;
                     chainIds?: string | string[] | undefined;
+                    creatorTag?: string | undefined;
                     user: string;
                 };
                 headers: unknown;

package/dist/src/modules/v4/chain/chain.model.d.ts

@@ -16,9 +16,15 @@ export declare const GetChainQueryDto: import("@sinclair/typebox").TObject<{
 export declare const ChainUniqueDto: import("@sinclair/typebox").TObject<{
     chainId: import("@sinclair/typebox").TNumber;
 }>;
+export declare const ChainUniqueOptionalDto: import("@sinclair/typebox").TObject<{
+    chainId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+}>;
 export declare const ChainArrayDto: import("@sinclair/typebox").TObject<{
     chainId: import("@sinclair/typebox").TTransform<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TArray<import("@sinclair/typebox").TNumber>]>, number[]>;
 }>;
+export declare const ChainArrayOptionalDto: import("@sinclair/typebox").TObject<{
+    chainIds: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TTransform<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TArray<import("@sinclair/typebox").TNumber>]>, number[]>>;
+}>;
 export declare const CreateChainExplorerDto: import("@sinclair/typebox").TObject<{
     type: import("@sinclair/typebox").TEnum<{
         ETHERSCAN: "ETHERSCAN";

package/dist/src/modules/v4/chain/chain.model.js

@@ -12,6 +12,9 @@ export const GetChainQueryDto = t.Object({
 export const ChainUniqueDto = t.Object({
     chainId: t.Numeric(),
 });
+export const ChainUniqueOptionalDto = t.Object({
+    chainId: t.Optional(t.Numeric()),
+});
 export const ChainArrayDto = t.Object({
     chainId: t
         .Transform(t.Union([t.String(), t.Array(t.Numeric())]))
@@ -20,6 +23,14 @@ export const ChainArrayDto = t.Object({
 }, {
     description: "A required comma separated list of chain ids.<br>You can get the list of all supported chains by calling [GET /v4/chains](#tag/chains/GET/v4/chains/)",
 });
+export const ChainArrayOptionalDto = t.Object({
+    chainIds: t.Optional(t
+        .Transform(t.Union([t.String(), t.Array(t.Numeric())]))
+        .Decode(value => (typeof value === "string" ? value.split(",").map(v => Number.parseInt(v)) : value))
+        .Encode(value => [...value])),
+}, {
+    description: "A required comma separated list of chain ids.<br>You can get the list of all supported chains by calling [GET /v4/chains](#tag/chains/GET/v4/chains/)",
+});
 export const CreateChainExplorerDto = t.Object({
     type: t.Enum(ExplorerType),
     chainId: t.Number(),

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

@@ -19,11 +19,13 @@ export declare const ClaimController: Elysia<"/claims", false, {
                 params: {
                     address: string;
                 };
-                query: unknown;
+                query: {
+                    chainIds?: number[] | undefined;
+                };
                 headers: unknown;
                 response: {
                     200: (import("./claims.model").ClaimModel & {
-                        token: import("..").Token["model"];
+                        token: import("..").Token["model"] | null;
                     })[];
                 };
             };

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

@@ -1,13 +1,18 @@
-import { throwOnInvalidRequiredAddress } from "../../../utils/throw";
+import { throwOnInvalidRequiredAddress, throwOnUnsupportedChainId } from "../../../utils/throw";
 import Elysia from "elysia";
+import { ChainArrayOptionalDto } from "../chain";
 import { UserUniqueDto } from "../user";
 import { ClaimService } from "./claims.service";
 // ─── Claim Controller ───────────────────────────────────────────────────────
-export const ClaimController = new Elysia({ prefix: "/claims", detail: { tags: ["Claims"], hide: true } })
+export const ClaimController = new Elysia({ prefix: "/claims", detail: { tags: ["Claims"] } })
     // ─── Get Historical Claims ────────────────────────────────────────────
-    .get("/:address", async ({ params }) => await ClaimService.getHistoricalClaims(params), {
+    .get("/:address", async ({ params, query }) => await ClaimService.getHistoricalClaims(params, query.chainIds), {
     params: UserUniqueDto,
-    beforeHandle: ({ params }) => {
+    query: ChainArrayOptionalDto,
+    beforeHandle: ({ params, query }) => {
         params.address = throwOnInvalidRequiredAddress(params.address);
+        for (const chainId of query?.chainIds ?? []) {
+            throwOnUnsupportedChainId(chainId);
+        }
     },
 });

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

@@ -1,8 +1,9 @@
+import type { ChainId } from "@sdk";
 import type { Token } from "../token";
 import type { UserUniqueModel } from "../user";
 import type { ClaimModel } from "./claims.model";
 export declare abstract class ClaimService {
-    static getHistoricalClaims(params: UserUniqueModel): Promise<(ClaimModel & {
-        token: Token["model"];
+    static getHistoricalClaims(params: UserUniqueModel, chainFilter?: ChainId[]): Promise<(ClaimModel & {
+        token: Token["model"] | null;
     })[]>;
 }

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

@@ -3,27 +3,36 @@ import { RewardService } from "../reward";
 import { ClaimRepository } from "./claims.repository";
 export class ClaimService {
     // ─── Get Historical Claims ─────────────────────────────────────────────────
-    static async getHistoricalClaims(params) {
+    static async getHistoricalClaims(params, chainFilter = []) {
         const roots = (await MerklRootService.fetchAll()).map(r => r.live);
-        const rewards = await RewardService.getByRecipient(params.address, roots, true);
+        const rewards = await RewardService.getByRecipient(params.address, roots, true, chainFilter);
+        const filteredRewards = chainFilter.length
+            ? rewards.filter(reward => chainFilter.includes(reward.RewardToken.chainId))
+            : rewards;
         const chainIds = [];
-        for (const reward of rewards) {
+        for (const reward of filteredRewards) {
             if (!chainIds.includes(reward.RewardToken.chainId)) {
                 chainIds.push(reward.RewardToken.chainId);
             }
         }
-        const tokens = rewards.reduce((acc, reward) => {
+        const tokens = filteredRewards.reduce((acc, reward) => {
             acc[reward.RewardToken.address.toLowerCase()] = reward.RewardToken;
             return acc;
         }, {});
         const promises = await Promise.allSettled(chainIds.map(chainId => ClaimRepository.fetch(chainId, params.address)));
-        const claims = await promises
+        const claims = promises
             .filter(p => p.status === "fulfilled")
-            .flatMap(p => p.value)
+            .flatMap(p => p.value ?? []) // null/undefined claim arrays
+            .filter(claim => {
+            // Ensure the claim's token exists and matches the chainFilter
+            const token = claim?.token ? tokens[claim.token.toLowerCase()] : null;
+            return token && (!chainFilter.length || chainFilter.includes(token.chainId));
+        })
             .map(claim => {
+            const token = claim?.token ? tokens[claim.token.toLowerCase()] : null;
             return {
                 ...claim,
-                token: tokens[claim.token.toLowerCase()],
+                token,
             };
         });
         return claims.sort((a, b) => Number(b.timestamp) - Number(a.timestamp));

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

@@ -1,9 +1,10 @@
 import type { Prisma } from "../../../../database/api/.generated";
+import type { ChainId } from "@sdk";
 import type { BreakdownForCampaignsRaw, CampaignIdModel, CampaignIdWithoutPageModel, CreateManyBreakdownModel, CreateManyRewardModel, PendingEntity } from "./reward.model";
 export declare abstract class RewardRepository {
     static createManyReward(rewards: CreateManyRewardModel): Promise<Prisma.BatchPayload>;
     static createManyBreakdown(data: CreateManyBreakdownModel): Promise<Prisma.BatchPayload>;
-    static getByRecipient(recipient: string, roots: string[], withToken: boolean): Promise<({
+    static getByRecipient(recipient: string, roots: string[], withToken: boolean, chainFilter?: ChainId[]): Promise<({
         RewardToken: {
             symbol: string;
             name: string | null;

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

@@ -52,13 +52,14 @@ export class RewardRepository {
             data: breakdownsToCreate,
         });
     }
-    static async getByRecipient(recipient, roots, withToken) {
+    static async getByRecipient(recipient, roots, withToken, chainFilter) {
         return await apiDbClient.reward.findMany({
             where: {
                 root: {
                     in: roots,
                 },
                 recipient,
+                ...(!!chainFilter?.length ? { RewardToken: { chainId: { in: chainFilter } } } : undefined),
             },
             include: {
                 Breakdown: {

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

@@ -156,7 +156,7 @@ export declare abstract class RewardService {
         proofs: string[];
     }[];
     static createManyBreakdown(data: CreateManyBreakdownModel): Promise<import("../../../../database/api/.generated").Prisma.BatchPayload | undefined>;
-    static getByRecipient(recipient: string, roots: string[], withToken?: boolean): Promise<({
+    static getByRecipient(recipient: string, roots: string[], withToken?: boolean, chainFilter?: ChainId[]): Promise<({
         RewardToken: {
             symbol: string;
             name: string | null;

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

@@ -83,8 +83,8 @@ export class RewardService {
             log.error(`createManyBreakdown - error creating many breakdowns for campaigns ${foundCampaigns.join(", ")}`, e);
         }
     }
-    static async getByRecipient(recipient, roots, withToken = false) {
-        return await RewardRepository.getByRecipient(recipient, roots, withToken);
+    static async getByRecipient(recipient, roots, withToken = false, chainFilter) {
+        return RewardRepository.getByRecipient(recipient, roots, withToken, chainFilter);
     }
     /**
      * Groups a breakdown array by their corresponding opportunities
@@ -174,7 +174,9 @@ export class RewardService {
     }
     static async getUserRewardsByChain(user, withToken, chainFilter = [], connectedChainId = null) {
         const chains = await ChainService.findMany();
-        let chainIds = chains.map(({ id }) => id).filter(id => !chainFilter.length || chainFilter.includes(id));
+        let chainIds = !chainFilter || !chainFilter.length
+            ? chains.map(({ id }) => id)
+            : chains.map(({ id }) => id).filter(id => chainFilter.includes(id));
         /** Check if the user is blacklisted */
         const isBlacklisted = !!(await BlacklistService.isBlacklisted(user));
         const res = [];

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

@@ -2477,11 +2477,13 @@ export declare const v4: Elysia<"/v4", false, {
                     params: {
                         address: string;
                     };
-                    query: unknown;
+                    query: {
+                        chainIds?: number[] | undefined;
+                    };
                     headers: unknown;
                     response: {
                         200: (import("./claims").ClaimModel & {
-                            token: import("./token").Token["model"];
+                            token: import("./token").Token["model"] | null;
                         })[];
                     };
                 };

package/dist/src/routes/v3/campaigns.d.ts

@@ -26,9 +26,9 @@ declare const _default: (app: Elysia) => Elysia<"", false, {
             params: {};
             query: {
                 types?: string | number | string[] | number[] | undefined;
+                chainIds?: string | string[] | undefined;
                 creatorTag?: string | undefined;
                 live?: boolean | undefined;
-                chainIds?: string | string[] | undefined;
                 hideTestTokens?: string | undefined;
             };
             headers: unknown;

package/dist/src/routes/v3/claims.d.ts

@@ -23,8 +23,8 @@ declare const _default: (app: Elysia) => Elysia<"", false, {
             body: unknown;
             params: {};
             query: {
-                creatorTag?: string | undefined;
                 chainIds?: string | string[] | undefined;
+                creatorTag?: string | undefined;
                 byReason?: boolean | undefined;
                 user: string;
             };

package/dist/src/routes/v3/rewards.d.ts

@@ -22,8 +22,8 @@ declare const _default: (app: Elysia) => Elysia<"", false, {
             body: unknown;
             params: {};
             query: {
-                creatorTag?: string | undefined;
                 chainIds?: string | string[] | undefined;
+                creatorTag?: string | undefined;
                 user: string;
             };
             headers: unknown;

package/dist/src/routes/v3/router.d.ts

@@ -87,9 +87,9 @@ export declare const v3: Elysia<"/v3", false, {
                 params: {};
                 query: {
                     types?: string | number | string[] | number[] | undefined;
+                    chainIds?: string | string[] | undefined;
                     creatorTag?: string | undefined;
                     live?: boolean | undefined;
-                    chainIds?: string | string[] | undefined;
                     hideTestTokens?: string | undefined;
                 };
                 headers: unknown;
@@ -181,8 +181,8 @@ export declare const v3: Elysia<"/v3", false, {
                 body: unknown;
                 params: {};
                 query: {
-                    creatorTag?: string | undefined;
                     chainIds?: string | string[] | undefined;
+                    creatorTag?: string | undefined;
                     byReason?: boolean | undefined;
                     user: string;
                 };
@@ -582,8 +582,8 @@ export declare const v3: Elysia<"/v3", false, {
                 body: unknown;
                 params: {};
                 query: {
-                    creatorTag?: string | undefined;
                     chainIds?: string | string[] | undefined;
+                    creatorTag?: string | undefined;
                     user: string;
                 };
                 headers: unknown;