@marinade.finance/scoring 1.0.1 → 1.0.2

package/dist/computing/cluster.d.ts

@@ -0,0 +1,10 @@
+import { BlockProductionResult, ClusterInfo } from '../dto/cluster.dto';
+import { ValidatorDto } from '../dto/validators.dto';
+export declare function computeBlockProduction(validators: ValidatorDto[], startEpoch: number, endEpoch: number): BlockProductionResult;
+export declare function computeTargetCreditsByEpoch(validators: ValidatorDto[]): Map<number, number>;
+export declare function computeConcentrations(validators: ValidatorDto[], epoch: number): {
+    city: Map<string, number>;
+    country: Map<string, number>;
+    aso: Map<string, number>;
+};
+export declare function computeClusterInfo(validators: ValidatorDto[], basicEligibilityEpochs: number, lastEpoch: number): ClusterInfo;

package/dist/computing/cluster.js

@@ -0,0 +1,95 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeClusterInfo = exports.computeConcentrations = exports.computeTargetCreditsByEpoch = exports.computeBlockProduction = void 0;
+const maths_1 = require("../utils/maths");
+const decimal_js_1 = __importDefault(require("decimal.js"));
+function computeBlockProduction(validators, startEpoch, endEpoch) {
+    const blockProductions = [];
+    for (const validator of validators) {
+        let leaderSlots = 0;
+        let blocksProduced = 0;
+        for (let epoch = startEpoch; epoch <= endEpoch; epoch++) {
+            if (!validator.epochStats) {
+                continue;
+            }
+            const epochStat = validator.epochStats[epoch];
+            if (epochStat) {
+                leaderSlots += epochStat.leader_slots;
+                blocksProduced += epochStat.blocks_produced;
+            }
+        }
+        if (leaderSlots) {
+            blockProductions.push(blocksProduced / leaderSlots);
+        }
+    }
+    return {
+        mean: (0, maths_1.mean)(blockProductions),
+        stdDev: (0, maths_1.stdDev)(blockProductions),
+    };
+}
+exports.computeBlockProduction = computeBlockProduction;
+function computeTargetCreditsByEpoch(validators) {
+    const sumOfWeightedCreditsPerEpoch = new Map();
+    const sumOfWeightsPerEpoch = new Map();
+    validators.forEach(validator => {
+        validator.epoch_stats.forEach(epochStat => {
+            if (epochStat.epoch_end_at) {
+                const activatedStakeDecimal = new decimal_js_1.default(epochStat.activated_stake);
+                const stakeInSol = activatedStakeDecimal.dividedBy(1e9);
+                const prevSumOfWeightedCredits = sumOfWeightedCreditsPerEpoch.get(epochStat.epoch) || new decimal_js_1.default(0);
+                sumOfWeightedCreditsPerEpoch.set(epochStat.epoch, prevSumOfWeightedCredits.plus(new decimal_js_1.default(epochStat.credits).times(stakeInSol)));
+                const prevSumOfWeightsPerEpoch = sumOfWeightsPerEpoch.get(epochStat.epoch) || new decimal_js_1.default(0);
+                sumOfWeightsPerEpoch.set(epochStat.epoch, prevSumOfWeightsPerEpoch.plus(stakeInSol));
+            }
+        });
+    });
+    const result = new Map();
+    sumOfWeightsPerEpoch.forEach((sumOfWeights, epoch) => {
+        const weightedCredits = sumOfWeightedCreditsPerEpoch.get(epoch) || new decimal_js_1.default(0);
+        result.set(epoch, weightedCredits.dividedBy(sumOfWeights).toDecimalPlaces(0, decimal_js_1.default.ROUND_HALF_UP).toNumber());
+    });
+    return result;
+}
+exports.computeTargetCreditsByEpoch = computeTargetCreditsByEpoch;
+function computeConcentrations(validators, epoch) {
+    let total = 0;
+    const city = new Map();
+    const country = new Map();
+    const aso = new Map();
+    for (const validator of validators) {
+        const lastEpochStats = validator.epoch_stats[0];
+        if (lastEpochStats?.epoch === epoch) {
+            const cityKey = validator.dc_full_city ?? '???';
+            const countryKey = validator.dc_country ?? '???';
+            const asoKey = validator.dc_aso ?? '???';
+            const stake = Number(validator.activated_stake) / 1e9;
+            city.set(cityKey, (city.get(cityKey) ?? 0) + stake);
+            country.set(countryKey, (country.get(countryKey) ?? 0) + stake);
+            aso.set(asoKey, (aso.get(asoKey) ?? 0) + stake);
+            total += stake;
+        }
+    }
+    if (total > 0) {
+        for (const map of [city, country, aso]) {
+            for (const [key, value] of map) {
+                map.set(key, value / total);
+            }
+        }
+    }
+    return { city, country, aso };
+}
+exports.computeConcentrations = computeConcentrations;
+function computeClusterInfo(validators, basicEligibilityEpochs, lastEpoch) {
+    const { mean: meanBlockProduction, stdDev: stdDevBlockProduction } = computeBlockProduction(validators, lastEpoch - basicEligibilityEpochs, lastEpoch - 1);
+    return {
+        targetCreditsByEpoch: computeTargetCreditsByEpoch(validators),
+        ...computeConcentrations(validators, lastEpoch),
+        meanBlockProductionOverBasicEligibilityPeriod: meanBlockProduction,
+        stdDevBlockProductionOverBasicEligibilityPeriod: stdDevBlockProduction,
+    };
+}
+exports.computeClusterInfo = computeClusterInfo;
+//# sourceMappingURL=cluster.js.map

