feat: benchmark details refinement

ensawards.org/data/acceptance-tests/index.test.ts

@@ -0,0 +1,24 @@
+import { ACCEPTANCE_TESTS } from "data/acceptance-tests";
+import { isValidSlug } from "data/shared/slugs";
+import { describe, expect, it } from "vitest";
+
+import { areStringsUnique } from "@/utils";
+
+describe("Acceptance test data", () => {
+  it("Should have valid and unique slugs", () => {
+    const slugArray: string[] = [];
+
+    ACCEPTANCE_TESTS.forEach((acceptanceTest) => {
+      expect(
+        isValidSlug(acceptanceTest.acceptanceTestSlug),
+        `Slug={${acceptanceTest.acceptanceTestSlug}} is not valid`,
+      ).toEqual(true);
+
+      slugArray.push(acceptanceTest.acceptanceTestSlug);
+    });
+
+    expect(areStringsUnique(slugArray), `Slugs for Acceptance Tests are not unique`).toEqual(true);
+  });
+
+  // TODO: Any more immediate tests we should add here?
+});

ensawards.org/data/acceptance-tests/index.ts

@@ -0,0 +1,5 @@
+import { ENS_BEST_PRACTICES } from "data/ens-best-practices";
+
+export const ACCEPTANCE_TESTS = [
+  ...ENS_BEST_PRACTICES.flatMap((bestPractice) => bestPractice.technicalDetails.acceptanceTests),
+];

ensawards.org/data/acceptance-tests/types.ts

@@ -0,0 +1,44 @@
+import type { BenchmarkResult } from "data/benchmarks/types";
+import type { Contribution } from "data/contributors/types";
+import type { JSX } from "react";
+
+/** A unique identifier for an acceptance test.
+ *
+ * @invariant Must be unique across all acceptance tests.
+ * @invariant Must match {@link ENSAWARDS_SLUG_PATTERN}.
+ */
+export type AcceptanceTestSlug = string;
+
+/**
+ * Represents an acceptance test that an app can be evaluated against.
+ */
+export interface AcceptanceTest {
+  acceptanceTestSlug: AcceptanceTestSlug;
+  name: string;
+  description: JSX.Element;
+}
+
+/**
+ * Represents the benchmark of an {@link AcceptanceTest} on an {@link App} against a {@link BestPractice}.
+ */
+export interface AcceptanceTestBenchmark {
+  /** The result of the benchmark */
+  result: BenchmarkResult;
+
+  /** A record of all contributors involved in the addition or maintenance of the benchmark's data.
+   *
+   * @invariant Multiple {@link Contribution} from the same contributor on the same app benchmark are not allowed.
+   * When a contributor makes updates to their existing contribution,
+   * they should update the `lastUpdated` timestamp of their existing `Contribution`.
+   */
+  contributions: [Contribution, ...Contribution[]];
+
+  /**
+   * Notes about how the benchmark result was determined,
+   * which may include details about the testing process,
+   * any challenges encountered, and explanations, as well as proof, for the final result.
+   */
+  // TODO: Maybe this element should be made stricter with a dedicated template.
+  // See here for more details: https://namehash.slack.com/archives/C086Z6FNBHN/p1777477037902549?thread_ts=1776097255.913659&cid=C086Z6FNBHN
+  notes: JSX.Element;
+}

ensawards.org/data/acceptance-tests/utils.ts

@@ -0,0 +1,22 @@
+import { ACCEPTANCE_TESTS } from "data/acceptance-tests";
+import type {
+  AcceptanceTest,
+  AcceptanceTestBenchmark,
+  AcceptanceTestSlug,
+} from "data/acceptance-tests/types";
+import type { AppSlug } from "data/apps/types";
+import { getAppBenchmarks } from "data/benchmarks/utils.ts";
+
+export const getAcceptanceTestBySlug = (slug: AcceptanceTestSlug): AcceptanceTest | undefined => {
+  return ACCEPTANCE_TESTS.find((acceptanceTest) => acceptanceTest.acceptanceTestSlug === slug);
+};
+
+export const getAcceptanceTestBenchmarksByApp = (
+  appSlug: AppSlug,
+): (AcceptanceTestBenchmark | undefined)[] => {
+  const appBenchmarks = getAppBenchmarks(appSlug);
+
+  return Object.values(appBenchmarks).flatMap((acceptanceTestBenchmarks) =>
+    Object.values(acceptanceTestBenchmarks),
+  );
+};

