@merkl/api 1.13.26 → 1.13.28

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

@@ -0,0 +1,196 @@
+import { Prisma } from "@package/databases/api";
+export declare abstract class DiffRepository {
+    /** Build where clause for DiffBreakdown queries */
+    static buildBreakdownWhere(params: {
+        distributionChainId: number;
+        root: string;
+        tokenAddress?: string;
+        campaignId?: string;
+        recipient?: string;
+    }): Prisma.DiffBreakdownWhereInput;
+    /** Paginated DiffBreakdown rows with sorting (numeric-aware for amount/claimed/unclaimed) */
+    static findManyBreakdowns(params: {
+        chainId: number;
+        root: string;
+        tokenAddress?: string;
+        campaignId?: string;
+        recipient?: string;
+    }, pagination: {
+        take?: number;
+        skip?: number;
+    }, sort?: string, order?: "asc" | "desc"): Promise<{
+        distributionChainId: number;
+        tokenAddress: string;
+        recipient: string;
+        campaignId: string;
+        reason: string;
+        root: string;
+        amount: string;
+        claimed: string;
+        lastProcessedTimestamp: number;
+        createdAt: number | null;
+        publishAfterTimestamp: number | null;
+        merged: boolean;
+        mergedAt: Date | null;
+    }[]>;
+    /** Count DiffBreakdown rows matching filters */
+    static countBreakdowns(where: Prisma.DiffBreakdownWhereInput): Promise<number>;
+    /** Group DiffBreakdown rows by merged status */
+    static groupByMergedBreakdowns(where: Prisma.DiffBreakdownWhereInput): Promise<(import("@prisma/client/runtime/client").GetAggregateResult<Prisma.$DiffBreakdownPayload<import("@prisma/client/runtime/client").InternalArgs & {
+        result: {};
+        model: {};
+        query: {};
+        client: {};
+    }>, {
+        by: "merged"[];
+        where: Prisma.DiffBreakdownWhereInput;
+        _count: true;
+    }> & {
+        merged: boolean;
+    })[]>;
+    /** Sum amount and claimed (absolute values) for DiffBreakdown rows */
+    static aggregateBreakdowns(where: Prisma.DiffBreakdownWhereInput): Promise<{
+        totalAmount: string;
+        totalClaimed: string;
+        positiveAmount: string;
+        negativeAmount: string;
+    }>;
+    /** Find campaigns with their opportunity for given chainId + campaignIds */
+    static findCampaignOpportunities(chainId: number, campaignIds: string[]): Promise<{
+        Opportunity: {
+            Chain: {
+                name: string;
+            };
+            id: string;
+            identifier: string;
+            name: string;
+            type: string;
+        };
+        campaignId: string;
+    }[]>;
+    /** Distinct token addresses for a given chain + root */
+    static findDistinctTokens(chainId: number, root: string): Promise<string[]>;
+    /** Recent MerklRoots for a chain (last 7 days) */
+    static findRecentRoots(chainId: number): Promise<{
+        root: string;
+        chainId: number;
+        epoch: number;
+        timestamp: bigint;
+    }[]>;
+    /** Build where clause for LeafBreakdown queries */
+    static buildLeafBreakdownWhere(params: {
+        distributionChainId: number;
+        tokenAddress: string;
+        campaignId?: string;
+        recipient?: string;
+    }): Prisma.LeafBreakdownWhereInput;
+    /** Paginated LeafBreakdown rows with sorting (numeric-aware for amount/claimed/unclaimed) */
+    static findManyLeafBreakdowns(params: {
+        chainId: number;
+        tokenAddress: string;
+        campaignId?: string;
+        recipient?: string;
+    }, pagination: {
+        take?: number;
+        skip?: number;
+    }, sort?: string, order?: "asc" | "desc"): Promise<{
+        distributionChainId: number;
+        tokenAddress: string;
+        recipient: string;
+        campaignId: string;
+        reason: string;
+        amount: string;
+        claimed: string;
+        lastProcessedTimestamp: number;
+        subCampaignId: string | null;
+    }[]>;
+    /** Count LeafBreakdown rows matching filters */
+    static countLeafBreakdowns(where: Prisma.LeafBreakdownWhereInput): Promise<number>;
+    /** Aggregate LeafBreakdown amounts (supports campaign/recipient filters) */
+    static aggregateLeafBreakdowns(where: Prisma.LeafBreakdownWhereInput): Promise<{
+        totalAmount: string;
+        totalClaimed: string;
+        positiveAmount: string;
+        negativeAmount: string;
+    }>;
+    /** Distinct token addresses for LeafBreakdown on a chain (raw SQL for perf) */
+    static findDistinctLeafTokens(chainId: number): Promise<string[]>;
+    /** Build where clause for Diff queries */
+    static buildDiffWhere(params: {
+        distributionChainId: number;
+        root: string;
+        tokenAddress?: string;
+        recipient?: string;
+    }): Prisma.DiffWhereInput;
+    /** Paginated Diff rows with numeric-aware sorting */
+    static findManyDiffs(params: {
+        chainId: number;
+        root: string;
+        tokenAddress?: string;
+        recipient?: string;
+    }, pagination: {
+        take?: number;
+        skip?: number;
+    }, sort?: string, order?: "asc" | "desc"): Promise<{
+        distributionChainId: number;
+        tokenAddress: string;
+        recipient: string;
+        root: string;
+        amount: string;
+        claimed: string;
+        merged: boolean;
+        mergedAt: Date | null;
+    }[]>;
+    /** Count Diff rows */
+    static countDiffs(where: Prisma.DiffWhereInput): Promise<number>;
+    /** Group Diff rows by merged status */
+    static groupByMergedDiffs(where: Prisma.DiffWhereInput): Promise<(import("@prisma/client/runtime/client").GetAggregateResult<Prisma.$DiffPayload<import("@prisma/client/runtime/client").InternalArgs & {
+        result: {};
+        model: {};
+        query: {};
+        client: {};
+    }>, {
+        by: "merged"[];
+        where: Prisma.DiffWhereInput;
+        _count: true;
+    }> & {
+        merged: boolean;
+    })[]>;
+    /** Aggregate Diff amounts */
+    static aggregateDiffs(where: Prisma.DiffWhereInput): Promise<{
+        totalAmount: string;
+        totalClaimed: string;
+        positiveAmount: string;
+        negativeAmount: string;
+    }>;
+    /** Build where clause for Leaf queries */
+    static buildLeafWhere(params: {
+        distributionChainId: number;
+        tokenAddress: string;
+        recipient?: string;
+    }): Prisma.LeafWhereInput;
+    /** Paginated Leaf rows with numeric-aware sorting */
+    static findManyLeaves(params: {
+        chainId: number;
+        tokenAddress: string;
+        recipient?: string;
+    }, pagination: {
+        take?: number;
+        skip?: number;
+    }, sort?: string, order?: "asc" | "desc"): Promise<{
+        distributionChainId: number;
+        tokenAddress: string;
+        recipient: string;
+        amount: string;
+        claimed: string;
+    }[]>;
+    /** Count Leaf rows */
+    static countLeaves(where: Prisma.LeafWhereInput): Promise<number>;
+    /** Aggregate Leaf amounts */
+    static aggregateLeaves(where: Prisma.LeafWhereInput): Promise<{
+        totalAmount: string;
+        totalClaimed: string;
+        positiveAmount: string;
+        negativeAmount: string;
+    }>;
+}