package/dist/computing/cluster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster.js","sourceRoot":"","sources":["../../src/computing/cluster.ts"],"names":[],"mappings":"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"}

package/dist/computing/eligibility.d.ts

@@ -0,0 +1,19 @@
+import { Bonds } from '../dto/bonds.dto';
+import { ClusterInfo } from '../dto/cluster.dto';
+import { EligibilityConfig, EvaluationResult, Issue, ValidatorEligibility, ValidatorsEligibilities } from '../dto/eligibility.dto';
+import { ScoreDto, Scores, ScoringConfig } from '../dto/scoring.dto';
+import { AggregatedValidator, AggregatedValidators } from '../dto/validators.dto';
+export declare function evalLowCreditsIssue(validator: AggregatedValidator, epochIndex: number, eligibilityConfig: EligibilityConfig, clusterInfo: ClusterInfo): Issue | null;
+export declare function evalLowExternalStakeIssue(validator: AggregatedValidator, epochIndex: number, eligibilityConfig: EligibilityConfig): Issue | undefined;
+export declare function evalBlacklistIssue(validator: AggregatedValidator): Issue | undefined;
+export declare function evalHighCommissionIssue(validator: AggregatedValidator, epochIndex: number, eligibilityConfig: EligibilityConfig): Issue | undefined;
+export declare function evalScoreIssue(epochIndex: number, eligibilityConfig: EligibilityConfig, { concentrationScore }: ScoreDto): Issue | undefined;
+export declare function evalBondIssue(validator: AggregatedValidator, bonds: Bonds): Issue | undefined;
+export declare function getValidatorIssuesInEpoch(validator: AggregatedValidator, bonds: Bonds, epochIndex: number, eligibilityConfig: EligibilityConfig, clusterInfo: ClusterInfo, score: ScoreDto): Issue[];
+export declare function evalIssuesInEpoch(issues: Issue[]): EvaluationResult;
+export declare function evalIssues(issuesCollection: Issue[][], epochs: number): EvaluationResult;
+export declare function isBasicEligible(issuesCollection: Issue[][], eligibilityConfig: EligibilityConfig): boolean;
+export declare function isBonusEligible(issuesCollection: Issue[][], eligibilityConfig: EligibilityConfig): boolean;
+export declare function getIssuesCollection(clusterInfo: ClusterInfo, aggregatedValidator: AggregatedValidator, bonds: Bonds, score: ScoreDto, eligibilityConfig: EligibilityConfig): Issue[][];
+export declare function computeValidatorEligibility(clusterInfo: ClusterInfo, aggregatedValidator: AggregatedValidator, bonds: Bonds, scores: ScoreDto, eligibilityConfig: EligibilityConfig, scoringConfig: ScoringConfig): ValidatorEligibility;
+export declare function computeValidatorsEligibilities(clusterInfo: ClusterInfo, scores: Scores, aggregatedValidators: AggregatedValidators, bonds: Bonds, eligibilityConfig: EligibilityConfig, scoringConfig: ScoringConfig): ValidatorsEligibilities;

