@marinade.finance/scoring 1.0.0 → 1.0.2

package/dist/computing/stake.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeValidatorsStakes = exports.computeStakesForValidators = exports.initStakes = exports.filterEligibleValidators = exports.processVotesAndCalculateTVLs = exports.removeFromVotes = void 0;
+const expr_eval_1 = require("expr-eval");
+const maths_1 = require("../utils/maths");
+const logger_1 = require("../logging/logger");
+function removeFromVotes(votes, toRemove) {
+    const votesCopy = { ...votes };
+    delete votesCopy[toRemove];
+    return votesCopy;
+}
+exports.removeFromVotes = removeFromVotes;
+function processVotesAndCalculateTVLs(mSolVotes, veMndeVotes, stakesConfig, scoringConfig) {
+    const updatedVeMndeVotes = removeFromVotes({ ...veMndeVotes }, scoringConfig.DS_PUBKEY);
+    const veMndeVotesForDS = veMndeVotes[scoringConfig.DS_PUBKEY] ?? 0;
+    const totalVeMndeVotes = (0, maths_1.sum)(Object.values(veMndeVotes));
+    const veMndeTvl = Math.round(totalVeMndeVotes > 0
+        ? (1 - veMndeVotesForDS / totalVeMndeVotes) * stakesConfig.veMndeControl * stakesConfig.tvl
+        : 0);
+    const updatedMSolVotes = removeFromVotes({ ...mSolVotes }, scoringConfig.DS_PUBKEY);
+    const mSolVotesForDS = mSolVotes[scoringConfig.DS_PUBKEY] ?? 0;
+    const totalMSolVotes = (0, maths_1.sum)(Object.values(mSolVotes));
+    const mSolTvl = Math.round(totalMSolVotes > 0
+        ? (1 - mSolVotesForDS / totalMSolVotes) * stakesConfig.mSolControl * stakesConfig.tvl
+        : 0);
+    return {
+        updatedMSolVotes,
+        updatedVeMndeVotes,
+        mSolTvl,
+        veMndeTvl,
+        totalTvl: stakesConfig.tvl
+    };
+}
+exports.processVotesAndCalculateTVLs = processVotesAndCalculateTVLs;
+function filterEligibleValidators(aggregatedValidators, eligibilities) {
+    return Object.keys(aggregatedValidators).filter(voteAccount => eligibilities[voteAccount]?.basicEligibility);
+}
+exports.filterEligibleValidators = filterEligibleValidators;
+function initStakes(eligibleValidators) {
+    const result = {};
+    for (const voteAccount of eligibleValidators) {
+        result[voteAccount] = {
+            algoStake: 0,
+            mSolStake: 0,
+            veMndeStake: 0,
+            totalStake: 0,
+            algoStakeFromOverflow: 0,
+            mSolStakeFromOverflow: 0,
+            veMndeStakeFromOverflow: 0,
+            totalStakeFromOverlfow: 0,
+        };
+    }
+    return result;
+}
+exports.initStakes = initStakes;
+function computeStakesForValidators(params) {
+    let updatedTotalMSolVotes = params.totalMsolVotes;
+    let updatedTotalVeMndeVotes = params.totalVeMndeVotes;
+    let algoStakeDistributed = 0;
+    let mSolStakeDistributed = 0;
+    let veMndeStakeDistributed = 0;
+    const stakes = initStakes(params.eligibleValidators);
+    let round = 1;
+    while (round <= 100 && (params.mSolTvl - mSolStakeDistributed > 1 || params.veMndeTvl - veMndeStakeDistributed > 1)) {
+        let someStakeIncreased = false;
+        const mSolStakeDistributedBeforeRound = mSolStakeDistributed;
+        const veMndeStakeDistributedBeforeRound = veMndeStakeDistributed;
+        for (const voteAccount of params.eligibleValidators) {
+            if (!stakes[voteAccount] || !params.scores[voteAccount] || !params.eligibilities[voteAccount]) {
+                continue;
+            }
+            let blocks = 0;
+            if (round === 1) {
+                if (params.eligibilities[voteAccount].bonusEligibility) {
+                    blocks += params.stakesConfig.stakeBlocksFromBonus;
+                }
+                blocks += expr_eval_1.Parser.evaluate(params.stakesConfig.formulaStakeBlocksFromScore, { ...params.stakingVariables, score: params.scores[voteAccount].score });
+            }
+            const algoStake = Math.round(Math.min(params.blockSize * blocks, Math.max(params.algoTvl - algoStakeDistributed, 0)));
+            const mSolStake = updatedTotalMSolVotes > 0 ? Math.round((params.mSolVotes[voteAccount] ?? 0) / updatedTotalMSolVotes * Math.max(params.mSolTvl - mSolStakeDistributedBeforeRound, 0)) : 0;
+            const veMndeStake = updatedTotalVeMndeVotes > 0 ? Math.round((params.veMndeVotes[voteAccount] ?? 0) / updatedTotalVeMndeVotes * Math.max(params.veMndeTvl - veMndeStakeDistributedBeforeRound, 0)) : 0;
+            const stake = algoStake + veMndeStake + mSolStake;
+            if (!stake) {
+                continue;
+            }
+            const cappedStake = Math.min(params.eligibilities[voteAccount].capFromBond - stakes[voteAccount].totalStake, params.eligibilities[voteAccount].capFromExternalStake - stakes[voteAccount].totalStake, stake);
+            const stakeOverflow = stake - cappedStake;
+            const algoStakeOverflow = Math.round(algoStake / stake * stakeOverflow);
+            const mSolStakeOverflow = Math.round(mSolStake / stake * stakeOverflow);
+            const veMndeStakeOverflow = Math.round(veMndeStake / stake * stakeOverflow);
+            const cappedAlgoStake = algoStake - algoStakeOverflow;
+            const cappedMSolStake = mSolStake - mSolStakeOverflow;
+            const cappedVeMndeStake = veMndeStake - veMndeStakeOverflow;
+            if (cappedAlgoStake + cappedMSolStake + cappedVeMndeStake > 0) {
+                someStakeIncreased = true;
+            }
+            algoStakeDistributed += cappedAlgoStake;
+            mSolStakeDistributed += cappedMSolStake;
+            veMndeStakeDistributed += cappedVeMndeStake;
+            stakes[voteAccount].algoStake += cappedAlgoStake;
+            stakes[voteAccount].mSolStake += cappedMSolStake;
+            stakes[voteAccount].veMndeStake += cappedVeMndeStake;
+            stakes[voteAccount].totalStake += cappedAlgoStake + cappedMSolStake + cappedVeMndeStake;
+            if (round > 1) {
+                stakes[voteAccount].algoStakeFromOverflow += cappedAlgoStake;
+                stakes[voteAccount].mSolStakeFromOverflow += cappedMSolStake;
+                stakes[voteAccount].veMndeStakeFromOverflow += cappedVeMndeStake;
+                stakes[voteAccount].totalStakeFromOverlfow += cappedAlgoStake + cappedMSolStake + cappedVeMndeStake;
+            }
+        }
+        round++;
+        if (!someStakeIncreased) {
+            break;
+        }
+        for (const voteAccount of params.eligibleValidators) {
+            if (Math.round(stakes[voteAccount].totalStake) === Math.round(params.eligibilities[voteAccount].capFromExternalStake)) {
+                params.veMndeVotes = removeFromVotes(params.veMndeVotes, voteAccount);
+                params.mSolVotes = removeFromVotes(params.mSolVotes, voteAccount);
+            }
+        }
+        updatedTotalVeMndeVotes = (0, maths_1.sum)(Object.values(params.veMndeVotes));
+        updatedTotalMSolVotes = (0, maths_1.sum)(Object.values(params.mSolVotes));
+    }
+    const remainingAlgoTvl = Math.max(params.algoTvl - algoStakeDistributed, 0);
+    const remainingMSolTvl = Math.max(params.mSolTvl - mSolStakeDistributed, 0);
+    const remainingVeMndeTvl = Math.max(params.veMndeTvl - veMndeStakeDistributed, 0);
+    for (const voteAccount of params.eligibleValidators) {
+        if (!stakes[voteAccount]) {
+            continue;
+        }
+        if (algoStakeDistributed) {
+            const extraStake = Math.round((stakes[voteAccount]?.algoStake ?? 0) / algoStakeDistributed * remainingAlgoTvl);
+            stakes[voteAccount].totalStake += extraStake;
+            stakes[voteAccount].algoStake += extraStake;
+            stakes[voteAccount].algoStakeFromOverflow += extraStake;
+        }
+        if (mSolStakeDistributed) {
+            const extraStake = Math.round((stakes[voteAccount]?.algoStake ?? 0) / mSolStakeDistributed * remainingMSolTvl);
+            stakes[voteAccount].totalStake += extraStake;
+            stakes[voteAccount].mSolStake += extraStake;
+            stakes[voteAccount].mSolStakeFromOverflow += extraStake;
+        }
+        if (veMndeStakeDistributed) {
+            const extraStake = Math.round((stakes[voteAccount]?.algoStake ?? 0) / veMndeStakeDistributed * remainingVeMndeTvl);
+            stakes[voteAccount].totalStake += extraStake;
+            stakes[voteAccount].veMndeStake += extraStake;
+            stakes[voteAccount].veMndeStakeFromOverflow += extraStake;
+        }
+    }
+    return stakes;
+}
+exports.computeStakesForValidators = computeStakesForValidators;
+function computeValidatorsStakes(aggregatedValidators, scores, eligibilities, stakesConfig, scoringConfig, mSolVotes, veMndeVotes) {
+    let updatedMSolVotes = { ...mSolVotes };
+    let updatedVeMndeVotes = { ...veMndeVotes };
+    const processedVotesAndTvls = processVotesAndCalculateTVLs(updatedMSolVotes, updatedVeMndeVotes, stakesConfig, scoringConfig);
+    updatedMSolVotes = processedVotesAndTvls.updatedMSolVotes;
+    updatedVeMndeVotes = processedVotesAndTvls.updatedVeMndeVotes;
+    const algoTvl = stakesConfig.tvl - processedVotesAndTvls.mSolTvl - processedVotesAndTvls.veMndeTvl;
+    try {
+        const eligibleValidators = filterEligibleValidators(aggregatedValidators, eligibilities);
+        const stakingVariables = { tvl: algoTvl };
+        const blockSize = expr_eval_1.Parser.evaluate(stakesConfig.formulaStakeBlockSize, stakingVariables);
+        Object.keys(aggregatedValidators).filter((v) => !eligibilities[v]?.basicEligibility).forEach((voteAccount) => {
+            updatedVeMndeVotes = removeFromVotes(updatedVeMndeVotes, voteAccount);
+            updatedMSolVotes = removeFromVotes(updatedMSolVotes, voteAccount);
+        });
+        const updatedTotalVeMndeVotes = (0, maths_1.sum)(Object.values(updatedVeMndeVotes));
+        const updatedTotalMSolVotes = (0, maths_1.sum)(Object.values(updatedMSolVotes));
+        eligibleValidators.sort((a, b) => {
+            const scoreA = scores[a]?.score ?? 0;
+            const scoreB = scores[b]?.score ?? 0;
+            return scoreB - scoreA;
+        });
+        return computeStakesForValidators({
+            stakingVariables: stakingVariables,
+            eligibleValidators: eligibleValidators,
+            scores: scores,
+            eligibilities: eligibilities,
+            stakesConfig: stakesConfig,
+            mSolVotes: updatedMSolVotes,
+            veMndeVotes: updatedVeMndeVotes,
+            totalMsolVotes: updatedTotalMSolVotes,
+            totalVeMndeVotes: updatedTotalVeMndeVotes,
+            mSolTvl: processedVotesAndTvls.mSolTvl,
+            veMndeTvl: processedVotesAndTvls.veMndeTvl,
+            algoTvl: algoTvl,
+            blockSize: blockSize
+        });
+    }
+    catch (err) {
+        (0, logger_1.error)("Computing validators stakes failed.", err);
+        throw err;
+    }
+}
+exports.computeValidatorsStakes = computeValidatorsStakes;
+//# sourceMappingURL=stake.js.map