package/dist/src/modules/v4/diff/diff.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.repository.js","sourceRoot":"","sources":["../../../../../../../apps/api/src/modules/v4/diff/diff.repository.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,108 @@
+import { type DiffBreakdownQueryModel, type DiffQueryModel, type LeafBreakdownQueryModel, type LeafQueryModel } from "./diff.model";
+export declare abstract class DiffService {
+    /** Fetch paginated DiffBreakdown rows with optional filters and sorting */
+    static findManyDiffBreakdowns(query: DiffBreakdownQueryModel): Promise<{
+        distributionChainId: number;
+        tokenAddress: string;
+        recipient: string;
+        campaignId: string;
+        reason: string;
+        root: string;
+        amount: string;
+        claimed: string;
+        lastProcessedTimestamp: number;
+        createdAt: number | null;
+        publishAfterTimestamp: number | null;
+        merged: boolean;
+        mergedAt: Date | null;
+    }[]>;
+    /** Count DiffBreakdown rows matching filters */
+    static countDiffBreakdowns(query: DiffBreakdownQueryModel): Promise<number>;
+    /** Aggregated summary: merged/unmerged counts + total amount/claimed (absolute) */
+    static getBreakdownSummary(chainId: number, root: string, tokenAddress?: string, filters?: {
+        campaignId?: string;
+        recipient?: string;
+    }): Promise<{
+        total: number;
+        merged: number;
+        unmerged: number;
+        totalAmount: string;
+        totalClaimed: string;
+        positiveAmount: string;
+        negativeAmount: string;
+    }>;
+    /** Distinct token addresses for a chain + root */
+    static findDistinctTokens(chainId: number, root: string): Promise<string[]>;
+    /** Recent roots on a chain (last 7 days) */
+    static findRecentRoots(chainId: number): Promise<{
+        root: string;
+        chainId: number;
+        epoch: number;
+        timestamp: bigint;
+    }[]>;
+    /** Fetch paginated LeafBreakdown rows */
+    static findManyLeafBreakdowns(query: LeafBreakdownQueryModel): Promise<{
+        distributionChainId: number;
+        tokenAddress: string;
+        recipient: string;
+        campaignId: string;
+        reason: string;
+        amount: string;
+        claimed: string;
+        lastProcessedTimestamp: number;
+        subCampaignId: string | null;
+    }[]>;
+    /** Count LeafBreakdown rows matching filters */
+    static countLeafBreakdowns(query: LeafBreakdownQueryModel): Promise<number>;
+    /** Aggregated summary for LeafBreakdown */
+    static getLeafBreakdownSummary(chainId: number, tokenAddress: string, campaignId?: string, recipient?: string): Promise<{
+        total: number;
+        totalAmount: string;
+        totalClaimed: string;
+        positiveAmount: string;
+        negativeAmount: string;
+    }>;
+    /** Distinct token addresses for LeafBreakdown on a chain */
+    static findDistinctLeafTokens(chainId: number): Promise<string[]>;
+    /** Fetch paginated Diff rows */
+    static findManyDiffs(query: DiffQueryModel): Promise<{
+        distributionChainId: number;
+        tokenAddress: string;
+        recipient: string;
+        root: string;
+        amount: string;
+        claimed: string;
+        merged: boolean;
+        mergedAt: Date | null;
+    }[]>;
+    /** Count Diff rows */
+    static countDiffs(query: DiffQueryModel): Promise<number>;
+    /** Summary for Diff table */
+    static getDiffSummary(chainId: number, root: string, tokenAddress?: string, recipient?: string): Promise<{
+        total: number;
+        merged: number;
+        unmerged: number;
+        totalAmount: string;
+        totalClaimed: string;
+        positiveAmount: string;
+        negativeAmount: string;
+    }>;
+    /** Fetch paginated Leaf rows */
+    static findManyLeaves(query: LeafQueryModel): Promise<{
+        distributionChainId: number;
+        tokenAddress: string;
+        recipient: string;
+        amount: string;
+        claimed: string;
+    }[]>;
+    /** Count Leaf rows */
+    static countLeaves(query: LeafQueryModel): Promise<number>;
+    /** Summary for Leaf table */
+    static getLeafSummary(chainId: number, tokenAddress: string, recipient?: string): Promise<{
+        total: number;
+        totalAmount: string;
+        totalClaimed: string;
+        positiveAmount: string;
+        negativeAmount: string;
+    }>;
+}

