feat: cSSV Syndicate Boost banner — API-gated eligibility #142
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,36 @@ | ||
| import { describe, expect, it } from "vitest"; | ||
|
|
||
| import { calculateBoost } from "@/lib/staking/genesis-boost"; | ||
|
|
||
| describe("calculateBoost", () => { | ||
| it("returns 0% for ineligible wallets regardless of stake", () => { | ||
| expect(calculateBoost(false, 0)).toBe("0%"); | ||
| expect(calculateBoost(false, 4_000)).toBe("0%"); | ||
| expect(calculateBoost(false, 50_000)).toBe("0%"); | ||
| }); | ||
|
|
||
| it("returns 0% for eligible wallets with no stake", () => { | ||
| expect(calculateBoost(true, 0)).toBe("0%"); | ||
| }); | ||
|
|
||
| it("applies the 20% tier for 0–5,000 SSV", () => { | ||
| expect(calculateBoost(true, 1)).toBe("+20%"); | ||
| expect(calculateBoost(true, 2_500)).toBe("+20%"); | ||
| expect(calculateBoost(true, 5_000)).toBe("+20%"); | ||
| }); | ||
|
|
||
| it("applies the 15% tier for 5,000.01–12,000 SSV", () => { | ||
| expect(calculateBoost(true, 5_000.01)).toBe("+15%"); | ||
| expect(calculateBoost(true, 12_000)).toBe("+15%"); | ||
| }); | ||
|
|
||
| it("applies the 10% tier for 12,000.01–20,000 SSV", () => { | ||
| expect(calculateBoost(true, 12_000.01)).toBe("+10%"); | ||
| expect(calculateBoost(true, 20_000)).toBe("+10%"); | ||
| }); | ||
|
|
||
| it("returns 0% above 20,000 SSV", () => { | ||
| expect(calculateBoost(true, 20_000.01)).toBe("0%"); | ||
| expect(calculateBoost(true, 100_000)).toBe("0%"); | ||
| }); | ||
| }); |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,23 +1,25 @@ | ||
| // cSSV Syndicate Boost tiers, effective 2026-06-09. Boost is gated on the June 5 | ||
| // LST snapshot (see use-genesis-eligibility): ineligible wallets always get 0%. | ||
| // For eligible wallets the boost is determined by SSV staked, with no minimum | ||
| // stake floor. Tiers (inclusive upper bound) — kept in lockstep with the | ||
| // backend getBoost() in generate-boosted-snapshots.js: | ||
| // 0 – 5,000 => 20% | ||
| // 5,000.01 – 12,000 => 15% | ||
| // 12,000.01 – 20,000 => 10% | ||
| // 20,000+ => 0% | ||
| const BOOST_TIERS: [number, number][] = [ | ||
| [5_000, 20], | ||
| [12_000, 15], | ||
| [20_000, 10], | ||
| [Infinity, 0] | ||
| ]; | ||
|
|
||
| export const calculateBoost = ( | ||
| isEligible: boolean, | ||
| stakedSSV: number | ||
| ): string => { | ||
| if (!isEligible || stakedSSV <= 0) return "0%"; | ||
| const match = BOOST_TIERS.find(([upperBound]) => stakedSSV <= upperBound); | ||
| const percent = match ? match[1] : 0; | ||
| return percent === 0 ? "0%" : `+${percent}%`; | ||
| }; |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,66 @@ | ||
| import { useQuery } from "@tanstack/react-query"; | ||
| import { getAddress, isAddress } from "viem"; | ||
|
|
||
| import { getNetworkConfigByChainId } from "@/lib/config"; | ||
|
|
||
| // Shape returned by GET {ssvApiBaseUrl}/apr/lst-snapshot/eligible/{address}. | ||
| // A wallet is eligible if it held any tracked LST at the June 5 snapshot block. | ||
| type EligibilityResponse = { | ||
| walletAddress?: string; | ||
| eligible?: boolean; | ||
| snapshotBlock?: string; | ||
| tokens?: Array<{ | ||
| symbol: string; | ||
| tokenAddress: string; | ||
| balanceWei: string; | ||
| }>; | ||
| }; | ||
|
|
||
| async function fetchEligibility( | ||
| chainId: number | undefined, | ||
| address: string | ||
| ): Promise<boolean> { | ||
| const baseUrl = getNetworkConfigByChainId(chainId).ssvApiBaseUrl; | ||
| const url = `${baseUrl}/apr/lst-snapshot/eligible/${address}`; | ||
|
There was a problem hiding this comment. Blocking: this path appears not to be exposed by the current gateway. |
||
|
|
||
| const response = await fetch(url, { cache: "no-store" }); | ||
| if (!response.ok) { | ||
| throw new Error(`Eligibility request failed: ${response.status}`); | ||
| } | ||
|
|
||
| const payload = (await response.json()) as EligibilityResponse; | ||
| return payload.eligible === true; | ||
| } | ||
|
|
||
| /** | ||
| * Resolves cSSV Syndicate Boost eligibility for the connected wallet by querying | ||
| * the LST snapshot API exactly once per address. The result is cached for the | ||
| * lifetime of the session (staleTime/gcTime Infinity, no refetch triggers), so | ||
| * the request fires only when a wallet first connects. | ||
| */ | ||
| export function useGenesisEligibility( | ||
| chainId: number | undefined, | ||
| address: string | undefined | ||
| ) { | ||
| const normalizedAddress = | ||
| address && isAddress(address) ? getAddress(address) : undefined; | ||
|
|
||
| const { data, isLoading, isError } = useQuery({ | ||
| queryKey: ["genesis-eligibility", chainId, normalizedAddress], | ||
| queryFn: () => fetchEligibility(chainId, normalizedAddress as string), | ||
| enabled: Boolean(normalizedAddress), | ||
| staleTime: Infinity, | ||
| gcTime: Infinity, | ||
| refetchOnMount: false, | ||
| refetchOnWindowFocus: false, | ||
| refetchOnReconnect: false, | ||
| refetchInterval: false, | ||
| retry: 1 | ||
| }); | ||
|
|
||
| return { | ||
| isEligible: data ?? false, | ||
|
There was a problem hiding this comment. Blocking: failures are currently indistinguishable from an ineligible wallet. A non-OK response throws, but the hook returns |
||
| isLoading: Boolean(normalizedAddress) && isLoading, | ||
| isError | ||
| }; | ||
| } | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nit/QA: the override says it forces eligibility, but
isEligibilityLoadingstill controls the label and boost value. A matchingboostWalletAddresswill still show.../-until the API returns, and the request still fires. If this is meant to be a hard QA override, please treatforcedEligibleas non-loading and consider disabling the eligibility query when it matches.