+
+ Business Verification
+
+
+ {org.kycStatus === "VERIFIED"
+ ? "Your organization is verified. Your hackathons carry the Verified Organization badge."
+ : "Verification is required before your first prize-pool deposit. Review takes up to 48 hours."}
+
+
+
+ {kyb.label}
+
+
+
+
+
+
+
+
+
+ Members
+
+
+ Everyone with organizer access to {org.name}. Owners and admins can manage hackathons,
+ invites and this page.
+
+
+
+
+ ({
+ token: invite.token,
+ expiresAt: invite.expiresAt.toISOString(),
+ }))}
+ />
+
+
+ Trust History
+
+ Why the score is where it is. Penalties and awards land here the moment they are
+ recorded; the same history (minus internal notes) is public on your organizer page.
+
+ {trustEvents.length === 0 ? (
+
+ No trust events yet. The score moves with payout speed, media delivery and milestone
+ honesty.
+
@@ -123,8 +126,8 @@ export default async function OrganizerPage() {
Run A Hackathon
- Five steps to a draft; publishing declares the prize pool. The vault deposit flow
- (Phase 3) flips it live with the Prize Verified badge.
+ Five steps to a draft; publishing declares the prize pool. Locking the pool in the
+ Prize Vault flips it live with the Prize Verified badge.
diff --git a/app/(auth)/onboarding/choose/page.tsx b/app/(auth)/onboarding/choose/page.tsx
index a55e806..45c8758 100644
--- a/app/(auth)/onboarding/choose/page.tsx
+++ b/app/(auth)/onboarding/choose/page.tsx
@@ -1,7 +1,10 @@
import type { Metadata } from "next";
-import { Building2, Code2 } from "lucide-react";
+import Link from "next/link";
+import { Building2, Code2, LogIn } from "lucide-react";
import { RoleChoiceCards } from "@/components/onboarding/role-choice-cards";
+import { Button } from "@/components/ui/button";
+import { Card, CardDescription, CardTitle } from "@/components/ui/card";
import { currentUser } from "@/lib/auth/guards";
export const metadata: Metadata = { title: "Choose Your Path" };
@@ -9,10 +12,27 @@ export const metadata: Metadata = { title: "Choose Your Path" };
export default async function OnboardingChoosePage() {
const user = await currentUser();
if (!user) {
+ // Signed-out visitors get a real way forward, not a dead end. After
+ // sign-in the auth flow returns unonboarded users to this page itself
+ // (lib/auth/actions.ts), so no ?next= round-trip is needed.
return (
-
- Sign in first, then we'll set you up.
-
+
+
+ Sign In To Choose Your Path
+
+
+ Pick organizer or developer right after you sign in — we'll bring you straight back
+ here.
+
+
+
+
+
+
+
+
+
+
);
}
diff --git a/app/(marketing)/developers/[handle]/loading.tsx b/app/(marketing)/developers/[handle]/loading.tsx
new file mode 100644
index 0000000..9a2c388
--- /dev/null
+++ b/app/(marketing)/developers/[handle]/loading.tsx
@@ -0,0 +1,20 @@
+import { Skeleton, SkeletonCard } from "@/components/ui/skeleton";
+
+export default function Loading() {
+ return (
+
+
+
+
+
+
+
+
+ {[0, 1, 2].map((i) => (
+
+ ))}
+
+
+
+ );
+}
diff --git a/app/(marketing)/hackathons/[slug]/loading.tsx b/app/(marketing)/hackathons/[slug]/loading.tsx
new file mode 100644
index 0000000..a97c994
--- /dev/null
+++ b/app/(marketing)/hackathons/[slug]/loading.tsx
@@ -0,0 +1,23 @@
+import { Skeleton, SkeletonCard } from "@/components/ui/skeleton";
+
+export default function Loading() {
+ return (
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ );
+}
diff --git a/app/(marketing)/hackathons/[slug]/page.tsx b/app/(marketing)/hackathons/[slug]/page.tsx
index 3c9f94f..b58dca6 100644
--- a/app/(marketing)/hackathons/[slug]/page.tsx
+++ b/app/(marketing)/hackathons/[slug]/page.tsx
@@ -5,6 +5,7 @@ import { CalendarDays, Clock, MapPin, Users } from "lucide-react";
import { KeyDatesCard } from "@/components/patterns/key-dates-card";
import { OrganizerCard } from "@/components/patterns/organizer-card";
+import { PrizeVerifiedBadge } from "@/components/patterns/prize-verified-badge";
import { StatusTimeline } from "@/components/patterns/status-timeline";
import { JsonLd } from "@/components/seo/json-ld";
import { Badge } from "@/components/ui/badge";
@@ -175,6 +176,7 @@ export default async function EventDetailPage({ params, searchParams }: PageProp
{event._count.teams} team
{event._count.teams === 1 ? "" : "s"}
+ {event.prizeVerifiedAt ? : null}
{event.summary ? (
{event.summary}
diff --git a/app/(marketing)/hackathons/loading.tsx b/app/(marketing)/hackathons/loading.tsx
new file mode 100644
index 0000000..4f94f85
--- /dev/null
+++ b/app/(marketing)/hackathons/loading.tsx
@@ -0,0 +1,22 @@
+import { Skeleton, SkeletonCard } from "@/components/ui/skeleton";
+
+export default function Loading() {
+ return (
+
+
+ Instant Payouts
+ {performance.instantTotal === 0 ? (
+
+ No payouts yet. The first winners paid will start this record.
+
+ ) : (
+ <>
+
+ {performance.instantSucceeded} of {performance.instantTotal}
+
+
+ instant-tranche payouts confirmed. Winners are promised 50% of their prize
+ within an hour of results.
+
+
+ )}
+
+
+
+ Announce→Paid
+
+ {performance.medianInstantMinutes === null ? (
+
+ No confirmed instant payouts yet, so there is no median time to report.
+
+ ) : (
+ <>
+
+
+ median time from winners announced to the instant payout landing.
+
+
+ )}
+
+
+
+ Media Delivery
+
+ {timeliness.eventsWithMedia === 0 ? (
+
+ No event media yet. Event photos delivered within 48 hours start this record.
+
+ ) : (
+ <>
+
+ {timeliness.onTime} of {timeliness.eventsWithMedia}
+
+
+ events delivered media inside the 48-hour standard.
+
+
+ )}
+
+
+
+
+
+
+ Hackathons
+
+ {events.length === 0 ? (
+
+
+ {org.name} has not published a hackathon yet. When they do, it appears here with
+ its escrow status.
+
+
+ ) : (
+
+
+ {trustEvents.length === 0 ? (
+
+ No trust events yet. The score moves with payout speed, media delivery and
+ milestone honesty; a quiet history is a good history.
+
+ ) : (
+
+ Trust scores start at 100 and move with payout speed, media delivery and milestone
+ honesty. Every lock and payout by this organizer is on the{" "}
+
+ public ledger
+
+ .
+
+
+
+
+
+ );
+}
diff --git a/app/(marketing)/organizers/[slug]/performance.ts b/app/(marketing)/organizers/[slug]/performance.ts
new file mode 100644
index 0000000..11095f2
--- /dev/null
+++ b/app/(marketing)/organizers/[slug]/performance.ts
@@ -0,0 +1,88 @@
+import type { PayoutStatus, PayoutTranche } from "@prisma/client";
+
+/**
+ * Pure math for the /organizers/[slug] payout-performance section, colocated
+ * with the route so it stays unit-testable (Next.js page modules may only
+ * export route entrypoints). Every metric degrades to an explicit empty
+ * state rather than a misleading zero — an organizer with no payouts yet has
+ * a clean record, not a failed one.
+ */
+
+export interface PayoutRecord {
+ tranche: PayoutTranche;
+ status: PayoutStatus;
+ paidAt: Date | null;
+ /** The parent winner's announcedAt — the start of the payout clock. */
+ announcedAt: Date;
+}
+
+export interface PayoutPerformance {
+ /** All instant-tranche payouts ever attempted for the organizer's events. */
+ instantTotal: number;
+ instantSucceeded: number;
+ /** Median minutes from winners announced to instant payout confirmed. */
+ medianInstantMinutes: number | null;
+}
+
+/** Median of a numeric sample; null when empty (never a fake zero). */
+export function median(values: number[]): number | null {
+ if (values.length === 0) return null;
+ const sorted = [...values].sort((a, b) => a - b);
+ const middle = Math.floor(sorted.length / 2);
+ return sorted.length % 2 === 0
+ ? (sorted[middle - 1] + sorted[middle]) / 2
+ : sorted[middle];
+}
+
+export function summarizePayoutPerformance(records: PayoutRecord[]): PayoutPerformance {
+ const instant = records.filter((record) => record.tranche === "INSTANT");
+ const succeeded = instant.filter((record) => record.status === "SUCCEEDED");
+ // Negative durations mean bad clock data upstream; exclude them rather
+ // than silently dragging the median down.
+ const paid = succeeded.filter(
+ (record): record is PayoutRecord & { paidAt: Date } => record.paidAt !== null,
+ );
+ const minutes = paid
+ .map((record) => (record.paidAt.getTime() - record.announcedAt.getTime()) / 60_000)
+ .filter((value) => value >= 0);
+ return {
+ instantTotal: instant.length,
+ instantSucceeded: succeeded.length,
+ medianInstantMinutes: median(minutes),
+ };
+}
+
+export interface MediaRecord {
+ eventId: string;
+ uploadedAt: Date;
+ /** The event's mediaDeadlineAt (endsAt + 48h); null means no deadline was set. */
+ mediaDeadlineAt: Date | null;
+}
+
+export interface MediaTimeliness {
+ /** Events with a media deadline and at least one visible upload. */
+ eventsWithMedia: number;
+ /** Of those, events whose first upload beat the 48-hour deadline. */
+ onTime: number;
+}
+
+export function summarizeMediaTimeliness(records: MediaRecord[]): MediaTimeliness {
+ const firstUploadByEvent = new Map();
+ for (const record of records) {
+ const current = firstUploadByEvent.get(record.eventId);
+ if (!current || record.uploadedAt.getTime() < current.uploadedAt.getTime()) {
+ firstUploadByEvent.set(record.eventId, {
+ uploadedAt: record.uploadedAt,
+ mediaDeadlineAt: record.mediaDeadlineAt,
+ });
+ }
+ }
+ let eventsWithMedia = 0;
+ let onTime = 0;
+ for (const first of firstUploadByEvent.values()) {
+ if (!first.mediaDeadlineAt) continue;
+ eventsWithMedia += 1;
+ if (first.uploadedAt.getTime() <= first.mediaDeadlineAt.getTime()) onTime += 1;
+ }
+ return { eventsWithMedia, onTime };
+}
diff --git a/app/(marketing)/trust/ledger.ts b/app/(marketing)/trust/ledger.ts
new file mode 100644
index 0000000..067391f
--- /dev/null
+++ b/app/(marketing)/trust/ledger.ts
@@ -0,0 +1,45 @@
+import type { LedgerEntryType, Prisma } from "@prisma/client";
+
+/**
+ * Pure display logic for the /trust public ledger page, colocated with the
+ * route (Next.js page modules may only export route entrypoints, so testable
+ * logic lives here — see tests/unit/public-trust-pages.test.ts).
+ */
+
+/** Human labels for the on-chain attestation types (plan §11.3). */
+export const LEDGER_TYPE_LABELS: Record = {
+ VAULT_CREATED: "Vault created",
+ DEPOSIT_LOCKED: "Prize pool locked",
+ INSTANT_PAYOUT: "Instant payout",
+ MILESTONE_PAYOUT: "Milestone payout",
+ VAULT_REFUNDED: "Vault refunded",
+};
+
+/**
+ * Ledger payloads are JSON written by the escrow/payout services: amountKes
+ * is present on every type today, but the page must survive older rows and
+ * future shapes — so extraction is defensive, never a cast.
+ */
+export function payloadAmountKes(payload: Prisma.JsonValue): number | null {
+ if (payload && typeof payload === "object" && !Array.isArray(payload)) {
+ const value = (payload as Record).amountKes;
+ if (typeof value === "number" && Number.isFinite(value)) return value;
+ }
+ return null;
+}
+
+/** The most human-readable reference in a payload: transfer ref, payment ref, refund ref or contract. */
+export function payloadReference(payload: Prisma.JsonValue): string | null {
+ if (!payload || typeof payload !== "object" || Array.isArray(payload)) return null;
+ const record = payload as Record;
+ for (const key of ["txRef", "paystackRef", "refundRef", "contractAddress"] as const) {
+ const value = record[key];
+ if (typeof value === "string" && value.length > 0) return value;
+ }
+ return null;
+}
+
+/** "0x1234…abcd" — enough to recognise a hash, short enough for a table row. */
+export function shortenHash(hash: string): string {
+ return hash.length > 12 ? `${hash.slice(0, 6)}…${hash.slice(-4)}` : hash;
+}
diff --git a/app/(marketing)/trust/loading.tsx b/app/(marketing)/trust/loading.tsx
new file mode 100644
index 0000000..a586993
--- /dev/null
+++ b/app/(marketing)/trust/loading.tsx
@@ -0,0 +1,20 @@
+import { Skeleton, SkeletonCard } from "@/components/ui/skeleton";
+
+export default function Loading() {
+ return (
+
+
+
+
+
+
+
+ {[0, 1, 2].map((i) => (
+
+ ))}
+
+
+
+
+ );
+}
diff --git a/app/(marketing)/trust/page.tsx b/app/(marketing)/trust/page.tsx
new file mode 100644
index 0000000..5426bdb
--- /dev/null
+++ b/app/(marketing)/trust/page.tsx
@@ -0,0 +1,281 @@
+import type { Metadata } from "next";
+import Link from "next/link";
+import { ExternalLink, ScrollText, ShieldCheck } from "lucide-react";
+import type { Prisma, VaultChainState } from "@prisma/client";
+
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import { Card, CardDescription, CardTitle } from "@/components/ui/card";
+import { EmptyState } from "@/components/ui/empty-state";
+import { prisma } from "@/lib/db";
+import { getEnv } from "@/lib/env";
+import { getChainPort } from "@/lib/ports/chain";
+import { pageOpenGraph } from "@/lib/seo/metadata";
+import { formatKes } from "@/lib/utils";
+
+import {
+ LEDGER_TYPE_LABELS,
+ payloadAmountKes,
+ payloadReference,
+ shortenHash,
+} from "./ledger";
+
+export const metadata: Metadata = {
+ title: "The Public Ledger: Every Prize Lock And Payout, Verifiable",
+ description:
+ "Every hackathon prize pool locked, paid out or refunded on HackVillage is recorded on a public ledger. Verify each entry yourself — radical transparency is the product.",
+ alternates: { canonical: "/trust" },
+ openGraph: pageOpenGraph("/trust"),
+};
+
+const VAULT_STATE_LABELS: Record = {
+ AWAITING: "Awaiting deposit",
+ LOCKED: "Locked in escrow",
+ HALF_RELEASED: "50% paid out",
+ SETTLED: "Fully settled",
+ REFUNDED: "Refunded",
+};
+
+const timestampFormat = new Intl.DateTimeFormat("en-KE", {
+ day: "numeric",
+ month: "short",
+ year: "numeric",
+ hour: "numeric",
+ minute: "2-digit",
+ timeZone: "Africa/Nairobi",
+});
+
+interface PageProps {
+ searchParams: Promise<{ event?: string }>;
+}
+
+export default async function TrustPage({ searchParams }: PageProps) {
+ const { event: eventFilter } = await searchParams;
+ const chainMode = getChainPort().mode;
+ const polygonscanUrl = getEnv().POLYGONSCAN_URL;
+ const onChain = chainMode !== "simulation";
+
+ const eventWhere: Prisma.EventWhereInput | undefined = eventFilter
+ ? { slug: eventFilter }
+ : undefined;
+
+ const [entries, vaults, filterEvents] = await Promise.all([
+ prisma.ledgerEntry.findMany({
+ where: eventWhere ? { event: eventWhere } : undefined,
+ include: { event: { select: { title: true, slug: true } } },
+ orderBy: { mirroredAt: "desc" },
+ take: 100,
+ }),
+ prisma.vaultState.findMany({
+ where: eventWhere ? { event: eventWhere } : undefined,
+ include: { event: { select: { title: true, slug: true } } },
+ orderBy: { updatedAt: "desc" },
+ }),
+ // Filter chips always list every event that has a ledger, so switching
+ // away from the current filter is one click.
+ prisma.event.findMany({
+ where: { ledgerEntries: { some: {} } },
+ select: { slug: true, title: true },
+ orderBy: { startsAt: "desc" },
+ }),
+ ]);
+
+ return (
+
+
+
+ The Public Ledger
+
+
+ Every prize pool locked, payout sent and vault refunded is recorded here, entry by
+ entry. Trust on HackVillage is not a promise; it is a record you can check.
+
+
+
+ {!onChain ? (
+
+
+ Simulation Mode
+
+
+ The ledger is running in simulation mode while we complete go-live. Entries are
+ application-verified and recorded in order; on-chain anchoring is pending, so
+ transaction references are not yet verifiable on a block explorer.
+
+
+ ) : null}
+
+ {vaults.length > 0 ? (
+
+
+ Showing the {entries.length} most recent entries
+ {entries.length === 100 ? " (use the hackathon filter to narrow down)" : ""}.{" "}
+ {onChain
+ ? "Each transaction hash resolves on Polygonscan, the independent block explorer for the Polygon network."
+ : "References are synthetic while the ledger runs in simulation mode."}
+
+
+ )}
+
+ );
+}
diff --git a/app/admin/hackathons/page.tsx b/app/admin/hackathons/page.tsx
index f447a8b..1903e92 100644
--- a/app/admin/hackathons/page.tsx
+++ b/app/admin/hackathons/page.tsx
@@ -1,6 +1,7 @@
import type { Metadata } from "next";
import Link from "next/link";
+import { AdminEventCancelForm } from "@/components/admin/event-cancel-form";
import { Badge } from "@/components/ui/badge";
import { Card, CardTitle } from "@/components/ui/card";
import { prisma } from "@/lib/db";
@@ -51,6 +52,11 @@ export default async function AdminEventsPage() {
>
{STATUS_LABELS[event.status]}
+ {["DRAFT", "PENDING_DEPOSIT", "LIVE", "IN_PROGRESS", "JUDGING"].includes(
+ event.status
+ ) ? (
+
+ ) : null}
))}
diff --git a/app/admin/loading.tsx b/app/admin/loading.tsx
new file mode 100644
index 0000000..ae8e096
--- /dev/null
+++ b/app/admin/loading.tsx
@@ -0,0 +1,20 @@
+import { Skeleton, SkeletonCard } from "@/components/ui/skeleton";
+
+export default function Loading() {
+ return (
+