ensawards.org/data/apps/blockscout-explorer/benchmarks.tsx

@@ -0,0 +1,70 @@
+// Read https://github.com/namehash/ensawards/blob/main/CONTRIBUTING.md for additional advice
+// on adding and modifying app benchmarks
+
+import type { AcceptanceTestBenchmark } from "data/acceptance-tests/types";
+import BlockscoutExplorer from "data/apps/blockscout-explorer";
+import { defineAppBenchmarks } from "data/benchmarks/registry";
+import { BenchmarkResults } from "data/benchmarks/types";
+import type { BestPracticeBenchmarks } from "data/ens-best-practices/types.ts";
+
+import { parseTimestamp } from "@ensnode/ensnode-sdk";
+
+import contributors from "../../contributors";
+import exampleProofImage from "./acceptance-test-benchmark-proof-example.png";
+
+// TODO: Some of these are placeholder benchmarks just to show how the new benchmarking system works,
+const benchmarks = {
+  // "recognize-all-ens-names": {
+  //   result: BenchmarkResults.Pass,
+  //   contributions: [
+  //     { from: contributors.stevedylan, lastUpdated: parseTimestamp("2025-12-03T14:00:00Z") },
+  //   ],
+  // },
+  "display-named-smart-contracts-mainnet": {
+    "mainnet-interactions-display-named-smart-contracts": {
+      result: BenchmarkResults.Pass,
+      contributions: [
+        { from: contributors.stevedylan, lastUpdated: parseTimestamp("2025-12-08T18:28:32.410Z") },
+      ],
+      notes: (
+        <div>
+          <p>Benchmark placeholder notes</p>
+          <img alt="example proof" src={exampleProofImage.src} />
+        </div>
+      ),
+    } as const satisfies AcceptanceTestBenchmark,
+    "mainnet-interactions-display-named-smart-contracts-at2": {
+      result: BenchmarkResults.Pass,
+      contributions: [
+        { from: contributors.stevedylan, lastUpdated: parseTimestamp("2025-12-08T18:28:32.410Z") },
+      ],
+      notes: (
+        <div>
+          <p>Benchmark placeholder notes</p>
+          <img alt="example proof" src={exampleProofImage.src} />
+        </div>
+      ),
+    } as const satisfies AcceptanceTestBenchmark,
+  },
+  "display-named-smart-contracts-l2-chains": {
+    "l2-chain-interactions-display-named-smart-contracts": {
+      result: BenchmarkResults.Fail,
+      contributions: [
+        { from: contributors.stevedylan, lastUpdated: parseTimestamp("2025-12-08T18:28:32.410Z") },
+      ],
+      notes: (
+        <div>
+          <p>Benchmark placeholder notes</p>
+          <img alt="example proof" src={exampleProofImage.src} />
+        </div>
+      ),
+    } as const satisfies AcceptanceTestBenchmark,
+  },
+  "mock-bp-all-pending-2": {
+    "mock-acceptance-test-3": undefined,
+  },
+} as const satisfies BestPracticeBenchmarks;
+
+defineAppBenchmarks(BlockscoutExplorer, benchmarks);
+
+export default benchmarks;

ensawards.org/data/apps/coinbase-wallet/benchmarks.tsx