package/dist/computing/stake.js.map

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

package/dist/computing/validators.d.ts

@@ -0,0 +1,16 @@
+import { AggregatedValidator, AggregatedValidators, ValidatorDto } from '../dto/validators.dto';
+import { JitoValidatorDto } from '../dto/jito.dto';
+import { ClusterInfo } from '../dto/cluster.dto';
+import { IDataProvider } from '../interfaces/data-provider.interface';
+export declare function aggregateValidatorData(validator: ValidatorDto, mevRecord: JitoValidatorDto, blacklist: Set<string>, firstEpoch: number, lastEpoch: number): AggregatedValidator;
+export declare function aggregateValidatorsData(validators: ValidatorDto[], basicEligibilityEpochs: number, bonusEligibilityExtraEpochs: number, dataProvider: IDataProvider): Promise<AggregatedValidators>;
+export declare function getMaxEpoch(validators: ValidatorDto[]): number;
+export declare function selectExternalStakeMin(validator: AggregatedValidator, fullEpochs: number): number;
+export declare function selectCreditsPctMean(validator: AggregatedValidator, clusterInfo: ClusterInfo, fullEpochs: number): number;
+export declare function selectBlockProductionMean(validator: AggregatedValidator, fullEpochs: number): number;
+export declare function selectCommissionInflationMax(validator: AggregatedValidator, epochs: number): number;
+export declare function selectCommissionMEV(validator: AggregatedValidator): number;
+export declare function selectCountryStakeConcentration(validator: AggregatedValidator, clusterInfo: ClusterInfo): number;
+export declare function selectCityStakeConcentration(validator: AggregatedValidator, clusterInfo: ClusterInfo): number;
+export declare function selectASOStakeConcentration(validator: AggregatedValidator, clusterInfo: ClusterInfo): number;
+export declare function selectNodeStake(validator: AggregatedValidator): number;