package/dist/src/modules/v4/diff/diff.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.service.js","sourceRoot":"","sources":["../../../../../../../apps/api/src/modules/v4/diff/diff.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAGL,wBAAwB,EAGxB,eAAe,EAGf,wBAAwB,EAGxB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,8MAAgF;AAEhF,MAAM,OAAgB,WAAW;IAC/B,2EAA2E;IAC3E,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,KAA8B,EAAE;QAClE,MAAM,IAAI,GAAI,KAAK,CAAC,IAAgC,IAAI,WAAW,CAAC;QACpE,MAAM,KAAK,GAAI,KAAK,CAAC,KAAwB,IAAI,KAAK,CAAC;QACvD,MAAM,SAAS,GAAG,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;QAE/E,OAAO,MAAM,cAAc,CAAC,kBAAkB,CAC5C;YACE,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,EACD,uBAAuB,CAAC,KAAK,CAAC,EAC9B,SAAS,EACT,KAAK,CACN,CAAC;IAAA,CACH;IAED,gDAAgD;IAChD,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAA8B,EAAE;QAC/D,MAAM,KAAK,GAAG,cAAc,CAAC,mBAAmB,CAAC;YAC/C,mBAAmB,EAAE,KAAK,CAAC,OAAO;YAClC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QACH,OAAO,MAAM,cAAc,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAAA,CACpD;IAED,mFAAmF;IACnF,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAC9B,OAAe,EACf,IAAY,EACZ,YAAqB,EACrB,OAAqD,EACrD;QACA,MAAM,KAAK,GAAG,cAAc,CAAC,mBAAmB,CAAC;YAC/C,mBAAmB,EAAE,OAAO;YAC5B,IAAI;YACJ,YAAY;YACZ,UAAU,EAAE,OAAO,EAAE,UAAU;YAC/B,SAAS,EAAE,OAAO,EAAE,SAAS;SAC9B,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC/C,cAAc,CAAC,uBAAuB,CAAC,KAAK,CAAC;YAC7C,cAAc,CAAC,mBAAmB,CAAC,KAAK,CAAC;SAC1C,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;QAE3D,OAAO;YACL,KAAK,EAAE,MAAM,GAAG,QAAQ;YACxB,MAAM;YACN,QAAQ;YACR,WAAW,EAAE,WAAW,CAAC,WAAW;YACpC,YAAY,EAAE,WAAW,CAAC,YAAY;YACtC,cAAc,EAAE,WAAW,CAAC,cAAc;YAC1C,cAAc,EAAE,WAAW,CAAC,cAAc;SAC3C,CAAC;IAAA,CACH;IAED,kDAAkD;IAClD,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,OAAe,EAAE,IAAY,EAAE;QAC7D,OAAO,MAAM,cAAc,CAAC,kBAAkB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAAA,CAC/D;IAED,4CAA4C;IAC5C,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE;QAC5C,OAAO,MAAM,cAAc,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAAA,CACtD;IAED,6LAAiF;IAEjF,yCAAyC;IACzC,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,KAA8B,EAAE;QAClE,MAAM,IAAI,GAAI,KAAK,CAAC,IAAgC,IAAI,WAAW,CAAC;QACpE,MAAM,KAAK,GAAI,KAAK,CAAC,KAAwB,IAAI,KAAK,CAAC;QACvD,MAAM,SAAS,GAAG,wBAAwB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;QAE/E,OAAO,MAAM,cAAc,CAAC,sBAAsB,CAChD;YACE,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,EACD,uBAAuB,CAAC,KAAK,CAAC,EAC9B,SAAS,EACT,KAAK,CACN,CAAC;IAAA,CACH;IAED,gDAAgD;IAChD,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAA8B,EAAE;QAC/D,MAAM,KAAK,GAAG,cAAc,CAAC,uBAAuB,CAAC;YACnD,mBAAmB,EAAE,KAAK,CAAC,OAAO;YAClC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QACH,OAAO,MAAM,cAAc,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAAA,CACxD;IAED,2CAA2C;IAC3C,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,OAAe,EAAE,YAAoB,EAAE,UAAmB,EAAE,SAAkB,EAAE;QACnH,MAAM,KAAK,GAAG,cAAc,CAAC,uBAAuB,CAAC;YACnD,mBAAmB,EAAE,OAAO;YAC5B,YAAY;YACZ,UAAU;YACV,SAAS;SACV,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC7C,cAAc,CAAC,mBAAmB,CAAC,KAAK,CAAC;YACzC,cAAc,CAAC,uBAAuB,CAAC,KAAK,CAAC;SAC9C,CAAC,CAAC;QAEH,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,WAAW,EAAE,WAAW,CAAC,WAAW;YACpC,YAAY,EAAE,WAAW,CAAC,YAAY;YACtC,cAAc,EAAE,WAAW,CAAC,cAAc;YAC1C,cAAc,EAAE,WAAW,CAAC,cAAc;SAC3C,CAAC;IAAA,CACH;IAED,4DAA4D;IAC5D,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,OAAe,EAAE;QACnD,OAAO,MAAM,cAAc,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAAA,CAC7D;IAED,+LAAiF;IAEjF,gCAAgC;IAChC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,KAAqB,EAAE;QAChD,MAAM,IAAI,GAAI,KAAK,CAAC,IAAuB,IAAI,WAAW,CAAC;QAC3D,MAAM,KAAK,GAAI,KAAK,CAAC,KAAwB,IAAI,KAAK,CAAC;QACvD,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;QAEtE,OAAO,MAAM,cAAc,CAAC,aAAa,CACvC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,EAC1G,uBAAuB,CAAC,KAAK,CAAC,EAC9B,SAAS,EACT,KAAK,CACN,CAAC;IAAA,CACH;IAED,sBAAsB;IACtB,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,KAAqB,EAAE;QAC7C,MAAM,KAAK,GAAG,cAAc,CAAC,cAAc,CAAC;YAC1C,mBAAmB,EAAE,KAAK,CAAC,OAAO;YAClC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QACH,OAAO,MAAM,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAAA,CAC/C;IAED,6BAA6B;IAC7B,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,IAAY,EAAE,YAAqB,EAAE,SAAkB,EAAE;QACpG,MAAM,KAAK,GAAG,cAAc,CAAC,cAAc,CAAC,EAAE,mBAAmB,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QAE7G,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC/C,cAAc,CAAC,kBAAkB,CAAC,KAAK,CAAC;YACxC,cAAc,CAAC,cAAc,CAAC,KAAK,CAAC;SACrC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;QAE3D,OAAO;YACL,KAAK,EAAE,MAAM,GAAG,QAAQ;YACxB,MAAM;YACN,QAAQ;YACR,WAAW,EAAE,WAAW,CAAC,WAAW;YACpC,YAAY,EAAE,WAAW,CAAC,YAAY;YACtC,cAAc,EAAE,WAAW,CAAC,cAAc;YAC1C,cAAc,EAAE,WAAW,CAAC,cAAc;SAC3C,CAAC;IAAA,CACH;IAED,+LAAiF;IAEjF,gCAAgC;IAChC,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,KAAqB,EAAE;QACjD,MAAM,IAAI,GAAI,KAAK,CAAC,IAAuB,IAAI,WAAW,CAAC;QAC3D,MAAM,KAAK,GAAI,KAAK,CAAC,KAAwB,IAAI,KAAK,CAAC;QACvD,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;QAEtE,OAAO,MAAM,cAAc,CAAC,cAAc,CACxC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,EACxF,uBAAuB,CAAC,KAAK,CAAC,EAC9B,SAAS,EACT,KAAK,CACN,CAAC;IAAA,CACH;IAED,sBAAsB;IACtB,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,KAAqB,EAAE;QAC9C,MAAM,KAAK,GAAG,cAAc,CAAC,cAAc,CAAC;YAC1C,mBAAmB,EAAE,KAAK,CAAC,OAAO;YAClC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC,CAAC;QACH,OAAO,MAAM,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAAA,CAChD;IAED,6BAA6B;IAC7B,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,YAAoB,EAAE,SAAkB,EAAE;QACrF,MAAM,KAAK,GAAG,cAAc,CAAC,cAAc,CAAC,EAAE,mBAAmB,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QACvG,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC7C,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC;YACjC,cAAc,CAAC,eAAe,CAAC,KAAK,CAAC;SACtC,CAAC,CAAC;QAEH,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,WAAW,EAAE,WAAW,CAAC,WAAW;YACpC,YAAY,EAAE,WAAW,CAAC,YAAY;YACtC,cAAc,EAAE,WAAW,CAAC,cAAc;YAC1C,cAAc,EAAE,WAAW,CAAC,cAAc;SAC3C,CAAC;IAAA,CACH;CACF"}

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

