feat(epoch1000): add Epoch 1000 campaign experience (#1670)

* feat(epoch1000): introduce Countdown, ThousandGrid, and WalletChecker components for epoch tracking and wallet verification

- Added Countdown component to display the countdown to epoch 1000, fetching epoch data from the API.
- Implemented ThousandGrid component to visually represent the progress of epochs.
- Created WalletChecker component for users to check their wallet's transaction history and generate survivor cards.
- Established campaign configuration for epoch 1000 with defined start and end dates.
- Developed Epoch1000Hero component to serve as the homepage hero during the campaign, showcasing live epoch data.
- Added CSS animations for the epoch hero components to enhance visual appeal.
- Introduced utility functions for handling Solana addresses and tier classifications based on epochs survived.

* fix(epoch1000): render gradient epoch number, add campaign window test

- Drop backdrop-blur on the hero live panel: Chrome skips background-clip:text
  paint inside backdrop-filter layers, hiding the gradient epoch number
- Add unit tests for the campaign hero activation window
- Locale-aware number/date formatting in the live panel

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

* feat(epoch1000): implement odometer component and related functionality

- Add Epoch1000Experience component to display live odometer and timeline.
- Create Odometer component for visual representation of epoch values.
- Implement odometer-math utility functions for calculating wheel targets.
- Add moments data for significant events in the epoch timeline.
- Introduce useEpochData hook for fetching and managing live epoch data.
- Style odometer with CSS for a mechanical appearance and celebration effects.
- Write unit tests for odometer math functions to ensure correctness.

* feat(epoch1000): enhance campaign page with new styles, components, and validation logic

* Refactor code structure for improved readability and maintainability

* feat(epoch1000): update translations and metadata for Epoch 1000 campaign

* feat(epoch1000): integrate GitHub contributions color palette and enhance grid functionality

* feat(epoch1000): implement rate limiting for wallet checks and enhance caching mechanisms

* feat(epoch1000): update eyebrow text for epoch 1000 campaign page

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

Author: h4rkl

apps/web/.env.example

@@ -34,3 +34,6 @@ DATABRICKS_TOKEN=
 
 # RWA.xyz API
 RWA_XYZ_API_TOKEN=
+
+HELIUS_API_KEY=
+SOLANA_RPC_URL=

apps/web/assets/fonts/epoch1000/ABCDiatype-Bold.woff

@@ -79,6 +79,10 @@ const nextConfig: NextConfig = {
   trailingSlash: false,
   transpilePackages: ["gsap"],
   serverExternalPackages: ["@databricks/sql", "lz4"],
+  // The epoch1000 OG card reads font files from disk at request time
+  outputFileTracingIncludes: {
+    "/api/epoch1000/og": ["./assets/fonts/epoch1000/*.woff"],
+  },
 
   async rewrites() {
     const baseRewrites = rewritesAndRedirectsJson.rewrites as {

apps/web/assets/fonts/epoch1000/ABCDiatypeSemi-Mono-Medium.woff

@@ -0,0 +1,38 @@
+import { describe, expect, it } from "vitest";
+import {
+  CAMPAIGNS,
+  getActiveCampaignId,
+} from "@/components/index/campaigns/config";
+
+describe("homepage campaign config", () => {
+  const epoch1000 = CAMPAIGNS.find((c) => c.id === "epoch1000")!;
+
+  it("activates epoch1000 inside its window", () => {
+    expect(getActiveCampaignId(new Date(`${epoch1000.start}T12:00:00Z`))).toBe(
+      "epoch1000",
+    );
+    expect(getActiveCampaignId(new Date(`${epoch1000.end}T12:00:00Z`))).toBe(
+      "epoch1000",
+    );
+  });
+
+  it("falls back to the default hero before the window opens", () => {
+    const dayBefore = new Date(`${epoch1000.start}T00:00:00Z`);
+    dayBefore.setUTCDate(dayBefore.getUTCDate() - 1);
+    expect(getActiveCampaignId(dayBefore)).toBeNull();
+  });
+
+  it("falls back to the default hero after the window closes", () => {
+    const dayAfter = new Date(`${epoch1000.end}T00:00:00Z`);
+    dayAfter.setUTCDate(dayAfter.getUTCDate() + 1);
+    expect(getActiveCampaignId(dayAfter)).toBeNull();
+  });
+
+  it("keeps windows as valid ISO dates", () => {
+    for (const c of CAMPAIGNS) {
+      expect(new Date(`${c.start}T00:00:00Z`).getTime()).not.toBeNaN();
+      expect(new Date(`${c.end}T00:00:00Z`).getTime()).not.toBeNaN();
+      expect(c.start <= c.end).toBe(true);
+    }
+  });
+});

apps/web/assets/fonts/epoch1000/ABCDiatypeSemi-Mono-Regular.woff

@@ -0,0 +1,40 @@
+import { describe, expect, it } from "vitest";
+import {
+  nextWheelTargets,
+  normalizeTargets,
+} from "@/components/epoch1000/odometer-math";
+
+/** Strip offsets mod 10 are the digits actually shown on the wheels. */
+function shownDigits(targets: number[]): number[] {
+  return targets.map((t) => t % 10);
+}
+
+describe("epoch odometer wheel math", () => {
+  it("first settle spins two revolutions and lands on the value's digits", () => {
+    const targets = nextWheelTargets(null, 998, 4);
+    expect(targets).toEqual([20, 29, 29, 28]);
+    expect(shownDigits(targets)).toEqual([0, 9, 9, 8]);
+  });
+
+  it("an epoch tick rolls only the wheels that change, always forward", () => {
+    const at998 = nextWheelTargets(null, 998, 4);
+    const at999 = nextWheelTargets(at998, 999, 4);
+    expect(shownDigits(at999)).toEqual([0, 9, 9, 9]);
+    // every wheel moved forward or stayed
+    at999.forEach((t, i) => expect(t).toBeGreaterThanOrEqual(at998[i]));
+  });
+
+  it("rolls 999 → 1000 forward on every wheel — the thousands wheel turns", () => {
+    const at999 = nextWheelTargets(null, 999, 4);
+    const at1000 = nextWheelTargets(at999, 1000, 4);
+    expect(shownDigits(at1000)).toEqual([1, 0, 0, 0]);
+    at1000.forEach((t, i) => expect(t).toBeGreaterThan(at999[i]));
+  });
+
+  it("normalize folds an offset back one revolution without changing digits", () => {
+    const targets = [21, 31, 35, 39];
+    const folded = normalizeTargets(targets);
+    expect(folded).toEqual([21, 21, 25, 29]);
+    expect(shownDigits(folded)).toEqual(shownDigits(targets));
+  });
+});

apps/web/next.config.ts

@@ -0,0 +1,33 @@
+import { describe, expect, it } from "vitest";
+import { isValidSolanaAddress } from "@/lib/epoch1000/public-key";
+
+describe("epoch1000 Solana public key validation", () => {
+  it("accepts base58 values that decode to 32 bytes", () => {
+    expect(isValidSolanaAddress("11111111111111111111111111111111")).toBe(true);
+    expect(
+      isValidSolanaAddress("So11111111111111111111111111111111111111112"),
+    ).toBe(true);
+    expect(
+      isValidSolanaAddress("TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"),
+    ).toBe(true);
+  });
+
+  it("rejects short, oversized, and non-base58 values", () => {
+    expect(isValidSolanaAddress("a")).toBe(false);
+    expect(isValidSolanaAddress("")).toBe(false);
+    expect(
+      isValidSolanaAddress(
+        "5HueCGU8rMjxEXxiPuD5BDuRa5Ww7C12QQAQH9Wzj3JDPZQQwXP",
+      ),
+    ).toBe(false);
+    expect(
+      isValidSolanaAddress("So11111111111111111111111111111111111111110"),
+    ).toBe(false);
+  });
+
+  it("trims whitespace before validating", () => {
+    expect(isValidSolanaAddress("  11111111111111111111111111111111  ")).toBe(
+      true,
+    );
+  });
+});