package/dist/computing/validators.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectNodeStake = exports.selectASOStakeConcentration = exports.selectCityStakeConcentration = exports.selectCountryStakeConcentration = exports.selectCommissionMEV = exports.selectCommissionInflationMax = exports.selectBlockProductionMean = exports.selectCreditsPctMean = exports.selectExternalStakeMin = exports.getMaxEpoch = exports.aggregateValidatorsData = exports.aggregateValidatorData = void 0;
+const maths_1 = require("../utils/maths");
+function aggregateValidatorData(validator, mevRecord, blacklist, firstEpoch, lastEpoch) {
+    const currentMarinadeStake = Number(validator.epochStats[lastEpoch]?.marinade_native_stake || 0) / 1e9 + Number(validator.epochStats[lastEpoch]?.marinade_stake || 0) / 1e9;
+    const voteAccount = validator.vote_account;
+    const name = validator.info_name || 'Unknown';
+    const epochs = [];
+    const commission = [];
+    const stake = [];
+    const externalStake = [];
+    const credits = [];
+    const blocksProduced = [];
+    const leaderSlots = [];
+    const dataAvailable = [];
+    const currentStake = Number(validator.epochStats[lastEpoch]?.activated_stake || 0) / 1e9;
+    const blacklisted = blacklist.has(voteAccount);
+    for (let epoch = lastEpoch; epoch >= firstEpoch; epoch--) {
+        const epochStat = validator.epochStats?.[epoch];
+        epochs.push(epoch);
+        commission.push(epochStat?.commission_max_observed || epochStat?.commission_advertised || 0);
+        stake.push(Number(epochStat?.activated_stake || 0) / 1e9);
+        externalStake.push(Number(epochStat?.activated_stake || 0) / 1e9 - Number(epochStat?.marinade_stake || 0) / 1e9 - Number(epochStat?.marinade_native_stake || 0) / 1e9);
+        credits.push(epochStat?.credits || 0);
+        blocksProduced.push(epochStat?.blocks_produced || 0);
+        leaderSlots.push(epochStat?.leader_slots || 0);
+        dataAvailable.push(!!epochStat);
+    }
+    const mevCommission = mevRecord?.running_jito ? mevRecord.mev_commission_bps / 100 : 100;
+    return {
+        voteAccount,
+        name,
+        epochs,
+        currentMarinadeStake,
+        currentStake,
+        commission,
+        stake,
+        externalStake,
+        credits,
+        blocksProduced,
+        leaderSlots,
+        dataAvailable,
+        mevCommission,
+        country: validator.dc_country || 'Unknown',
+        city: validator.dc_full_city || 'Unknown',
+        aso: validator.dc_aso || 'Unknown',
+        blacklisted,
+        version: validator.version
+    };
+}
+exports.aggregateValidatorData = aggregateValidatorData;
+async function aggregateValidatorsData(validators, basicEligibilityEpochs, bonusEligibilityExtraEpochs, dataProvider) {
+    const lastEpoch = getMaxEpoch(validators);
+    const firstEpoch = lastEpoch - basicEligibilityEpochs - bonusEligibilityExtraEpochs;
+    const jitoMevRecords = await dataProvider.fetchValidatorsJitoMEV(true);
+    const blacklist = await dataProvider.fetchBlacklist(true);
+    const result = {};
+    for (const validator of validators) {
+        const mevRecord = jitoMevRecords[validator.vote_account] ?? {
+            vote_account: validator.vote_account,
+            mev_commission_bps: 100,
+            running_jito: false,
+            active_stake: Number(validator.activated_stake)
+        };
+        if (mevRecord) {
+            const aggregatedData = aggregateValidatorData(validator, mevRecord, blacklist, firstEpoch, lastEpoch);
+            result[validator.vote_account] = aggregatedData;
+        }
+    }
+    return result;
+}
+exports.aggregateValidatorsData = aggregateValidatorsData;
+function getMaxEpoch(validators) {
+    return validators.reduce((maxEpoch, validator) => {
+        const validatorMaxEpoch = validator.epoch_stats.reduce((max, { epoch }) => {
+            return Math.max(epoch, max);
+        }, 0);
+        return Math.max(maxEpoch, validatorMaxEpoch);
+    }, 0);
+}
+exports.getMaxEpoch = getMaxEpoch;
+function selectExternalStakeMin(validator, fullEpochs) {
+    if (validator.externalStake.length === 0) {
+        throw new Error('Validator has no external stake data.');
+    }
+    return Math.min(...validator.externalStake.slice(0, fullEpochs + 1));
+}
+exports.selectExternalStakeMin = selectExternalStakeMin;
+function selectCreditsPctMean(validator, clusterInfo, fullEpochs) {
+    return (0, maths_1.mean)(validator.epochs.slice(1, fullEpochs + 1).map((epoch, fullEpochIndex) => (validator.credits[fullEpochIndex + 1] ?? 0) / (clusterInfo.targetCreditsByEpoch.get(epoch) ?? 1)));
+}
+exports.selectCreditsPctMean = selectCreditsPctMean;
+function selectBlockProductionMean(validator, fullEpochs) {
+    const leaderSlots = (0, maths_1.sum)(validator.leaderSlots.slice(1, fullEpochs + 1));
+    return leaderSlots === 0 ? 1 : (0, maths_1.sum)(validator.blocksProduced.slice(1, fullEpochs + 1)) / leaderSlots;
+}
+exports.selectBlockProductionMean = selectBlockProductionMean;
+function selectCommissionInflationMax(validator, epochs) {
+    return Math.max(...validator.commission.slice(0, epochs));
+}
+exports.selectCommissionInflationMax = selectCommissionInflationMax;
+function selectCommissionMEV(validator) {
+    return validator.mevCommission;
+}
+exports.selectCommissionMEV = selectCommissionMEV;
+function selectCountryStakeConcentration(validator, clusterInfo) {
+    return clusterInfo.country.get(validator.country ?? '???') ?? 0;
+}
+exports.selectCountryStakeConcentration = selectCountryStakeConcentration;
+function selectCityStakeConcentration(validator, clusterInfo) {
+    return clusterInfo.city.get(validator.city ?? '???') ?? 0;
+}
+exports.selectCityStakeConcentration = selectCityStakeConcentration;
+function selectASOStakeConcentration(validator, clusterInfo) {
+    return clusterInfo.aso.get(validator.aso ?? '???') ?? 0;
+}
+exports.selectASOStakeConcentration = selectASOStakeConcentration;
+function selectNodeStake(validator) {
+    return validator.stake[0] ?? 0;
+}
+exports.selectNodeStake = selectNodeStake;
+//# sourceMappingURL=validators.js.map