@@ -1,4 +1,31 @@
+import type { apiDbClient, engineDbClient } from "@package/databases";
 import type { MerklRootService } from "../merklRoot/merklRoot.service";
+import type { LeafRepository } from "./leaf.repository";
+/** Shape of a leaf row as returned by LeafRepository.getByRecipient. */
+export type Leaf = Awaited<ReturnType<typeof LeafRepository.getByRecipient>>[number];
+/** Shape of a temp leaf row from the engine DB. */
+export type TempLeaf = Awaited<ReturnType<typeof engineDbClient.tempLeaves.findMany>>[number];
+/** Prisma include for pre-fetching campaign data alongside temp leaves. */
+export declare const campaignInclude: {
+    Opportunity: {
+        include: {
+            MainProtocol: true;
+            Chain: true;
+            Tokens: true;
+            ActivePrograms: true;
+            DepositUrls: {
+                orderBy: {
+                    priority: "asc";
+                };
+            };
+        };
+    };
+    CampaignStatus: true;
+};
+/** Campaign row with the standard include for temp-leaf reconciliation. */
+export type PrefetchedCampaign = Awaited<ReturnType<typeof apiDbClient.campaign.findMany<{
+    include: typeof campaignInclude;
+}>>>[number];
 /**
  * Minimal RewardBreakdown shape needed for correction.
  *

package/dist/src/modules/v4/leaf/leaf.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"leaf.model.js","sourceRoot":"","sources":["../../../../../../../apps/api/src/modules/v4/leaf/leaf.model.ts"],"names":[],"mappings":""}
+{"version":3,"file":"leaf.model.js","sourceRoot":"","sources":["../../../../../../../apps/api/src/modules/v4/leaf/leaf.model.ts"],"names":[],"mappings":"AAYA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,WAAW,EAAE;QACX,OAAO,EAAE;YACP,YAAY,EAAE,IAAa;YAC3B,KAAK,EAAE,IAAa;YACpB,MAAM,EAAE,IAAa;YACrB,cAAc,EAAE,IAAa;YAC7B,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAc,EAAE,EAAE;SACvD;KACF;IACD,cAAc,EAAE,IAAa;CAC9B,CAAC"}

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

@@ -1,6 +1,7 @@
 import type { TokenType } from "@package/resources/enums";
-import type { RootsByChain } from "./leaf.model";
+import { type RootsByChain } from "./leaf.model";
 export declare abstract class LeafRepository {
+    /** Paginates reward breakdowns, ordered by amount desc. */
     static getByRecipient(recipient: string, distributionChainIds: number[], roots: RootsByChain, tags: string[], options: {
         items?: number;
         page?: number;
@@ -317,9 +318,7 @@ export declare abstract class LeafRepository {
         amount: string;
         claimed: string;
     })[]>;
-    /**
-     * @notice Returns rewards and campaignIds from breakdowns matching (recipient, root, tokenId)
-     */
+    /** Returns leaf with all breakdowns matching (recipient, chainId, tokenAddress). */
     static getByChainRecipientToken(id: {
         distributionChainId: number;
         recipient: string;
@@ -343,4 +342,253 @@ export declare abstract class LeafRepository {
         amount: string;
         claimed: string;
     }) | null>;
+    /** Fetches pending temp leaves from the engine DB. */
+    static getTempLeaves(recipient: string, distributionChainIds: number[], reasonFilter?: string): Promise<{
+        chainId: number;
+        campaignId: string;
+        recipient: string;
+        reason: string;
+        rewardToken: string;
+        amount: string;
+        lastProcessedTimestamp: number;
+        createdAt: number;
+        publishAfterTimestamp: number | null;
+    }[]>;
+    /** Batch-fetches campaigns by (chainId, campaignId) pairs with standard includes. */
+    static getCampaignsByKeys(keys: Array<{
+        distributionChainId: number;
+        campaignId: string;
+    }>): Promise<({
+        CampaignStatus: {
+            campaignId: string;
+            computedUntil: bigint;
+            processingStarted: bigint;
+            status: import("@package/databases").RunStatus;
+            preComputeStatus: import("@package/databases").RunStatus;
+            preComputeProcessingStarted: bigint;
+            error: string;
+            details: import("@prisma/client/runtime/client").JsonValue;
+        }[];
+        Opportunity: {
+            ActivePrograms: {
+                id: string;
+                slug: string | null;
+                name: string;
+                description: string;
+                icon: string;
+            }[];
+            Chain: {
+                id: number;
+                name: string;
+                icon: string;
+                liveCampaigns: number;
+                endOfDisputePeriod: number;
+                lastClaimsOnchainFetchTimestamp: string | null;
+            };
+            DepositUrls: {
+                id: string;
+                title: string;
+                url: string;
+                subtitle: string | null;
+                icon: string | null;
+                priority: number;
+                opportunityId: string;
+            }[];
+            MainProtocol: {
+                id: string;
+                tags: string[];
+                name: string;
+                description: string;
+                url: string;
+                icon: string;
+                banner: string | null;
+                opportunityBannerLight: string | null;
+                opportunityBannerDark: string | null;
+            } | null;
+            Tokens: {
+                id: string;
+                name: string | null;
+                chainId: number;
+                address: string;
+                decimals: number;
+                symbol: string;
+                displaySymbol: string;
+                icon: string;
+                verified: boolean;
+                isTest: boolean;
+                type: import("@package/databases").TokenType;
+                isNative: boolean;
+                underlyingTokenId: string | null;
+                price: number | null;
+                updatedAt: number | null;
+                priceSource: string | null;
+            }[];
+        } & {
+            id: string;
+            chainId: number;
+            type: string;
+            identifier: string;
+            name: string;
+            description: string;
+            howToSteps: string[];
+            depositUrl: string | null;
+            explorerAddress: string | null;
+            status: import("@package/databases").Status;
+            action: import("@package/databases").OpportunityAction;
+            mainProtocolId: string | null;
+            tvl: number;
+            apr: number;
+            nativeApr: number | null;
+            maxApr: number | null;
+            dailyRewards: number;
+            tags: string[];
+            lastCampaignCreatedAt: Date;
+            manualOverrides: import("@package/databases").OpportunityManualOverride[];
+            liveCampaigns: number;
+            earliestCampaignStart: bigint | null;
+            latestCampaignStart: bigint | null;
+            earliestCampaignEnd: bigint | null;
+            latestCampaignEnd: bigint | null;
+            hidden: boolean;
+        };
+    } & {
+        id: string;
+        computeChainId: number;
+        distributionChainId: number;
+        campaignId: string;
+        type: string;
+        distributionType: import("@package/databases").DistributionType;
+        subType: number | null;
+        rewardTokenId: string;
+        amount: string;
+        opportunityId: string;
+        startTimestamp: bigint;
+        endTimestamp: bigint;
+        params: import("@prisma/client/runtime/client").JsonValue;
+        description: string | null;
+        pauseCompute: string | null;
+        dailyRewards: number;
+        apr: number;
+        creatorAddress: string;
+        manualOverrides: import("@package/databases").CampaignManualOverride[];
+        createdAt: Date;
+        rootCampaignId: string | null;
+        parentCampaignId: string | null;
+        isPrivate: boolean;
+        campaignEncodingHash: string | null;
+    })[]>;
+    /** Batch-fetches tokens by (chainId, address) pairs. */
+    static getTokensByKeys(keys: Array<{
+        chainId: number;
+        address: string;
+    }>): Promise<{
+        id: string;
+        name: string | null;
+        chainId: number;
+        address: string;
+        decimals: number;
+        symbol: string;
+        displaySymbol: string;
+        icon: string;
+        verified: boolean;
+        isTest: boolean;
+        type: import("@package/databases").TokenType;
+        isNative: boolean;
+        underlyingTokenId: string | null;
+        price: number | null;
+        updatedAt: number | null;
+        priceSource: string | null;
+    }[]>;
+    /** Creates a leaf record, swallowing duplicate-key errors. */
+    static createLeaf(data: {
+        distributionChainId: number;
+        recipient: string;
+        tokenAddress: string;
+        amount: string;
+        claimed: string;
+    }): Promise<void>;
+    /** Upserts a leaf breakdown for an unmatched temp leaf. */
+    static upsertLeafBreakdown(data: {
+        distributionChainId: number;
+        recipient: string;
+        tokenAddress: string;
+        campaignId: string;
+        reason: string;
+        subCampaignId: string | null;
+    }): Promise<void>;
+    /** Returns the amount of a leaf by composite key, or 0n if not found. */
+    static findLeafAmount(key: {
+        distributionChainId: number;
+        recipient: string;
+        tokenAddress: string;
+    }): Promise<bigint>;
+    /** Updates the claimed amount on a leaf. */
+    static updateLeafClaimed(key: {
+        distributionChainId: number;
+        recipient: string;
+        tokenAddress: string;
+    }, claimed: string): Promise<void>;
+    /** Finds an unmerged diff by composite key + root. */
+    static findUnmergedDiff(distributionChainId: number, recipient: string, tokenAddress: string, root: string): Promise<{
+        distributionChainId: number;
+        tokenAddress: string;
+        recipient: string;
+        root: string;
+        amount: string;
+        claimed: string;
+        merged: boolean;
+        mergedAt: Date | null;
+    } | null>;
+    /** Updates the claimed amount on a diff. */
+    static updateDiffClaimed(key: {
+        distributionChainId: number;
+        recipient: string;
+        tokenAddress: string;
+        root: string;
+    }, claimed: string): Promise<void>;
+    /** Finds all leaf breakdowns for a given (chainId, recipient, token). */
+    static findLeafBreakdowns(distributionChainId: number, recipient: string, tokenAddress: string): Promise<{
+        distributionChainId: number;
+        tokenAddress: string;
+        recipient: string;
+        campaignId: string;
+        reason: string;
+        amount: string;
+        claimed: string;
+        lastProcessedTimestamp: number;
+        subCampaignId: string | null;
+    }[]>;
+    /** Updates the claimed amount on a single leaf breakdown. */
+    static updateLeafBreakdownClaimed(key: {
+        distributionChainId: number;
+        recipient: string;
+        tokenAddress: string;
+        campaignId: string;
+        reason: string;
+    }, claimed: string): Promise<void>;
+    /** Finds all unmerged diff breakdowns for a given (chainId, recipient, token, root). */
+    static findDiffBreakdowns(distributionChainId: number, recipient: string, tokenAddress: string, root: string): Promise<{
+        distributionChainId: number;
+        tokenAddress: string;
+        recipient: string;
+        campaignId: string;
+        reason: string;
+        root: string;
+        amount: string;
+        claimed: string;
+        lastProcessedTimestamp: number;
+        createdAt: number | null;
+        publishAfterTimestamp: number | null;
+        merged: boolean;
+        mergedAt: Date | null;
+    }[]>;
+    /** Updates the claimed amount on a single diff breakdown. */
+    static updateDiffBreakdownClaimed(key: {
+        distributionChainId: number;
+        recipient: string;
+        tokenAddress: string;
+        campaignId: string;
+        reason: string;
+        root: string;
+    }, claimed: string): Promise<void>;
 }