package/dist/computing/eligibility.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeValidatorsEligibilities = exports.computeValidatorEligibility = exports.getIssuesCollection = exports.isBonusEligible = exports.isBasicEligible = exports.evalIssues = exports.evalIssuesInEpoch = exports.getValidatorIssuesInEpoch = exports.evalBondIssue = exports.evalScoreIssue = exports.evalHighCommissionIssue = exports.evalBlacklistIssue = exports.evalLowExternalStakeIssue = exports.evalLowCreditsIssue = void 0;
+const validators_1 = require("./validators");
+function evalLowCreditsIssue(validator, epochIndex, eligibilityConfig, clusterInfo) {
+    if (!validator.epochs[epochIndex]) {
+        return null;
+    }
+    const targetCredits = clusterInfo.targetCreditsByEpoch.get(validator.epochs[epochIndex]);
+    if (!targetCredits) {
+        return null;
+    }
+    const actualCredits = validator.credits[epochIndex] || 0;
+    const creditsPct = Math.round((100 * actualCredits) / targetCredits);
+    if (creditsPct < eligibilityConfig.voteCreditsLow) {
+        return { type: "VOTE_CREDITS_LOW", message: `Credits @ ${creditsPct}%` };
+    }
+    else if (creditsPct < eligibilityConfig.voteCreditsWarning) {
+        return { type: "VOTE_CREDITS_WARNING", message: `(Warning) Credits @ ${creditsPct}%` };
+    }
+    return null;
+}
+exports.evalLowCreditsIssue = evalLowCreditsIssue;
+function evalLowExternalStakeIssue(validator, epochIndex, eligibilityConfig) {
+    const externalStake = validator.externalStake[epochIndex];
+    if (!externalStake) {
+        return undefined;
+    }
+    if (externalStake < eligibilityConfig.minExternalStake) {
+        return { type: "EXTERNAL_STAKE", message: `External stake: ${externalStake}` };
+    }
+    return undefined;
+}
+exports.evalLowExternalStakeIssue = evalLowExternalStakeIssue;
+function evalBlacklistIssue(validator) {
+    if (validator.blacklisted) {
+        return { type: "BLACKLIST", message: 'Validator is blacklisted' };
+    }
+    return undefined;
+}
+exports.evalBlacklistIssue = evalBlacklistIssue;
+function evalHighCommissionIssue(validator, epochIndex, eligibilityConfig) {
+    const commission = validator.commission[epochIndex];
+    if (!commission) {
+        return undefined;
+    }
+    if (eligibilityConfig.maxCommission < commission) {
+        return { type: "COMMISSION", message: `Commission: ${commission}%` };
+    }
+    return undefined;
+}
+exports.evalHighCommissionIssue = evalHighCommissionIssue;
+function evalScoreIssue(epochIndex, eligibilityConfig, { concentrationScore }) {
+    if (epochIndex === 0 && concentrationScore < eligibilityConfig.minScore) {
+        return { type: "SCORE", message: `Concentration Score: ${concentrationScore}` };
+    }
+    return undefined;
+}
+exports.evalScoreIssue = evalScoreIssue;
+function evalBondIssue(validator, bonds) {
+    if (!(validator.voteAccount in bonds)) {
+        return { type: "NO_BOND", message: 'Validator has no bond' };
+    }
+    return undefined;
+}
+exports.evalBondIssue = evalBondIssue;
+function getValidatorIssuesInEpoch(validator, bonds, epochIndex, eligibilityConfig, clusterInfo, score) {
+    if (!validator.dataAvailable[epochIndex]) {
+        return [{ type: "NO_DATA", message: `No data for validator in epoch ${validator.epochs[epochIndex]}` }];
+    }
+    return [
+        evalBlacklistIssue(validator),
+        evalLowCreditsIssue(validator, epochIndex, eligibilityConfig, clusterInfo),
+        evalLowExternalStakeIssue(validator, epochIndex, eligibilityConfig),
+        evalHighCommissionIssue(validator, epochIndex, eligibilityConfig),
+        evalScoreIssue(epochIndex, eligibilityConfig, score),
+        evalBondIssue(validator, bonds),
+    ].filter(Boolean);
+}
+exports.getValidatorIssuesInEpoch = getValidatorIssuesInEpoch;
+function evalIssuesInEpoch(issues) {
+    let criticals = 0;
+    let warnings = 0;
+    const criticalTypes = new Set([
+        "NO_BOND",
+        "NO_DATA",
+        "BLACKLIST",
+        "COMMISSION",
+        "EXTERNAL_STAKE",
+        "CENTRALIZATION",
+        "SCORE",
+        "VOTE_CREDITS_LOW",
+    ]);
+    const warningTypes = new Set([
+        "VOTE_CREDITS_WARNING",
+    ]);
+    issues.forEach(issue => {
+        if (criticalTypes.has(issue.type)) {
+            criticals++;
+        }
+        else if (warningTypes.has(issue.type)) {
+            warnings++;
+        }
+        else {
+            throw new Error(`Unexpected issue: ${issue.type}`);
+        }
+    });
+    return { criticals, warnings };
+}
+exports.evalIssuesInEpoch = evalIssuesInEpoch;
+function evalIssues(issuesCollection, epochs) {
+    let totalCriticals = 0;
+    let totalWarnings = 0;
+    for (let epochIndex = 0; epochIndex < epochs; epochIndex++) {
+        if (!issuesCollection[epochIndex]) {
+            continue;
+        }
+        const { criticals, warnings } = evalIssuesInEpoch(issuesCollection[epochIndex]);
+        totalCriticals += criticals;
+        totalWarnings += warnings;
+    }
+    return { criticals: totalCriticals, warnings: totalWarnings };
+}
+exports.evalIssues = evalIssues;
+function isBasicEligible(issuesCollection, eligibilityConfig) {
+    const { criticals, warnings } = evalIssues(issuesCollection, eligibilityConfig.basicEligibilityEpochs + 1);
+    return criticals === 0 && warnings <= eligibilityConfig.maxWarnings;
+}
+exports.isBasicEligible = isBasicEligible;
+function isBonusEligible(issuesCollection, eligibilityConfig) {
+    const totalEpochs = eligibilityConfig.basicEligibilityEpochs + eligibilityConfig.bonusEligibilityExtraEpochs + 1;
+    const { criticals, warnings } = evalIssues(issuesCollection, totalEpochs);
+    return criticals === 0 && warnings <= eligibilityConfig.maxWarnings;
+}
+exports.isBonusEligible = isBonusEligible;
+function getIssuesCollection(clusterInfo, aggregatedValidator, bonds, score, eligibilityConfig) {
+    return Array.from({ length: eligibilityConfig.basicEligibilityEpochs + eligibilityConfig.bonusEligibilityExtraEpochs + 1 }, (_, epochIndex) => getValidatorIssuesInEpoch(aggregatedValidator, bonds, epochIndex, eligibilityConfig, clusterInfo, score));
+}
+exports.getIssuesCollection = getIssuesCollection;
+function computeValidatorEligibility(clusterInfo, aggregatedValidator, bonds, scores, eligibilityConfig, scoringConfig) {
+    const issuesCollection = getIssuesCollection(clusterInfo, aggregatedValidator, bonds, scores, eligibilityConfig);
+    const minExternalStake = (0, validators_1.selectExternalStakeMin)(aggregatedValidator, eligibilityConfig.basicEligibilityEpochs);
+    return {
+        basicEligibility: isBasicEligible(issuesCollection, eligibilityConfig),
+        bonusEligibility: isBonusEligible(issuesCollection, eligibilityConfig),
+        issuesCollection,
+        capFromBond: scoringConfig.CAP_FROM_BOND,
+        capFromExternalStake: minExternalStake * (eligibilityConfig.maxStakeShare / (1 - eligibilityConfig.maxStakeShare)),
+    };
+}
+exports.computeValidatorEligibility = computeValidatorEligibility;
+function computeValidatorsEligibilities(clusterInfo, scores, aggregatedValidators, bonds, eligibilityConfig, scoringConfig) {
+    const result = {};
+    for (const [voteAccount, validator] of Object.entries(aggregatedValidators)) {
+        if (!scores[voteAccount]) {
+            continue;
+        }
+        result[voteAccount] = computeValidatorEligibility(clusterInfo, validator, bonds, scores[voteAccount], eligibilityConfig, scoringConfig);
+    }
+    return result;
+}
+exports.computeValidatorsEligibilities = computeValidatorsEligibilities;
+//# sourceMappingURL=eligibility.js.map