package/dist/computing/validators.js.map

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

package/dist/constants/marinade.json

@@ -0,0 +1,38 @@
+{
+    "DS_PUBKEY": "MarinadeA1gorithmicDe1egationStrategy111111",
+    "REWARDS_PAST_EPOCHS": 14,
+    "CAP_FROM_BOND": 1000000000,
+    "formulaStakeBlockSize": "tvl / ((6000000 /  30000) * 1.5 ^ (log(tvl / 6000000) / log(2)))",
+    "formulaStakeBlocksFromScore": "1 + ((max(0.94, score) - 0.94) / (1 - 0.94)) ^ 10",
+    "formulaVoteCredits": "min(credits_pct_mean ^ 10, 1)",
+    "formulaBlockProduction": "piecewise((bp_mean - bp_cluster_mean) / bp_cluster_std_dev < -1, bp_mean / (bp_cluster_mean - bp_cluster_std_dev), 1)",
+    "formulaInflationCommission": "piecewise(commission_inflation_max <= 10, (100 - commission_inflation_max) / 100, 0)",
+    "formulaMEVCommission": "(100 - commission_mev) / 100",
+    "formulaStakeConcentrationCountry": "piecewise(country_stake_concentration_last < 1/3, (1 - (3 * country_stake_concentration_last)) ^ (1/3), 0)",
+    "formulaStakeConcentrationCity": "piecewise(city_stake_concentration_last < 1/3, (1 - (3 * city_stake_concentration_last)) ^ (1/3), 0)",
+    "formulaStakeConcentrationASO": "piecewise(aso_stake_concentration_last < 1/3, (1 - (3 * aso_stake_concentration_last)) ^ (1/3), 0)",
+    "formulaStakeConcentrationNode": "piecewise(node_stake_last < 100000, 1, node_stake_last < 4000000, 1 - (node_stake_last - 100000) / (4000000 - 100000), 0)",
+    "weightTargetSumOfRewards": 5,
+    "weightMevHeuristic": 0.1,
+    "weightVoteCredits": 10,
+    "weightBlockProduction": 5,
+    "weightInflationCommission": 4.9,
+    "weightMEVCommission": 0.1,
+    "weightStakeConcentrationCountry": 2,
+    "weightStakeConcentrationCity": 3,
+    "weightStakeConcentrationASO": 4,
+    "weightStakeConcentrationNode": 2,
+    "basicEligibilityEpochs": 14,
+    "bonusEligibilityExtraEpochs": 0,
+    "maxCommission": 7,
+    "voteCreditsWarning": 0,
+    "voteCreditsLow": 80,
+    "minExternalStake": 0,
+    "minScore": 0.8,
+    "maxStakeShare": 0.8,
+    "maxWarnings": 1,
+    "mSolControl": 0.2,
+    "veMndeControl": 0.2,
+    "stakeBlocksFromBonus": 0,
+    "concentrationParams": [4, 5, 6, 7]
+}

