@namehash/ens-referrals 1.8.1 → 1.10.0

package/dist/index.d.cts

@@ -1,178 +1,307 @@
-import { Address } from 'viem';
-import { UnixTimestamp, AccountId, Duration } from '@ensnode/ensnode-sdk';
+import { NormalizedAddress, UnixTimestamp, AccountId, Duration, Address } from 'enssdk';
+import { PriceUsdc, PriceEth, SerializedPriceEth, SerializedPriceUsdc } from '@ensnode/ensnode-sdk';
 
-declare const validateLowercaseAddress: (address: Address) => void;
-declare const normalizeAddress: (address: Address) => Address;
+declare const validateNormalizedAddress: (address: NormalizedAddress) => void;
 
 /**
- * Represents a quantity of USD.
+ * Discriminant values for the award model used in a referral program edition.
  *
- * @invariant Guaranteed to be a finite non-negative number (>= 0)
- */
-type USDQuantity = number;
-declare function isValidUSDQuantity(value: USDQuantity): boolean;
-declare function validateUSDQuantity(value: USDQuantity): void;
-
-/**
- * Start date for the ENS Holiday Awards referral program.
- * 2025-12-01T00:00:00Z (December 1, 2025 at 00:00:00 UTC)
- */
-declare const ENS_HOLIDAY_AWARDS_START_DATE: UnixTimestamp;
-/**
- * End date for the ENS Holiday Awards referral program.
- * 2025-12-31T23:59:59Z (December 31, 2025 at 23:59:59 UTC)
- */
-declare const ENS_HOLIDAY_AWARDS_END_DATE: UnixTimestamp;
+ * @remarks Clients MUST check `awardModel` before accessing model-specific fields.
+ * Editions with unrecognized `awardModel` values are preserved as
+ * {@link ReferralProgramRulesUnrecognized} during parsing (see
+ * `makeReferralProgramEditionConfigSetArraySchema`). Clients must handle this variant — typically
+ * by skipping those editions with a warning log rather than crashing.
+ */
+declare const ReferralProgramAwardModels: {
+    readonly PieSplit: "pie-split";
+    readonly RevShareCap: "rev-share-cap";
+    readonly Unrecognized: "unrecognized";
+};
+type ReferralProgramAwardModel = (typeof ReferralProgramAwardModels)[keyof typeof ReferralProgramAwardModels];
 /**
- * The maximum number of qualified referrers for ENS Holiday Awards.
+ * Base fields shared across all referral program rule types.
+ *
+ * Both `ReferralProgramRulesPieSplit` and `ReferralProgramRulesRevShareCap` are structurally
+ * compatible with this interface, so it can be used wherever only the common fields are needed
+ * (e.g., `assertLeaderboardInputs`).
  */
-declare const ENS_HOLIDAY_AWARDS_MAX_QUALIFIED_REFERRERS = 10;
+interface BaseReferralProgramRules {
+    /**
+     * Discriminant: identifies the award model for this edition.
+     */
+    awardModel: ReferralProgramAwardModel;
+    /**
+     * The start time of the referral program.
+     */
+    startTime: UnixTimestamp;
+    /**
+     * The end time of the referral program.
+     * @invariant Guaranteed to be greater than or equal to `startTime`
+     */
+    endTime: UnixTimestamp;
+    /**
+     * The account ID of the subregistry for the referral program.
+     */
+    subregistryId: AccountId;
+    /**
+     * URL to the full rules document for these rules.
+     * @example new URL("https://ensawards.org/ens-holiday-awards-rules")
+     */
+    rulesUrl: URL;
+    /**
+     * Whether the awards for this edition have been distributed.
+     *
+     * When `true` and `now > endTime`, the status transitions from `AwardsReview` to `Closed`.
+     */
+    areAwardsDistributed: boolean;
+}
 /**
- * The total value of the award pool in USD.
+ * Rules for a referral program edition whose `awardModel` is not recognized by this client version.
+ *
+ * @remarks
+ * This is a **client-side forward-compatibility** type only. It is never serialized or processed
+ * by business logic on the backend. When the server introduces a new award model type, older
+ * clients preserve the edition rather than silently dropping it, and downstream code that
+ * encounters this type should skip it with a warning log rather than crashing.
  */
