@merkl/api 0.0.22

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

@@ -0,0 +1,901 @@
+import { type ChainId } from "@angleprotocol/sdk/ts";
+import { type CampaignManualOverride } from "@package/databases/api";
+import type { Campaign, CampaignUnique, CampaignWithParams, GetCampaignQueryModel } from "../../../modules/v4/campaign/campaign.model";
+export declare abstract class CampaignRepository {
+    static transformQueryToPrismaFilters(query: GetCampaignQueryModel): {
+        where: {
+            createdAt: {
+                gte: Date;
+            } | undefined;
+            rootCampaignId: {
+                equals: string;
+                mode: "insensitive";
+            } | undefined;
+            parentCampaignId: {
+                equals: string;
+                mode: "insensitive";
+            } | undefined;
+            endTimestamp: {
+                gte: number;
+                lt?: undefined;
+            };
+            startTimestamp: {
+                lte: number;
+                gt?: undefined;
+                gte?: undefined;
+            };
+            OR: {
+                id: string;
+            }[] | undefined;
+            distributionChainId: {
+                in: number[];
+            } | undefined;
+            computeChainId: number | undefined;
+            opportunityId: string | undefined;
+            campaignId: string | undefined;
+            Opportunity: {
+                identifier: string | undefined;
+            };
+            subType: number | undefined;
+            type: string | {
+                in: string[];
+            } | undefined;
+            creatorAddress: string | undefined;
+            RewardToken: {
+                address: string | undefined;
+                symbol: string | undefined;
+                OR: ({
+                    symbol: {
+                        equals: string;
+                        mode: "insensitive";
+                    };
+                    displaySymbol?: undefined;
+                } | {
+                    displaySymbol: {
+                        equals: string;
+                        mode: "insensitive";
+                    };
+                    symbol?: undefined;
+                })[] | undefined;
+                isTest: false | undefined;
+                isPoint: boolean | undefined;
+            };
+            Creator: {
+                OR: ({
+                    Creator: {
+                        id: string;
+                    };
+                    tags?: undefined;
+                } | {
+                    tags: {
+                        has: string;
+                    };
+                    Creator?: undefined;
+                })[];
+                Creator?: undefined;
+                tags?: undefined;
+            } | {
+                Creator: {
+                    id: string;
+                };
+                OR?: undefined;
+                tags?: undefined;
+            } | {
+                tags: {
+                    has: string;
+                };
+                OR?: undefined;
+                Creator?: undefined;
+            } | undefined;
+        } | {
+            createdAt: {
+                gte: Date;
+            } | undefined;
+            rootCampaignId: {
+                equals: string;
+                mode: "insensitive";
+            } | undefined;
+            parentCampaignId: {
+                equals: string;
+                mode: "insensitive";
+            } | undefined;
+            endTimestamp: {
+                lt: number;
+                gte?: undefined;
+            };
+            startTimestamp?: undefined;
+            OR: {
+                id: string;
+            }[] | undefined;
+            distributionChainId: {
+                in: number[];
+            } | undefined;
+            computeChainId: number | undefined;
+            opportunityId: string | undefined;
+            campaignId: string | undefined;
+            Opportunity: {
+                identifier: string | undefined;
+            };
+            subType: number | undefined;
+            type: string | {
+                in: string[];
+            } | undefined;
+            creatorAddress: string | undefined;
+            RewardToken: {
+                address: string | undefined;
+                symbol: string | undefined;
+                OR: ({
+                    symbol: {
+                        equals: string;
+                        mode: "insensitive";
+                    };
+                    displaySymbol?: undefined;
+                } | {
+                    displaySymbol: {
+                        equals: string;
+                        mode: "insensitive";
+                    };
+                    symbol?: undefined;
+                })[] | undefined;
+                isTest: false | undefined;
+                isPoint: boolean | undefined;
+            };
+            Creator: {
+                OR: ({
+                    Creator: {
+                        id: string;
+                    };
+                    tags?: undefined;
+                } | {
+                    tags: {
+                        has: string;
+                    };
+                    Creator?: undefined;
+                })[];
+                Creator?: undefined;
+                tags?: undefined;
+            } | {
+                Creator: {
+                    id: string;
+                };
+                OR?: undefined;
+                tags?: undefined;
+            } | {
+                tags: {
+                    has: string;
+                };
+                OR?: undefined;
+                Creator?: undefined;
+            } | undefined;
+        } | {
+            createdAt: {
+                gte: Date;
+            } | undefined;
+            rootCampaignId: {
+                equals: string;
+                mode: "insensitive";
+            } | undefined;
+            parentCampaignId: {
+                equals: string;
+                mode: "insensitive";
+            } | undefined;
+            startTimestamp: {
+                gt: number;
+                lte?: undefined;
+                gte?: undefined;
+            };
+            endTimestamp?: undefined;
+            OR: {
+                id: string;
+            }[] | undefined;
+            distributionChainId: {
+                in: number[];
+            } | undefined;
+            computeChainId: number | undefined;
+            opportunityId: string | undefined;
+            campaignId: string | undefined;
+            Opportunity: {
+                identifier: string | undefined;
+            };
+            subType: number | undefined;
+            type: string | {
+                in: string[];
+            } | undefined;
+            creatorAddress: string | undefined;
+            RewardToken: {
+                address: string | undefined;
+                symbol: string | undefined;
+                OR: ({
+                    symbol: {
+                        equals: string;
+                        mode: "insensitive";
+                    };
+                    displaySymbol?: undefined;
+                } | {
+                    displaySymbol: {
+                        equals: string;
+                        mode: "insensitive";
+                    };
+                    symbol?: undefined;
+                })[] | undefined;
+                isTest: false | undefined;
+                isPoint: boolean | undefined;
+            };
+            Creator: {
+                OR: ({
+                    Creator: {
+                        id: string;
+                    };
+                    tags?: undefined;
+                } | {
+                    tags: {
+                        has: string;
+                    };
+                    Creator?: undefined;
+                })[];
+                Creator?: undefined;
+                tags?: undefined;
+            } | {
+                Creator: {
+                    id: string;
+                };
+                OR?: undefined;
+                tags?: undefined;
+            } | {
+                tags: {
+                    has: string;
+                };
+                OR?: undefined;
+                Creator?: undefined;
+            } | undefined;
+        } | {
+            createdAt: {
+                gte: Date;
+            } | undefined;
+            rootCampaignId: {
+                equals: string;
+                mode: "insensitive";
+            } | undefined;
+            parentCampaignId: {
+                equals: string;
+                mode: "insensitive";
+            } | undefined;
+            endTimestamp: {
+                gte: number;
+                lt?: undefined;
+            } | undefined;
+            startTimestamp: {
+                gte: number;
+                lte?: undefined;
+                gt?: undefined;
+            } | undefined;
+            OR: {
+                id: string;
+            }[] | undefined;
+            distributionChainId: {
+                in: number[];
+            } | undefined;
+            computeChainId: number | undefined;
+            opportunityId: string | undefined;
+            campaignId: string | undefined;
+            Opportunity: {
+                identifier: string | undefined;
+            };
+            subType: number | undefined;
+            type: string | {
+                in: string[];
+            } | undefined;
+            creatorAddress: string | undefined;
+            RewardToken: {
+                address: string | undefined;
+                symbol: string | undefined;
+                OR: ({
+                    symbol: {
+                        equals: string;
+                        mode: "insensitive";
+                    };
+                    displaySymbol?: undefined;
+                } | {
+                    displaySymbol: {
+                        equals: string;
+                        mode: "insensitive";
+                    };
+                    symbol?: undefined;
+                })[] | undefined;
+                isTest: false | undefined;
+                isPoint: boolean | undefined;
+            };
+            Creator: {
+                OR: ({
+                    Creator: {
+                        id: string;
+                    };
+                    tags?: undefined;
+                } | {
+                    tags: {
+                        has: string;
+                    };
+                    Creator?: undefined;
+                })[];
+                Creator?: undefined;
+                tags?: undefined;
+            } | {
+                Creator: {
+                    id: string;
+                };
+                OR?: undefined;
+                tags?: undefined;
+            } | {
+                tags: {
+                    has: string;
+                };
+                OR?: undefined;
+                Creator?: undefined;
+            } | undefined;
+        };
+    };
+    /**
+     * Retrieves all past campaigns from the database.
+     * A campaign is considered past if the current timestamp is greater than the campaign's end timestamp.
+     *
+     * @returns A promise that resolves to an array of past campaigns.
+     *
+     * @dev Excludes test campaigns
+     */
+    static getPastCampaigns(query?: {
+        computeChainId?: number;
+        type?: string;
+        creatorId?: string;
+        creatorAddress?: string;
+    }): Promise<({
+        Opportunity: {
+            name: string;
+            apr: number;
+            tvl: number;
+            description: string;
+            id: string;
+            status: import("@package/databases").Status;
+            chainId: number;
+            action: import("@package/databases").OpportunityAction;
+            type: string;
+            depositUrl: string | null;
+            explorerAddress: string | null;
+            howToSteps: string[];
+            mainProtocolId: string | null;
+            manualOverrides: import("@package/databases").OpportunityManualOverride[];
+            identifier: string;
+            dailyRewards: number;
+            tags: string[];
+            lastCampaignCreatedAt: Date;
+        };
+    } & {
+        campaignId: string;
+        description: string | null;
+        id: string;
+        params: import("@prisma/client/runtime/library").JsonValue;
+        amount: string;
+        startTimestamp: bigint;
+        type: string;
+        computeChainId: number;
+        distributionChainId: number;
+        endTimestamp: bigint;
+        opportunityId: string;
+        creatorAddress: string;
+        distributionType: import("@package/databases").DistributionType;
+        subType: number | null;
+        rewardTokenId: string;
+        manualOverrides: import("@package/databases").CampaignManualOverride[];
+        createdAt: Date;
+        rootCampaignId: string | null;
+        parentCampaignId: string | null;
+    })[]>;
+    /**
+     * Retrieves all past campaigns from the database.
+     * A campaign is considered past if the current timestamp is greater than the campaign's end timestamp.
+     *
+     * @returns A promise that resolves to an array of past campaigns.
+     *
+     * @dev Excludes test campaigns
+     */
+    static getFutureCampaigns(query?: {
+        computeChainId?: number;
+        type?: string;
+        creatorId?: string;
+        creatorAddress?: string;
+    }): Promise<({
+        Opportunity: {
+            name: string;
+            apr: number;
+            tvl: number;
+            description: string;
+            id: string;
+            status: import("@package/databases").Status;
+            chainId: number;
+            action: import("@package/databases").OpportunityAction;
+            type: string;
+            depositUrl: string | null;
+            explorerAddress: string | null;
+            howToSteps: string[];
+            mainProtocolId: string | null;
+            manualOverrides: import("@package/databases").OpportunityManualOverride[];
+            identifier: string;
+            dailyRewards: number;
+            tags: string[];
+            lastCampaignCreatedAt: Date;
+        };
+    } & {
+        campaignId: string;
+        description: string | null;
+        id: string;
+        params: import("@prisma/client/runtime/library").JsonValue;
+        amount: string;
+        startTimestamp: bigint;
+        type: string;
+        computeChainId: number;
+        distributionChainId: number;
+        endTimestamp: bigint;
+        opportunityId: string;
+        creatorAddress: string;
+        distributionType: import("@package/databases").DistributionType;
+        subType: number | null;
+        rewardTokenId: string;
+        manualOverrides: import("@package/databases").CampaignManualOverride[];
+        createdAt: Date;
+        rootCampaignId: string | null;
+        parentCampaignId: string | null;
+    })[]>;
+    /**
+     * Retrieves all live campaigns from the database.
+     * A campaign is considered live if the current timestamp is between the campaign's start and end timestamps.
+     *
+     * @returns A promise that resolves to an array of live campaigns.
+     *
+     * @dev Excludes test campaigns
+     */
+    static getLiveCampaigns(query?: {
+        distributionChainId?: number;
+        computeChainId?: number;
+        type?: string;
+        creatorId?: string;
+        creatorAddress?: string;
+    }): Promise<({
+        RewardToken: {
+            symbol: string;
+            name: string | null;
+            decimals: number;
+            price: number | null;
+            address: string;
+            id: string;
+            chainId: number;
+            icon: string;
+            isNative: boolean;
+            isPoint: boolean;
+            isPreTGE: boolean;
+            isTest: boolean;
+            verified: boolean;
+            displaySymbol: string;
+        };
+        Opportunity: {
+            name: string;
+            apr: number;
+            tvl: number;
+            description: string;
+            id: string;
+            status: import("@package/databases").Status;
+            chainId: number;
+            action: import("@package/databases").OpportunityAction;
+            type: string;
+            depositUrl: string | null;
+            explorerAddress: string | null;
+            howToSteps: string[];
+            mainProtocolId: string | null;
+            manualOverrides: import("@package/databases").OpportunityManualOverride[];
+            identifier: string;
+            dailyRewards: number;
+            tags: string[];
+            lastCampaignCreatedAt: Date;
+        };
+        RewardBreakdown: ({
+            Reward: {
+                claimed: string;
+                id: string;
+                recipient: string;
+                amount: string;
+                root: string;
+                proofs: string[];
+                pending: string;
+                rewardTokenId: string;
+            };
+        } & {
+            protocolId: string | null;
+            campaignId: string;
+            claimed: string;
+            id: string;
+            amount: string;
+            reason: string;
+            rewardId: string;
+            pending: string;
+            subCampaignId: string | null;
+        })[];
+    } & {
+        campaignId: string;
+        description: string | null;
+        id: string;
+        params: import("@prisma/client/runtime/library").JsonValue;
+        amount: string;
+        startTimestamp: bigint;
+        type: string;
+        computeChainId: number;
+        distributionChainId: number;
+        endTimestamp: bigint;
+        opportunityId: string;
+        creatorAddress: string;
+        distributionType: import("@package/databases").DistributionType;
+        subType: number | null;
+        rewardTokenId: string;
+        manualOverrides: import("@package/databases").CampaignManualOverride[];
+        createdAt: Date;
+        rootCampaignId: string | null;
+        parentCampaignId: string | null;
+    })[]>;
+    static countLives(query?: {
+        distributionChainId?: number;
+        computeChainId?: number;
+        type?: string;
+    }, includeSubCampaigns?: boolean): Promise<number>;
+    /**
+     * Upserts a campaign in the database. If the campaign already exists, it updates the existing record;
+     * otherwise, it creates a new one.
+     *
+     * @param {CreateCampaignModel} campaign - The campaign data to be upserted.
+     * @returns The upserted campaign record.
+     *
+     * @dev Should be the only way of creating campaigns in the database.
+     *
+     * @throws {Error} If unable to fetch data for the reward token.
+     *
+     * @remarks
+     * This method performs the following steps:
+     * 1. Determines the campaign type from the provided campaign data.
+     * 2. Computes the opportunity ID based on the campaign data.
+     * 3. Constructs the data object for the campaign to be upserted.
+     * 4. Upserts the campaign in the database using the constructed data object.
+     * 5. Logs an error if the upsert operation fails.
+     */
+    static upsert(campaign: Omit<CampaignWithParams, "manualOverrides">, opportunityIdentifier: string): Promise<{
+        campaignId: string;
+        description: string | null;
+        id: string;
+        params: import("@prisma/client/runtime/library").JsonValue;
+        amount: string;
+        startTimestamp: bigint;
+        type: string;
+        computeChainId: number;
+        distributionChainId: number;
+        endTimestamp: bigint;
+        opportunityId: string;
+        creatorAddress: string;
+        distributionType: import("@package/databases").DistributionType;
+        subType: number | null;
+        rewardTokenId: string;
+        manualOverrides: import("@package/databases").CampaignManualOverride[];
+        createdAt: Date;
+        rootCampaignId: string | null;
+        parentCampaignId: string | null;
+    } | undefined>;
+    /**
+     * Retrieves a campaign from the engine database by its chain and campaign id.
+     * @dev Types are different from the API database.
+     * @dev IDs are different from the API database.
+     * id in the engine database = campaignId in the API database
+     */
+    static getFromEngineDbWithId(campaignIds: CampaignUnique[]): Promise<{
+        rewardToken: string;
+        campaignId: string;
+        creator: string;
+        amount: string;
+        index: number;
+        chainId: number;
+        campaignType: number;
+        startTimestamp: number;
+        computeChainId: number;
+        endTimestamp: number;
+        campaignParameters: import("@prisma/client/runtime/library").JsonValue;
+        campaignSubType: number;
+        mainParameter: string;
+    }[]>;
+    static findUnique(id: string): Promise<({
+        ComputeChain: {
+            name: string;
+            id: number;
+            icon: string;
+        };
+        DistributionChain: {
+            name: string;
+            id: number;
+            icon: string;
+        };
+        RewardToken: {
+            symbol: string;
+            name: string | null;
+            decimals: number;
+            price: number | null;
+            address: string;
+            id: string;
+            chainId: number;
+            icon: string;
+            isNative: boolean;
+            isPoint: boolean;
+            isPreTGE: boolean;
+            isTest: boolean;
+            verified: boolean;
+            displaySymbol: string;
+        };
+        Creator: {
+            address: string;
+            tags: string[];
+            creatorId: string | null;
+        };
+        CampaignStatus: {
+            campaignId: string;
+            error: string;
+            status: import("@package/databases").RunStatus;
+            details: import("@prisma/client/runtime/library").JsonValue;
+            computedUntil: bigint;
+            processingStarted: bigint;
+        }[];
+    } & {
+        campaignId: string;
+        description: string | null;
+        id: string;
+        params: import("@prisma/client/runtime/library").JsonValue;
+        amount: string;
+        startTimestamp: bigint;
+        type: string;
+        computeChainId: number;
+        distributionChainId: number;
+        endTimestamp: bigint;
+        opportunityId: string;
+        creatorAddress: string;
+        distributionType: import("@package/databases").DistributionType;
+        subType: number | null;
+        rewardTokenId: string;
+        manualOverrides: import("@package/databases").CampaignManualOverride[];
+        createdAt: Date;
+        rootCampaignId: string | null;
+        parentCampaignId: string | null;
+    }) | null>;
+    static findUniqueOrThrow(id: string, withOpportunity: boolean): Promise<{
+        ComputeChain: {
+            name: string;
+            id: number;
+            icon: string;
+        };
+        DistributionChain: {
+            name: string;
+            id: number;
+            icon: string;
+        };
+        RewardToken: {
+            symbol: string;
+            name: string | null;
+            decimals: number;
+            price: number | null;
+            address: string;
+            id: string;
+            chainId: number;
+            icon: string;
+            isNative: boolean;
+            isPoint: boolean;
+            isPreTGE: boolean;
+            isTest: boolean;
+            verified: boolean;
+            displaySymbol: string;
+        };
+        Opportunity: {
+            name: string;
+            apr: number;
+            tvl: number;
+            description: string;
+            id: string;
+            status: import("@package/databases").Status;
+            chainId: number;
+            action: import("@package/databases").OpportunityAction;
+            type: string;
+            depositUrl: string | null;
+            explorerAddress: string | null;
+            howToSteps: string[];
+            mainProtocolId: string | null;
+            manualOverrides: import("@package/databases").OpportunityManualOverride[];
+            identifier: string;
+            dailyRewards: number;
+            tags: string[];
+            lastCampaignCreatedAt: Date;
+        };
+        Creator: {
+            address: string;
+            tags: string[];
+            creatorId: string | null;
+        };
+        CampaignStatus: {
+            campaignId: string;
+            error: string;
+            status: import("@package/databases").RunStatus;
+            details: import("@prisma/client/runtime/library").JsonValue;
+            computedUntil: bigint;
+            processingStarted: bigint;
+        }[];
+    } & {
+        campaignId: string;
+        description: string | null;
+        id: string;
+        params: import("@prisma/client/runtime/library").JsonValue;
+        amount: string;
+        startTimestamp: bigint;
+        type: string;
+        computeChainId: number;
+        distributionChainId: number;
+        endTimestamp: bigint;
+        opportunityId: string;
+        creatorAddress: string;
+        distributionType: import("@package/databases").DistributionType;
+        subType: number | null;
+        rewardTokenId: string;
+        manualOverrides: import("@package/databases").CampaignManualOverride[];
+        createdAt: Date;
+        rootCampaignId: string | null;
+        parentCampaignId: string | null;
+    }>;
+    static findCampaignsToProcess(distributionChainId: ChainId): Promise<{
+        campaignId: string;
+        endTimestamp: bigint;
+        CampaignStatus: {
+            status: import("@package/databases").RunStatus;
+            computedUntil: bigint;
+            processingStarted: bigint;
+        }[];
+    }[]>;
+    static findMany(query: GetCampaignQueryModel): Promise<({
+        ComputeChain: {
+            name: string;
+            id: number;
+            icon: string;
+        };
+        DistributionChain: {
+            name: string;
+            id: number;
+            icon: string;
+        };
+        RewardToken: {
+            symbol: string;
+            name: string | null;
+            decimals: number;
+            price: number | null;
+            address: string;
+            id: string;
+            chainId: number;
+            icon: string;
+            isNative: boolean;
+            isPoint: boolean;
+            isPreTGE: boolean;
+            isTest: boolean;
+            verified: boolean;
+            displaySymbol: string;
+        };
+        Opportunity: {
+            name: string;
+            apr: number;
+            tvl: number;
+            description: string;
+            id: string;
+            status: import("@package/databases").Status;
+            chainId: number;
+            action: import("@package/databases").OpportunityAction;
+            type: string;
+            depositUrl: string | null;
+            explorerAddress: string | null;
+            howToSteps: string[];
+            mainProtocolId: string | null;
+            manualOverrides: import("@package/databases").OpportunityManualOverride[];
+            identifier: string;
+            dailyRewards: number;
+            tags: string[];
+            lastCampaignCreatedAt: Date;
+        };
+        Creator: {
+            address: string;
+            tags: string[];
+            creatorId: string | null;
+        };
+        CampaignStatus: {
+            campaignId: string;
+            error: string;
+            status: import("@package/databases").RunStatus;
+            details: import("@prisma/client/runtime/library").JsonValue;
+            computedUntil: bigint;
+            processingStarted: bigint;
+        }[];
+    } & {
+        campaignId: string;
+        description: string | null;
+        id: string;
+        params: import("@prisma/client/runtime/library").JsonValue;
+        amount: string;
+        startTimestamp: bigint;
+        type: string;
+        computeChainId: number;
+        distributionChainId: number;
+        endTimestamp: bigint;
+        opportunityId: string;
+        creatorAddress: string;
+        distributionType: import("@package/databases").DistributionType;
+        subType: number | null;
+        rewardTokenId: string;
+        manualOverrides: import("@package/databases").CampaignManualOverride[];
+        createdAt: Date;
+        rootCampaignId: string | null;
+        parentCampaignId: string | null;
+    })[]>;
+    static countMany(query: GetCampaignQueryModel): Promise<number>;
+    static findChains(): Promise<Record<string, ChainId>>;
+    static addManualOverride(id: string, field: CampaignManualOverride): Promise<void>;
+    static removeManualOverride(id: string, field: CampaignManualOverride): Promise<void>;
+    static updateOpportunity(id: string, opportunityId: string): Promise<void>;
+    static updateCreator(id: string, creatorAddress: string): Promise<void>;
+    static updateParams(id: string, params: string): Promise<{
+        campaignId: string;
+        description: string | null;
+        id: string;
+        params: import("@prisma/client/runtime/library").JsonValue;
+        amount: string;
+        startTimestamp: bigint;
+        type: string;
+        computeChainId: number;
+        distributionChainId: number;
+        endTimestamp: bigint;
+        opportunityId: string;
+        creatorAddress: string;
+        distributionType: import("@package/databases").DistributionType;
+        subType: number | null;
+        rewardTokenId: string;
+        manualOverrides: import("@package/databases").CampaignManualOverride[];
+        createdAt: Date;
+        rootCampaignId: string | null;
+        parentCampaignId: string | null;
+    }>;
+    static getTvlRecords(campaign: {
+        opportunityId: string;
+        startTimestamp: bigint;
+        endTimestamp: bigint;
+    }): Promise<{
+        timestamp: bigint;
+        total: number;
+    }[]>;
+    static getAprRecords(campaign: Campaign["raw"]): Promise<{
+        timestamp: bigint;
+        apr: number;
+    }[]>;
+    static getDailyRewardsRecords(campaign: {
+        opportunityId: string;
+        startTimestamp: bigint;
+        endTimestamp: bigint;
+    }): Promise<{
+        timestamp: bigint;
+        total: number;
+    }[]>;
+    static getWalletCount(campaign: {
+        id: string;
+        opportunityId: string;
+        startTimestamp: bigint;
+        endTimestamp: bigint;
+    }): Promise<number>;
+    static getWalletCountOverTime(campaign: {
+        id: string;
+        opportunityId: string;
+        startTimestamp: bigint;
+        endTimestamp: bigint;
+    }): Promise<{
+        timestamp: bigint;
+        walletCount: number;
+    }[]>;
+}