package/dist/dto/bonds.dto.d.ts

@@ -0,0 +1,12 @@
+export type BondDto = {
+    pubkey: string;
+    vote_account: string;
+    authority: string;
+    cpmpe: number;
+    updated_at: string;
+    epoch: number;
+};
+export type BondsDto = {
+    bonds: BondDto[];
+};
+export type Bonds = Record<string, number>;

package/dist/dto/bonds.dto.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=bonds.dto.js.map

package/dist/dto/bonds.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bonds.dto.js","sourceRoot":"","sources":["../../src/dto/bonds.dto.ts"],"names":[],"mappings":""}

package/dist/dto/cluster.dto.d.ts

@@ -0,0 +1,12 @@
+export type ClusterInfo = {
+    city: Map<string, number>;
+    country: Map<string, number>;
+    aso: Map<string, number>;
+    targetCreditsByEpoch: Map<number, number>;
+    meanBlockProductionOverBasicEligibilityPeriod: number;
+    stdDevBlockProductionOverBasicEligibilityPeriod: number;
+};
+export type BlockProductionResult = {
+    mean: number;
+    stdDev: number;
+};

package/dist/dto/cluster.dto.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=cluster.dto.js.map

package/dist/dto/cluster.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster.dto.js","sourceRoot":"","sources":["../../src/dto/cluster.dto.ts"],"names":[],"mappings":""}