package/dist/computing/eligibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligibility.js","sourceRoot":"","sources":["../../src/computing/eligibility.ts"],"names":[],"mappings":"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"}

package/dist/computing/score.d.ts

@@ -0,0 +1,20 @@
+import { ClusterInfo } from '../dto/cluster.dto';
+import { ScoreDto, ScoreConfig, Scores, Variables } from '../dto/scoring.dto';
+import { AggregatedValidator, AggregatedValidators } from '../dto/validators.dto';
+import { ValidatorsEligibilities } from '../dto/eligibility.dto';
+import { ScoringConfig } from '../dto/scoring.dto';
+export declare function selectVariables(clusterInfo: ClusterInfo, aggregatedValidator: AggregatedValidator, scoreConfig: ScoreConfig): Variables;
+export declare function computeValidatorScore(clusterInfo: ClusterInfo, aggregatedValidator: AggregatedValidator, formulas: string[], weights: number[], scoreConfig: ScoreConfig): ScoreDto;
+export declare function computeValidatorsScores(clusterInfo: ClusterInfo, aggregatedValidators: AggregatedValidators, formulas: string[], weights: number[], scoreConfig: ScoreConfig): Scores;
+export declare function scoreTooltipCredits(validator: AggregatedValidator, clusterInfo: ClusterInfo): string;
+export declare function scoreTooltipBlockProduction(validator: AggregatedValidator, _clusterInfo: ClusterInfo): string;
+export declare function scoreTooltipCommissionInflation(validator: AggregatedValidator, _clusterInfo: ClusterInfo): string;
+export declare function scoreTooltipCommissionMEV(validator: AggregatedValidator, _clusterInfo: ClusterInfo): string;
+export declare function scoreTooltipCountryStakeConcentration(validator: AggregatedValidator, _clusterInfo: ClusterInfo): string;
+export declare function scoreTooltipCityStakeConcentration(validator: AggregatedValidator, _clusterInfo: ClusterInfo): string;
+export declare function scoreTooltipNodeStake(validator: AggregatedValidator, _clusterInfo: ClusterInfo): string;
+export declare function scoreTooltipASOStakeConcentration(validator: AggregatedValidator, _clusterInfo: ClusterInfo): string;
+export declare function getScoreTooltipBuilders(): ((validator: AggregatedValidator, clusterInfo: ClusterInfo) => string)[];
+export declare function getDefaultFormulas(scoringConfig: ScoringConfig): string[];
+export declare function getDefaultWeights(scoringConfig: ScoringConfig): number[];
+export declare function orderByEligibiltyAndScore(scores: Scores, eligibilities: ValidatorsEligibilities): string[];

