@polygonlabs/staker-pool-allocations-client 0.1.0

package/dist/generated/@tanstack/react-query.gen.d.ts

@@ -0,0 +1,796 @@
+import { type InfiniteData } from '@tanstack/react-query';
+import type { GetAddressAllocationHistoryError, GetAllocationError, GetDistributionError, GetProofError, GetUnclaimedProofsError, ListExcludedAllocationsError } from '../registry-validator.gen.js';
+import { type Options } from '../sdk.gen.js';
+import type { GetAddressAllocationHistoryData, GetAllocationData, GetDistributionData, GetHealthCheckData, GetProofData, GetReadinessData, GetUnclaimedProofsData, ListAllocationsData, ListDistributionsData, ListExcludedAllocationsData } from '../types.gen.js';
+export type QueryKey<TOptions extends Options> = [
+    Pick<TOptions, 'baseUrl' | 'body' | 'headers' | 'path' | 'query'> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }
+];
+export declare const getHealthCheckQueryKey: (options?: Options<GetHealthCheckData>) => [Pick<Options<GetHealthCheckData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}];
+/**
+ * Liveness check (K8s probe)
+ */
+export declare const getHealthCheckOptions: (options?: Options<GetHealthCheckData>) => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    status: "ok";
+}, {
+    error: true;
+    message: string;
+    info?: Record<string, unknown> | undefined;
+}, {
+    status: "ok";
+}, [Pick<Options<GetHealthCheckData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        status: "ok";
+    }, [Pick<Options<GetHealthCheckData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }], never> | undefined;
+} & {
+    queryKey: [Pick<Options<GetHealthCheckData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }] & {
+        [dataTagSymbol]: {
+            status: "ok";
+        };
+        [dataTagErrorSymbol]: {
+            error: true;
+            message: string;
+            info?: Record<string, unknown> | undefined;
+        };
+    };
+};
+export declare const getReadinessQueryKey: (options?: Options<GetReadinessData>) => [Pick<Options<GetReadinessData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}];
+/**
+ * Readiness check
+ *
+ * Distinguishes "fully ready" from "partially degraded but still serving". Currently a 200 stub — the real DB + subgraph reachability probe is outstanding work.
+ */
+export declare const getReadinessOptions: (options?: Options<GetReadinessData>) => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    status: "ok";
+}, {
+    error: true;
+    message: string;
+    info?: Record<string, unknown> | undefined;
+}, {
+    status: "ok";
+}, [Pick<Options<GetReadinessData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        status: "ok";
+    }, [Pick<Options<GetReadinessData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }], never> | undefined;
+} & {
+    queryKey: [Pick<Options<GetReadinessData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }] & {
+        [dataTagSymbol]: {
+            status: "ok";
+        };
+        [dataTagErrorSymbol]: {
+            error: true;
+            message: string;
+            info?: Record<string, unknown> | undefined;
+        };
+    };
+};
+export declare const listDistributionsQueryKey: (options: Options<ListDistributionsData>) => [Pick<Options<ListDistributionsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}];
+/**
+ * List completed distributions
+ *
+ * Paginated list of completed distributions, oldest first by id (e.g. `2026-04`). Non-completed rows are not surfaced on the public API.
+ */
+export declare const listDistributionsOptions: (options: Options<ListDistributionsData>) => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    items: {
+        distributionId: string;
+        status: "pending" | "running" | "completed" | "failed";
+        startPoSBlock: string;
+        endPoSBlock: string;
+        merkleRoot: string | null;
+        totalAllocated: string | null;
+        completedAt: string | null;
+    }[];
+    nextCursor: string | null;
+}, {
+    error: true;
+    message: string;
+    info?: Record<string, unknown> | undefined;
+}, {
+    items: {
+        distributionId: string;
+        status: "pending" | "running" | "completed" | "failed";
+        startPoSBlock: string;
+        endPoSBlock: string;
+        merkleRoot: string | null;
+        totalAllocated: string | null;
+        completedAt: string | null;
+    }[];
+    nextCursor: string | null;
+}, [Pick<Options<ListDistributionsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        items: {
+            distributionId: string;
+            status: "pending" | "running" | "completed" | "failed";
+            startPoSBlock: string;
+            endPoSBlock: string;
+            merkleRoot: string | null;
+            totalAllocated: string | null;
+            completedAt: string | null;
+        }[];
+        nextCursor: string | null;
+    }, [Pick<Options<ListDistributionsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }], never> | undefined;
+} & {
+    queryKey: [Pick<Options<ListDistributionsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }] & {
+        [dataTagSymbol]: {
+            items: {
+                distributionId: string;
+                status: "pending" | "running" | "completed" | "failed";
+                startPoSBlock: string;
+                endPoSBlock: string;
+                merkleRoot: string | null;
+                totalAllocated: string | null;
+                completedAt: string | null;
+            }[];
+            nextCursor: string | null;
+        };
+        [dataTagErrorSymbol]: {
+            error: true;
+            message: string;
+            info?: Record<string, unknown> | undefined;
+        };
+    };
+};
+export declare const listDistributionsInfiniteQueryKey: (options: Options<ListDistributionsData>) => QueryKey<Options<ListDistributionsData>>;
+/**
+ * List completed distributions
+ *
+ * Paginated list of completed distributions, oldest first by id (e.g. `2026-04`). Non-completed rows are not surfaced on the public API.
+ */
+export declare const listDistributionsInfiniteOptions: (options: Options<ListDistributionsData>) => import("@tanstack/react-query").UseInfiniteQueryOptions<{
+    items: {
+        distributionId: string;
+        status: "pending" | "running" | "completed" | "failed";
+        startPoSBlock: string;
+        endPoSBlock: string;
+        merkleRoot: string | null;
+        totalAllocated: string | null;
+        completedAt: string | null;
+    }[];
+    nextCursor: string | null;
+}, {
+    error: true;
+    message: string;
+    info?: Record<string, unknown> | undefined;
+}, InfiniteData<{
+    items: {
+        distributionId: string;
+        status: "pending" | "running" | "completed" | "failed";
+        startPoSBlock: string;
+        endPoSBlock: string;
+        merkleRoot: string | null;
+        totalAllocated: string | null;
+        completedAt: string | null;
+    }[];
+    nextCursor: string | null;
+}, unknown>, QueryKey<Options<ListDistributionsData>>, string | Pick<Pick<Options<ListDistributionsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}, "query" | "body" | "headers" | "path">> & {
+    initialData: InfiniteData<{
+        items: {
+            distributionId: string;
+            status: "pending" | "running" | "completed" | "failed";
+            startPoSBlock: string;
+            endPoSBlock: string;
+            merkleRoot: string | null;
+            totalAllocated: string | null;
+            completedAt: string | null;
+        }[];
+        nextCursor: string | null;
+    }, string | Pick<Pick<Options<ListDistributionsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }, "query" | "body" | "headers" | "path">> | (() => InfiniteData<{
+        items: {
+            distributionId: string;
+            status: "pending" | "running" | "completed" | "failed";
+            startPoSBlock: string;
+            endPoSBlock: string;
+            merkleRoot: string | null;
+            totalAllocated: string | null;
+            completedAt: string | null;
+        }[];
+        nextCursor: string | null;
+    }, string | Pick<Pick<Options<ListDistributionsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }, "query" | "body" | "headers" | "path">>) | undefined;
+} & {
+    queryKey: QueryKey<Options<ListDistributionsData>> & {
+        [dataTagSymbol]: InfiniteData<{
+            items: {
+                distributionId: string;
+                status: "pending" | "running" | "completed" | "failed";
+                startPoSBlock: string;
+                endPoSBlock: string;
+                merkleRoot: string | null;
+                totalAllocated: string | null;
+                completedAt: string | null;
+            }[];
+            nextCursor: string | null;
+        }, unknown>;
+        [dataTagErrorSymbol]: {
+            error: true;
+            message: string;
+            info?: Record<string, unknown> | undefined;
+        };
+    };
+};
+export declare const getDistributionQueryKey: (options: Options<GetDistributionData>) => [Pick<Options<GetDistributionData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}];
+/**
+ * Get a single completed distribution
+ */
+export declare const getDistributionOptions: (options: Options<GetDistributionData>) => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    distributionId: string;
+    status: "pending" | "running" | "completed" | "failed";
+    startPoSBlock: string;
+    endPoSBlock: string;
+    merkleRoot: string | null;
+    totalAllocated: string | null;
+    completedAt: string | null;
+    checkpointCount: number;
+    polUsdPrice: string | null;
+    maxClaimableUsdThreshold: string | null;
+    inputsHash: string | null;
+    posStakingSubgraphBlock: string | null;
+    posStakingSubgraphHash: string | null;
+    posCheckpointsSubgraphBlock: string | null;
+    posCheckpointsSubgraphHash: string | null;
+    posPriorityFeesSubgraphBlock: string | null;
+    posPriorityFeesSubgraphHash: string | null;
+}, GetDistributionError, {
+    distributionId: string;
+    status: "pending" | "running" | "completed" | "failed";
+    startPoSBlock: string;
+    endPoSBlock: string;
+    merkleRoot: string | null;
+    totalAllocated: string | null;
+    completedAt: string | null;
+    checkpointCount: number;
+    polUsdPrice: string | null;
+    maxClaimableUsdThreshold: string | null;
+    inputsHash: string | null;
+    posStakingSubgraphBlock: string | null;
+    posStakingSubgraphHash: string | null;
+    posCheckpointsSubgraphBlock: string | null;
+    posCheckpointsSubgraphHash: string | null;
+    posPriorityFeesSubgraphBlock: string | null;
+    posPriorityFeesSubgraphHash: string | null;
+}, [Pick<Options<GetDistributionData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        distributionId: string;
+        status: "pending" | "running" | "completed" | "failed";
+        startPoSBlock: string;
+        endPoSBlock: string;
+        merkleRoot: string | null;
+        totalAllocated: string | null;
+        completedAt: string | null;
+        checkpointCount: number;
+        polUsdPrice: string | null;
+        maxClaimableUsdThreshold: string | null;
+        inputsHash: string | null;
+        posStakingSubgraphBlock: string | null;
+        posStakingSubgraphHash: string | null;
+        posCheckpointsSubgraphBlock: string | null;
+        posCheckpointsSubgraphHash: string | null;
+        posPriorityFeesSubgraphBlock: string | null;
+        posPriorityFeesSubgraphHash: string | null;
+    }, [Pick<Options<GetDistributionData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }], never> | undefined;
+} & {
+    queryKey: [Pick<Options<GetDistributionData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }] & {
+        [dataTagSymbol]: {
+            distributionId: string;
+            status: "pending" | "running" | "completed" | "failed";
+            startPoSBlock: string;
+            endPoSBlock: string;
+            merkleRoot: string | null;
+            totalAllocated: string | null;
+            completedAt: string | null;
+            checkpointCount: number;
+            polUsdPrice: string | null;
+            maxClaimableUsdThreshold: string | null;
+            inputsHash: string | null;
+            posStakingSubgraphBlock: string | null;
+            posStakingSubgraphHash: string | null;
+            posCheckpointsSubgraphBlock: string | null;
+            posCheckpointsSubgraphHash: string | null;
+            posPriorityFeesSubgraphBlock: string | null;
+            posPriorityFeesSubgraphHash: string | null;
+        };
+        [dataTagErrorSymbol]: GetDistributionError;
+    };
+};
+export declare const listAllocationsQueryKey: (options: Options<ListAllocationsData>) => [Pick<Options<ListAllocationsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}];
+/**
+ * List allocations for a completed distribution
+ *
+ * Paginated by `leafIndex` ascending.
+ */
+export declare const listAllocationsOptions: (options: Options<ListAllocationsData>) => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    items: {
+        address: string;
+        amount: string;
+        leafIndex: number | null;
+    }[];
+    nextCursor: string | null;
+}, {
+    error: true;
+    message: string;
+    info?: Record<string, unknown> | undefined;
+}, {
+    items: {
+        address: string;
+        amount: string;
+        leafIndex: number | null;
+    }[];
+    nextCursor: string | null;
+}, [Pick<Options<ListAllocationsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        items: {
+            address: string;
+            amount: string;
+            leafIndex: number | null;
+        }[];
+        nextCursor: string | null;
+    }, [Pick<Options<ListAllocationsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }], never> | undefined;
+} & {
+    queryKey: [Pick<Options<ListAllocationsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }] & {
+        [dataTagSymbol]: {
+            items: {
+                address: string;
+                amount: string;
+                leafIndex: number | null;
+            }[];
+            nextCursor: string | null;
+        };
+        [dataTagErrorSymbol]: {
+            error: true;
+            message: string;
+            info?: Record<string, unknown> | undefined;
+        };
+    };
+};
+export declare const listAllocationsInfiniteQueryKey: (options: Options<ListAllocationsData>) => QueryKey<Options<ListAllocationsData>>;
+/**
+ * List allocations for a completed distribution
+ *
+ * Paginated by `leafIndex` ascending.
+ */
+export declare const listAllocationsInfiniteOptions: (options: Options<ListAllocationsData>) => import("@tanstack/react-query").UseInfiniteQueryOptions<{
+    items: {
+        address: string;
+        amount: string;
+        leafIndex: number | null;
+    }[];
+    nextCursor: string | null;
+}, {
+    error: true;
+    message: string;
+    info?: Record<string, unknown> | undefined;
+}, InfiniteData<{
+    items: {
+        address: string;
+        amount: string;
+        leafIndex: number | null;
+    }[];
+    nextCursor: string | null;
+}, unknown>, QueryKey<Options<ListAllocationsData>>, string | Pick<Pick<Options<ListAllocationsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}, "query" | "body" | "headers" | "path">> & {
+    initialData: InfiniteData<{
+        items: {
+            address: string;
+            amount: string;
+            leafIndex: number | null;
+        }[];
+        nextCursor: string | null;
+    }, string | Pick<Pick<Options<ListAllocationsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }, "query" | "body" | "headers" | "path">> | (() => InfiniteData<{
+        items: {
+            address: string;
+            amount: string;
+            leafIndex: number | null;
+        }[];
+        nextCursor: string | null;
+    }, string | Pick<Pick<Options<ListAllocationsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }, "query" | "body" | "headers" | "path">>) | undefined;
+} & {
+    queryKey: QueryKey<Options<ListAllocationsData>> & {
+        [dataTagSymbol]: InfiniteData<{
+            items: {
+                address: string;
+                amount: string;
+                leafIndex: number | null;
+            }[];
+            nextCursor: string | null;
+        }, unknown>;
+        [dataTagErrorSymbol]: {
+            error: true;
+            message: string;
+            info?: Record<string, unknown> | undefined;
+        };
+    };
+};
+export declare const listExcludedAllocationsQueryKey: (options: Options<ListExcludedAllocationsData>) => [Pick<Options<ListExcludedAllocationsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}];
+/**
+ * List off-chain (merkle-excluded) allocations for a distribution
+ *
+ * Recipients allocated but excluded from the merkle tree (excluded addresses) — not claimable on-chain, settled manually. Not paginated (small bounded set). `totalAmount` equals the distribution `total_allocated - claimable_total`.
+ */
+export declare const listExcludedAllocationsOptions: (options: Options<ListExcludedAllocationsData>) => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    items: {
+        address: string;
+        amount: string;
+    }[];
+    total: number;
+    totalAmount: string;
+}, ListExcludedAllocationsError, {
+    items: {
+        address: string;
+        amount: string;
+    }[];
+    total: number;
+    totalAmount: string;
+}, [Pick<Options<ListExcludedAllocationsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        items: {
+            address: string;
+            amount: string;
+        }[];
+        total: number;
+        totalAmount: string;
+    }, [Pick<Options<ListExcludedAllocationsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }], never> | undefined;
+} & {
+    queryKey: [Pick<Options<ListExcludedAllocationsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }] & {
+        [dataTagSymbol]: {
+            items: {
+                address: string;
+                amount: string;
+            }[];
+            total: number;
+            totalAmount: string;
+        };
+        [dataTagErrorSymbol]: ListExcludedAllocationsError;
+    };
+};
+export declare const getAllocationQueryKey: (options: Options<GetAllocationData>) => [Pick<Options<GetAllocationData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}];
+/**
+ * Get a single address allocation in a distribution
+ */
+export declare const getAllocationOptions: (options: Options<GetAllocationData>) => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    address: string;
+    amount: string;
+    leafIndex: number | null;
+}, GetAllocationError, {
+    address: string;
+    amount: string;
+    leafIndex: number | null;
+}, [Pick<Options<GetAllocationData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        address: string;
+        amount: string;
+        leafIndex: number | null;
+    }, [Pick<Options<GetAllocationData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }], never> | undefined;
+} & {
+    queryKey: [Pick<Options<GetAllocationData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }] & {
+        [dataTagSymbol]: {
+            address: string;
+            amount: string;
+            leafIndex: number | null;
+        };
+        [dataTagErrorSymbol]: GetAllocationError;
+    };
+};
+export declare const getAddressAllocationHistoryQueryKey: (options: Options<GetAddressAllocationHistoryData>) => [Pick<Options<GetAddressAllocationHistoryData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}];
+/**
+ * Per-address cross-distribution allocation history with live claim status
+ *
+ * Returns every allocation row for the given address across all completed distributions on the network, enriched with `status: "claimed" | "unclaimed"` derived live at request time by querying the pos-staker-pool-claims subgraph (spec §3.6, D10). Empty array if the address never qualified.
+ */
+export declare const getAddressAllocationHistoryOptions: (options: Options<GetAddressAllocationHistoryData>) => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    items: {
+        address: string;
+        distributionId: string;
+        amount: string;
+        leafIndex: number | null;
+        merkleRoot: string;
+        completedAt: string;
+        status: "claimed" | "unclaimed";
+    }[];
+}, GetAddressAllocationHistoryError, {
+    items: {
+        address: string;
+        distributionId: string;
+        amount: string;
+        leafIndex: number | null;
+        merkleRoot: string;
+        completedAt: string;
+        status: "claimed" | "unclaimed";
+    }[];
+}, [Pick<Options<GetAddressAllocationHistoryData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        items: {
+            address: string;
+            distributionId: string;
+            amount: string;
+            leafIndex: number | null;
+            merkleRoot: string;
+            completedAt: string;
+            status: "claimed" | "unclaimed";
+        }[];
+    }, [Pick<Options<GetAddressAllocationHistoryData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }], never> | undefined;
+} & {
+    queryKey: [Pick<Options<GetAddressAllocationHistoryData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }] & {
+        [dataTagSymbol]: {
+            items: {
+                address: string;
+                distributionId: string;
+                amount: string;
+                leafIndex: number | null;
+                merkleRoot: string;
+                completedAt: string;
+                status: "claimed" | "unclaimed";
+            }[];
+        };
+        [dataTagErrorSymbol]: GetAddressAllocationHistoryError;
+    };
+};
+export declare const getUnclaimedProofsQueryKey: (options: Options<GetUnclaimedProofsData>) => [Pick<Options<GetUnclaimedProofsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}];
+/**
+ * Per-address unclaimed-proofs array — the primary claim-flow UI endpoint
+ *
+ * Returns the address's outstanding allocations with merkle proofs ready to submit to the claimer contract in one batched transaction. Proof generation is on demand from the persisted leaves (spec D9); the in-memory tree cache absorbs repeat calls for the same distribution. Empty array if every allocation has been claimed (or the address has none).
+ */
+export declare const getUnclaimedProofsOptions: (options: Options<GetUnclaimedProofsData>) => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    items: {
+        distributionId: string;
+        merkleRoot: string;
+        amount: string;
+        leafIndex: number;
+        proof: string[];
+    }[];
+}, GetUnclaimedProofsError, {
+    items: {
+        distributionId: string;
+        merkleRoot: string;
+        amount: string;
+        leafIndex: number;
+        proof: string[];
+    }[];
+}, [Pick<Options<GetUnclaimedProofsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        items: {
+            distributionId: string;
+            merkleRoot: string;
+            amount: string;
+            leafIndex: number;
+            proof: string[];
+        }[];
+    }, [Pick<Options<GetUnclaimedProofsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }], never> | undefined;
+} & {
+    queryKey: [Pick<Options<GetUnclaimedProofsData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }] & {
+        [dataTagSymbol]: {
+            items: {
+                distributionId: string;
+                merkleRoot: string;
+                amount: string;
+                leafIndex: number;
+                proof: string[];
+            }[];
+        };
+        [dataTagErrorSymbol]: GetUnclaimedProofsError;
+    };
+};
+export declare const getProofQueryKey: (options: Options<GetProofData>) => [Pick<Options<GetProofData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}];
+/**
+ * Get the merkle proof for a single allocation
+ *
+ * Rebuilds (or cache-hits) the merkle tree from the persisted allocations table and extracts the proof for the requested address. The returned tuple `(merkleRoot, address, amount, leafIndex, proof)` can be passed straight to a Solidity verifier built around the same `[address, uint256]` leaf encoding.
+ */
+export declare const getProofOptions: (options: Options<GetProofData>) => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<{
+    address: string;
+    merkleRoot: string;
+    amount: string;
+    leafIndex: number;
+    proof: string[];
+}, GetProofError, {
+    address: string;
+    merkleRoot: string;
+    amount: string;
+    leafIndex: number;
+    proof: string[];
+}, [Pick<Options<GetProofData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+    _id: string;
+    _infinite?: boolean;
+    tags?: ReadonlyArray<string>;
+}]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<{
+        address: string;
+        merkleRoot: string;
+        amount: string;
+        leafIndex: number;
+        proof: string[];
+    }, [Pick<Options<GetProofData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }], never> | undefined;
+} & {
+    queryKey: [Pick<Options<GetProofData>, "query" | "body" | "headers" | "path" | "baseUrl"> & {
+        _id: string;
+        _infinite?: boolean;
+        tags?: ReadonlyArray<string>;
+    }] & {
+        [dataTagSymbol]: {
+            address: string;
+            merkleRoot: string;
+            amount: string;
+            leafIndex: number;
+            proof: string[];
+        };
+        [dataTagErrorSymbol]: GetProofError;
+    };
+};
+//# sourceMappingURL=react-query.gen.d.ts.map