package/{src/dto/eligibility.dto.ts → dist/dto/eligibility.dto.d.ts}

@@ -8,36 +8,31 @@ export type EligibilityConfig = {
     minScore: number;
     maxStakeShare: number;
     maxWarnings: number;
-}
-
+};
 export type ValidatorEligibility = {
     basicEligibility: boolean;
     bonusEligibility: boolean;
     issuesCollection: Issue[][];
     capFromBond: number;
     capFromExternalStake: number;
-}
-
+};
 export type EvaluationResult = {
     criticals: number;
     warnings: number;
-}
-
+};
 export type Issue = {
     type: IssueType;
     message: string;
+};
+export declare const enum IssueType {
+    NO_DATA = "NO_DATA",
+    NO_BOND = "NO_BOND",
+    SCORE = "SCORE",
+    BLACKLIST = "BLACKLIST",
+    COMMISSION = "COMMISSION",
+    EXTERNAL_STAKE = "EXTERNAL_STAKE",
+    CENTRALIZATION = "CENTRALIZATION",
+    VOTE_CREDITS_LOW = "VOTE_CREDITS_LOW",
+    VOTE_CREDITS_WARNING = "VOTE_CREDITS_WARNING"
 }
-
-export const enum IssueType {
-    NO_DATA = 'NO_DATA',
-    NO_BOND = 'NO_BOND',
-    SCORE = 'SCORE',
-    BLACKLIST = 'BLACKLIST',
-    COMMISSION = 'COMMISSION',
-    EXTERNAL_STAKE = 'EXTERNAL_STAKE',
-    CENTRALIZATION = 'CENTRALIZATION',
-    VOTE_CREDITS_LOW = 'VOTE_CREDITS_LOW',
-    VOTE_CREDITS_WARNING = 'VOTE_CREDITS_WARNING',
-}
-
-export type ValidatorsEligibilities = Record<string, ValidatorEligibility>
+export type ValidatorsEligibilities = Record<string, ValidatorEligibility>;