package/dist/computing/score.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.orderByEligibiltyAndScore = exports.getDefaultWeights = exports.getDefaultFormulas = exports.getScoreTooltipBuilders = exports.scoreTooltipASOStakeConcentration = exports.scoreTooltipNodeStake = exports.scoreTooltipCityStakeConcentration = exports.scoreTooltipCountryStakeConcentration = exports.scoreTooltipCommissionMEV = exports.scoreTooltipCommissionInflation = exports.scoreTooltipBlockProduction = exports.scoreTooltipCredits = exports.computeValidatorsScores = exports.computeValidatorScore = exports.selectVariables = void 0;
+const expr_eval_1 = require("expr-eval");
+const maths_1 = require("../utils/maths");
+const zip_1 = require("../utils/zip");
+const validators_1 = require("./validators");
+const logger_1 = require("../logging/logger");
+function selectVariables(clusterInfo, aggregatedValidator, scoreConfig) {
+    return {
+        bp_cluster_mean: clusterInfo.meanBlockProductionOverBasicEligibilityPeriod,
+        bp_cluster_std_dev: clusterInfo.stdDevBlockProductionOverBasicEligibilityPeriod,
+        credits_pct_mean: (0, validators_1.selectCreditsPctMean)(aggregatedValidator, clusterInfo, scoreConfig.epochs),
+        bp_mean: (0, validators_1.selectBlockProductionMean)(aggregatedValidator, scoreConfig.epochs),
+        commission_inflation_max: (0, validators_1.selectCommissionInflationMax)(aggregatedValidator, scoreConfig.epochs + 1),
+        commission_mev: (0, validators_1.selectCommissionMEV)(aggregatedValidator),
+        country_stake_concentration_last: (0, validators_1.selectCountryStakeConcentration)(aggregatedValidator, clusterInfo),
+        city_stake_concentration_last: (0, validators_1.selectCityStakeConcentration)(aggregatedValidator, clusterInfo),
+        aso_stake_concentration_last: (0, validators_1.selectASOStakeConcentration)(aggregatedValidator, clusterInfo),
+        node_stake_last: (0, validators_1.selectNodeStake)(aggregatedValidator),
+    };
+}
+exports.selectVariables = selectVariables;
+function computeValidatorScore(clusterInfo, aggregatedValidator, formulas, weights, scoreConfig) {
+    const scoreErrors = [];
+    const scores = [];
+    const values = [];
+    const tooltips = [];
+    let totalWeight = 0;
+    let totalScore = 0;
+    let totalConcentrationWeight = 0;
+    let totalConcentrationScore = 0;
+    const variables = { ...selectVariables(clusterInfo, aggregatedValidator, scoreConfig), ...(0, maths_1.mathUtilityFunctions)() };
+    for (const [formula, weight, tooltipBuilder] of (0, zip_1.zip)(formulas, weights, getScoreTooltipBuilders())) {
+        let score = 0;
+        try {
+            values.push(0);
+            score = expr_eval_1.Parser.evaluate(formula, variables);
+            scoreErrors.push(false);
+        }
+        catch (err) {
+            (0, logger_1.error)('Failed to calculate', formula, 'for', aggregatedValidator.voteAccount, 'err:', err);
+            scoreErrors.push(true);
+        }
+        totalWeight += weight;
+        totalScore += weight * score;
+        if (scoreConfig.concentrationParams.includes(scores.length)) {
+            totalConcentrationWeight += weight;
+            totalConcentrationScore += weight * score;
+        }
+        tooltips.push(tooltipBuilder(aggregatedValidator, clusterInfo));
+        scores.push(score);
+    }
+    return {
+        score: totalScore / totalWeight,
+        concentrationScore: totalConcentrationScore / totalConcentrationWeight,
+        scores,
+        values,
+        scoreErrors,
+        tooltips,
+    };
+}
+exports.computeValidatorScore = computeValidatorScore;
+function computeValidatorsScores(clusterInfo, aggregatedValidators, formulas, weights, scoreConfig) {
+    const result = {};
+    for (const [voteAccount, aggregatedValidator] of Object.entries(aggregatedValidators)) {
+        result[voteAccount] = computeValidatorScore(clusterInfo, aggregatedValidator, formulas, weights, scoreConfig);
+    }
+    return result;
+}
+exports.computeValidatorsScores = computeValidatorsScores;
+function scoreTooltipCredits(validator, clusterInfo) {
+    return `Credits: ${validator.credits.slice(1).map((credits, e) => {
+        const epoch = validator.epochs[e + 1];
+        if (epoch !== undefined) {
+            const targetCredits = clusterInfo.targetCreditsByEpoch.get(epoch) || 1;
+            return `${(100 * credits / targetCredits).toFixed(2)}%`;
+        }
+        else {
+            return 'N/A';
+        }
+    }).join(', ')}`;
+}
+exports.scoreTooltipCredits = scoreTooltipCredits;
+function scoreTooltipBlockProduction(validator, _clusterInfo) {
+    return `Block production: ${validator.blocksProduced.map((blocksProduced, e) => {
+        const leaderSlot = validator.leaderSlots[e];
+        if (leaderSlot) {
+            return `${(100 * blocksProduced / leaderSlot).toFixed(2)}%`;
+        }
+        else {
+            return '-';
+        }
+    }).join(', ')}`;
+}
+exports.scoreTooltipBlockProduction = scoreTooltipBlockProduction;
+function scoreTooltipCommissionInflation(validator, _clusterInfo) {
+    return `Inflation commission: ${validator.commission.map(c => `${c}%`).join(', ')}`;
+}
+exports.scoreTooltipCommissionInflation = scoreTooltipCommissionInflation;
+function scoreTooltipCommissionMEV(validator, _clusterInfo) {
+    return `MEV commission: ${validator.mevCommission} %`;
+}
+exports.scoreTooltipCommissionMEV = scoreTooltipCommissionMEV;
+function scoreTooltipCountryStakeConcentration(validator, _clusterInfo) {
+    return `Country: ${validator.country}`;
+}
+exports.scoreTooltipCountryStakeConcentration = scoreTooltipCountryStakeConcentration;
+function scoreTooltipCityStakeConcentration(validator, _clusterInfo) {
+    return `City: ${validator.city}`;
+}
+exports.scoreTooltipCityStakeConcentration = scoreTooltipCityStakeConcentration;
+function scoreTooltipNodeStake(validator, _clusterInfo) {
+    return `Stake of the node: ${Math.round(validator.stake[0] ?? 0).toLocaleString()} SOL`;
+}
+exports.scoreTooltipNodeStake = scoreTooltipNodeStake;
+function scoreTooltipASOStakeConcentration(validator, _clusterInfo) {
+    return `ASO: ${validator.aso}`;
+}
+exports.scoreTooltipASOStakeConcentration = scoreTooltipASOStakeConcentration;
+function getScoreTooltipBuilders() {
+    return [
+        scoreTooltipCredits,
+        scoreTooltipBlockProduction,
+        scoreTooltipCommissionInflation,
+        scoreTooltipCommissionMEV,
+        scoreTooltipCountryStakeConcentration,
+        scoreTooltipCityStakeConcentration,
+        scoreTooltipASOStakeConcentration,
+        scoreTooltipNodeStake,
+    ];
+}
+exports.getScoreTooltipBuilders = getScoreTooltipBuilders;
+function getDefaultFormulas(scoringConfig) {
+    return [
+        scoringConfig.formulaVoteCredits,
+        scoringConfig.formulaBlockProduction,
+        scoringConfig.formulaInflationCommission,
+        scoringConfig.formulaMEVCommission,
+        scoringConfig.formulaStakeConcentrationCountry,
+        scoringConfig.formulaStakeConcentrationCity,
+        scoringConfig.formulaStakeConcentrationASO,
+        scoringConfig.formulaStakeConcentrationNode,
+    ];
+}
+exports.getDefaultFormulas = getDefaultFormulas;
+function getDefaultWeights(scoringConfig) {
+    return [
+        scoringConfig.weightVoteCredits,
+        scoringConfig.weightBlockProduction,
+        scoringConfig.weightInflationCommission,
+        scoringConfig.weightMEVCommission,
+        scoringConfig.weightStakeConcentrationCountry,
+        scoringConfig.weightStakeConcentrationCity,
+        scoringConfig.weightStakeConcentrationASO,
+        scoringConfig.weightStakeConcentrationNode,
+    ];
+}
+exports.getDefaultWeights = getDefaultWeights;
+function orderByEligibiltyAndScore(scores, eligibilities) {
+    const voteAccounts = Object.keys(scores);
+    voteAccounts.sort((a, b) => {
+        const eligibilityOrder = Number(eligibilities[b]?.basicEligibility ?? 0) - Number(eligibilities[a]?.basicEligibility ?? 0);
+        if (eligibilityOrder === 0) {
+            const scoreA = scores[a]?.score ?? 0;
+            const scoreB = scores[b]?.score ?? 0;
+            return scoreB - scoreA;
+        }
+        return eligibilityOrder;
+    });
+    return voteAccounts;
+}
+exports.orderByEligibiltyAndScore = orderByEligibiltyAndScore;
+//# sourceMappingURL=score.js.map