@@ -0,0 +1,48 @@
+// Read https://github.com/namehash/ensawards/blob/main/CONTRIBUTING.md for additional advice
+// on adding and modifying app benchmarks
+
+import type { AcceptanceTestBenchmark } from "data/acceptance-tests/types";
+import exampleProofImage from "data/apps/blockscout-explorer/acceptance-test-benchmark-proof-example.png";
+import CoinbaseWallet from "data/apps/coinbase-wallet";
+import { defineAppBenchmarks } from "data/benchmarks/registry";
+import { BenchmarkResults } from "data/benchmarks/types";
+import type { BestPracticeBenchmarks } from "data/ens-best-practices/types.ts";
+
+import { parseTimestamp } from "@ensnode/ensnode-sdk";
+
+import contributors from "../../contributors";
+
+const benchmarks = {
+  // "recognize-all-ens-names": {
+  //   result: BenchmarkResults.Pass,
+  //   contributions: [
+  //     { from: contributors.stevedylan, lastUpdated: parseTimestamp("2025-12-03T14:00:00Z") },
+  //   ],
+  // },
+  // TODO: remember to rollback to benchmarks actuall results (base it on the current prod if needed)
+  "display-named-smart-contracts-mainnet": {
+    "mainnet-interactions-display-named-smart-contracts": undefined, // simulate pending benchmark
+    "mainnet-interactions-display-named-smart-contracts-at2": undefined, // simulate both benchmarks pending
+  },
+  "display-named-smart-contracts-l2-chains": {
+    "l2-chain-interactions-display-named-smart-contracts": {
+      result: BenchmarkResults.Fail,
+      contributions: [
+        { from: contributors.stevedylan, lastUpdated: parseTimestamp("2025-12-08T18:26:20.566Z") },
+      ],
+      notes: (
+        <div>
+          <p>Benchmark placeholder notes</p>
+          <img alt="example proof" src={exampleProofImage.src} />
+        </div>
+      ),
+    } as const satisfies AcceptanceTestBenchmark,
+  },
+  "mock-bp-all-pending": {
+    "mock-acceptance-test-1": undefined, // simulate pending benchmark
+  },
+} as const satisfies BestPracticeBenchmarks;
+
+defineAppBenchmarks(CoinbaseWallet, benchmarks);
+
+export default benchmarks;

ensawards.org/data/apps/etherscan-explorer/benchmarks.tsx

@@ -0,0 +1,48 @@
+// Read https://github.com/namehash/ensawards/blob/main/CONTRIBUTING.md for additional advice
+// on adding and modifying app benchmarks
+
+import type { AcceptanceTestBenchmark } from "data/acceptance-tests/types";
+import exampleProofImage from "data/apps/blockscout-explorer/acceptance-test-benchmark-proof-example.png";
+import EtherscanExplorer from "data/apps/etherscan-explorer";
+import { defineAppBenchmarks } from "data/benchmarks/registry";
+import { BenchmarkResults } from "data/benchmarks/types";
+import type { BestPracticeBenchmarks } from "data/ens-best-practices/types.ts";
+
+import { parseTimestamp } from "@ensnode/ensnode-sdk";
+
+import contributors from "../../contributors";
+
+const benchmarks = {
+  // "recognize-all-ens-names": {
+  //   result: BenchmarkResults.Pass,
+  //   contributions: [
+  //     { from: contributors.stevedylan, lastUpdated: parseTimestamp("2025-12-03T14:00:00Z") },
+  //   ],
+  // },
+  // TODO: remember to rollback to benchmarks actuall results (base it on the current prod if needed)
+  "display-named-smart-contracts-mainnet": {
+    "mainnet-interactions-display-named-smart-contracts": undefined, // simulate pending benchmark
+    "mainnet-interactions-display-named-smart-contracts-at2": undefined, // simulate both benchmarks pending
+  },
+  "display-named-smart-contracts-l2-chains": {
+    "l2-chain-interactions-display-named-smart-contracts": {
+      result: BenchmarkResults.Fail,
+      contributions: [
+        { from: contributors.stevedylan, lastUpdated: parseTimestamp("2025-12-08T18:26:20.566Z") },
+      ],
+      notes: (
+        <div>
+          <p>Benchmark placeholder notes</p>
+          <img alt="example proof" src={exampleProofImage.src} />
+        </div>
+      ),
+    } as const satisfies AcceptanceTestBenchmark,
+  },
+  "mock-bp-all-pending-2": {
+    "mock-acceptance-test-3": undefined,
+  },
+} as const satisfies BestPracticeBenchmarks;
+
+defineAppBenchmarks(EtherscanExplorer, benchmarks);
+
+export default benchmarks;