package/dist/dto/eligibility.dto.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=eligibility.dto.js.map

package/dist/dto/eligibility.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eligibility.dto.js","sourceRoot":"","sources":["../../src/dto/eligibility.dto.ts"],"names":[],"mappings":""}

package/dist/dto/jito.dto.d.ts

@@ -0,0 +1,9 @@
+export declare class JitoValidatorDto {
+    vote_account: string;
+    mev_commission_bps: number;
+    running_jito: boolean;
+    active_stake: number;
+}
+export declare class JitoValidatorsResponseDto {
+    validators: JitoValidatorDto[];
+}

package/dist/dto/jito.dto.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JitoValidatorsResponseDto = exports.JitoValidatorDto = void 0;
+class JitoValidatorDto {
+}
+exports.JitoValidatorDto = JitoValidatorDto;
+class JitoValidatorsResponseDto {
+}
+exports.JitoValidatorsResponseDto = JitoValidatorsResponseDto;
+//# sourceMappingURL=jito.dto.js.map

package/dist/dto/jito.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jito.dto.js","sourceRoot":"","sources":["../../src/dto/jito.dto.ts"],"names":[],"mappings":";;;AAAA,MAAa,gBAAgB;CAK5B;AALD,4CAKC;AACD,MAAa,yBAAyB;CAErC;AAFD,8DAEC"}