package/dist/computing/score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"score.js","sourceRoot":"","sources":["../../src/computing/score.ts"],"names":[],"mappings":"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"}

package/dist/computing/stake.d.ts

@@ -0,0 +1,26 @@
+import { ValidatorsEligibilities } from '../dto/eligibility.dto';
+import { Scores, ScoringConfig } from '../dto/scoring.dto';
+import { Votes } from '../dto/snapshots.dto';
+import { ProcessedVotesAndTVLs, Stakes, StakesConfig, StakingVariables } from '../dto/stakes.dto';
+import { AggregatedValidators } from '../dto/validators.dto';
+export interface ComputeStakesForValidatorsParams {
+    stakingVariables: StakingVariables;
+    eligibleValidators: string[];
+    scores: Scores;
+    eligibilities: ValidatorsEligibilities;
+    stakesConfig: StakesConfig;
+    mSolVotes: Votes;
+    veMndeVotes: Votes;
+    totalMsolVotes: number;
+    totalVeMndeVotes: number;
+    mSolTvl: number;
+    veMndeTvl: number;
+    algoTvl: number;
+    blockSize: number;
+}
+export declare function removeFromVotes(votes: Votes, toRemove: string): Votes;
+export declare function processVotesAndCalculateTVLs(mSolVotes: Votes, veMndeVotes: Votes, stakesConfig: StakesConfig, scoringConfig: ScoringConfig): ProcessedVotesAndTVLs;
+export declare function filterEligibleValidators(aggregatedValidators: AggregatedValidators, eligibilities: ValidatorsEligibilities): string[];
+export declare function initStakes(eligibleValidators: string[]): Stakes;
+export declare function computeStakesForValidators(params: ComputeStakesForValidatorsParams): Stakes;
+export declare function computeValidatorsStakes(aggregatedValidators: AggregatedValidators, scores: Scores, eligibilities: ValidatorsEligibilities, stakesConfig: StakesConfig, scoringConfig: ScoringConfig, mSolVotes: Votes, veMndeVotes: Votes): Stakes;