-declare const ENS_HOLIDAY_AWARDS_TOTAL_AWARD_POOL_VALUE: USDQuantity;
-interface ReferralProgramRules {
+interface ReferralProgramRulesUnrecognized extends BaseReferralProgramRules {
     /**
-     * The total value of the award pool in USD.
+     * Discriminant — always `"unrecognized"`.
+     */
+    awardModel: typeof ReferralProgramAwardModels.Unrecognized;
+    /**
+     * The original, unrecognized `awardModel` string received from the server.
+     *
+     * @remarks Preserved for logging and debugging. Never used for business logic.
+     */
+    originalAwardModel: string;
+}
+declare const validateBaseReferralProgramRules: (rules: BaseReferralProgramRules) => void;
+
+interface ReferralProgramRulesPieSplit extends BaseReferralProgramRules {
+    /**
+     * Discriminant: identifies this as a "pie-split" award model edition.
+     *
+     * In pie-split, the top-N referrers split an award pool proportionally
+     * based on their scored duration (with rank-based boost).
+     */
+    awardModel: typeof ReferralProgramAwardModels.PieSplit;
+    /**
+     * The award pool in USDC.
      *
      * NOTE: Awards will actually be distributed in $ENS tokens.
      */
-    totalAwardPoolValue: USDQuantity;
+    awardPool: PriceUsdc;
     /**
      * The maximum number of referrers that will qualify to receive a non-zero `awardPoolShare`.
      *
      * @invariant Guaranteed to be a non-negative integer (>= 0)
      */
     maxQualifiedReferrers: number;
+}
+declare const validateReferralProgramRulesPieSplit: (rules: ReferralProgramRulesPieSplit) => void;
+declare const buildReferralProgramRulesPieSplit: (awardPool: PriceUsdc, maxQualifiedReferrers: number, startTime: UnixTimestamp, endTime: UnixTimestamp, subregistryId: AccountId, rulesUrl: URL, areAwardsDistributed: boolean) => ReferralProgramRulesPieSplit;
+
+/**
+ * The types of admin actions that can be taken upon a referrer in a rev-share-cap edition.
+ */
+declare const AdminActionTypes: {
     /**
-     * The start time of the referral program.
+     * The referrer is disqualified for awards.
      */
-    startTime: UnixTimestamp;
+    readonly Disqualification: "Disqualification";
     /**
-     * The end time of the referral program.
-     * @invariant Guaranteed to be greater than or equal to `startTime`
+     * The referrer is warned about a potential disqualification but may still be qualified for awards.
      */
-    endTime: UnixTimestamp;
+    readonly Warning: "Warning";
+};
+type AdminActionType = (typeof AdminActionTypes)[keyof typeof AdminActionTypes];
+/**
+ * An admin action to disqualify a referrer from receiving awards for an edition.
+ */
+interface AdminActionDisqualification {
+    actionType: typeof AdminActionTypes.Disqualification;
     /**
-     * The account ID of the subregistry for the referral program.
+     * The Ethereum address of the affected referrer, as a {@link NormalizedAddress}.
      */
-    subregistryId: AccountId;
+    referrer: NormalizedAddress;
+    /**
+     * A short message explaining the disqualification.
+     *
+     * @invariant Must be a trimmed, non-empty string.
+     */
+    reason: string;
 }
-declare const validateReferralProgramRules: (rules: ReferralProgramRules) => void;
-declare const buildReferralProgramRules: (totalAwardPoolValue: USDQuantity, maxQualifiedReferrers: number, startTime: UnixTimestamp, endTime: UnixTimestamp, subregistryId: AccountId) => ReferralProgramRules;
-
 /**
- * The score of a referrer.
- *
- * @invariant Guaranteed to be a finite non-negative number (>= 0)
+ * An admin action to warn a referrer that their eligibility for receiving awards for an edition
+ * is at risk unless the referrer takes corrective actions.
  */
-type ReferrerScore = number;
-declare const isValidReferrerScore: (score: ReferrerScore) => boolean;
-declare const validateReferrerScore: (score: ReferrerScore) => void;
+interface AdminActionWarning {
+    actionType: typeof AdminActionTypes.Warning;
+    /**
+     * The Ethereum address of the affected referrer, as a {@link NormalizedAddress}.
+     */
+    referrer: NormalizedAddress;
+    /**
+     * A short message explaining the warning.
+     *
+     * @invariant Must be a trimmed, non-empty string.
+     */
+    reason: string;
+}
 /**
- * Calculate the score of a referrer based on the total incremental duration
- * (in seconds) of registrations and renewals for direct subnames of .eth
- * referred by the referrer within the ENS Holiday Awards period.
- *
- * @param totalIncrementalDuration - The total incremental duration (in seconds)
- * of referrals made by a referrer within the {@link ReferralProgramRules}.
- * @returns The score of the referrer.
+ * A discriminated union of all admin action types.
  */
-declare const calcReferrerScore: (totalIncrementalDuration: Duration) => ReferrerScore;
-
+type AdminAction = AdminActionDisqualification | AdminActionWarning;
+interface ReferralProgramRulesRevShareCap extends BaseReferralProgramRules {
+    /**
+     * Discriminant: identifies this as a "rev-share-cap" award model edition.
+     *
+     * In rev-share-cap, each qualified referrer receives a share of their base revenue
+     * contribution (base-fee-only: `baseAnnualRevenueContribution` × years of incremental duration),
+     * subject to the award pool cap and a minimum qualification threshold.
+     */
+    awardModel: typeof ReferralProgramAwardModels.RevShareCap;
+    /**
+     * The award pool in USDC (acts as a cap on total payouts).
+     */
+    awardPool: PriceUsdc;
+    /**
+     * The minimum base revenue contribution required for a referrer to qualify for awards.
+     */
+    minBaseRevenueContribution: PriceUsdc;
+    /**
+     * Base revenue contribution in USDC per year of incremental duration from referred registrations and renewals.
+     *
+     * Used in `rev-share-cap` qualification and award calculations:
+     * 1 year of incremental duration → this many USDC of base revenue (base-fee-only, excluding premiums).
+     */
+    baseAnnualRevenueContribution: PriceUsdc;
+    /**
+     * The fraction of the referrer's base revenue contribution that constitutes their max potential award for each referral.
+     * This is the max for a referral that ignores the possibility of the referrer not having achieved qualification for awards yet, the referrer being disqualified from awards, or the award pool being exhausted.
+     *
+     * @invariant Guaranteed to be a number between 0 and 1 (inclusive)
+     */
+    maxBaseRevenueShare: number;
+    /**
+     * Admin actions for this edition.
+     *
+     * @invariant No duplicate referrer addresses (a referrer can have at most one admin action).
+     */
+    adminActions: AdminAction[];
+}
+declare const validateReferralProgramRulesRevShareCap: (rules: ReferralProgramRulesRevShareCap) => void;
+declare const buildReferralProgramRulesRevShareCap: (awardPool: PriceUsdc, minBaseRevenueContribution: PriceUsdc, baseAnnualRevenueContribution: PriceUsdc, maxBaseRevenueShare: number, startTime: UnixTimestamp, endTime: UnixTimestamp, subregistryId: AccountId, rulesUrl: URL, areAwardsDistributed: boolean, adminActions?: AdminAction[]) => ReferralProgramRulesRevShareCap;
 /**
- * The rank of a referrer relative to all other referrers, where 1 is the
- * top-ranked referrer.
+ * Determine if a referrer is qualified under rev-share-cap rules.
  *
- * @invariant Guaranteed to be a positive integer (> 0)
+ * A referrer is qualified if they meet the revenue threshold AND are not admin-disqualified.
+ *
+ * @param referrer - The referrer's address.
+ * @param totalBaseRevenueContribution - The referrer's total base revenue contribution.
+ * @param rules - The rev-share-cap rules of the referral program.
  */
-type ReferrerRank = number;
-declare const validateReferrerRank: (rank: ReferrerRank) => void;
+declare function isReferrerQualifiedRevShareCap(referrer: NormalizedAddress, totalBaseRevenueContribution: PriceUsdc, rules: ReferralProgramRulesRevShareCap): boolean;
+
 /**
- * Determine if a referrer with the given `rank` is qualified to receive a non-zero `awardPoolShare` according to the given `rules`.
+ * The rules of a referral program edition.
  *
- * @param rank - The rank of the referrer relative to all other referrers on a {@link ReferrerLeaderboard}.
- * @param rules - The rules of the referral program that generated the `rank`.
+ * Use `awardModel` to discriminate between rule types at runtime:
+ * - `"pie-split"` → {@link ReferralProgramRulesPieSplit}
+ * - `"rev-share-cap"` → {@link ReferralProgramRulesRevShareCap}
+ * - `"unrecognized"` → {@link ReferralProgramRulesUnrecognized} (client-side forward-compatibility
+ *   placeholder for editions whose `awardModel` string is not known to this client version)
+ *
+ * Internal business logic only handles the known variants (`pie-split`, `rev-share-cap`).
+ * Unrecognized editions should be skipped with a warning log rather than crashing.
  */
-declare function isReferrerQualified(rank: ReferrerRank, rules: ReferralProgramRules): boolean;
+type ReferralProgramRules = ReferralProgramRulesPieSplit | ReferralProgramRulesRevShareCap | ReferralProgramRulesUnrecognized;
+
 /**
- * Calculate the final score boost of a referrer based on their rank.
+ * Referral program edition slug.
  *
- * @param rank - The rank of the referrer relative to all other referrers, where 1 is the
- * top-ranked referrer.
- * @returns The final score boost of the referrer as a number between 0 and 1 (inclusive).
+ * A URL-safe identifier for a referral program edition. Each edition represents
+ * a distinct referral program period with its own rules, leaderboard, and
+ * award distribution.
+ *
+ * @invariant Must contain only lowercase letters (a-z), digits (0-9), and hyphens (-).
+ *            Must not start or end with a hyphen. Pattern: `^[a-z0-9]+(-[a-z0-9]+)*$`
+ *
+ * @example "2025-12" // December 2025 edition
+ * @example "2026-03" // March 2026 edition
+ * @example "holiday-special" // Custom named edition
  */
-declare function calcReferrerFinalScoreBoost(rank: ReferrerRank, rules: ReferralProgramRules): number;
+type ReferralProgramEditionSlug = string;
 /**
- * Calculate the final score multiplier of a referrer based on their rank.
+ * Regex pattern that all {@link ReferralProgramEditionSlug} values must match.
  *
- * @param rank - The rank of the referrer relative to all other referrers, where 1 is the
- * top-ranked referrer.
- * @returns The final score multiplier of the referrer as a number between 1 and 2 (inclusive).
+ * Allows lowercase letters (a-z), digits (0-9), and hyphens (-).
+ * Must not start or end with a hyphen.
  */
-declare function calcReferrerFinalScoreMultiplier(rank: ReferrerRank, rules: ReferralProgramRules): number;
+declare const REFERRAL_PROGRAM_EDITION_SLUG_PATTERN: RegExp;
 /**
- * Calculate the final score of a referrer based on their score and final score boost.
- *
- * @param rank - The rank of the referrer relative to all other referrers.
- * @param totalIncrementalDuration - The total incremental duration (in seconds)
- * of referrals made by the referrer within the `rules`.
- * @param rules - The rules of the referral program that generated the `rank`.
- * @returns The final score of the referrer.
+ * Represents a referral program edition configuration.
  */
-declare function calcReferrerFinalScore(rank: ReferrerRank, totalIncrementalDuration: Duration, rules: ReferralProgramRules): ReferrerScore;
-interface ReferrerMetricsForComparison {
+interface ReferralProgramEditionConfig {
     /**
-     * The total incremental duration (in seconds) of all referrals made by the referrer within
-     * the {@link ReferralProgramRules}.
+     * Unique slug identifier for the edition.
      */
-    totalIncrementalDuration: Duration;
+    slug: ReferralProgramEditionSlug;
     /**
-     * The fully lowercase Ethereum address of the referrer.
-     *
-     * @invariant Guaranteed to be a valid EVM address in lowercase format.
+     * Human-readable display name for the edition.
+     * @example "ENS Holiday Awards"
      */
-    referrer: Address;
+    displayName: string;
+    /**
+     * The rules that govern this referral program edition.
+     */
+    rules: ReferralProgramRules;
 }
-declare const compareReferrerMetrics: (a: ReferrerMetricsForComparison, b: ReferrerMetricsForComparison) => number;
-
 /**
- * Revenue Contribution
+ * A map from edition slug to edition configuration.
  *
- * Represents the total revenue contribution (in Wei) made to the ENS DAO.
+ * Used to store and look up all configured referral program editions.
  *
- * This is the sum of the total cost paid by registrants for registrar actions.
- * From the perspective of the ENS DAO, this represents revenue received.
+ * @invariant For each key-value pair in the map, the key must equal the value's slug property.
+ *            That is, for all entries: `map.get(key)?.slug === key`
+ */
+type ReferralProgramEditionConfigSet = Map<ReferralProgramEditionSlug, ReferralProgramEditionConfig>;
+/**
+ * Validates that a ReferralProgramEditionConfigSet maintains the invariant
+ * that each map key equals the corresponding config's slug.
  *
- * @invariant Guaranteed to be a non-negative bigint value (>= 0n)
- * @invariant Never null (records with null `total` in the database are treated as 0 when summing)
+ * @param configSet - The edition config set to validate
+ * @throws {Error} If any entry violates the invariant (key !== value.slug)
  */
-type RevenueContribution = bigint;
+declare function validateReferralProgramEditionConfigSet(configSet: ReferralProgramEditionConfigSet): void;
 /**
- * Check if a value is a valid revenue contribution.
+ * Builds a new ReferralProgramEditionConfigSet from an array of configs and validates the invariant.
  *
- * @param value - The value to check
- * @returns true if the value is a non-negative bigint, false otherwise
+ * @param configs - Array of edition configurations to add to the set
+ * @returns A validated edition config set
+ * @throws {Error} If duplicate slugs are detected or if any config would violate the invariant
  */
-declare function isValidRevenueContribution(value: unknown): value is RevenueContribution;
+declare function buildReferralProgramEditionConfigSet(configs: ReferralProgramEditionConfig[]): ReferralProgramEditionConfigSet;
+
 /**
- * Validate that a value is a valid revenue contribution.
+ * The score of a referrer.
  *
- * @param value - The value to validate
- * @throws {Error} If the value is not a valid revenue contribution
+ * @invariant Guaranteed to be a finite non-negative number (>= 0)
  */
-declare function validateRevenueContribution(value: unknown): void;
+type ReferrerScore = number;
+declare const isValidReferrerScore: (score: ReferrerScore) => boolean;
+declare const validateReferrerScore: (score: ReferrerScore) => void;
 
 /**
- * Represents metrics for a single referrer independent of other referrers.
+ * Metrics for a single referrer, as aggregated from the DB layer.
+ * Independent of other referrers and award model; does not carry an `awardModel` discriminant.
  */
 interface ReferrerMetrics {
     /**
-     * The fully lowercase Ethereum address of the referrer.
-     *
-     * @invariant Guaranteed to be a valid EVM address in lowercase format
+     * The Ethereum address of the referrer, as a {@link NormalizedAddress}.
      */
-    referrer: Address;
+    referrer: NormalizedAddress;
     /**
      * The total number of referrals made by the referrer within the {@link ReferralProgramRules}.
      * @invariant Guaranteed to be a non-negative integer (>= 0)
@@ -184,54 +313,79 @@ interface ReferrerMetrics {
      */
     totalIncrementalDuration: Duration;
     /**
-     * The total revenue contribution (in Wei) made to the ENS DAO by all referrals
+     * The total revenue contribution in ETH made to the ENS DAO by all referrals
      * from this referrer.
      *
      * This is the sum of the total cost paid by registrants for all registrar actions
      * where this address was the referrer.
      *
-     * @invariant Guaranteed to be a non-negative bigint value (>= 0n)
      * @invariant Never null (records with null `total` in the database are treated as 0 when summing)
      */
-    totalRevenueContribution: RevenueContribution;
+    totalRevenueContribution: PriceEth;
 }
-declare const buildReferrerMetrics: (referrer: Address, totalReferrals: number, totalIncrementalDuration: Duration, totalRevenueContribution: RevenueContribution) => ReferrerMetrics;
+declare const buildReferrerMetrics: (referrer: NormalizedAddress, totalReferrals: number, totalIncrementalDuration: Duration, totalRevenueContribution: PriceEth) => ReferrerMetrics;
 declare const validateReferrerMetrics: (metrics: ReferrerMetrics) => void;
+
+/**
+ * The rank of a referrer relative to all other referrers, where 1 is the
+ * top-ranked referrer.
+ *
+ * @invariant Guaranteed to be a positive integer (> 0)
+ */
+type ReferrerRank = number;
+declare const validateReferrerRank: (rank: ReferrerRank) => void;
+interface ReferrerMetricsForComparison {
+    /**
+     * The total incremental duration (in seconds) of all referrals made by the referrer within
+     * the {@link ReferralProgramRules}.
+     */
+    totalIncrementalDuration: Duration;
+    /**
+     * The Ethereum address of the referrer, as a {@link NormalizedAddress}.
+     */
+    referrer: NormalizedAddress;
+}
+declare const compareReferrerMetrics: (a: ReferrerMetricsForComparison, b: ReferrerMetricsForComparison) => number;
+/**
+ * Sorts a list of referrers for leaderboard ranking.
+ * Returns a new array — does not mutate the input.
+ */
 declare const sortReferrerMetrics: (referrers: ReferrerMetrics[]) => ReferrerMetrics[];
+
 /**
  * Represents metrics for a single referrer independent of other referrers,
  * including a calculation of the referrer's score.
  */
-interface ScoredReferrerMetrics extends ReferrerMetrics {
+interface ScoredReferrerMetricsPieSplit extends ReferrerMetrics {
     /**
      * The referrer's score.
      *
-     * @invariant Guaranteed to be `calcReferrerScore(totalIncrementalDuration)`
+     * @invariant Guaranteed to be `calcReferrerScorePieSplit(totalIncrementalDuration)`
      */
     score: ReferrerScore;
 }
-declare const buildScoredReferrerMetrics: (referrer: ReferrerMetrics) => ScoredReferrerMetrics;
-declare const validateScoredReferrerMetrics: (metrics: ScoredReferrerMetrics) => void;
+declare const buildScoredReferrerMetricsPieSplit: (referrer: ReferrerMetrics) => ScoredReferrerMetricsPieSplit;
+declare const validateScoredReferrerMetricsPieSplit: (metrics: ScoredReferrerMetricsPieSplit) => void;
 /**
- * Extends {@link ScoredReferrerMetrics} to include additional metrics
- * relative to all other referrers on a {@link ReferrerLeaderboard} and {@link ReferralProgramRules}.
+ * Extends {@link ScoredReferrerMetricsPieSplit} to include additional metrics relative to all
+ * other referrers on a {@link ReferrerLeaderboardPieSplit} and {@link ReferralProgramRulesPieSplit}.
  */
-interface RankedReferrerMetrics extends ScoredReferrerMetrics {
+interface RankedReferrerMetricsPieSplit extends ScoredReferrerMetricsPieSplit {
     /**
-     * The referrer's rank on the {@link ReferrerLeaderboard} relative to all other referrers.
+     * The referrer's rank on the {@link ReferrerLeaderboardPieSplit} relative to all other referrers.
      */
     rank: ReferrerRank;
     /**
-     * Identifies if the referrer meets the qualifications of the {@link ReferralProgramRules} to receive a non-zero `awardPoolShare`.
+     * Identifies if the referrer meets the qualifications of the {@link ReferralProgramRulesPieSplit} to receive a non-zero `awardPoolShare`.
      *
-     * @invariant true if and only if `rank` is less than or equal to {@link ReferralProgramRules.maxQualifiedReferrers}
+     * @invariant true if and only if `rank` is less than or equal to {@link ReferralProgramRulesPieSplit.maxQualifiedReferrers}
      */
     isQualified: boolean;
     /**
      * The referrer's final score boost.
      *
      * @invariant Guaranteed to be a number between 0 and 1 (inclusive)
-     * @invariant Calculated as: `1-((rank-1)/({@link ReferralProgramRules.maxQualifiedReferrers}-1))` if `isQualified` is `true`, else `0`
+     * @invariant Calculated as: `1-((rank-1)/({@link ReferralProgramRulesPieSplit.maxQualifiedReferrers}-1))` if `isQualified` is `true`, else `0`
      */
     finalScoreBoost: number;
     /**
@@ -241,43 +395,42 @@ interface RankedReferrerMetrics extends ScoredReferrerMetrics {
      */
     finalScore: ReferrerScore;
 }
-declare const validateRankedReferrerMetrics: (metrics: RankedReferrerMetrics, rules: ReferralProgramRules) => void;
-declare const buildRankedReferrerMetrics: (referrer: ScoredReferrerMetrics, rank: ReferrerRank, rules: ReferralProgramRules) => RankedReferrerMetrics;
+declare const validateRankedReferrerMetricsPieSplit: (metrics: RankedReferrerMetricsPieSplit, rules: ReferralProgramRulesPieSplit) => void;
+declare const buildRankedReferrerMetricsPieSplit: (referrer: ScoredReferrerMetricsPieSplit, rank: ReferrerRank, rules: ReferralProgramRulesPieSplit) => RankedReferrerMetricsPieSplit;
 /**
  * Calculate the share of the award pool for a referrer.
  * @param referrer - The referrer to calculate the award pool share for.
  * @param aggregatedMetrics - Aggregated metrics for all referrers.
- * @param rules - The rules of the referral program.
  * @returns The referrer's share of the award pool as a number between 0 and 1 (inclusive).
  */
-declare const calcReferrerAwardPoolShare: (referrer: RankedReferrerMetrics, aggregatedMetrics: AggregatedReferrerMetrics, rules: ReferralProgramRules) => number;
+declare const calcReferrerAwardPoolSharePieSplit: (referrer: RankedReferrerMetricsPieSplit, aggregatedMetrics: AggregatedReferrerMetricsPieSplit) => number;
 /**
- * Extends {@link RankedReferrerMetrics} to include additional metrics
- * relative to {@link AggregatedRankedReferrerMetrics}.
+ * Extends {@link RankedReferrerMetricsPieSplit} to include additional metrics
+ * relative to {@link AggregatedReferrerMetricsPieSplit}.
  */
-interface AwardedReferrerMetrics extends RankedReferrerMetrics {
+interface AwardedReferrerMetricsPieSplit extends RankedReferrerMetricsPieSplit {
     /**
      * The referrer's share of the award pool.
      *
      * @invariant Guaranteed to be a number between 0 and 1 (inclusive)
-     * @invariant Calculated as: `finalScore / {@link AggregatedRankedReferrerMetrics.grandTotalQualifiedReferrersFinalScore}` if `isQualified` is `true`, else `0`
+     * @invariant Calculated as: `finalScore / {@link AggregatedReferrerMetricsPieSplit.grandTotalQualifiedReferrersFinalScore}` if `isQualified` is `true`, else `0`
      */
     awardPoolShare: number;
     /**
-     * The approximate {@link USDQuantity} of the referrer's share of the {@link ReferralProgramRules.totalAwardPoolValue}.
+     * The approximate USDC value of the referrer's share of the {@link ReferralProgramRulesPieSplit.awardPool}.
      *
-     * @invariant Guaranteed to be a number between 0 and {@link ReferralProgramRules.totalAwardPoolValue} (inclusive)
-     * @invariant Calculated as: `awardPoolShare` * {@link ReferralProgramRules.totalAwardPoolValue}
+     * @invariant Guaranteed to be a valid PriceUsdc with amount between 0 and {@link ReferralProgramRulesPieSplit.awardPool.amount} (inclusive)
+     * @invariant Calculated as: `awardPoolShare` * {@link ReferralProgramRulesPieSplit.awardPool.amount}
      */
-    awardPoolApproxValue: USDQuantity;
+    awardPoolApproxValue: PriceUsdc;
 }
-declare const validateAwardedReferrerMetrics: (referrer: AwardedReferrerMetrics, rules: ReferralProgramRules) => void;
-declare const buildAwardedReferrerMetrics: (referrer: RankedReferrerMetrics, aggregatedMetrics: AggregatedReferrerMetrics, rules: ReferralProgramRules) => AwardedReferrerMetrics;
+declare const validateAwardedReferrerMetricsPieSplit: (referrer: AwardedReferrerMetricsPieSplit, rules: ReferralProgramRulesPieSplit) => void;
+declare const buildAwardedReferrerMetricsPieSplit: (referrer: RankedReferrerMetricsPieSplit, aggregatedMetrics: AggregatedReferrerMetricsPieSplit, rules: ReferralProgramRulesPieSplit) => AwardedReferrerMetricsPieSplit;
 /**
- * Extends {@link AwardedReferrerMetrics} but with rank set to null to represent
+ * Extends {@link AwardedReferrerMetricsPieSplit} but with rank set to null to represent
  * a referrer who is not on the leaderboard (has zero referrals within the rules associated with the leaderboard).
  */
-interface UnrankedReferrerMetrics extends Omit<AwardedReferrerMetrics, "rank" | "isQualified"> {
+interface UnrankedReferrerMetricsPieSplit extends Omit<AwardedReferrerMetricsPieSplit, "rank" | "isQualified"> {
     /**
      * The referrer is not on the leaderboard and therefore has no rank.
      */
@@ -287,7 +440,7 @@ interface UnrankedReferrerMetrics extends Omit<AwardedReferrerMetrics, "rank" |
      */
     isQualified: false;
 }
-declare const validateUnrankedReferrerMetrics: (metrics: UnrankedReferrerMetrics) => void;
+declare const validateUnrankedReferrerMetricsPieSplit: (metrics: UnrankedReferrerMetricsPieSplit) => void;
 /**
  * Build an unranked zero-score referrer record for a referrer address that is not in the leaderboard.
  *
@@ -295,34 +448,34 @@ declare const validateUnrankedReferrerMetrics: (metrics: UnrankedReferrerMetrics
  * and is not qualified for the leaderboard.
  *
  * @param referrer - The referrer address
- * @returns An {@link UnrankedReferrerMetrics} with zero values for all metrics and null rank
+ * @returns An {@link UnrankedReferrerMetricsPieSplit} with zero values for all metrics and null rank
  */
-declare const buildUnrankedReferrerMetrics: (referrer: Address) => UnrankedReferrerMetrics;
+declare const buildUnrankedReferrerMetricsPieSplit: (referrer: NormalizedAddress) => UnrankedReferrerMetricsPieSplit;
 
 /**
- * Represents aggregated metrics for a list of `RankedReferrerMetrics`.
+ * Represents aggregated metrics for a list of {@link RankedReferrerMetricsPieSplit}.
  */
-interface AggregatedReferrerMetrics {
+interface AggregatedReferrerMetricsPieSplit {
     /**
-     * @invariant The sum of `totalReferrals` across all `RankedReferrerMetrics` in the list.
+     * @invariant The sum of `totalReferrals` across all {@link RankedReferrerMetricsPieSplit} in the list.
      * @invariant Guaranteed to be a non-negative integer (>= 0)
      */
     grandTotalReferrals: number;
     /**
-     * @invariant The sum of `totalIncrementalDuration` across all `RankedReferrerMetrics` in the list.
+     * @invariant The sum of `totalIncrementalDuration` across all {@link RankedReferrerMetricsPieSplit} in the list.
      */
     grandTotalIncrementalDuration: Duration;
     /**
-     * The total revenue contribution (in Wei) to the ENS DAO from all referrals
+     * The total revenue contribution in ETH to the ENS DAO from all referrals
      * across all referrers on the leaderboard.
      *
-     * This is the sum of `totalRevenueContribution` across all `RankedReferrerMetrics` in the list.
+     * This is the sum of `totalRevenueContribution` across all {@link RankedReferrerMetricsPieSplit} in the list.
      *
-     * @invariant Guaranteed to be a non-negative bigint value (>= 0n)
+     * @invariant Guaranteed to be a valid PriceEth with non-negative amount (>= 0n)
      */
-    grandTotalRevenueContribution: RevenueContribution;
+    grandTotalRevenueContribution: PriceEth;
     /**
-     * @invariant The sum of `finalScore` across all `RankedReferrerMetrics` where `isQualified` is `true`.
+     * @invariant The sum of `finalScore` across all {@link RankedReferrerMetricsPieSplit} where `isQualified` is `true`.
      */
     grandTotalQualifiedReferrersFinalScore: ReferrerScore;
     /**
@@ -334,41 +487,557 @@ interface AggregatedReferrerMetrics {
      */
     minFinalScoreToQualify: ReferrerScore;
 }
-declare const validateAggregatedReferrerMetrics: (metrics: AggregatedReferrerMetrics) => void;
-declare const buildAggregatedReferrerMetrics: (referrers: RankedReferrerMetrics[], rules: ReferralProgramRules) => AggregatedReferrerMetrics;
+declare const validateAggregatedReferrerMetricsPieSplit: (metrics: AggregatedReferrerMetricsPieSplit) => void;
+/**
+ * Builds aggregated pie-split metrics from a complete, globally ranked list of referrers.
+ *
+ * **IMPORTANT: This function expects a complete ranking of all referrers.**
+ *
+ * @param referrers - Must be a complete, globally ranked list of {@link RankedReferrerMetricsPieSplit}
+ *                    where ranks start at 1 and are consecutive.
+ *                    **This must NOT be a paginated or partial slice of the rankings.**
+ *
+ * @param rules - The {@link ReferralProgramRulesPieSplit} object that define qualification criteria,
+ *                including `maxQualifiedReferrers` (the maximum number of referrers
+ *                that can qualify for rewards).
+ *
+ * @returns Aggregated metrics including totals across all referrers and the minimum
+ *          score required to qualify.
+ *
+ * @remarks
+ * - If you need to work with paginated data, aggregate the full ranking first before
+ *   calling this function, or call this function on the complete dataset and then paginate
+ *   the results.
+ * - If `rules.maxQualifiedReferrers === 0`, no referrers can qualify and
+ *   `minFinalScoreToQualify` will be set to `Number.MAX_SAFE_INTEGER`.
+ * - If `referrers` is empty and `rules.maxQualifiedReferrers > 0`,
+ *   `minFinalScoreToQualify` will be set to `0` (anyone can qualify).
+ */
+declare const buildAggregatedReferrerMetricsPieSplit: (referrers: RankedReferrerMetricsPieSplit[], rules: ReferralProgramRulesPieSplit) => AggregatedReferrerMetricsPieSplit;
 
 /**
- * Represents a leaderboard for any number of referrers.
+ * The type of referrer edition metrics data.
  */
-interface ReferrerLeaderboard {
+declare const ReferrerEditionMetricsTypeIds: {
     /**
-     * The rules of the referral program that generated the {@link ReferrerLeaderboard}.
+     * Represents a referrer who is ranked on the leaderboard.
      */
-    rules: ReferralProgramRules;
+    readonly Ranked: "ranked";
+    /**
+     * Represents a referrer who is not ranked on the leaderboard.
+     */
+    readonly Unranked: "unranked";
+};
+/**
+ * The derived string union of possible {@link ReferrerEditionMetricsTypeIds}.
+ */
+type ReferrerEditionMetricsTypeId = (typeof ReferrerEditionMetricsTypeIds)[keyof typeof ReferrerEditionMetricsTypeIds];
+/**
+ * Referrer edition metrics for an edition whose `awardModel` is not recognized by this client version.
+ *
+ * @remarks
+ * This is a **client-side forward-compatibility** type only. It is never serialized or processed
+ * by business logic on the backend. When the server introduces a new award model type, older
+ * clients preserve the metrics rather than throwing, and downstream code that encounters this type
+ * should handle it gracefully rather than crashing.
+ */
+interface ReferrerEditionMetricsUnrecognized {
+    /**
+     * Discriminant — always `"unrecognized"`.
+     */
+    awardModel: typeof ReferralProgramAwardModels.Unrecognized;
+    /**
+     * The original, unrecognized `awardModel` string received from the server.
+     *
+     * @remarks Preserved for logging and debugging. Never used for business logic.
+     */
+    originalAwardModel: string;
+}
+
+/**
+ * The type of referral program edition's status.
+ */
+declare const ReferralProgramEditionStatuses: {
+    /**
+     * Represents a referral program edition that has been announced, but hasn't started yet.
+     */
+    readonly Scheduled: "Scheduled";
     /**
-     * The {@link AggregatedReferrerMetrics} for all `RankedReferrerMetrics` values in `leaderboard`.
+     * Represents a currently ongoing referral program edition.
      */
-    aggregatedMetrics: AggregatedReferrerMetrics;
+    readonly Active: "Active";
+    /**
+     * Represents a referral program edition that is still within its active window
+     * but whose award pool has been fully consumed.
+     *
+     * @note Not all award models may support this status.
+     */
+    readonly Exhausted: "Exhausted";
     /**
-     * Ordered map containing `AwardedReferrerMetrics` for all referrers with 1 or more
-     * `totalReferrals` within the `rules` as of `updatedAt`.
+     * Represents a referral program edition that has passed its end time but whose awards have not yet
+     * been distributed. The edition is in a review window before full closure.
+     *
+     * Transitions to {@link ReferralProgramEditionStatuses.Closed} once `areAwardsDistributed` is set to `true`.
+     */
+    readonly AwardsReview: "AwardsReview";
+    /**
+     * Represents a referral program edition that has already ended and whose awards have been distributed.
+     */
+    readonly Closed: "Closed";
+};
+/**
+ * The derived string union of possible {@link ReferralProgramEditionStatuses}.
+ */
+type ReferralProgramEditionStatusId = (typeof ReferralProgramEditionStatuses)[keyof typeof ReferralProgramEditionStatuses];
+/**
+ * Calculate the base status of a referral program edition using only its rules and
+ * the current time (makes no consideration of the awards possibly being exhausted).
+ *
+ * @param rules - Related referral program's rules containing program's start/end date and
+ *   `areAwardsDistributed` flag.
+ * @param now - Current date in {@link UnixTimestamp} format.
+ */
+declare const calcBaseReferralProgramEditionStatus: (rules: BaseReferralProgramRules, now: UnixTimestamp) => ReferralProgramEditionStatusId;
+
+/**
+ * Referrer edition metrics data for a specific referrer address on the pie-split leaderboard.
+ *
+ * Includes the referrer's awarded metrics from the leaderboard plus timestamp.
+ *
+ * Invariants:
+ * - `type` is always {@link ReferrerEditionMetricsTypeIds.Ranked}.
+ * - `awardModel` is always {@link ReferralProgramAwardModels.PieSplit} and equals `rules.awardModel`.
+ *
+ * @see {@link AwardedReferrerMetricsPieSplit}
+ */
+interface ReferrerEditionMetricsRankedPieSplit {
+    /**
+     * Discriminant identifying this as data from a pie-split leaderboard edition.
+     *
+     * @invariant Always equals `rules.awardModel` ({@link ReferralProgramAwardModels.PieSplit}).
+     */
+    awardModel: typeof ReferralProgramAwardModels.PieSplit;
+    /**
+     * The type of referrer edition metrics data.
+     */
+    type: typeof ReferrerEditionMetricsTypeIds.Ranked;
+    /**
+     * The {@link ReferralProgramRulesPieSplit} used to calculate the {@link AwardedReferrerMetricsPieSplit}.
+     */
+    rules: ReferralProgramRulesPieSplit;
+    /**
+     * The awarded referrer metrics from the leaderboard.
+     *
+     * Contains all calculated metrics including score, rank, qualification status,
+     * and award pool share information.
+     */
+    referrer: AwardedReferrerMetricsPieSplit;
+    /**
+     * Aggregated metrics for all referrers on the leaderboard.
+     */
+    aggregatedMetrics: AggregatedReferrerMetricsPieSplit;
+    /**
+     * The status of the referral program edition
+     * calculated based on the program's timing relative to {@link accurateAsOf}.
+     */
+    status: ReferralProgramEditionStatusId;
+    /**
+     * The {@link UnixTimestamp} of when the data used to build the {@link ReferrerEditionMetricsRankedPieSplit} was accurate as of.
+     */
+    accurateAsOf: UnixTimestamp;
+}
+/**
+ * Referrer edition metrics data for a specific referrer address NOT on the pie-split leaderboard.
+ *
+ * Includes the referrer's unranked metrics (with null rank and isQualified: false) plus timestamp.
+ *
+ * Invariants:
+ * - `type` is always {@link ReferrerEditionMetricsTypeIds.Unranked}.
+ * - `awardModel` is always {@link ReferralProgramAwardModels.PieSplit} and equals `rules.awardModel`.
+ *
+ * @see {@link UnrankedReferrerMetricsPieSplit}
+ */
+interface ReferrerEditionMetricsUnrankedPieSplit {
+    /**
+     * Discriminant identifying this as data from a pie-split leaderboard edition.
+     *
+     * @invariant Always equals `rules.awardModel` ({@link ReferralProgramAwardModels.PieSplit}).
+     */
+    awardModel: typeof ReferralProgramAwardModels.PieSplit;
+    /**
+     * The type of referrer edition metrics data.
+     */
+    type: typeof ReferrerEditionMetricsTypeIds.Unranked;
+    /**
+     * The {@link ReferralProgramRulesPieSplit} used to calculate the {@link UnrankedReferrerMetricsPieSplit}.
+     */
+    rules: ReferralProgramRulesPieSplit;
+    /**
+     * The unranked referrer metrics (not on the leaderboard).
+     *
+     * Contains all calculated metrics with rank set to null and isQualified set to false.
+     */
+    referrer: UnrankedReferrerMetricsPieSplit;
+    /**
+     * Aggregated metrics for all referrers on the leaderboard.
+     */
+    aggregatedMetrics: AggregatedReferrerMetricsPieSplit;
+    /**
+     * The status of the referral program edition
+     * calculated based on the program's timing relative to {@link accurateAsOf}.
+     */
+    status: ReferralProgramEditionStatusId;
+    /**
+     * The {@link UnixTimestamp} of when the data used to build the {@link ReferrerEditionMetricsUnrankedPieSplit} was accurate as of.
+     */
+    accurateAsOf: UnixTimestamp;
+}
+/**
+ * All referrer edition metrics variants for the pie-split award model.
+ *
+ * Use `type` to determine if the referrer is ranked or unranked.
+ */
+type ReferrerEditionMetricsPieSplit = ReferrerEditionMetricsRankedPieSplit | ReferrerEditionMetricsUnrankedPieSplit;
+
+/**
+ * Base fields shared by all edition summary variants.
+ */
+interface BaseReferralProgramEditionSummary {
+    /**
+     * Discriminant: identifies the award model for this edition.
+     *
+     * @invariant Always equals `rules.awardModel`.
+     */
+    awardModel: ReferralProgramAwardModel;
+    /**
+     * Unique slug identifier for the edition.
+     */
+    slug: ReferralProgramEditionSlug;
+    /**
+     * Human-readable display name for the edition.
+     */
+    displayName: string;
+    /**
+     * The current runtime status of the edition.
+     */
+    status: ReferralProgramEditionStatusId;
+    /**
+     * The rules for this edition. Per-model subtypes narrow this to their specific rules type.
+     */
+    rules: BaseReferralProgramRules;
+}
+/**
+ * Edition summary for an edition whose `awardModel` is not recognized by this client version.
+ *
+ * @remarks
+ * This is a **client-side forward-compatibility** type only. It is never serialized or produced
+ * by the server. When the server sends a new award model, older clients preserve the edition
+ * summary rather than crashing, and downstream code should handle it gracefully.
+ */
+interface ReferralProgramEditionSummaryUnrecognized extends BaseReferralProgramEditionSummary {
+    /**
+     * Discriminant — always `"unrecognized"`.
+     */
+    awardModel: typeof ReferralProgramAwardModels.Unrecognized;
+    /**
+     * The unrecognized rules — preserves `originalAwardModel` for logging/debugging.
+     */
+    rules: ReferralProgramRulesUnrecognized;
+}
+declare const validateBaseReferralProgramEditionSummary: (summary: BaseReferralProgramEditionSummary) => void;
+
+/**
+ * Represents a leaderboard with the pie-split award model for any number of referrers.
+ */
+interface ReferrerLeaderboardPieSplit {
+    /**
+     * Discriminant identifying this as a pie-split leaderboard.
+     *
+     * @invariant Always equals `rules.awardModel` ({@link ReferralProgramAwardModels.PieSplit}).
+     */
+    awardModel: typeof ReferralProgramAwardModels.PieSplit;
+    /**
+     * The rules of the referral program that generated the {@link ReferrerLeaderboardPieSplit}.
+     */
+    rules: ReferralProgramRulesPieSplit;
+    /**
+     * The {@link AggregatedReferrerMetricsPieSplit} for all {@link RankedReferrerMetricsPieSplit} values in `referrers`.
+     */
+    aggregatedMetrics: AggregatedReferrerMetricsPieSplit;
+    /**
+     * Ordered map containing `AwardedReferrerMetricsPieSplit` for all referrers with 1 or more
+     * `totalReferrals` within the `rules` as of `accurateAsOf`.
      *
      * @invariant Map entries are ordered by `rank` (ascending).
      * @invariant Map is empty if there are no referrers with 1 or more `totalReferrals`
-     *            within the `rules` as of `updatedAt`.
-     * @invariant If a fully-lowercase `Address` is not a key in this map then that `Address` had
+     *            within the `rules` as of `accurateAsOf`.
+     * @invariant If a `NormalizedAddress` is not a key in this map then that `NormalizedAddress` had
      *            0 `totalReferrals`, `totalIncrementalDuration`, and `score` within the
-     *            `rules` as of `updatedAt`.
+     *            `rules` as of `accurateAsOf`.
      * @invariant Each value in this map is guaranteed to have a non-zero
      *            `totalReferrals`, `totalIncrementalDuration`, and `score`.
      */
-    referrers: Map<Address, AwardedReferrerMetrics>;
+    referrers: Map<NormalizedAddress, AwardedReferrerMetricsPieSplit>;
+    /**
+     * The {@link UnixTimestamp} of when the data used to build the {@link ReferrerLeaderboardPieSplit} was accurate as of.
+     */
+    accurateAsOf: UnixTimestamp;
+}
+declare const buildReferrerLeaderboardPieSplit: (allReferrers: ReferrerMetrics[], rules: ReferralProgramRulesPieSplit, accurateAsOf: UnixTimestamp) => ReferrerLeaderboardPieSplit;
+
+/**
+ * Edition summary for a `pie-split` referral program edition.
+ */
+interface ReferralProgramEditionSummaryPieSplit extends BaseReferralProgramEditionSummary {
+    /**
+     * Discriminant — always `"pie-split"`.
+     *
+     * @invariant Always equals `rules.awardModel` ({@link ReferralProgramAwardModels.PieSplit}).
+     */
+    awardModel: typeof ReferralProgramAwardModels.PieSplit;
+    /**
+     * The pie-split rules for this edition.
+     */
+    rules: ReferralProgramRulesPieSplit;
+}
+declare const validateEditionSummaryPieSplit: (summary: ReferralProgramEditionSummaryPieSplit) => void;
+/**
+ * Build a {@link ReferralProgramEditionSummaryPieSplit} from a pie-split edition config and the
+ * edition's leaderboard.
+ */
+declare function buildEditionSummaryPieSplit(slug: ReferralProgramEditionSlug, displayName: string, rules: ReferralProgramRulesPieSplit, leaderboard: ReferrerLeaderboardPieSplit): ReferralProgramEditionSummaryPieSplit;
+
+/**
+ * Extends {@link ReferrerMetrics} with computed base revenue contribution.
+ */
+interface ReferrerMetricsRevShareCap extends ReferrerMetrics {
+    /**
+     * The referrer's base revenue contribution
+     * (`rules.baseAnnualRevenueContribution` × years of incremental duration).
+     * Used for qualification and award calculation in the rev-share-cap model.
+     *
+     * @invariant Guaranteed to be `priceUsdc(rules.baseAnnualRevenueContribution.amount * BigInt(totalIncrementalDuration) / BigInt(SECONDS_PER_YEAR))`
+     */
+    totalBaseRevenueContribution: PriceUsdc;
+}
+declare const validateReferrerMetricsRevShareCap: (metrics: ReferrerMetricsRevShareCap, rules: ReferralProgramRulesRevShareCap) => void;
+declare const buildReferrerMetricsRevShareCap: (metrics: ReferrerMetrics, rules: ReferralProgramRulesRevShareCap) => ReferrerMetricsRevShareCap;
+/**
+ * Extends {@link ReferrerMetricsRevShareCap} with rank, qualification status, and admin disqualification.
+ */
+interface RankedReferrerMetricsRevShareCap extends ReferrerMetricsRevShareCap {
+    /**
+     * The referrer's rank on the {@link ReferrerLeaderboardRevShareCap} relative to all other referrers.
+     */
+    rank: ReferrerRank;
+    /**
+     * Identifies if the referrer is eligible for an award under the {@link ReferralProgramRulesRevShareCap}.
+     *
+     * Note: this is a purely rule-based eligibility predicate and does NOT guarantee
+     * `cappedAward.amount > 0n` — a qualified referrer may still receive $0 if the
+     * capped award pool is already exhausted by earlier referrers in the race.
+     *
+     * @invariant true if and only if `totalBaseRevenueContribution` is greater than or equal to
+     *   {@link ReferralProgramRulesRevShareCap.minBaseRevenueContribution} AND
+     *   {@link adminAction} does not have `actionType` of {@link AdminActionTypes.Disqualification}.
+     */
+    isQualified: boolean;
+    /**
+     * The admin action taken on this referrer, or null if no admin action has been taken.
+     *
+     * @invariant null when no admin action has been taken on this referrer.
+     * @invariant Must match the corresponding entry in {@link ReferralProgramRulesRevShareCap.adminActions}.
+     */
+    adminAction: AdminAction | null;
+}
+declare const validateRankedReferrerMetricsRevShareCap: (metrics: RankedReferrerMetricsRevShareCap, rules: ReferralProgramRulesRevShareCap) => void;
+declare const buildRankedReferrerMetricsRevShareCap: (referrer: ReferrerMetricsRevShareCap, rank: ReferrerRank, rules: ReferralProgramRulesRevShareCap) => RankedReferrerMetricsRevShareCap;
+/**
+ * Extends {@link RankedReferrerMetricsRevShareCap} with the referrer's uncapped and capped awards.
+ */
+interface AwardedReferrerMetricsRevShareCap extends RankedReferrerMetricsRevShareCap {
+    /**
+     * The uncapped USDC award for this referrer, computed as
+     * `maxBaseRevenueShare × totalBaseRevenueContribution`.
+     *
+     * Represents what the referrer would receive if the pool were uncapped and the referrer were qualified.
+     * Independent of the pool state, qualification status, and admin disqualification status.
+     */
+    uncappedAward: PriceUsdc;
+    /**
+     * The referrer's (tentative) capped USDC award.
+     *
+     * This is the amount (tentatively) claimed from the award pool by this referrer, capped by
+     * the remaining award pool at the time of their qualifying referrals.
+     *
+     * @invariant Guaranteed to be a valid PriceUsdc with amount between 0 and {@link ReferralProgramRulesRevShareCap.awardPool.amount} (inclusive)
+     * @invariant Always <= uncappedAward.amount
+     * @invariant Amount equal to 0 when {@link adminAction} has `actionType` of {@link AdminActionTypes.Disqualification}.
+     * @invariant Amount equal to 0 when {@link isQualified} is false.
+     */
+    cappedAward: PriceUsdc;
+}
+declare const validateAwardedReferrerMetricsRevShareCap: (metrics: AwardedReferrerMetricsRevShareCap, rules: ReferralProgramRulesRevShareCap) => void;
+declare const buildAwardedReferrerMetricsRevShareCap: (referrer: RankedReferrerMetricsRevShareCap, uncappedAward: PriceUsdc, cappedAward: PriceUsdc, rules: ReferralProgramRulesRevShareCap) => AwardedReferrerMetricsRevShareCap;
+/**
+ * Extends {@link AwardedReferrerMetricsRevShareCap} but with rank set to null to represent
+ * a referrer who is not on the leaderboard (has zero referrals within the rules associated with the leaderboard).
+ */
+interface UnrankedReferrerMetricsRevShareCap extends Omit<AwardedReferrerMetricsRevShareCap, "rank" | "isQualified"> {
+    /**
+     * The referrer is not on the leaderboard and therefore has no rank.
+     */
+    rank: null;
+    /**
+     * Always false for unranked referrers.
+     */
+    isQualified: false;
+}
+declare const validateUnrankedReferrerMetricsRevShareCap: (metrics: UnrankedReferrerMetricsRevShareCap, rules: ReferralProgramRulesRevShareCap) => void;
+/**
+ * Build an unranked zero-metrics rev-share-cap referrer record for an address not on the leaderboard.
+ */
+declare const buildUnrankedReferrerMetricsRevShareCap: (referrer: NormalizedAddress, rules: ReferralProgramRulesRevShareCap) => UnrankedReferrerMetricsRevShareCap;
+
+/**
+ * Represents aggregated metrics for a list of referrers on a rev-share-cap leaderboard.
+ */
+interface AggregatedReferrerMetricsRevShareCap {
+    /**
+     * @invariant The sum of `totalReferrals` across all referrers in the list.
+     * @invariant Guaranteed to be a non-negative integer (>= 0)
+     */
+    grandTotalReferrals: number;
+    /**
+     * @invariant The sum of `totalIncrementalDuration` across all referrers in the list.
+     */
+    grandTotalIncrementalDuration: Duration;
+    /**
+     * The total revenue contribution in ETH to the ENS DAO from all referrals
+     * across all referrers on the leaderboard.
+     *
+     * This is the sum of `totalRevenueContribution` across all referrers in the list.
+     *
+     * @invariant Guaranteed to be a valid PriceEth with non-negative amount (>= 0n)
+     */
+    grandTotalRevenueContribution: PriceEth;
     /**
-     * The {@link UnixTimestamp} of when the data used to build the {@link ReferrerLeaderboard} was accurate as of.
+     * The remaining amount in the award pool after subtracting all capped awards
+     * claimed during the sequential race processing.
+     *
+     * @invariant Guaranteed to be a valid PriceUsdc with non-negative amount (>= 0n)
+     */
+    awardPoolRemaining: PriceUsdc;
+}
+declare const validateAggregatedReferrerMetricsRevShareCap: (metrics: AggregatedReferrerMetricsRevShareCap) => void;
+/**
+ * Builds aggregated rev-share-cap metrics from a complete list of referrers and
+ * the award pool remaining after sequential race processing.
+ *
+ * **IMPORTANT: This function expects a complete list of all referrers.**
+ *
+ * @param referrers - Must be a complete list of referrers with their totals.
+ *                    **This must NOT be a paginated or partial slice.**
+ *
+ * @param awardPoolRemaining - The amount remaining in the award pool after the sequential
+ *                             race algorithm has processed all events.
+ *
+ * @returns Aggregated metrics including totals across all referrers and the award pool remaining.
+ */
+declare const buildAggregatedReferrerMetricsRevShareCap: (referrers: AwardedReferrerMetricsRevShareCap[], awardPoolRemaining: PriceUsdc) => AggregatedReferrerMetricsRevShareCap;
+
+/**
+ * Represents a single raw referral event.
+ *
+ * Used as input to the sequential race algorithm for the rev-share-cap award model.
+ * Events are processed in chronological order to determine award claims from the pool.
+ */
+interface ReferralEvent {
+    /**
+     * The Ethereum address of the referrer, as a {@link NormalizedAddress}.
+     */
+    referrer: NormalizedAddress;
+    /**
+     * Unix seconds block timestamp.
+     */
+    timestamp: UnixTimestamp;
+    /**
+     * Registrar action ID.
+     *
+     * @invariant Deterministic and globally unique identifier for the "logical registrar action"
+     *   associated with this ReferralEvent.
+     * @invariant Sorting by this value achieves a chronological ordering of each registrar action
+     *   by the order they were executed onchain.
+     */
+    id: string;
+    /**
+     * Duration in seconds contributed by this single referral event.
+     */
+    incrementalDuration: Duration;
+    /**
+     * Revenue contribution in ETH from this single referral event.
+     */
+    incrementalRevenueContribution: PriceEth;
+}
+
+/**
+ * Represents a leaderboard with the rev-share-cap award model for any number of referrers.
+ */
+interface ReferrerLeaderboardRevShareCap {
+    /**
+     * Discriminant identifying this as a rev-share-cap leaderboard.
+     *
+     * @invariant Always equals `rules.awardModel` ({@link ReferralProgramAwardModels.RevShareCap}).
+     */
+    awardModel: typeof ReferralProgramAwardModels.RevShareCap;
+    /**
+     * The rules of the referral program that generated the {@link ReferrerLeaderboardRevShareCap}.
+     */
+    rules: ReferralProgramRulesRevShareCap;
+    /**
+     * The {@link AggregatedReferrerMetricsRevShareCap} for all {@link AwardedReferrerMetricsRevShareCap} values in `referrers`.
+     */
+    aggregatedMetrics: AggregatedReferrerMetricsRevShareCap;
+    /**
+     * Ordered map containing {@link AwardedReferrerMetricsRevShareCap} for all referrers with 1 or more
+     * `totalReferrals` within the `rules` as of `accurateAsOf`.
+     *
+     * @invariant Map entries are ordered by `rank` (ascending).
+     * @invariant Map is empty if there are no referrers with 1 or more `totalReferrals`
+     *            within the `rules` as of `accurateAsOf`.
+     * @invariant If a `NormalizedAddress` is not a key in this map then that `NormalizedAddress` had
+     *            0 `totalReferrals`, `totalIncrementalDuration`, and `totalRevenueContribution` within the
+     *            `rules` as of `accurateAsOf`.
+     * @invariant Each value in this map is guaranteed to have a non-zero
+     *            `totalReferrals` and `totalIncrementalDuration`.
+     */
+    referrers: Map<NormalizedAddress, AwardedReferrerMetricsRevShareCap>;
+    /**
+     * The {@link UnixTimestamp} of when the data used to build the {@link ReferrerLeaderboardRevShareCap} was accurate as of.
      */
     accurateAsOf: UnixTimestamp;
 }
-declare const buildReferrerLeaderboard: (allReferrers: ReferrerMetrics[], rules: ReferralProgramRules, accurateAsOf: UnixTimestamp) => ReferrerLeaderboard;
+/**
+ * Builds a {@link ReferrerLeaderboardRevShareCap} using a sequential "first-come, first-served"
+ * race algorithm over individual referral events.
+ *
+ * Events are processed in chronological order. When a referrer first crosses the qualification
+ * threshold, they claim ALL accumulated uncapped awards at once (capped by remaining award pool).
+ * After qualifying, each referrer's subsequent referrals claim that event's incremental capped award.
+ * Once the award pool is exhausted, no further awards are issued to anyone.
+ *
+ * @param events - Raw referral events from ENSDb (unsorted; will be sorted internally).
+ * @param rules - The {@link ReferralProgramRulesRevShareCap} defining the program parameters.
+ * @param accurateAsOf - Timestamp indicating data freshness.
+ */
+declare const buildReferrerLeaderboardRevShareCap: (events: ReferralEvent[], rules: ReferralProgramRulesRevShareCap, accurateAsOf: UnixTimestamp) => ReferrerLeaderboardRevShareCap;
+
+/**
+ * Represents a leaderboard for any number of referrers.
+ *
+ * Use `awardModel` to narrow the specific variant at runtime.
+ */
+type ReferrerLeaderboard = ReferrerLeaderboardPieSplit | ReferrerLeaderboardRevShareCap;
 
 /**
  * The default number of referrers per leaderboard page.
@@ -409,7 +1078,7 @@ interface ReferrerLeaderboardPageContext extends Required<ReferrerLeaderboardPag
     totalPages: number;
     /**
      * Indicates if there is a next page available
-     * @invariant true if and only if (`page` * `recordsPerPage` < `total`)
+     * @invariant true if and only if (`page` * `recordsPerPage` < `totalRecords`)
      */
     hasNext: boolean;
     /**
@@ -437,150 +1106,423 @@ interface ReferrerLeaderboardPageContext extends Required<ReferrerLeaderboardPag
      */
     endIndex?: number;
 }
-declare const validateReferrerLeaderboardPageContext: (context: ReferrerLeaderboardPageContext) => void;
-declare const buildReferrerLeaderboardPageContext: (optionalParams: ReferrerLeaderboardPageParams, leaderboard: ReferrerLeaderboard) => ReferrerLeaderboardPageContext;
+declare const validateReferrerLeaderboardPageContext: (context: ReferrerLeaderboardPageContext) => void;
+declare const buildReferrerLeaderboardPageContext: (optionalParams: ReferrerLeaderboardPageParams, leaderboard: ReferrerLeaderboard) => ReferrerLeaderboardPageContext;
+/**
+ * Base fields shared by all leaderboard page variants.
+ */
+interface BaseReferrerLeaderboardPage {
+    /**
+     * Discriminant identifying the award model for this leaderboard page.
+     */
+    awardModel: ReferralProgramAwardModel;
+    /**
+     * The {@link ReferrerLeaderboardPageContext} of this page relative to the overall leaderboard.
+     */
+    pageContext: ReferrerLeaderboardPageContext;
+    /**
+     * The status of the referral program edition.
+     */
+    status: ReferralProgramEditionStatusId;
+    /**
+     * The {@link UnixTimestamp} of when the data used to build this page was accurate as of.
+     */
+    accurateAsOf: UnixTimestamp;
+}
+/**
+ * A leaderboard page whose `awardModel` is not recognized by this client version.
+ *
+ * @remarks
+ * This is a **client-side forward-compatibility** type only. It is never serialized or processed
+ * by business logic on the backend. When the server introduces a new award model type, older
+ * clients preserve the page rather than throwing, and downstream code that encounters this type
+ * should handle it gracefully rather than crashing.
+ */
+interface ReferrerLeaderboardPageUnrecognized extends BaseReferrerLeaderboardPage {
+    /**
+     * Discriminant — always `"unrecognized"`.
+     */
+    awardModel: typeof ReferralProgramAwardModels.Unrecognized;
+    /**
+     * The original, unrecognized `awardModel` string received from the server.
+     *
+     * @remarks Preserved for logging and debugging. Never used for business logic.
+     */
+    originalAwardModel: string;
+}
+/**
+ * Extracts the referrers for the current page from a fully-ranked Map.
+ * Generic over the referrer type so each model variant retains its specific type.
+ */
+declare function sliceReferrers<T>(referrers: Map<NormalizedAddress, T>, pageContext: ReferrerLeaderboardPageContext): T[];
+
+/**
+ * A page of referrers from the pie-split referrer leaderboard.
+ */
+interface ReferrerLeaderboardPagePieSplit extends BaseReferrerLeaderboardPage {
+    /**
+     * Discriminant identifying this as a page from a pie-split leaderboard.
+     *
+     * @invariant Always equals `rules.awardModel` ({@link ReferralProgramAwardModels.PieSplit}).
+     */
+    awardModel: typeof ReferralProgramAwardModels.PieSplit;
+    /**
+     * The {@link ReferralProgramRulesPieSplit} used to generate the {@link ReferrerLeaderboardPieSplit}
+     * that this {@link ReferrerLeaderboardPagePieSplit} comes from.
+     */
+    rules: ReferralProgramRulesPieSplit;
+    /**
+     * Ordered list of {@link AwardedReferrerMetricsPieSplit} for the {@link ReferrerLeaderboardPagePieSplit}
+     * described by {@link pageContext} within the related {@link ReferrerLeaderboardPieSplit}.
+     *
+     * @invariant Array will be empty if `pageContext.totalRecords` is 0.
+     * @invariant Array entries are ordered by `rank` (ascending).
+     */
+    referrers: AwardedReferrerMetricsPieSplit[];
+    /**
+     * The aggregated metrics for all referrers on the leaderboard.
+     */
+    aggregatedMetrics: AggregatedReferrerMetricsPieSplit;
+}
+declare function buildLeaderboardPagePieSplit(pageContext: ReferrerLeaderboardPageContext, leaderboard: ReferrerLeaderboardPieSplit): ReferrerLeaderboardPagePieSplit;
+
+/**
+ * Serialized representation of {@link ReferralProgramRulesPieSplit}.
+ */
+interface SerializedReferralProgramRulesPieSplit extends Omit<ReferralProgramRulesPieSplit, "awardPool" | "rulesUrl"> {
+    awardPool: SerializedPriceUsdc;
+    rulesUrl: string;
+}
+/**
+ * Serialized representation of {@link AggregatedReferrerMetricsPieSplit}.
+ */
+interface SerializedAggregatedReferrerMetricsPieSplit extends Omit<AggregatedReferrerMetricsPieSplit, "grandTotalRevenueContribution"> {
+    grandTotalRevenueContribution: SerializedPriceEth;
+}
+/**
+ * Serialized representation of {@link AwardedReferrerMetricsPieSplit}.
+ */
+interface SerializedAwardedReferrerMetricsPieSplit extends Omit<AwardedReferrerMetricsPieSplit, "totalRevenueContribution" | "awardPoolApproxValue"> {
+    totalRevenueContribution: SerializedPriceEth;
+    awardPoolApproxValue: SerializedPriceUsdc;
+}
+/**
+ * Serialized representation of {@link UnrankedReferrerMetricsPieSplit}.
+ */
+interface SerializedUnrankedReferrerMetricsPieSplit extends Omit<UnrankedReferrerMetricsPieSplit, "totalRevenueContribution" | "awardPoolApproxValue"> {
+    totalRevenueContribution: SerializedPriceEth;
+    awardPoolApproxValue: SerializedPriceUsdc;
+}
+/**
+ * Serialized representation of {@link ReferrerLeaderboardPagePieSplit}.
+ */
+interface SerializedReferrerLeaderboardPagePieSplit extends Omit<ReferrerLeaderboardPagePieSplit, "rules" | "referrers" | "aggregatedMetrics"> {
+    rules: SerializedReferralProgramRulesPieSplit;
+    referrers: SerializedAwardedReferrerMetricsPieSplit[];
+    aggregatedMetrics: SerializedAggregatedReferrerMetricsPieSplit;
+}
+/**
+ * Serialized representation of {@link ReferrerEditionMetricsRankedPieSplit}.
+ */
+interface SerializedReferrerEditionMetricsRankedPieSplit extends Omit<ReferrerEditionMetricsRankedPieSplit, "rules" | "referrer" | "aggregatedMetrics"> {
+    rules: SerializedReferralProgramRulesPieSplit;
+    referrer: SerializedAwardedReferrerMetricsPieSplit;
+    aggregatedMetrics: SerializedAggregatedReferrerMetricsPieSplit;
+}
+/**
+ * Serialized representation of {@link ReferrerEditionMetricsUnrankedPieSplit}.
+ */
+interface SerializedReferrerEditionMetricsUnrankedPieSplit extends Omit<ReferrerEditionMetricsUnrankedPieSplit, "rules" | "referrer" | "aggregatedMetrics"> {
+    rules: SerializedReferralProgramRulesPieSplit;
+    referrer: SerializedUnrankedReferrerMetricsPieSplit;
+    aggregatedMetrics: SerializedAggregatedReferrerMetricsPieSplit;
+}
+/**
+ * Serialized representation of {@link ReferrerEditionMetricsPieSplit}.
+ */
+type SerializedReferrerEditionMetricsPieSplit = SerializedReferrerEditionMetricsRankedPieSplit | SerializedReferrerEditionMetricsUnrankedPieSplit;
+/**
+ * Serialized representation of {@link ReferralProgramEditionSummaryPieSplit}.
+ */
+interface SerializedReferralProgramEditionSummaryPieSplit extends Omit<ReferralProgramEditionSummaryPieSplit, "rules"> {
+    rules: SerializedReferralProgramRulesPieSplit;
+}
+
 /**
- * A page of referrers from the referrer leaderboard.
+ * Referrer edition metrics data for a specific referrer on a rev-share-cap leaderboard.
+ *
+ * Includes the referrer's awarded metrics from the leaderboard plus timestamp.
+ *
+ * @see {@link AwardedReferrerMetricsRevShareCap}
  */
-interface ReferrerLeaderboardPage {
+interface ReferrerEditionMetricsRankedRevShareCap {
     /**
-     * The {@link ReferralProgramRules} used to generate the {@link ReferrerLeaderboard}
-     * that this {@link ReferrerLeaderboardPage} comes from.
+     * Discriminant identifying this as data from a rev-share-cap leaderboard edition.
+     *
+     * @invariant Always equals `rules.awardModel` ({@link ReferralProgramAwardModels.RevShareCap}).
      */
-    rules: ReferralProgramRules;
+    awardModel: typeof ReferralProgramAwardModels.RevShareCap;
     /**
-     * Ordered list of {@link AwardedReferrerMetrics} for the {@link ReferrerLeaderboardPage}
-     * described by `pageContext` within the related {@link ReferrerLeaderboard}.
-     *
-     * @invariant Array will be empty if `pageContext.totalRecords` is 0.
-     * @invariant Array entries are ordered by `rank` (ascending).
+     * The type of referrer edition metrics data.
      */
-    referrers: AwardedReferrerMetrics[];
+    type: typeof ReferrerEditionMetricsTypeIds.Ranked;
     /**
-     * Aggregated metrics for all referrers on the leaderboard.
+     * The {@link ReferralProgramRulesRevShareCap} used to calculate the {@link AwardedReferrerMetricsRevShareCap}.
      */
-    aggregatedMetrics: AggregatedReferrerMetrics;
+    rules: ReferralProgramRulesRevShareCap;
     /**
-     * The {@link ReferrerLeaderboardPageContext} of this {@link ReferrerLeaderboardPage} relative to the overall
-     * {@link ReferrerLeaderboard}.
+     * The awarded referrer metrics from the leaderboard.
+     *
+     * Contains all calculated metrics including rank, qualification status,
+     * uncapped award, and capped award.
      */
-    pageContext: ReferrerLeaderboardPageContext;
+    referrer: AwardedReferrerMetricsRevShareCap;
     /**
-     * The {@link UnixTimestamp} of when the data used to build the {@link ReferrerLeaderboardPage} was accurate as of.
+     * Aggregated metrics for all referrers on the leaderboard.
      */
-    accurateAsOf: UnixTimestamp;
-}
-declare const getReferrerLeaderboardPage: (pageParams: ReferrerLeaderboardPageParams, leaderboard: ReferrerLeaderboard) => ReferrerLeaderboardPage;
-
-/**
- * The type of referrer detail data.
- */
-declare const ReferrerDetailTypeIds: {
+    aggregatedMetrics: AggregatedReferrerMetricsRevShareCap;
     /**
-     * Represents a referrer who is ranked on the leaderboard.
+     * The status of the referral program edition
+     * calculated based on the program's timing relative to {@link accurateAsOf}.
      */
-    readonly Ranked: "ranked";
+    status: ReferralProgramEditionStatusId;
     /**
-     * Represents a referrer who is not ranked on the leaderboard.
+     * The {@link UnixTimestamp} of when the data used to build the {@link ReferrerEditionMetricsRankedRevShareCap} was accurate as of.
      */
-    readonly Unranked: "unranked";
-};
-/**
- * The derived string union of possible {@link ReferrerDetailTypeIds}.
- */
-type ReferrerDetailTypeId = (typeof ReferrerDetailTypeIds)[keyof typeof ReferrerDetailTypeIds];
+    accurateAsOf: UnixTimestamp;
+}
 /**
- * Referrer detail data for a specific referrer address on the leaderboard.
- *
- * Includes the referrer's awarded metrics from the leaderboard plus timestamp.
+ * Referrer edition metrics data for a specific referrer address NOT on the rev-share-cap leaderboard.
  *
- * Invariants:
- * - `type` is always {@link ReferrerDetailTypeIds.Ranked}.
+ * Includes the referrer's unranked metrics (with null rank and isQualified: false) plus timestamp.
  *
- * @see {@link AwardedReferrerMetrics}
+ * @see {@link UnrankedReferrerMetricsRevShareCap}
  */
-interface ReferrerDetailRanked {
+interface ReferrerEditionMetricsUnrankedRevShareCap {
     /**
-     * The type of referrer detail data.
+     * Discriminant identifying this as data from a rev-share-cap leaderboard edition.
+     *
+     * @invariant Always equals `rules.awardModel` ({@link ReferralProgramAwardModels.RevShareCap}).
      */
-    type: typeof ReferrerDetailTypeIds.Ranked;
+    awardModel: typeof ReferralProgramAwardModels.RevShareCap;
     /**
-     * The {@link ReferralProgramRules} used to calculate the {@link AwardedReferrerMetrics}.
+     * The type of referrer edition metrics data.
      */
-    rules: ReferralProgramRules;
+    type: typeof ReferrerEditionMetricsTypeIds.Unranked;
     /**
-     * The awarded referrer metrics from the leaderboard.
+     * The {@link ReferralProgramRulesRevShareCap} used to calculate the {@link UnrankedReferrerMetricsRevShareCap}.
+     */
+    rules: ReferralProgramRulesRevShareCap;
+    /**
+     * The unranked referrer metrics (not on the leaderboard).
      *
-     * Contains all calculated metrics including score, rank, qualification status,
-     * and award pool share information.
+     * Contains all calculated metrics with rank set to null and isQualified set to false.
      */
-    referrer: AwardedReferrerMetrics;
+    referrer: UnrankedReferrerMetricsRevShareCap;
     /**
      * Aggregated metrics for all referrers on the leaderboard.
      */
-    aggregatedMetrics: AggregatedReferrerMetrics;
+    aggregatedMetrics: AggregatedReferrerMetricsRevShareCap;
+    /**
+     * The status of the referral program edition
+     * calculated based on the program's timing relative to {@link accurateAsOf}.
+     */
+    status: ReferralProgramEditionStatusId;
     /**
-     * The {@link UnixTimestamp} of when the data used to build the {@link ReferrerDetailData} was accurate as of.
+     * The {@link UnixTimestamp} of when the data used to build the {@link ReferrerEditionMetricsUnrankedRevShareCap} was accurate as of.
      */
     accurateAsOf: UnixTimestamp;
 }
 /**
- * Referrer detail data for a specific referrer address NOT on the leaderboard.
+ * All referrer edition metrics variants for the rev-share-cap award model.
  *
- * Includes the referrer's unranked metrics (with null rank and isQualified: false) plus timestamp.
- *
- * Invariants:
- * - `type` is always {@link ReferrerDetailTypeIds.Unranked}.
+ * Use `type` to determine if the referrer is ranked or unranked.
+ */
+type ReferrerEditionMetricsRevShareCap = ReferrerEditionMetricsRankedRevShareCap | ReferrerEditionMetricsUnrankedRevShareCap;
+
+/**
+ * Edition summary for a `rev-share-cap` referral program edition.
  *
- * @see {@link UnrankedReferrerMetrics}
+ * Includes `awardPoolRemaining` so consumers can display pool exhaustion state
+ * without needing to fetch the full leaderboard.
  */
-interface ReferrerDetailUnranked {
+interface ReferralProgramEditionSummaryRevShareCap extends BaseReferralProgramEditionSummary {
     /**
-     * The type of referrer detail data.
+     * Discriminant — always `"rev-share-cap"`.
+     *
+     * @invariant Always equals `rules.awardModel` ({@link ReferralProgramAwardModels.RevShareCap}).
      */
-    type: typeof ReferrerDetailTypeIds.Unranked;
+    awardModel: typeof ReferralProgramAwardModels.RevShareCap;
     /**
-     * The {@link ReferralProgramRules} used to calculate the {@link UnrankedReferrerMetrics}.
+     * The rev-share-cap rules for this edition.
      */
-    rules: ReferralProgramRules;
+    rules: ReferralProgramRulesRevShareCap;
     /**
-     * The unranked referrer metrics (not on the leaderboard).
+     * The remaining award pool after sequential race processing.
      *
-     * Contains all calculated metrics with rank set to null and isQualified set to false.
+     * When `0n`, the edition's status will be {@link ReferralProgramEditionStatuses.Exhausted}
+     * if the edition is still within its active window.
+     */
+    awardPoolRemaining: PriceUsdc;
+}
+declare const validateEditionSummaryRevShareCap: (summary: ReferralProgramEditionSummaryRevShareCap) => void;
+/**
+ * Build a {@link ReferralProgramEditionSummaryRevShareCap} from a rev-share-cap edition
+ * config and the edition's leaderboard.
+ */
+declare function buildEditionSummaryRevShareCap(slug: ReferralProgramEditionSlug, displayName: string, rules: ReferralProgramRulesRevShareCap, leaderboard: ReferrerLeaderboardRevShareCap): ReferralProgramEditionSummaryRevShareCap;
+
+/**
+ * A page of referrers from the rev-share-cap referrer leaderboard.
+ */
+interface ReferrerLeaderboardPageRevShareCap extends BaseReferrerLeaderboardPage {
+    /**
+     * Discriminant identifying this as a page from a rev-share-cap leaderboard.
+     *
+     * @invariant Always equals `rules.awardModel` ({@link ReferralProgramAwardModels.RevShareCap}).
      */
-    referrer: UnrankedReferrerMetrics;
+    awardModel: typeof ReferralProgramAwardModels.RevShareCap;
     /**
-     * Aggregated metrics for all referrers on the leaderboard.
+     * The {@link ReferralProgramRulesRevShareCap} used to generate the {@link ReferrerLeaderboardRevShareCap}
+     * that this {@link ReferrerLeaderboardPageRevShareCap} comes from.
      */
-    aggregatedMetrics: AggregatedReferrerMetrics;
+    rules: ReferralProgramRulesRevShareCap;
     /**
-     * The {@link UnixTimestamp} of when the data used to build the {@link UnrankedReferrerDetailData} was accurate as of.
+     * Ordered list of {@link AwardedReferrerMetricsRevShareCap} for the {@link ReferrerLeaderboardPageRevShareCap}
+     * described by {@link pageContext} within the related {@link ReferrerLeaderboard}.
+     *
+     * @invariant Array will be empty if `pageContext.totalRecords` is 0.
+     * @invariant Array entries are ordered by `rank` (ascending).
      */
-    accurateAsOf: UnixTimestamp;
+    referrers: AwardedReferrerMetricsRevShareCap[];
+    /**
+     * The aggregated metrics for all referrers on the leaderboard.
+     */
+    aggregatedMetrics: AggregatedReferrerMetricsRevShareCap;
+}
+declare function buildLeaderboardPageRevShareCap(pageContext: ReferrerLeaderboardPageContext, leaderboard: ReferrerLeaderboardRevShareCap): ReferrerLeaderboardPageRevShareCap;
+
+/**
+ * Serialized representation of {@link ReferralProgramRulesRevShareCap}.
+ */
+interface SerializedReferralProgramRulesRevShareCap extends Omit<ReferralProgramRulesRevShareCap, "awardPool" | "minBaseRevenueContribution" | "baseAnnualRevenueContribution" | "rulesUrl"> {
+    awardPool: SerializedPriceUsdc;
+    minBaseRevenueContribution: SerializedPriceUsdc;
+    baseAnnualRevenueContribution: SerializedPriceUsdc;
+    rulesUrl: string;
+}
+/**
+ * Serialized representation of {@link AggregatedReferrerMetricsRevShareCap}.
+ */
+interface SerializedAggregatedReferrerMetricsRevShareCap extends Omit<AggregatedReferrerMetricsRevShareCap, "grandTotalRevenueContribution" | "awardPoolRemaining"> {
+    grandTotalRevenueContribution: SerializedPriceEth;
+    awardPoolRemaining: SerializedPriceUsdc;
+}
+/**
+ * Serialized representation of {@link AwardedReferrerMetricsRevShareCap}.
+ */
+interface SerializedAwardedReferrerMetricsRevShareCap extends Omit<AwardedReferrerMetricsRevShareCap, "totalRevenueContribution" | "totalBaseRevenueContribution" | "uncappedAward" | "cappedAward"> {
+    totalRevenueContribution: SerializedPriceEth;
+    totalBaseRevenueContribution: SerializedPriceUsdc;
+    uncappedAward: SerializedPriceUsdc;
+    cappedAward: SerializedPriceUsdc;
+}
+/**
+ * Serialized representation of {@link UnrankedReferrerMetricsRevShareCap}.
+ */
+interface SerializedUnrankedReferrerMetricsRevShareCap extends Omit<UnrankedReferrerMetricsRevShareCap, "totalRevenueContribution" | "totalBaseRevenueContribution" | "uncappedAward" | "cappedAward"> {
+    totalRevenueContribution: SerializedPriceEth;
+    totalBaseRevenueContribution: SerializedPriceUsdc;
+    uncappedAward: SerializedPriceUsdc;
+    cappedAward: SerializedPriceUsdc;
+}
+/**
+ * Serialized representation of {@link ReferrerLeaderboardPageRevShareCap}.
+ */
+interface SerializedReferrerLeaderboardPageRevShareCap extends Omit<ReferrerLeaderboardPageRevShareCap, "rules" | "referrers" | "aggregatedMetrics"> {
+    rules: SerializedReferralProgramRulesRevShareCap;
+    referrers: SerializedAwardedReferrerMetricsRevShareCap[];
+    aggregatedMetrics: SerializedAggregatedReferrerMetricsRevShareCap;
+}
+/**
+ * Serialized representation of {@link ReferrerEditionMetricsRankedRevShareCap}.
+ */
+interface SerializedReferrerEditionMetricsRankedRevShareCap extends Omit<ReferrerEditionMetricsRankedRevShareCap, "rules" | "referrer" | "aggregatedMetrics"> {
+    rules: SerializedReferralProgramRulesRevShareCap;
+    referrer: SerializedAwardedReferrerMetricsRevShareCap;
+    aggregatedMetrics: SerializedAggregatedReferrerMetricsRevShareCap;
+}
+/**
+ * Serialized representation of {@link ReferrerEditionMetricsUnrankedRevShareCap}.
+ */
+interface SerializedReferrerEditionMetricsUnrankedRevShareCap extends Omit<ReferrerEditionMetricsUnrankedRevShareCap, "rules" | "referrer" | "aggregatedMetrics"> {
+    rules: SerializedReferralProgramRulesRevShareCap;
+    referrer: SerializedUnrankedReferrerMetricsRevShareCap;
+    aggregatedMetrics: SerializedAggregatedReferrerMetricsRevShareCap;
 }
 /**
- * Referrer detail data for a specific referrer address.
+ * Serialized representation of {@link ReferrerEditionMetricsRevShareCap}.
+ */
+type SerializedReferrerEditionMetricsRevShareCap = SerializedReferrerEditionMetricsRankedRevShareCap | SerializedReferrerEditionMetricsUnrankedRevShareCap;
+/**
+ * Serialized representation of {@link ReferralProgramEditionSummaryRevShareCap}.
+ */
+interface SerializedReferralProgramEditionSummaryRevShareCap extends Omit<ReferralProgramEditionSummaryRevShareCap, "rules" | "awardPoolRemaining"> {
+    rules: SerializedReferralProgramRulesRevShareCap;
+    awardPoolRemaining: SerializedPriceUsdc;
+}
+
+/**
+ * Referrer edition metrics data for a specific referrer address.
  *
- * Use the `type` field to determine the specific type interpretation
- * at runtime.
+ * Use `awardModel` to narrow the award model variant, then `type` to narrow ranked vs unranked.
+ * When `awardModel` is `"unrecognized"`, the data was produced by a server running a newer
+ * version — use {@link ReferrerEditionMetricsUnrecognized} to access `originalAwardModel`.
  */
-type ReferrerDetail = ReferrerDetailRanked | ReferrerDetailUnranked;
+type ReferrerEditionMetrics = ReferrerEditionMetricsPieSplit | ReferrerEditionMetricsRevShareCap | ReferrerEditionMetricsUnrecognized;
 /**
- * Get the detail for a specific referrer from the leaderboard.
+ * Get the edition metrics for a specific referrer from the leaderboard.
  *
- * Returns a {@link ReferrerDetailRanked} if the referrer is on the leaderboard,
- * or a {@link ReferrerDetailUnranked} if the referrer has no referrals.
+ * Returns a {@link ReferrerEditionMetricsPieSplit} or {@link ReferrerEditionMetricsRevShareCap}
+ * with `type: "ranked"` if the referrer is on the leaderboard, or `type: "unranked"` otherwise.
  *
  * @param referrer - The referrer address to look up
  * @param leaderboard - The referrer leaderboard to query
- * @returns The appropriate {@link ReferrerDetail} (ranked or unranked)
  */
-declare const getReferrerDetail: (referrer: Address, leaderboard: ReferrerLeaderboard) => ReferrerDetail;
+declare const getReferrerEditionMetrics: (referrer: NormalizedAddress, leaderboard: ReferrerLeaderboard) => ReferrerEditionMetrics;
+
+/**
+ * Runtime summary of a referral program edition, enriched with current status and pool data.
+ *
+ * Use `awardModel` to discriminate between variants at runtime.
+ */
+type ReferralProgramEditionSummary = ReferralProgramEditionSummaryPieSplit | ReferralProgramEditionSummaryRevShareCap | ReferralProgramEditionSummaryUnrecognized;
+/**
+ * Build a runtime edition summary from an edition config and the edition's leaderboard.
+ * Dispatches to the appropriate per-model builder based on `leaderboard.awardModel`.
+ *
+ * @param config - The edition configuration (provides `slug` and `displayName`).
+ * @param leaderboard - The resolved leaderboard for this edition.
+ */
+declare function buildEditionSummary(config: ReferralProgramEditionConfig, leaderboard: ReferrerLeaderboard): ReferralProgramEditionSummary;
+
+/**
+ * A page of referrers from the referrer leaderboard.
+ *
+ * Use `awardModel` to narrow the specific variant at runtime. Within each variant,
+ * `rules`, `referrers`, and `aggregatedMetrics` are all guaranteed to be from the same model.
+ * When `awardModel` is `"unrecognized"`, the page was produced by a server running a newer
+ * version — use {@link ReferrerLeaderboardPageUnrecognized} to access `originalAwardModel`.
+ */
+type ReferrerLeaderboardPage = ReferrerLeaderboardPagePieSplit | ReferrerLeaderboardPageRevShareCap | ReferrerLeaderboardPageUnrecognized;
+declare const getReferrerLeaderboardPage: (pageParams: ReferrerLeaderboardPageParams, leaderboard: ReferrerLeaderboard) => ReferrerLeaderboardPage;
 
 /**
  * Request parameters for a referrer leaderboard page query.
  */
 interface ReferrerLeaderboardPageRequest extends ReferrerLeaderboardPageParams {
+    /** The referral program edition slug */
+    edition: ReferralProgramEditionSlug;
 }
 /**
  * A status code for a referrer leaderboard page API response.
@@ -622,18 +1564,24 @@ type ReferrerLeaderboardPageResponseError = {
  */
 type ReferrerLeaderboardPageResponse = ReferrerLeaderboardPageResponseOk | ReferrerLeaderboardPageResponseError;
 /**
- * Request parameters for referrer detail query.
+ * Maximum number of editions that can be requested in a single {@link ReferrerMetricsEditionsRequest}.
  */
-interface ReferrerDetailRequest {
+declare const MAX_EDITIONS_PER_REQUEST = 20;
+/**
+ * Request parameters for referrer metrics query.
+ */
+interface ReferrerMetricsEditionsRequest {
     /** The Ethereum address of the referrer to query */
     referrer: Address;
+    /** Array of edition slugs to query (min 1, max {@link MAX_EDITIONS_PER_REQUEST}, must be distinct) */
+    editions: ReferralProgramEditionSlug[];
 }
 /**
- * A status code for referrer detail API responses.
+ * A status code for referrer metrics API responses.
  */
-declare const ReferrerDetailResponseCodes: {
+declare const ReferrerMetricsEditionsResponseCodes: {
     /**
-     * Represents that the referrer detail data is available.
+     * Represents that the referrer metrics data for the requested editions is available.
      */
     readonly Ok: "ok";
     /**
@@ -642,87 +1590,99 @@ declare const ReferrerDetailResponseCodes: {
     readonly Error: "error";
 };
 /**
- * The derived string union of possible {@link ReferrerDetailResponseCodes}.
+ * The derived string union of possible {@link ReferrerMetricsEditionsResponseCodes}.
+ */
+type ReferrerMetricsEditionsResponseCode = (typeof ReferrerMetricsEditionsResponseCodes)[keyof typeof ReferrerMetricsEditionsResponseCodes];
+/**
+ * Referrer metrics data for requested editions.
+ *
+ * Maps each requested edition slug to the referrer's metrics for that edition.
+ * Uses Partial because TypeScript cannot know at compile time which specific edition
+ * slugs are requested. At runtime, when responseCode is Ok, all requested edition slugs
+ * are guaranteed to be present in this record.
  */
-type ReferrerDetailResponseCode = (typeof ReferrerDetailResponseCodes)[keyof typeof ReferrerDetailResponseCodes];
+type ReferrerMetricsEditionsData = Partial<Record<ReferralProgramEditionSlug, ReferrerEditionMetrics>>;
 /**
- * A referrer detail response when the data is available for a referrer on the leaderboard.
+ * A successful response containing referrer metrics for the requested editions.
  */
-type ReferrerDetailResponseOk = {
-    responseCode: typeof ReferrerDetailResponseCodes.Ok;
-    data: ReferrerDetail;
+type ReferrerMetricsEditionsResponseOk = {
+    responseCode: typeof ReferrerMetricsEditionsResponseCodes.Ok;
+    data: ReferrerMetricsEditionsData;
 };
 /**
- * A referrer detail response when an error occurs.
+ * A referrer metrics editions response when an error occurs.
  */
-type ReferrerDetailResponseError = {
-    responseCode: typeof ReferrerDetailResponseCodes.Error;
+type ReferrerMetricsEditionsResponseError = {
+    responseCode: typeof ReferrerMetricsEditionsResponseCodes.Error;
     error: string;
     errorMessage: string;
 };
 /**
- * A referrer detail API response.
+ * A referrer metrics editions API response.
  *
  * Use the `responseCode` field to determine the specific type interpretation
  * at runtime.
  */
-type ReferrerDetailResponse = ReferrerDetailResponseOk | ReferrerDetailResponseError;
-
+type ReferrerMetricsEditionsResponse = ReferrerMetricsEditionsResponseOk | ReferrerMetricsEditionsResponseError;
 /**
- * Serialized representation of {@link RevenueContribution}.
- *
- * RevenueContribution is a bigint, which is serialized as a string for JSON compatibility.
+ * A status code for referral program edition summaries API responses.
  */
-type SerializedRevenueContribution = string;
+declare const ReferralProgramEditionSummariesResponseCodes: {
+    /**
+     * Represents that the edition summaries are available.
+     */
+    readonly Ok: "ok";
+    /**
+     * Represents that the edition summaries are not available.
+     */
+    readonly Error: "error";
+};
 /**
- * Serialized representation of {@link ReferralProgramRules}.
- *
- * Note: All fields are already serializable primitives, so this type is identical to the source type.
+ * The derived string union of possible {@link ReferralProgramEditionSummariesResponseCodes}.
  */
-type SerializedReferralProgramRules = ReferralProgramRules;
+type ReferralProgramEditionSummariesResponseCode = (typeof ReferralProgramEditionSummariesResponseCodes)[keyof typeof ReferralProgramEditionSummariesResponseCodes];
 /**
- * Serialized representation of {@link AwardedReferrerMetrics}.
+ * The data payload containing edition summaries.
+ * Editions are sorted in descending order by start timestamp.
  */
-interface SerializedAwardedReferrerMetrics extends Omit<AwardedReferrerMetrics, "totalRevenueContribution"> {
-    totalRevenueContribution: SerializedRevenueContribution;
-}
+type ReferralProgramEditionSummariesData = {
+    editions: ReferralProgramEditionSummary[];
+};
 /**
- * Serialized representation of {@link UnrankedReferrerMetrics}.
+ * A successful response containing edition summaries.
  */
-interface SerializedUnrankedReferrerMetrics extends Omit<UnrankedReferrerMetrics, "totalRevenueContribution"> {
-    totalRevenueContribution: SerializedRevenueContribution;
-}
+type ReferralProgramEditionSummariesResponseOk = {
+    responseCode: typeof ReferralProgramEditionSummariesResponseCodes.Ok;
+    data: ReferralProgramEditionSummariesData;
+};
 /**
- * Serialized representation of {@link AggregatedReferrerMetrics}.
+ * An edition summaries response when an error occurs.
  */
-interface SerializedAggregatedReferrerMetrics extends Omit<AggregatedReferrerMetrics, "grandTotalRevenueContribution"> {
-    grandTotalRevenueContribution: SerializedRevenueContribution;
-}
+type ReferralProgramEditionSummariesResponseError = {
+    responseCode: typeof ReferralProgramEditionSummariesResponseCodes.Error;
+    error: string;
+    errorMessage: string;
+};
 /**
- * Serialized representation of {@link ReferrerLeaderboardPage}.
+ * A referral program edition summaries API response.
+ *
+ * Use the `responseCode` field to determine the specific type interpretation
+ * at runtime.
  */
-interface SerializedReferrerLeaderboardPage extends Omit<ReferrerLeaderboardPage, "referrers" | "aggregatedMetrics"> {
-    referrers: SerializedAwardedReferrerMetrics[];
-    aggregatedMetrics: SerializedAggregatedReferrerMetrics;
-}
+type ReferralProgramEditionSummariesResponse = ReferralProgramEditionSummariesResponseOk | ReferralProgramEditionSummariesResponseError;
+
 /**
- * Serialized representation of {@link ReferrerDetailRanked}.
+ * Serialized representation of {@link ReferralProgramRules}.
  */
-interface SerializedReferrerDetailRanked extends Omit<ReferrerDetailRanked, "referrer" | "aggregatedMetrics"> {
-    referrer: SerializedAwardedReferrerMetrics;
-    aggregatedMetrics: SerializedAggregatedReferrerMetrics;
-}
+type SerializedReferralProgramRules = SerializedReferralProgramRulesPieSplit | SerializedReferralProgramRulesRevShareCap;
 /**
- * Serialized representation of {@link ReferrerDetailUnranked}.
+ * Serialized representation of {@link ReferrerLeaderboardPage}.
  */
-interface SerializedReferrerDetailUnranked extends Omit<ReferrerDetailUnranked, "referrer" | "aggregatedMetrics"> {
-    referrer: SerializedUnrankedReferrerMetrics;
-    aggregatedMetrics: SerializedAggregatedReferrerMetrics;
-}
+type SerializedReferrerLeaderboardPage = SerializedReferrerLeaderboardPagePieSplit | SerializedReferrerLeaderboardPageRevShareCap;
 /**
- * Serialized representation of {@link ReferrerDetail} (union of ranked and unranked).
+ * Serialized representation of {@link ReferrerEditionMetrics}.
  */
-type SerializedReferrerDetail = SerializedReferrerDetailRanked | SerializedReferrerDetailUnranked;
+type SerializedReferrerEditionMetrics = SerializedReferrerEditionMetricsPieSplit | SerializedReferrerEditionMetricsRevShareCap;
 /**
  * Serialized representation of {@link ReferrerLeaderboardPageResponseError}.
  *
@@ -740,61 +1700,147 @@ interface SerializedReferrerLeaderboardPageResponseOk extends Omit<ReferrerLeade
  */
 type SerializedReferrerLeaderboardPageResponse = SerializedReferrerLeaderboardPageResponseOk | SerializedReferrerLeaderboardPageResponseError;
 /**
- * Serialized representation of {@link ReferrerDetailResponseError}.
+ * Serialized representation of {@link ReferralProgramEditionSummary}.
+ */
+type SerializedReferralProgramEditionSummary = SerializedReferralProgramEditionSummaryPieSplit | SerializedReferralProgramEditionSummaryRevShareCap;
+/**
+ * Serialized representation of referrer metrics data for requested editions.
+ * Uses Partial because TypeScript cannot know at compile time which specific edition
+ * slugs are requested. At runtime, when responseCode is Ok, all requested edition slugs
+ * are guaranteed to be present in this record.
+ */
+type SerializedReferrerMetricsEditionsData = Partial<Record<ReferralProgramEditionSlug, SerializedReferrerEditionMetrics>>;
+/**
+ * Serialized representation of {@link ReferrerMetricsEditionsResponseOk}.
+ */
+interface SerializedReferrerMetricsEditionsResponseOk extends Omit<ReferrerMetricsEditionsResponseOk, "data"> {
+    data: SerializedReferrerMetricsEditionsData;
+}
+/**
+ * Serialized representation of {@link ReferrerMetricsEditionsResponseError}.
  *
  * Note: All fields are already serializable, so this type is identical to the source type.
  */
-type SerializedReferrerDetailResponseError = ReferrerDetailResponseError;
+type SerializedReferrerMetricsEditionsResponseError = ReferrerMetricsEditionsResponseError;
+/**
+ * Serialized representation of {@link ReferrerMetricsEditionsResponse}.
+ */
+type SerializedReferrerMetricsEditionsResponse = SerializedReferrerMetricsEditionsResponseOk | SerializedReferrerMetricsEditionsResponseError;
+/**
+ * Serialized representation of {@link ReferralProgramEditionSummariesData}.
+ */
+interface SerializedReferralProgramEditionSummariesData extends Omit<ReferralProgramEditionSummariesData, "editions"> {
+    editions: SerializedReferralProgramEditionSummary[];
+}
 /**
- * Serialized representation of {@link ReferrerDetailResponseOk}.
+ * Serialized representation of {@link ReferralProgramEditionSummariesResponseOk}.
  */
-interface SerializedReferrerDetailResponseOk extends Omit<ReferrerDetailResponseOk, "data"> {
-    data: SerializedReferrerDetail;
+interface SerializedReferralProgramEditionSummariesResponseOk extends Omit<ReferralProgramEditionSummariesResponseOk, "data"> {
+    data: SerializedReferralProgramEditionSummariesData;
 }
 /**
- * Serialized representation of {@link ReferrerDetailResponse}.
+ * Serialized representation of {@link ReferralProgramEditionSummariesResponseError}.
+ *
+ * Note: All fields are already serializable, so this type is identical to the source type.
+ */
+type SerializedReferralProgramEditionSummariesResponseError = ReferralProgramEditionSummariesResponseError;
+/**
+ * Serialized representation of {@link ReferralProgramEditionSummariesResponse}.
  */
-type SerializedReferrerDetailResponse = SerializedReferrerDetailResponseOk | SerializedReferrerDetailResponseError;
+type SerializedReferralProgramEditionSummariesResponse = SerializedReferralProgramEditionSummariesResponseOk | SerializedReferralProgramEditionSummariesResponseError;
 
 /**
  * Deserialize a {@link ReferrerLeaderboardPageResponse} object.
- *
- * Note: This function explicitly deserializes each subobject to convert string
- * RevenueContribution values back to bigint, then validates using Zod schemas
- * to enforce invariants on the data.
  */
 declare function deserializeReferrerLeaderboardPageResponse(maybeResponse: SerializedReferrerLeaderboardPageResponse, valueLabel?: string): ReferrerLeaderboardPageResponse;
 /**
- * Deserialize a {@link ReferrerDetailResponse} object.
- *
- * Note: This function explicitly deserializes each subobject to convert string
- * RevenueContribution values back to bigint, then validates using Zod schemas
- * to enforce invariants on the data.
+ * Deserialize a {@link ReferrerMetricsEditionsResponse} object.
  */
-declare function deserializeReferrerDetailResponse(maybeResponse: SerializedReferrerDetailResponse, valueLabel?: string): ReferrerDetailResponse;
+declare function deserializeReferrerMetricsEditionsResponse(maybeResponse: SerializedReferrerMetricsEditionsResponse, valueLabel?: string): ReferrerMetricsEditionsResponse;
+/**
+ * Deserializes an array of {@link ReferralProgramEditionConfig} objects.
+ */
+declare function deserializeReferralProgramEditionConfigSetArray(maybeArray: unknown, valueLabel?: string): ReferralProgramEditionConfig[];
+/**
+ * Deserialize a {@link ReferralProgramEditionSummariesResponse} object.
+ */
+declare function deserializeReferralProgramEditionSummariesResponse(maybeResponse: SerializedReferralProgramEditionSummariesResponse, valueLabel?: string): ReferralProgramEditionSummariesResponse;
 
+/**
+ * Serializes a {@link ReferralProgramRules} object.
+ *
+ * @throws if called with a {@link ReferralProgramRulesUnrecognized} — unrecognized editions are
+ *   client-side forward-compatibility placeholders and must never be serialized.
+ */
+declare function serializeReferralProgramRules(rules: ReferralProgramRules): SerializedReferralProgramRules;
+/**
+ * Serializes a {@link ReferralProgramEditionSummary} object.
+ *
+ * @throws if called with a {@link ReferralProgramEditionSummaryUnrecognized} — unrecognized
+ *   summaries are client-side forward-compatibility placeholders and must never be serialized.
+ */
+declare function serializeReferralProgramEditionSummary(summary: ReferralProgramEditionSummary): SerializedReferralProgramEditionSummary;
 /**
  * Serialize a {@link ReferrerLeaderboardPageResponse} object.
  */
 declare function serializeReferrerLeaderboardPageResponse(response: ReferrerLeaderboardPageResponse): SerializedReferrerLeaderboardPageResponse;
 /**
- * Serialize a {@link ReferrerDetailResponse} object.
+ * Serialize a {@link ReferrerMetricsEditionsResponse} object.
+ */
+declare function serializeReferrerMetricsEditionsResponse(response: ReferrerMetricsEditionsResponse): SerializedReferrerMetricsEditionsResponse;
+/**
+ * Serialize a {@link ReferralProgramEditionSummariesResponse} object.
+ */
+declare function serializeReferralProgramEditionSummariesResponse(response: ReferralProgramEditionSummariesResponse): SerializedReferralProgramEditionSummariesResponse;
+
+/**
+ * Calculate the score of a referrer based on the total incremental duration
+ * (in seconds) of registrations and renewals for direct subnames of .eth
+ * referred by the referrer within the referral program edition.
+ *
+ * Used exclusively in the pie-split award model pipeline.
+ *
+ * @param totalIncrementalDuration - The total incremental duration (in seconds)
+ * of referrals made by a referrer within the {@link ReferralProgramRulesPieSplit}.
+ */
+declare const calcReferrerScorePieSplit: (totalIncrementalDuration: Duration) => ReferrerScore;
+
+/**
+ * Calculate the status of a `pie-split` referral program.
+ *
+ * Delegates entirely to {@link calcBaseReferralProgramEditionStatus} — pie-split has no additional
+ * runtime conditions that affect status beyond the time-based lifecycle.
+ *
+ * @param rules - The pie-split rules for the edition.
+ * @param now - Current date in {@link UnixTimestamp} format.
+ */
+declare const calcReferralProgramEditionStatusPieSplit: (rules: ReferralProgramRulesPieSplit, now: UnixTimestamp) => ReferralProgramEditionStatusId;
+
+/**
+ * Calculate the status of a `rev-share-cap` referral program.
+ *
+ * Returns `Exhausted` when the program is `Active` but its award pool has been fully consumed
+ * (`awardPoolRemaining.amount === 0n`). Otherwise delegates to {@link calcBaseReferralProgramEditionStatus}.
+ *
+ * @param rules - The rev-share-cap rules for the edition.
+ * @param now - Current date in {@link UnixTimestamp} format.
+ * @param aggregatedMetrics - The aggregated leaderboard metrics, used to check `awardPoolRemaining`.
  */
-declare function serializeReferrerDetailResponse(response: ReferrerDetailResponse): SerializedReferrerDetailResponse;
+declare const calcReferralProgramEditionStatusRevShareCap: (rules: ReferralProgramRulesRevShareCap, now: UnixTimestamp, aggregatedMetrics: AggregatedReferrerMetricsRevShareCap) => ReferralProgramEditionStatusId;
 
 /**
- * Default ENSNode API endpoint URL
+ * Default ENSNode endpoint URL
  */
 declare const DEFAULT_ENSNODE_API_URL: "https://api.alpha.ensnode.io";
 /**
- * Configuration options for ENS Referrals API client
+ * Configuration options for an ENS Referrals client
  */
 interface ClientOptions {
-    /** The ENSNode API URL */
+    /** The ENSNode URL */
     url: URL;
 }
 /**
- * ENS Referrals API Client
+ * ENS Referrals Client
  *
  * Provides access to ENS Referrals data and leaderboard information.
  *
@@ -803,8 +1849,9 @@ interface ClientOptions {
  * // Create client with default options
  * const client = new ENSReferralsClient();
  *
- * // Get referrer leaderboard
+ * // Get referrer leaderboard for December 2025 edition
  * const leaderboardPage = await client.getReferrerLeaderboardPage({
+ *   edition: "2025-12",
  *   page: 1,
  *   recordsPerPage: 25
  * });
@@ -823,51 +1870,83 @@ declare class ENSReferralsClient {
     static defaultOptions(): ClientOptions;
     constructor(options?: Partial<ClientOptions>);
     getOptions(): Readonly<ClientOptions>;
+    /**
+     * Get Referral Program Edition Config Set
+     *
+     * Fetches and deserializes a referral program edition config set from a remote URL.
+     *
+     * @param url - The URL to fetch the edition config set from
+     * @returns A ReferralProgramEditionConfigSet (Map of edition slugs to edition configurations)
+     *
+     * @remarks Editions whose `rules.awardModel` is not recognized by this client version are
+     * preserved as {@link ReferralProgramRulesUnrecognized}. The returned map includes all
+     * editions — recognized and unrecognized alike. Callers should check `editionConfig.rules.awardModel`
+     * and skip editions with `"unrecognized"` as appropriate. The returned map may be empty.
+     *
+     * @throws if the fetch fails
+     * @throws if the response is not valid JSON
+     * @throws if the data doesn't match the expected schema
+     *
+     * @example
+     * ```typescript
+     * const url = new URL("https://example.com/editions.json");
+     * const editionConfigSet = await ENSReferralsClient.getReferralProgramEditionConfigSet(url);
+     * console.log(`Loaded ${editionConfigSet.size} editions`);
+     * ```
+     */
+    static getReferralProgramEditionConfigSet(url: URL): Promise<ReferralProgramEditionConfigSet>;
     /**
      * Fetch Referrer Leaderboard Page
      *
-     * Retrieves a paginated list of referrer leaderboard metrics with contribution percentages.
-     * Each referrer's contribution is calculated as a percentage of the grand totals across all referrers.
+     * Retrieves a paginated list of referrer leaderboard metrics for a specific referral program edition.
      *
-     * @param request - Pagination parameters
+     * @param request - Request parameters including edition and pagination
+     * @param request.edition - The referral program edition slug (e.g., "2025-12", "2026-03", or any other configured edition slug)
      * @param request.page - The page number to retrieve (1-indexed, default: 1)
      * @param request.recordsPerPage - Number of records per page (default: 25, max: 100)
      * @returns {ReferrerLeaderboardPageResponse}
      *
+     * @remarks If the server returns a leaderboard page whose `awardModel` is not recognized by
+     * this client version, it is preserved as {@link ReferrerLeaderboardPageUnrecognized}. Callers
+     * should check `response.data.awardModel` and handle the `"unrecognized"` case accordingly.
+     *
      * @throws if the ENSNode request fails
      * @throws if the ENSNode API returns an error response
      * @throws if the ENSNode response breaks required invariants
      *
      * @example
      * ```typescript
-     * // Get first page with default page size (25 records)
-     * const response = await client.getReferrerLeaderboardPage();
+     * // Get first page of 2025-12 leaderboard with default page size (25 records)
+     * const editionSlug = "2025-12";
+     * const response = await client.getReferrerLeaderboardPage({ edition: editionSlug });
      * if (response.responseCode === ReferrerLeaderboardPageResponseCodes.Ok) {
-     *   const {
-     *     aggregatedMetrics,
-     *     referrers,
-     *     rules,
-     *     pageContext,
-     *     updatedAt
-     *   } = response.data;
-     *   console.log(aggregatedMetrics);
-     *   console.log(referrers);
-     *   console.log(rules);
-     *   console.log(updatedAt);
-     *   console.log(`Page ${pageContext.page} of ${pageContext.totalPages}`);
+     *   const { awardModel, pageContext, accurateAsOf } = response.data;
+     *   if (awardModel === ReferralProgramAwardModels.Unrecognized) {
+     *     console.log(`Unrecognized award model: ${response.data.originalAwardModel} — skipping`);
+     *   } else {
+     *     const { aggregatedMetrics, referrers, rules } = response.data;
+     *     console.log(`Edition: ${editionSlug}`);
+     *     console.log(`Subregistry: ${rules.subregistryId}`);
+     *     console.log(`Total Referrers: ${pageContext.totalRecords}`);
+     *     console.log(`Page ${pageContext.page} of ${pageContext.totalPages}`);
+     *   }
      * }
      * ```
      *
      * @example
      * ```typescript
-     * // Get second page with 50 records per page
-     * const response = await client.getReferrerLeaderboardPage({ page: 2, recordsPerPage: 50 });
+     * // Get second page of 2026-03 with 50 records per page
+     * const response = await client.getReferrerLeaderboardPage({
+     *   edition: "2026-03",
+     *   page: 2,
+     *   recordsPerPage: 50
+     * });
      * ```
      *
      * @example
      * ```typescript
-     * // Handle error response, ie. when Referrer Leaderboard is not currently available.
-     * const response = await client.getReferrerLeaderboardPage();
+     * // Handle error response (e.g., unknown edition or data not available)
+     * const response = await client.getReferrerLeaderboardPage({ edition: "2025-12" });
      *
      * if (response.responseCode === ReferrerLeaderboardPageResponseCodes.Error) {
      *   console.error(response.error);
@@ -875,84 +1954,136 @@ declare class ENSReferralsClient {
      * }
      * ```
      */
-    getReferrerLeaderboardPage(request?: ReferrerLeaderboardPageRequest): Promise<ReferrerLeaderboardPageResponse>;
+    getReferrerLeaderboardPage(request: ReferrerLeaderboardPageRequest): Promise<ReferrerLeaderboardPageResponse>;
     /**
-     * Fetch Referrer Detail
+     * Fetch Referrer Metrics for Specific Editions
      *
-     * Retrieves detailed information about a specific referrer, whether they are on the
-     * leaderboard or not.
+     * Retrieves detailed information about a specific referrer for the requested
+     * referral program editions. Returns a record mapping each requested edition slug
+     * to the referrer's metrics for that edition.
      *
-     * The response data is a discriminated union type with a `type` field:
+     * The response data maps edition slugs to referrer metrics. Each edition's entry is a
+     * {@link ReferrerEditionMetrics} discriminated union. Narrow on `awardModel` first to
+     * exclude unrecognized models, then on `type` to distinguish ranked from unranked:
      *
-     * **For referrers on the leaderboard** (`ReferrerDetailRanked`):
-     * - `type`: {@link ReferrerDetailTypeIds.Ranked}
-     * - `referrer`: The `AwardedReferrerMetrics` from @namehash/ens-referrals
-     * - `rules`: The referral program rules
-     * - `aggregatedMetrics`: Aggregated metrics for all referrers on the leaderboard
-     * - `accurateAsOf`: Unix timestamp indicating when the data was last updated
+     * - `awardModel: "unrecognized"` ({@link ReferrerEditionMetricsUnrecognized}): the server
+     *   returned an award model this client does not recognize. Only `originalAwardModel` is
+     *   available; no model-specific fields are present.
+     * - `type: "ranked"` ({@link ReferrerEditionMetricsTypeIds.Ranked}): the referrer appears on
+     *   the leaderboard. `referrer` contains rank, qualification status, and award share.
+     * - `type: "unranked"` ({@link ReferrerEditionMetricsTypeIds.Unranked}): the referrer has no
+     *   activity in this edition. `referrer` contains zero-value placeholders.
      *
-     * **For referrers NOT on the leaderboard** (`ReferrerDetailUnranked`):
-     * - `type`: {@link ReferrerDetailTypeIds.Unranked}
-     * - `referrer`: The `UnrankedReferrerMetrics` from @namehash/ens-referrals
-     * - `rules`: The referral program rules
-     * - `aggregatedMetrics`: Aggregated metrics for all referrers on the leaderboard
-     * - `accurateAsOf`: Unix timestamp indicating when the data was last updated
+     * **Note:** This endpoint does not allow partial success. When `responseCode === Ok`,
+     * all requested editions are guaranteed to be present in the response data. If any
+     * requested edition cannot be returned, the entire request fails with an error.
      *
      * @see {@link https://www.npmjs.com/package/@namehash/ens-referrals|@namehash/ens-referrals} for calculation details
      *
-     * @param request The referrer address to query
-     * @returns {ReferrerDetailResponse} Returns the referrer detail response
+     * @param request The referrer address and edition slugs to query
+     * @returns {ReferrerMetricsEditionsResponse} Returns the referrer metrics for requested editions
+     *
+     * @remarks If the server returns metrics for an edition whose `awardModel` is not recognized by
+     * this client version, that edition's entry in `response.data` is preserved as
+     * {@link ReferrerEditionMetricsUnrecognized}. Callers should check each edition's `awardModel`
+     * and handle the `"unrecognized"` case accordingly.
      *
      * @throws if the ENSNode request fails
      * @throws if the response data is malformed
      *
      * @example
      * ```typescript
-     * // Get referrer detail for a specific address
-     * const response = await client.getReferrerDetail({
-     *   referrer: "0x1234567890123456789012345678901234567890"
+     * // Get referrer metrics for specific editions
+     * const response = await client.getReferrerMetricsEditions({
+     *   referrer: "0x1234567890123456789012345678901234567890",
+     *   editions: ["2025-12", "2026-01"]
      * });
-     * if (response.responseCode === ReferrerDetailResponseCodes.Ok) {
-     *   const { type, referrer, rules, aggregatedMetrics, accurateAsOf } = response.data;
-     *   console.log(type); // ReferrerDetailTypeIds.Ranked or ReferrerDetailTypeIds.Unranked
-     *   console.log(referrer);
-     *   console.log(accurateAsOf);
+     * if (response.responseCode === ReferrerMetricsEditionsResponseCodes.Ok) {
+     *   // All requested editions are present in response.data
+     *   for (const [editionSlug, detail] of Object.entries(response.data)) {
+     *     console.log(`Edition: ${editionSlug}`);
+     *     if (detail.awardModel === ReferralProgramAwardModels.Unrecognized) {
+     *       console.log(`Unrecognized award model: ${detail.originalAwardModel} — skipping`);
+     *       continue;
+     *     }
+     *     console.log(`Type: ${detail.type}`);
+     *     if (detail.type === ReferrerEditionMetricsTypeIds.Ranked) {
+     *       console.log(`Rank: ${detail.referrer.rank}`);
+     *       console.log(`Award Share: ${detail.referrer.awardPoolShare * 100}%`);
+     *     }
+     *   }
      * }
      * ```
      *
      * @example
      * ```typescript
-     * // Use discriminated union to check if referrer is ranked
-     * const response = await client.getReferrerDetail({
-     *   referrer: "0x1234567890123456789012345678901234567890"
+     * // Access specific edition data directly (edition is guaranteed to exist when OK)
+     * const response = await client.getReferrerMetricsEditions({
+     *   referrer: "0x1234567890123456789012345678901234567890",
+     *   editions: ["2025-12"]
      * });
-     * if (response.responseCode === ReferrerDetailResponseCodes.Ok) {
-     *   if (response.data.type === ReferrerDetailTypeIds.Ranked) {
-     *     // TypeScript knows this is ReferrerDetailRanked
-     *     console.log(`Rank: ${response.data.referrer.rank}`);
-     *     console.log(`Qualified: ${response.data.referrer.isQualified}`);
-     *     console.log(`Award Pool Share: ${response.data.referrer.awardPoolShare * 100}%`);
-     *   } else {
-     *     // TypeScript knows this is ReferrerDetailUnranked
-     *     console.log("Referrer is not on the leaderboard (no referrals yet)");
+     * if (response.responseCode === ReferrerMetricsEditionsResponseCodes.Ok) {
+     *   const detail = response.data["2025-12"];
+     *   if (detail && detail.awardModel === ReferralProgramAwardModels.Unrecognized) {
+     *     console.log(`Unrecognized award model: ${detail.originalAwardModel} — skipping`);
+     *   } else if (detail && detail.type === ReferrerEditionMetricsTypeIds.Ranked) {
+     *     console.log(`Edition 2025-12 Rank: ${detail.referrer.rank}`);
+     *   } else if (detail) {
+     *     console.log("Referrer is not on the leaderboard for 2025-12");
      *   }
      * }
      * ```
      *
      * @example
      * ```typescript
-     * // Handle error response, ie. when Referrer Detail is not currently available.
-     * const response = await client.getReferrerDetail({
-     *   referrer: "0x1234567890123456789012345678901234567890"
+     * // Handle error response (e.g., unknown edition or data not available)
+     * const response = await client.getReferrerMetricsEditions({
+     *   referrer: "0x1234567890123456789012345678901234567890",
+     *   editions: ["2025-12", "invalid-edition"]
      * });
      *
-     * if (response.responseCode === ReferrerDetailResponseCodes.Error) {
+     * if (response.responseCode === ReferrerMetricsEditionsResponseCodes.Error) {
+     *   console.error(response.error);
+     *   console.error(response.errorMessage);
+     * }
+     * ```
+     */
+    getReferrerMetricsEditions(request: ReferrerMetricsEditionsRequest): Promise<ReferrerMetricsEditionsResponse>;
+    /**
+     * Get the currently configured referral program edition summaries.
+     * Editions are sorted in descending order by start timestamp (most recent first).
+     *
+     * @returns A response containing edition summaries, or an error response if unavailable.
+     *
+     * @remarks Editions whose `rules.awardModel` is not recognized by this client version are
+     * preserved as {@link ReferralProgramEditionSummaryUnrecognized}. The returned response includes all
+     * editions — recognized and unrecognized alike. Callers should check `edition.awardModel`
+     * and skip editions with `"unrecognized"` as appropriate. The returned editions list may be empty.
+     *
+     * @example
+     * ```typescript
+     * const response = await client.getEditionSummaries();
+     *
+     * if (response.responseCode === ReferralProgramEditionSummariesResponseCodes.Ok) {
+     *   console.log(`Found ${response.data.editions.length} editions`);
+     *   for (const edition of response.data.editions) {
+     *     console.log(`${edition.slug}: ${edition.displayName}`);
+     *   }
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // Handle error response
+     * const response = await client.getEditionSummaries();
+     *
+     * if (response.responseCode === ReferralProgramEditionSummariesResponseCodes.Error) {
      *   console.error(response.error);
      *   console.error(response.errorMessage);
      * }
      * ```
      */
-    getReferrerDetail(request: ReferrerDetailRequest): Promise<ReferrerDetailResponse>;
+    getEditionSummaries(): Promise<ReferralProgramEditionSummariesResponse>;
 }
 
 /**
@@ -967,38 +2098,6 @@ declare const isPositiveInteger: (value: number) => boolean;
 declare const validateNonNegativeInteger: (value: number) => void;
 declare const isFiniteNonNegativeNumber: (value: number) => boolean;
 
-/**
- * The type of referral program's status.
- */
-declare const ReferralProgramStatuses: {
-    /**
-     * Represents a referral program that has been announced, but hasn't started yet.
-     */
-    readonly Scheduled: "Scheduled";
-    /**
-     * Represents a currently ongoing referral program.
-     */
-    readonly Active: "Active";
-    /**
-     * Represents a referral program that has already ended.
-     */
-    readonly Closed: "Closed";
-};
-/**
- * The derived string union of possible {@link ReferralProgramStatuses}.
- */
-type ReferralProgramStatusId = (typeof ReferralProgramStatuses)[keyof typeof ReferralProgramStatuses];
-/**
- * Calculate the status of the referral program based on the current date
- * and program's timeframe available in its rules.
- *
- * @param referralProgramRules - Related referral program's rules containing
- * program's start date and end date.
- *
- * @param now - Current date in {@link UnixTimestamp} format.
- */
-declare const calcReferralProgramStatus: (referralProgramRules: ReferralProgramRules, now: UnixTimestamp) => ReferralProgramStatusId;
-
 declare const validateUnixTimestamp: (timestamp: UnixTimestamp) => void;
 /**
  * The number of seconds in a year.
@@ -1010,4 +2109,4 @@ declare const SECONDS_PER_YEAR: Duration;
 declare function isValidDuration(duration: Duration): boolean;
 declare function validateDuration(duration: Duration): void;
 
-export { type AggregatedReferrerMetrics, type AwardedReferrerMetrics, type ClientOptions, DEFAULT_ENSNODE_API_URL, ENSReferralsClient, ENS_HOLIDAY_AWARDS_END_DATE, ENS_HOLIDAY_AWARDS_MAX_QUALIFIED_REFERRERS, ENS_HOLIDAY_AWARDS_START_DATE, ENS_HOLIDAY_AWARDS_TOTAL_AWARD_POOL_VALUE, REFERRERS_PER_LEADERBOARD_PAGE_DEFAULT, REFERRERS_PER_LEADERBOARD_PAGE_MAX, type RankedReferrerMetrics, type ReferralProgramRules, type ReferralProgramStatusId, ReferralProgramStatuses, type ReferrerDetail, type ReferrerDetailRanked, type ReferrerDetailRequest, type ReferrerDetailResponse, type ReferrerDetailResponseCode, ReferrerDetailResponseCodes, type ReferrerDetailResponseError, type ReferrerDetailResponseOk, type ReferrerDetailTypeId, ReferrerDetailTypeIds, type ReferrerDetailUnranked, type ReferrerLeaderboard, type ReferrerLeaderboardPage, type ReferrerLeaderboardPageContext, type ReferrerLeaderboardPageParams, type ReferrerLeaderboardPageRequest, type ReferrerLeaderboardPageResponse, type ReferrerLeaderboardPageResponseCode, ReferrerLeaderboardPageResponseCodes, type ReferrerLeaderboardPageResponseError, type ReferrerLeaderboardPageResponseOk, type ReferrerMetrics, type ReferrerMetricsForComparison, type ReferrerRank, type ReferrerScore, type RevenueContribution, SECONDS_PER_YEAR, type ScoredReferrerMetrics, type SerializedAggregatedReferrerMetrics, type SerializedAwardedReferrerMetrics, type SerializedReferralProgramRules, type SerializedReferrerDetail, type SerializedReferrerDetailRanked, type SerializedReferrerDetailResponse, type SerializedReferrerDetailResponseError, type SerializedReferrerDetailResponseOk, type SerializedReferrerDetailUnranked, type SerializedReferrerLeaderboardPage, type SerializedReferrerLeaderboardPageResponse, type SerializedReferrerLeaderboardPageResponseError, type SerializedReferrerLeaderboardPageResponseOk, type SerializedRevenueContribution, type SerializedUnrankedReferrerMetrics, type USDQuantity, type UnrankedReferrerMetrics, buildAggregatedReferrerMetrics, buildAwardedReferrerMetrics, buildEnsReferralUrl, buildRankedReferrerMetrics, buildReferralProgramRules, buildReferrerLeaderboard, buildReferrerLeaderboardPageContext, buildReferrerLeaderboardPageParams, buildReferrerMetrics, buildScoredReferrerMetrics, buildUnrankedReferrerMetrics, calcReferralProgramStatus, calcReferrerAwardPoolShare, calcReferrerFinalScore, calcReferrerFinalScoreBoost, calcReferrerFinalScoreMultiplier, calcReferrerScore, compareReferrerMetrics, deserializeReferrerDetailResponse, deserializeReferrerLeaderboardPageResponse, getReferrerDetail, getReferrerLeaderboardPage, isFiniteNonNegativeNumber, isInteger, isNonNegativeInteger, isPositiveInteger, isReferrerQualified, isValidDuration, isValidReferrerScore, isValidRevenueContribution, isValidUSDQuantity, normalizeAddress, serializeReferrerDetailResponse, serializeReferrerLeaderboardPageResponse, sortReferrerMetrics, validateAggregatedReferrerMetrics, validateAwardedReferrerMetrics, validateDuration, validateLowercaseAddress, validateNonNegativeInteger, validateRankedReferrerMetrics, validateReferralProgramRules, validateReferrerLeaderboardPageContext, validateReferrerMetrics, validateReferrerRank, validateReferrerScore, validateRevenueContribution, validateScoredReferrerMetrics, validateUSDQuantity, validateUnixTimestamp, validateUnrankedReferrerMetrics };
+export { type AdminAction, type AdminActionDisqualification, type AdminActionType, AdminActionTypes, type AdminActionWarning, type AggregatedReferrerMetricsPieSplit, type AggregatedReferrerMetricsRevShareCap, type AwardedReferrerMetricsPieSplit, type AwardedReferrerMetricsRevShareCap, type BaseReferralProgramEditionSummary, type BaseReferralProgramRules, type BaseReferrerLeaderboardPage, type ClientOptions, DEFAULT_ENSNODE_API_URL, ENSReferralsClient, MAX_EDITIONS_PER_REQUEST, REFERRAL_PROGRAM_EDITION_SLUG_PATTERN, REFERRERS_PER_LEADERBOARD_PAGE_DEFAULT, REFERRERS_PER_LEADERBOARD_PAGE_MAX, type RankedReferrerMetricsPieSplit, type RankedReferrerMetricsRevShareCap, type ReferralEvent, type ReferralProgramAwardModel, ReferralProgramAwardModels, type ReferralProgramEditionConfig, type ReferralProgramEditionConfigSet, type ReferralProgramEditionSlug, type ReferralProgramEditionStatusId, ReferralProgramEditionStatuses, type ReferralProgramEditionSummariesData, type ReferralProgramEditionSummariesResponse, type ReferralProgramEditionSummariesResponseCode, ReferralProgramEditionSummariesResponseCodes, type ReferralProgramEditionSummariesResponseError, type ReferralProgramEditionSummariesResponseOk, type ReferralProgramEditionSummary, type ReferralProgramEditionSummaryPieSplit, type ReferralProgramEditionSummaryRevShareCap, type ReferralProgramEditionSummaryUnrecognized, type ReferralProgramRules, type ReferralProgramRulesPieSplit, type ReferralProgramRulesRevShareCap, type ReferralProgramRulesUnrecognized, type ReferrerEditionMetrics, type ReferrerEditionMetricsPieSplit, type ReferrerEditionMetricsRankedPieSplit, type ReferrerEditionMetricsRankedRevShareCap, type ReferrerEditionMetricsRevShareCap, type ReferrerEditionMetricsTypeId, ReferrerEditionMetricsTypeIds, type ReferrerEditionMetricsUnrankedPieSplit, type ReferrerEditionMetricsUnrankedRevShareCap, type ReferrerEditionMetricsUnrecognized, type ReferrerLeaderboard, type ReferrerLeaderboardPage, type ReferrerLeaderboardPageContext, type ReferrerLeaderboardPageParams, type ReferrerLeaderboardPagePieSplit, type ReferrerLeaderboardPageRequest, type ReferrerLeaderboardPageResponse, type ReferrerLeaderboardPageResponseCode, ReferrerLeaderboardPageResponseCodes, type ReferrerLeaderboardPageResponseError, type ReferrerLeaderboardPageResponseOk, type ReferrerLeaderboardPageRevShareCap, type ReferrerLeaderboardPageUnrecognized, type ReferrerLeaderboardPieSplit, type ReferrerLeaderboardRevShareCap, type ReferrerMetrics, type ReferrerMetricsEditionsData, type ReferrerMetricsEditionsRequest, type ReferrerMetricsEditionsResponse, type ReferrerMetricsEditionsResponseCode, ReferrerMetricsEditionsResponseCodes, type ReferrerMetricsEditionsResponseError, type ReferrerMetricsEditionsResponseOk, type ReferrerMetricsForComparison, type ReferrerMetricsRevShareCap, type ReferrerRank, type ReferrerScore, SECONDS_PER_YEAR, type ScoredReferrerMetricsPieSplit, type SerializedAggregatedReferrerMetricsPieSplit, type SerializedAggregatedReferrerMetricsRevShareCap, type SerializedAwardedReferrerMetricsPieSplit, type SerializedAwardedReferrerMetricsRevShareCap, type SerializedReferralProgramEditionSummariesData, type SerializedReferralProgramEditionSummariesResponse, type SerializedReferralProgramEditionSummariesResponseError, type SerializedReferralProgramEditionSummariesResponseOk, type SerializedReferralProgramEditionSummary, type SerializedReferralProgramEditionSummaryPieSplit, type SerializedReferralProgramEditionSummaryRevShareCap, type SerializedReferralProgramRules, type SerializedReferralProgramRulesPieSplit, type SerializedReferralProgramRulesRevShareCap, type SerializedReferrerEditionMetrics, type SerializedReferrerEditionMetricsPieSplit, type SerializedReferrerEditionMetricsRankedPieSplit, type SerializedReferrerEditionMetricsRankedRevShareCap, type SerializedReferrerEditionMetricsRevShareCap, type SerializedReferrerEditionMetricsUnrankedPieSplit, type SerializedReferrerEditionMetricsUnrankedRevShareCap, type SerializedReferrerLeaderboardPage, type SerializedReferrerLeaderboardPagePieSplit, type SerializedReferrerLeaderboardPageResponse, type SerializedReferrerLeaderboardPageResponseError, type SerializedReferrerLeaderboardPageResponseOk, type SerializedReferrerLeaderboardPageRevShareCap, type SerializedReferrerMetricsEditionsData, type SerializedReferrerMetricsEditionsResponse, type SerializedReferrerMetricsEditionsResponseError, type SerializedReferrerMetricsEditionsResponseOk, type SerializedUnrankedReferrerMetricsPieSplit, type SerializedUnrankedReferrerMetricsRevShareCap, type UnrankedReferrerMetricsPieSplit, type UnrankedReferrerMetricsRevShareCap, buildAggregatedReferrerMetricsPieSplit, buildAggregatedReferrerMetricsRevShareCap, buildAwardedReferrerMetricsPieSplit, buildAwardedReferrerMetricsRevShareCap, buildEditionSummary, buildEditionSummaryPieSplit, buildEditionSummaryRevShareCap, buildEnsReferralUrl, buildLeaderboardPagePieSplit, buildLeaderboardPageRevShareCap, buildRankedReferrerMetricsPieSplit, buildRankedReferrerMetricsRevShareCap, buildReferralProgramEditionConfigSet, buildReferralProgramRulesPieSplit, buildReferralProgramRulesRevShareCap, buildReferrerLeaderboardPageContext, buildReferrerLeaderboardPageParams, buildReferrerLeaderboardPieSplit, buildReferrerLeaderboardRevShareCap, buildReferrerMetrics, buildReferrerMetricsRevShareCap, buildScoredReferrerMetricsPieSplit, buildUnrankedReferrerMetricsPieSplit, buildUnrankedReferrerMetricsRevShareCap, calcBaseReferralProgramEditionStatus, calcReferralProgramEditionStatusPieSplit, calcReferralProgramEditionStatusRevShareCap, calcReferrerAwardPoolSharePieSplit, calcReferrerScorePieSplit, compareReferrerMetrics, deserializeReferralProgramEditionConfigSetArray, deserializeReferralProgramEditionSummariesResponse, deserializeReferrerLeaderboardPageResponse, deserializeReferrerMetricsEditionsResponse, getReferrerEditionMetrics, getReferrerLeaderboardPage, isFiniteNonNegativeNumber, isInteger, isNonNegativeInteger, isPositiveInteger, isReferrerQualifiedRevShareCap, isValidDuration, isValidReferrerScore, serializeReferralProgramEditionSummariesResponse, serializeReferralProgramEditionSummary, serializeReferralProgramRules, serializeReferrerLeaderboardPageResponse, serializeReferrerMetricsEditionsResponse, sliceReferrers, sortReferrerMetrics, validateAggregatedReferrerMetricsPieSplit, validateAggregatedReferrerMetricsRevShareCap, validateAwardedReferrerMetricsPieSplit, validateAwardedReferrerMetricsRevShareCap, validateBaseReferralProgramEditionSummary, validateBaseReferralProgramRules, validateDuration, validateEditionSummaryPieSplit, validateEditionSummaryRevShareCap, validateNonNegativeInteger, validateNormalizedAddress, validateRankedReferrerMetricsPieSplit, validateRankedReferrerMetricsRevShareCap, validateReferralProgramEditionConfigSet, validateReferralProgramRulesPieSplit, validateReferralProgramRulesRevShareCap, validateReferrerLeaderboardPageContext, validateReferrerMetrics, validateReferrerMetricsRevShareCap, validateReferrerRank, validateReferrerScore, validateScoredReferrerMetricsPieSplit, validateUnixTimestamp, validateUnrankedReferrerMetricsPieSplit, validateUnrankedReferrerMetricsRevShareCap };