package/dist/dto/marinade.dto.d.ts

@@ -0,0 +1,18 @@
+export type TvlStats = {
+    staked_sol: number;
+    staked_usd: number;
+    msol_directed_stake_sol: number;
+    msol_directed_stake_msol: number;
+    liquidity_sol: number;
+    liquidity_usd: number;
+    total_sol: number;
+    total_usd: number;
+    self_staked_sol: number;
+    self_staked_usd: number;
+    standard_staked_sol: number;
+    standard_staked_usd: number;
+    total_virtual_staked_sol: number;
+    total_virtual_staked_usd: number;
+    marinade_native_stake_sol: number;
+    marinade_native_stake_usd: number;
+};

package/dist/dto/marinade.dto.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=marinade.dto.js.map

package/dist/dto/marinade.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marinade.dto.js","sourceRoot":"","sources":["../../src/dto/marinade.dto.ts"],"names":[],"mappings":""}

package/dist/dto/rewards.dto.d.ts

@@ -0,0 +1,17 @@
+export declare class RewardPairDto {
+    epoch: number;
+    amount: number;
+    constructor(pair: [number, number]);
+}
+export declare class RewardsResponseDto {
+    rewards_mev: RewardPairDto[];
+    rewards_inflation_est: RewardPairDto[];
+    constructor(data: {
+        rewards_mev: [number, number][];
+        rewards_inflation_est: [number, number][];
+    });
+}
+export type Rewards = {
+    inflation: number;
+    mev: number;
+};

package/dist/dto/rewards.dto.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RewardsResponseDto = exports.RewardPairDto = void 0;
+class RewardPairDto {
+    constructor(pair) {
+        this.epoch = pair[0];
+        this.amount = pair[1];
+    }
+}
+exports.RewardPairDto = RewardPairDto;
+class RewardsResponseDto {
+    constructor(data) {
+        this.rewards_mev = data.rewards_mev.map(pair => new RewardPairDto(pair));
+        this.rewards_inflation_est = data.rewards_inflation_est.map(pair => new RewardPairDto(pair));
+    }
+}
+exports.RewardsResponseDto = RewardsResponseDto;
+//# sourceMappingURL=rewards.dto.js.map

package/dist/dto/rewards.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewards.dto.js","sourceRoot":"","sources":["../../src/dto/rewards.dto.ts"],"names":[],"mappings":";;;AAAA,MAAa,aAAa;IAIxB,YAAa,IAAsB;QACjC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;CACF;AARD,sCAQC;AACD,MAAa,kBAAkB;IAI7B,YAAa,IAAoF;QAC/F,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/F,CAAC;CACF;AARD,gDAQC"}