@xyo-network/crypto-nft-collection-diviner-score-plugin 2.71.4 → 2.71.5

package/dist/cjs/lib/rating/criteria/index.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.scoringCriteria = void 0;
 const scoring_1 = require("./scoring");
-exports.scoringCriteria = Object.assign(Object.assign({}, scoring_1.scoreMetadata), { Total: { score: scoring_1.scoreTotal, weight: 1 } });
+exports.scoringCriteria = Object.assign(Object.assign({}, scoring_1.scoreMetadata), { Total: { score: scoring_1.scoreTotal, weight: 2 } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/lib/rating/criteria/scoring/metadata/scoreIndividualAttributes.js

@@ -5,6 +5,9 @@ const crypto_nft_score_model_1 = require("@xyo-network/crypto-nft-score-model");
 const maxScore = 10;
 const scoreIndividualAttributes = (info) => {
     const { attributes } = info.metrics.metadata;
+    const entries = Object.entries(attributes);
+    if (entries.length === 0)
+        return [0, maxScore];
     const scores = Object.entries(attributes)
         .map(([_trait, { values }]) => {
         return Object.entries(values).map(([_traitValue, metrics]) => {

package/dist/cjs/lib/rating/criteria/scoring/metadata/scoreIndividualAttributes.js.map

@@ -1 +1 @@
-{"version":3,"file":"scoreIndividualAttributes.js","sourceRoot":"","sources":["../../../../../../../src/lib/rating/criteria/scoring/metadata/scoreIndividualAttributes.ts"],"names":[],"mappings":";;;AACA,gFAAsE;AAEtE,MAAM,QAAQ,GAAG,EAAE,CAAA;AAEZ,MAAM,yBAAyB,GAAG,CAAC,IAAmC,EAAS,EAAE;IACtF,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;QAC5B,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAQ,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE;YAClE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAA;YAClF,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC;SACD,IAAI,EAAE,CAAA;IACT,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC9E,OAAO,IAAA,kCAAS,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACnC,CAAC,CAAA;AAZY,QAAA,yBAAyB,6BAYrC"}
+{"version":3,"file":"scoreIndividualAttributes.js","sourceRoot":"","sources":["../../../../../../../src/lib/rating/criteria/scoring/metadata/scoreIndividualAttributes.ts"],"names":[],"mappings":";;;AACA,gFAAsE;AAEtE,MAAM,QAAQ,GAAG,EAAE,CAAA;AAEZ,MAAM,yBAAyB,GAAG,CAAC,IAAmC,EAAS,EAAE;IACtF,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;IAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;QAC5B,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAQ,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE;YAClE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAA;YAClF,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC;SACD,IAAI,EAAE,CAAA;IACT,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC9E,OAAO,IAAA,kCAAS,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACnC,CAAC,CAAA;AAdY,QAAA,yBAAyB,6BAcrC"}

package/dist/cjs/lib/rating/criteria/scoring/metadata/scoreTotalAttributes.js

@@ -3,14 +3,61 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.scoreTotalAttributes = void 0;
 const crypto_nft_score_model_1 = require("@xyo-network/crypto-nft-score-model");
 const maxScore = 10;
+/**
+ * Mean: What value is the distribution centered around
+ */
+const defaultMu = 0.15;
+/**
+ * Standard Deviation: How spread out is the distribution
+ */
+const defaultSigma = 0.1;
+/**
+ * Calculates the Gaussian probability density
+ * @param x
+ * @param mu Mean
+ * @param sigma Standard Deviation
+ * @returns
+ */
+const gaussianProbabilityDensity = (x, mu = defaultMu, sigma = defaultSigma) => {
+    const sqrtTwoPi = Math.sqrt(2 * Math.PI);
+    const denominator = sigma * sqrtTwoPi;
+    const power = -0.5 * Math.pow((x - mu) / sigma, 2);
+    return (1 / denominator) * Math.exp(power);
+};
+/**
+ * For a Gaussian distribution, the peak of the distribution is the mean
+ */
+const maxProbabilityDensity = gaussianProbabilityDensity(defaultMu);
+/**
+ * We're working on some assumptions here:
+ *
+ * - If you have a 100% chance of getting a trait, everyone get's a trophy
+ * - If you have a 50% chance of getting a trait, it's not rare
+ * - If you have a 0% chance of getting a trait, it's not fun
+ *
+ * So we're looking for something Pareto-ish (somewhere between
+ * 80/20 or 90/10) as that's a good & sustainable model for the
+ * distribution of many traits in real life.
+ * However, we also don't want to maximally reward collections
+ * that have a lot of single attributes distributed uniformly
+ * (basically a 0% trait probably) as that's perfectly entropic
+ * but not very interesting (some overlap is desirable).
+ * So we're using a Gaussian distribution to model the
+ * probability density of the joint probability of all traits
+ * centered around 15%.
+ * @param info
+ * @returns
+ */
 const scoreTotalAttributes = (info) => {
     const { attributes } = info.metrics.metadata;
-    const scores = Object.entries(attributes).map(([_trait, { metrics }]) => {
-        const rarity = Math.floor((1 - metrics.binomial.p) * 100);
-        return [rarity, 100];
-    });
-    const total = scores.reduce(([a, b], [c, d]) => [a + c, b + d], [0, 0]);
-    return (0, crypto_nft_score_model_1.normalize)(total, maxScore);
+    // This has somewhat of a filtering function by causing anything with 100% probability to
+    // add no value to the end score
+    const jointProbability = Object.entries(attributes).reduce((acc, [_trait, { metrics }]) => {
+        return acc * metrics.binomial.p;
+    }, 1);
+    const probabilityDensity = gaussianProbabilityDensity(jointProbability);
+    const score = [probabilityDensity, maxProbabilityDensity];
+    return (0, crypto_nft_score_model_1.normalize)(score, maxScore);
 };
 exports.scoreTotalAttributes = scoreTotalAttributes;
 //# sourceMappingURL=scoreTotalAttributes.js.map

package/dist/cjs/lib/rating/criteria/scoring/metadata/scoreTotalAttributes.js.map

@@ -1 +1 @@
-{"version":3,"file":"scoreTotalAttributes.js","sourceRoot":"","sources":["../../../../../../../src/lib/rating/criteria/scoring/metadata/scoreTotalAttributes.ts"],"names":[],"mappings":";;;AACA,gFAAsE;AAEtE,MAAM,QAAQ,GAAG,EAAE,CAAA;AAEZ,MAAM,oBAAoB,GAAG,CAAC,IAAmC,EAAS,EAAE;IACjF,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE;QAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAA;QACzD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACtB,CAAC,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC9E,OAAO,IAAA,kCAAS,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACnC,CAAC,CAAA;AARY,QAAA,oBAAoB,wBAQhC"}
+{"version":3,"file":"scoreTotalAttributes.js","sourceRoot":"","sources":["../../../../../../../src/lib/rating/criteria/scoring/metadata/scoreTotalAttributes.ts"],"names":[],"mappings":";;;AACA,gFAAsE;AAEtE,MAAM,QAAQ,GAAG,EAAE,CAAA;AAEnB;;GAEG;AACH,MAAM,SAAS,GAAG,IAAI,CAAA;AAEtB;;GAEG;AACH,MAAM,YAAY,GAAG,GAAG,CAAA;AAExB;;;;;;GAMG;AACH,MAAM,0BAA0B,GAAG,CAAC,CAAS,EAAE,KAAa,SAAS,EAAE,QAAgB,YAAY,EAAU,EAAE;IAC7G,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAA;IACxC,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,CAAA;IACrC,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAA;IAClD,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AAC5C,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,qBAAqB,GAAG,0BAA0B,CAAC,SAAS,CAAC,CAAA;AAEnE;;;;;;;;;;;;;;;;;;;GAmBG;AACI,MAAM,oBAAoB,GAAG,CAAC,IAAmC,EAAS,EAAE;IACjF,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IAC5C,yFAAyF;IACzF,gCAAgC;IAChC,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE;QACxF,OAAO,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IACjC,CAAC,EAAE,CAAC,CAAC,CAAA;IACL,MAAM,kBAAkB,GAAG,0BAA0B,CAAC,gBAAgB,CAAC,CAAA;IACvE,MAAM,KAAK,GAAU,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAA;IAChE,OAAO,IAAA,kCAAS,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACnC,CAAC,CAAA;AAVY,QAAA,oBAAoB,wBAUhC"}

package/dist/cjs/lib/rating/criteria/scoring/total.js

@@ -2,12 +2,15 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.scoreTotal = void 0;
 const crypto_nft_score_model_1 = require("@xyo-network/crypto-nft-score-model");
-const median = 100000;
+/**
+ * This "magic" value was obtained using Solver in Excel
+ * to find the median, with mu/sigma fixed, which maximizes
+ * the distribution (the mode for lognormal) at 10,000
+ */
+const median = 81030839.8217352;
 const defaultMu = Math.log(median);
-const defaultSigma = 2;
-// const mean = Math.exp(defaultMu + Math.pow(defaultSigma, 2) / 2)
+const defaultSigma = 3;
 const mode = Math.exp(defaultMu - Math.pow(defaultSigma, 2));
-// console.log(`mean: ${mean} median: ${median} mode: ${mode}`)
 /**
  * Calculates the log-normal probability density
  * @param x the value at which you want to calculate the probability density
@@ -25,8 +28,19 @@ const logNormalProbabilityDensity = (x, mu = defaultMu, sigma = defaultSigma) =>
  * For a lognormal distribution, the peak of the distribution is the mode
  */
 const maxProbabilityDensity = logNormalProbabilityDensity(mode);
-// console.log(`mode: ${mode} maxDensity: ${maxProbabilityDensity}`)
 const maxScore = 10;
+/**
+ * We're working on some assumptions here:
+ * - If there's < 1000 NFTs in your collection it starts becoming too niche
+ * - If there's > 20,000 NFTs in your collection it starts becoming too broad
+ * So there's a sweet spot somewhere between 2000 and 10,000
+ * where a collection has enough NFTs to be interesting, but
+ * not so many that it's teetering on a diluted money grab.
+ * To model that we're using a log-normal distribution optimized
+ * to maximally reward collections in the aforementioned range
+ * @param nft
+ * @returns
+ */
 const scoreTotal = (nft) => {
     const density = logNormalProbabilityDensity(nft.total);
     const score = [density, maxProbabilityDensity];

package/dist/cjs/lib/rating/criteria/scoring/total.js.map

@@ -1 +1 @@
-{"version":3,"file":"total.js","sourceRoot":"","sources":["../../../../../../src/lib/rating/criteria/scoring/total.ts"],"names":[],"mappings":";;;AACA,gFAAsE;AAEtE,MAAM,MAAM,GAAG,MAAM,CAAA;AACrB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AAClC,MAAM,YAAY,GAAG,CAAC,CAAA;AACtB,mEAAmE;AACnE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAA;AAC5D,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,2BAA2B,GAAG,CAAC,CAAS,EAAE,KAAa,SAAS,EAAE,QAAgB,YAAY,EAAU,EAAE;IAC9G,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACxB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;AACvG,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,qBAAqB,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAA;AAC/D,oEAAoE;AAEpE,MAAM,QAAQ,GAAG,EAAE,CAAA;AAEZ,MAAM,UAAU,GAAG,CAAC,GAAuB,EAAS,EAAE;IAC3D,MAAM,OAAO,GAAG,2BAA2B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACtD,MAAM,KAAK,GAAU,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAA;IACrD,OAAO,IAAA,kCAAS,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACnC,CAAC,CAAA;AAJY,QAAA,UAAU,cAItB"}
+{"version":3,"file":"total.js","sourceRoot":"","sources":["../../../../../../src/lib/rating/criteria/scoring/total.ts"],"names":[],"mappings":";;;AACA,gFAAsE;AAEtE;;;;GAIG;AACH,MAAM,MAAM,GAAG,gBAAgB,CAAA;AAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AAClC,MAAM,YAAY,GAAG,CAAC,CAAA;AACtB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAA;AAC5D;;;;;;GAMG;AACH,MAAM,2BAA2B,GAAG,CAAC,CAAS,EAAE,KAAa,SAAS,EAAE,QAAgB,YAAY,EAAU,EAAE;IAC9G,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACxB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;AACvG,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,qBAAqB,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAA;AAE/D,MAAM,QAAQ,GAAG,EAAE,CAAA;AAEnB;;;;;;;;;;;GAWG;AACI,MAAM,UAAU,GAAG,CAAC,GAAuB,EAAS,EAAE;IAC3D,MAAM,OAAO,GAAG,2BAA2B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACtD,MAAM,KAAK,GAAU,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAA;IACrD,OAAO,IAAA,kCAAS,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACnC,CAAC,CAAA;AAJY,QAAA,UAAU,cAItB"}

package/dist/docs.json

@@ -16,7 +16,7 @@
 					"fileName": "plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/index.ts",
 					"line": 9,
 					"character": 0,
-					"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/a0f34ef7cfcd4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/index.ts#L9"
+					"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/746cc37b4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/index.ts#L9"
 				}
 			],
 			"target": 1
@@ -3966,7 +3966,7 @@
 							"fileName": "plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts",
 							"line": 29,
 							"character": 18,
-							"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/a0f34ef7cfcd4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts#L29"
+							"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/746cc37b4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts#L29"
 						}
 					],
 					"type": {
@@ -7567,7 +7567,7 @@
 							"fileName": "plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts",
 							"line": 31,
 							"character": 21,
-							"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/a0f34ef7cfcd4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts#L31"
+							"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/746cc37b4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts#L31"
 						}
 					],
 					"signatures": [
@@ -7582,7 +7582,7 @@
 									"fileName": "plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts",
 									"line": 31,
 									"character": 37,
-									"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/a0f34ef7cfcd4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts#L31"
+									"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/746cc37b4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts#L31"
 								}
 							],
 							"parameters": [
@@ -16213,7 +16213,7 @@
 					"fileName": "plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts",
 					"line": 26,
 					"character": 13,
-					"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/a0f34ef7cfcd4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts#L26"
+					"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/746cc37b4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts#L26"
 				}
 			],
 			"typeParameters": [
@@ -16268,7 +16268,7 @@
 					"fileName": "plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/lib/rating/analyzeNftCollection.ts",
 					"line": 8,
 					"character": 12,
-					"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/a0f34ef7cfcd4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/lib/rating/analyzeNftCollection.ts#L8"
+					"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/746cc37b4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/lib/rating/analyzeNftCollection.ts#L8"
 				}
 			],
 			"type": {
@@ -16302,7 +16302,7 @@
 					"fileName": "plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts",
 					"line": 18,
 					"character": 12,
-					"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/a0f34ef7cfcd4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts#L18"
+					"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/746cc37b4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Diviner.ts#L18"
 				}
 			],
 			"type": {
@@ -16348,7 +16348,7 @@
 					"fileName": "plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/lib/rating/analyzeNftCollection.ts",
 					"line": 6,
 					"character": 12,
-					"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/a0f34ef7cfcd4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/lib/rating/analyzeNftCollection.ts#L6"
+					"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/746cc37b4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/lib/rating/analyzeNftCollection.ts#L6"
 				}
 			],
 			"type": {
@@ -16393,7 +16393,7 @@
 					"fileName": "plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Plugin.ts",
 					"line": 7,
 					"character": 13,
-					"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/a0f34ef7cfcd4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Plugin.ts#L7"
+					"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/746cc37b4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Plugin.ts#L7"
 				}
 			],
 			"signatures": [
@@ -16408,7 +16408,7 @@
 							"fileName": "plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Plugin.ts",
 							"line": 7,
 							"character": 47,
-							"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/a0f34ef7cfcd4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Plugin.ts#L7"
+							"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/746cc37b4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/Plugin.ts#L7"
 						}
 					],
 					"type": {
@@ -17983,7 +17983,7 @@
 					"fileName": "plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/lib/rating/analyzeNftCollection.ts",
 					"line": 12,
 					"character": 13,
-					"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/a0f34ef7cfcd4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/lib/rating/analyzeNftCollection.ts#L12"
+					"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/746cc37b4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/lib/rating/analyzeNftCollection.ts#L12"
 				}
 			],
 			"signatures": [
@@ -17998,7 +17998,7 @@
 							"fileName": "plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/lib/rating/analyzeNftCollection.ts",
 							"line": 12,
 							"character": 36,
-							"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/a0f34ef7cfcd4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/lib/rating/analyzeNftCollection.ts#L12"
+							"url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/blob/746cc37b4/packages/plugins/packages/payloadset/packages/crypto/packages/nft/packages/collection/diviner/src/lib/rating/analyzeNftCollection.ts#L12"
 						}
 					],
 					"parameters": [

package/dist/esm/lib/rating/criteria/index.js

@@ -1,6 +1,6 @@
 import { scoreMetadata, scoreTotal } from './scoring';
 export const scoringCriteria = {
     ...scoreMetadata,
-    Total: { score: scoreTotal, weight: 1 },
+    Total: { score: scoreTotal, weight: 2 },
 };
 //# sourceMappingURL=index.js.map

package/dist/esm/lib/rating/criteria/scoring/metadata/scoreIndividualAttributes.js

@@ -2,6 +2,9 @@ import { normalize } from '@xyo-network/crypto-nft-score-model';
 const maxScore = 10;
 export const scoreIndividualAttributes = (info) => {
     const { attributes } = info.metrics.metadata;
+    const entries = Object.entries(attributes);
+    if (entries.length === 0)
+        return [0, maxScore];
     const scores = Object.entries(attributes)
         .map(([_trait, { values }]) => {
         return Object.entries(values).map(([_traitValue, metrics]) => {

package/dist/esm/lib/rating/criteria/scoring/metadata/scoreIndividualAttributes.js.map

@@ -1 +1 @@
-{"version":3,"file":"scoreIndividualAttributes.js","sourceRoot":"","sources":["../../../../../../../src/lib/rating/criteria/scoring/metadata/scoreIndividualAttributes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAS,MAAM,qCAAqC,CAAA;AAEtE,MAAM,QAAQ,GAAG,EAAE,CAAA;AAEnB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,IAAmC,EAAS,EAAE;IACtF,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;QAC5B,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAQ,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE;YAClE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAA;YAClF,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC;SACD,IAAI,EAAE,CAAA;IACT,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC9E,OAAO,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACnC,CAAC,CAAA"}
+{"version":3,"file":"scoreIndividualAttributes.js","sourceRoot":"","sources":["../../../../../../../src/lib/rating/criteria/scoring/metadata/scoreIndividualAttributes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAS,MAAM,qCAAqC,CAAA;AAEtE,MAAM,QAAQ,GAAG,EAAE,CAAA;AAEnB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,IAAmC,EAAS,EAAE;IACtF,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;IAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAA;IAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;QAC5B,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAQ,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,EAAE;YAClE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAA;YAClF,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QAC3B,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC;SACD,IAAI,EAAE,CAAA;IACT,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC9E,OAAO,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACnC,CAAC,CAAA"}

package/dist/esm/lib/rating/criteria/scoring/metadata/scoreTotalAttributes.js

@@ -1,12 +1,59 @@
 import { normalize } from '@xyo-network/crypto-nft-score-model';
 const maxScore = 10;
+/**
+ * Mean: What value is the distribution centered around
+ */
+const defaultMu = 0.15;
+/**
+ * Standard Deviation: How spread out is the distribution
+ */
+const defaultSigma = 0.1;
+/**
+ * Calculates the Gaussian probability density
+ * @param x
+ * @param mu Mean
+ * @param sigma Standard Deviation
+ * @returns
+ */
+const gaussianProbabilityDensity = (x, mu = defaultMu, sigma = defaultSigma) => {
+    const sqrtTwoPi = Math.sqrt(2 * Math.PI);
+    const denominator = sigma * sqrtTwoPi;
+    const power = -0.5 * Math.pow((x - mu) / sigma, 2);
+    return (1 / denominator) * Math.exp(power);
+};
+/**
+ * For a Gaussian distribution, the peak of the distribution is the mean
+ */
+const maxProbabilityDensity = gaussianProbabilityDensity(defaultMu);
+/**
+ * We're working on some assumptions here:
+ *
+ * - If you have a 100% chance of getting a trait, everyone get's a trophy
+ * - If you have a 50% chance of getting a trait, it's not rare
+ * - If you have a 0% chance of getting a trait, it's not fun
+ *
+ * So we're looking for something Pareto-ish (somewhere between
+ * 80/20 or 90/10) as that's a good & sustainable model for the
+ * distribution of many traits in real life.
+ * However, we also don't want to maximally reward collections
+ * that have a lot of single attributes distributed uniformly
+ * (basically a 0% trait probably) as that's perfectly entropic
+ * but not very interesting (some overlap is desirable).
+ * So we're using a Gaussian distribution to model the
+ * probability density of the joint probability of all traits
+ * centered around 15%.
+ * @param info
+ * @returns
+ */
 export const scoreTotalAttributes = (info) => {
     const { attributes } = info.metrics.metadata;
-    const scores = Object.entries(attributes).map(([_trait, { metrics }]) => {
-        const rarity = Math.floor((1 - metrics.binomial.p) * 100);
-        return [rarity, 100];
-    });
-    const total = scores.reduce(([a, b], [c, d]) => [a + c, b + d], [0, 0]);
-    return normalize(total, maxScore);
+    // This has somewhat of a filtering function by causing anything with 100% probability to
+    // add no value to the end score
+    const jointProbability = Object.entries(attributes).reduce((acc, [_trait, { metrics }]) => {
+        return acc * metrics.binomial.p;
+    }, 1);
+    const probabilityDensity = gaussianProbabilityDensity(jointProbability);
+    const score = [probabilityDensity, maxProbabilityDensity];
+    return normalize(score, maxScore);
 };
 //# sourceMappingURL=scoreTotalAttributes.js.map

package/dist/esm/lib/rating/criteria/scoring/metadata/scoreTotalAttributes.js.map

@@ -1 +1 @@
-{"version":3,"file":"scoreTotalAttributes.js","sourceRoot":"","sources":["../../../../../../../src/lib/rating/criteria/scoring/metadata/scoreTotalAttributes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAS,MAAM,qCAAqC,CAAA;AAEtE,MAAM,QAAQ,GAAG,EAAE,CAAA;AAEnB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAmC,EAAS,EAAE;IACjF,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAQ,CAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE;QAC7E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAA;QACzD,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACtB,CAAC,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC9E,OAAO,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACnC,CAAC,CAAA"}
+{"version":3,"file":"scoreTotalAttributes.js","sourceRoot":"","sources":["../../../../../../../src/lib/rating/criteria/scoring/metadata/scoreTotalAttributes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAS,MAAM,qCAAqC,CAAA;AAEtE,MAAM,QAAQ,GAAG,EAAE,CAAA;AAEnB;;GAEG;AACH,MAAM,SAAS,GAAG,IAAI,CAAA;AAEtB;;GAEG;AACH,MAAM,YAAY,GAAG,GAAG,CAAA;AAExB;;;;;;GAMG;AACH,MAAM,0BAA0B,GAAG,CAAC,CAAS,EAAE,KAAa,SAAS,EAAE,QAAgB,YAAY,EAAU,EAAE;IAC7G,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAA;IACxC,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,CAAA;IACrC,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAA;IAClD,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AAC5C,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,qBAAqB,GAAG,0BAA0B,CAAC,SAAS,CAAC,CAAA;AAEnE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAmC,EAAS,EAAE;IACjF,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;IAC5C,yFAAyF;IACzF,gCAAgC;IAChC,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE;QACxF,OAAO,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IACjC,CAAC,EAAE,CAAC,CAAC,CAAA;IACL,MAAM,kBAAkB,GAAG,0BAA0B,CAAC,gBAAgB,CAAC,CAAA;IACvE,MAAM,KAAK,GAAU,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAA;IAChE,OAAO,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACnC,CAAC,CAAA"}

package/dist/esm/lib/rating/criteria/scoring/total.js

@@ -1,10 +1,13 @@
 import { normalize } from '@xyo-network/crypto-nft-score-model';
-const median = 100000;
+/**
+ * This "magic" value was obtained using Solver in Excel
+ * to find the median, with mu/sigma fixed, which maximizes
+ * the distribution (the mode for lognormal) at 10,000
+ */
+const median = 81030839.8217352;
 const defaultMu = Math.log(median);
-const defaultSigma = 2;
-// const mean = Math.exp(defaultMu + Math.pow(defaultSigma, 2) / 2)
+const defaultSigma = 3;
 const mode = Math.exp(defaultMu - Math.pow(defaultSigma, 2));
-// console.log(`mean: ${mean} median: ${median} mode: ${mode}`)
 /**
  * Calculates the log-normal probability density
  * @param x the value at which you want to calculate the probability density
@@ -22,8 +25,19 @@ const logNormalProbabilityDensity = (x, mu = defaultMu, sigma = defaultSigma) =>
  * For a lognormal distribution, the peak of the distribution is the mode
  */
 const maxProbabilityDensity = logNormalProbabilityDensity(mode);
-// console.log(`mode: ${mode} maxDensity: ${maxProbabilityDensity}`)
 const maxScore = 10;
+/**
+ * We're working on some assumptions here:
+ * - If there's < 1000 NFTs in your collection it starts becoming too niche
+ * - If there's > 20,000 NFTs in your collection it starts becoming too broad
+ * So there's a sweet spot somewhere between 2000 and 10,000
+ * where a collection has enough NFTs to be interesting, but
+ * not so many that it's teetering on a diluted money grab.
+ * To model that we're using a log-normal distribution optimized
+ * to maximally reward collections in the aforementioned range
+ * @param nft
+ * @returns
+ */
 export const scoreTotal = (nft) => {
     const density = logNormalProbabilityDensity(nft.total);
     const score = [density, maxProbabilityDensity];

package/dist/esm/lib/rating/criteria/scoring/total.js.map

@@ -1 +1 @@
-{"version":3,"file":"total.js","sourceRoot":"","sources":["../../../../../../src/lib/rating/criteria/scoring/total.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAS,MAAM,qCAAqC,CAAA;AAEtE,MAAM,MAAM,GAAG,MAAM,CAAA;AACrB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AAClC,MAAM,YAAY,GAAG,CAAC,CAAA;AACtB,mEAAmE;AACnE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAA;AAC5D,+DAA+D;AAE/D;;;;;;GAMG;AACH,MAAM,2BAA2B,GAAG,CAAC,CAAS,EAAE,KAAa,SAAS,EAAE,QAAgB,YAAY,EAAU,EAAE;IAC9G,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACxB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;AACvG,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,qBAAqB,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAA;AAC/D,oEAAoE;AAEpE,MAAM,QAAQ,GAAG,EAAE,CAAA;AAEnB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAuB,EAAS,EAAE;IAC3D,MAAM,OAAO,GAAG,2BAA2B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACtD,MAAM,KAAK,GAAU,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAA;IACrD,OAAO,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACnC,CAAC,CAAA"}
+{"version":3,"file":"total.js","sourceRoot":"","sources":["../../../../../../src/lib/rating/criteria/scoring/total.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAS,MAAM,qCAAqC,CAAA;AAEtE;;;;GAIG;AACH,MAAM,MAAM,GAAG,gBAAgB,CAAA;AAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;AAClC,MAAM,YAAY,GAAG,CAAC,CAAA;AACtB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAA;AAC5D;;;;;;GAMG;AACH,MAAM,2BAA2B,GAAG,CAAC,CAAS,EAAE,KAAa,SAAS,EAAE,QAAgB,YAAY,EAAU,EAAE;IAC9G,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAA;IACpB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACxB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;AACvG,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,qBAAqB,GAAG,2BAA2B,CAAC,IAAI,CAAC,CAAA;AAE/D,MAAM,QAAQ,GAAG,EAAE,CAAA;AAEnB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAuB,EAAS,EAAE;IAC3D,MAAM,OAAO,GAAG,2BAA2B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACtD,MAAM,KAAK,GAAU,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAA;IACrD,OAAO,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;AACnC,CAAC,CAAA"}

package/dist/types/lib/rating/criteria/scoring/metadata/scoreIndividualAttributes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scoreIndividualAttributes.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/rating/criteria/scoring/metadata/scoreIndividualAttributes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAA;AACjG,OAAO,EAAa,KAAK,EAAE,MAAM,qCAAqC,CAAA;AAItE,eAAO,MAAM,yBAAyB,SAAU,6BAA6B,KAAG,KAY/E,CAAA"}
+{"version":3,"file":"scoreIndividualAttributes.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/rating/criteria/scoring/metadata/scoreIndividualAttributes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAA;AACjG,OAAO,EAAa,KAAK,EAAE,MAAM,qCAAqC,CAAA;AAItE,eAAO,MAAM,yBAAyB,SAAU,6BAA6B,KAAG,KAc/E,CAAA"}

package/dist/types/lib/rating/criteria/scoring/metadata/scoreTotalAttributes.d.ts

@@ -1,4 +1,24 @@
 import { NftCollectionAttributeMetrics } from '@xyo-network/crypto-nft-collection-payload-plugin';
 import { Score } from '@xyo-network/crypto-nft-score-model';
+/**
+ * We're working on some assumptions here:
+ *
+ * - If you have a 100% chance of getting a trait, everyone get's a trophy
+ * - If you have a 50% chance of getting a trait, it's not rare
+ * - If you have a 0% chance of getting a trait, it's not fun
+ *
+ * So we're looking for something Pareto-ish (somewhere between
+ * 80/20 or 90/10) as that's a good & sustainable model for the
+ * distribution of many traits in real life.
+ * However, we also don't want to maximally reward collections
+ * that have a lot of single attributes distributed uniformly
+ * (basically a 0% trait probably) as that's perfectly entropic
+ * but not very interesting (some overlap is desirable).
+ * So we're using a Gaussian distribution to model the
+ * probability density of the joint probability of all traits
+ * centered around 15%.
+ * @param info
+ * @returns
+ */
 export declare const scoreTotalAttributes: (info: NftCollectionAttributeMetrics) => Score;
 //# sourceMappingURL=scoreTotalAttributes.d.ts.map

package/dist/types/lib/rating/criteria/scoring/metadata/scoreTotalAttributes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scoreTotalAttributes.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/rating/criteria/scoring/metadata/scoreTotalAttributes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAA;AACjG,OAAO,EAAa,KAAK,EAAE,MAAM,qCAAqC,CAAA;AAItE,eAAO,MAAM,oBAAoB,SAAU,6BAA6B,KAAG,KAQ1E,CAAA"}
+{"version":3,"file":"scoreTotalAttributes.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/rating/criteria/scoring/metadata/scoreTotalAttributes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,mDAAmD,CAAA;AACjG,OAAO,EAAa,KAAK,EAAE,MAAM,qCAAqC,CAAA;AAiCtE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,oBAAoB,SAAU,6BAA6B,KAAG,KAU1E,CAAA"}

package/dist/types/lib/rating/criteria/scoring/total.d.ts

@@ -1,4 +1,16 @@
 import { NftCollectionCount } from '@xyo-network/crypto-nft-collection-payload-plugin';
 import { Score } from '@xyo-network/crypto-nft-score-model';
+/**
+ * We're working on some assumptions here:
+ * - If there's < 1000 NFTs in your collection it starts becoming too niche
+ * - If there's > 20,000 NFTs in your collection it starts becoming too broad
+ * So there's a sweet spot somewhere between 2000 and 10,000
+ * where a collection has enough NFTs to be interesting, but
+ * not so many that it's teetering on a diluted money grab.
+ * To model that we're using a log-normal distribution optimized
+ * to maximally reward collections in the aforementioned range
+ * @param nft
+ * @returns
+ */
 export declare const scoreTotal: (nft: NftCollectionCount) => Score;
 //# sourceMappingURL=total.d.ts.map

package/dist/types/lib/rating/criteria/scoring/total.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"total.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/rating/criteria/scoring/total.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAA;AACtF,OAAO,EAAa,KAAK,EAAE,MAAM,qCAAqC,CAAA;AA8BtE,eAAO,MAAM,UAAU,QAAS,kBAAkB,KAAG,KAIpD,CAAA"}
+{"version":3,"file":"total.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/rating/criteria/scoring/total.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAA;AACtF,OAAO,EAAa,KAAK,EAAE,MAAM,qCAAqC,CAAA;AA+BtE;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,QAAS,kBAAkB,KAAG,KAIpD,CAAA"}

package/package.json

@@ -10,15 +10,15 @@
     "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/issues"
   },
   "dependencies": {
-    "@xyo-network/abstract-diviner": "~2.71.4",
-    "@xyo-network/core": "~2.71.4",
-    "@xyo-network/crypto-nft-collection-payload-plugin": "~2.71.4",
-    "@xyo-network/crypto-nft-payload-plugin": "~2.71.4",
-    "@xyo-network/crypto-nft-score-model": "~2.71.4",
-    "@xyo-network/diviner-model": "~2.71.4",
-    "@xyo-network/module": "~2.71.4",
-    "@xyo-network/payload-model": "~2.71.4",
-    "@xyo-network/payloadset-plugin": "~2.71.4"
+    "@xyo-network/abstract-diviner": "~2.71.5",
+    "@xyo-network/core": "~2.71.5",
+    "@xyo-network/crypto-nft-collection-payload-plugin": "~2.71.5",
+    "@xyo-network/crypto-nft-payload-plugin": "~2.71.5",
+    "@xyo-network/crypto-nft-score-model": "~2.71.5",
+    "@xyo-network/diviner-model": "~2.71.5",
+    "@xyo-network/module": "~2.71.5",
+    "@xyo-network/payload-model": "~2.71.5",
+    "@xyo-network/payloadset-plugin": "~2.71.5"
   },
   "devDependencies": {
     "@xylabs/jest-helpers": "^2.9.3",
@@ -61,5 +61,5 @@
   },
   "sideEffects": false,
   "types": "dist/types/index.d.ts",
-  "version": "2.71.4"
+  "version": "2.71.5"
 }

package/src/lib/rating/criteria/index.ts

@@ -5,5 +5,5 @@ import { scoreMetadata, scoreTotal } from './scoring'
 
 export const scoringCriteria: { [key: string]: WeightedScoringCriteria<NftCollectionInfo> } = {
   ...scoreMetadata,
-  Total: { score: scoreTotal, weight: 1 },
+  Total: { score: scoreTotal, weight: 2 },
 }

package/src/lib/rating/criteria/scoring/metadata/scoreIndividualAttributes.ts

@@ -5,6 +5,8 @@ const maxScore = 10
 
 export const scoreIndividualAttributes = (info: NftCollectionAttributeMetrics): Score => {
   const { attributes } = info.metrics.metadata
+  const entries = Object.entries(attributes)
+  if (entries.length === 0) return [0, maxScore]
   const scores = Object.entries(attributes)
     .map(([_trait, { values }]) => {
       return Object.entries(values).map<Score>(([_traitValue, metrics]) => {

package/src/lib/rating/criteria/scoring/metadata/scoreTotalAttributes.ts

@@ -3,12 +3,63 @@ import { normalize, Score } from '@xyo-network/crypto-nft-score-model'
 
 const maxScore = 10
 
+/**
+ * Mean: What value is the distribution centered around
+ */
+const defaultMu = 0.15
+
+/**
+ * Standard Deviation: How spread out is the distribution
+ */
+const defaultSigma = 0.1
+
+/**
+ * Calculates the Gaussian probability density
+ * @param x
+ * @param mu Mean
+ * @param sigma Standard Deviation
+ * @returns
+ */
+const gaussianProbabilityDensity = (x: number, mu: number = defaultMu, sigma: number = defaultSigma): number => {
+  const sqrtTwoPi = Math.sqrt(2 * Math.PI)
+  const denominator = sigma * sqrtTwoPi
+  const power = -0.5 * Math.pow((x - mu) / sigma, 2)
+  return (1 / denominator) * Math.exp(power)
+}
+
+/**
+ * For a Gaussian distribution, the peak of the distribution is the mean
+ */
+const maxProbabilityDensity = gaussianProbabilityDensity(defaultMu)
+
+/**
+ * We're working on some assumptions here:
+ *
+ * - If you have a 100% chance of getting a trait, everyone get's a trophy
+ * - If you have a 50% chance of getting a trait, it's not rare
+ * - If you have a 0% chance of getting a trait, it's not fun
+ *
+ * So we're looking for something Pareto-ish (somewhere between
+ * 80/20 or 90/10) as that's a good & sustainable model for the
+ * distribution of many traits in real life.
+ * However, we also don't want to maximally reward collections
+ * that have a lot of single attributes distributed uniformly
+ * (basically a 0% trait probably) as that's perfectly entropic
+ * but not very interesting (some overlap is desirable).
+ * So we're using a Gaussian distribution to model the
+ * probability density of the joint probability of all traits
+ * centered around 15%.
+ * @param info
+ * @returns
+ */
 export const scoreTotalAttributes = (info: NftCollectionAttributeMetrics): Score => {
   const { attributes } = info.metrics.metadata
-  const scores = Object.entries(attributes).map<Score>(([_trait, { metrics }]) => {
-    const rarity = Math.floor((1 - metrics.binomial.p) * 100)
-    return [rarity, 100]
-  })
-  const total = scores.reduce<Score>(([a, b], [c, d]) => [a + c, b + d], [0, 0])
-  return normalize(total, maxScore)
+  // This has somewhat of a filtering function by causing anything with 100% probability to
+  // add no value to the end score
+  const jointProbability = Object.entries(attributes).reduce((acc, [_trait, { metrics }]) => {
+    return acc * metrics.binomial.p
+  }, 1)
+  const probabilityDensity = gaussianProbabilityDensity(jointProbability)
+  const score: Score = [probabilityDensity, maxProbabilityDensity]
+  return normalize(score, maxScore)
 }

package/src/lib/rating/criteria/scoring/total.ts

@@ -1,13 +1,15 @@
 import { NftCollectionCount } from '@xyo-network/crypto-nft-collection-payload-plugin'
 import { normalize, Score } from '@xyo-network/crypto-nft-score-model'
 
-const median = 100000
+/**
+ * This "magic" value was obtained using Solver in Excel
+ * to find the median, with mu/sigma fixed, which maximizes
+ * the distribution (the mode for lognormal) at 10,000
+ */
+const median = 81030839.8217352
 const defaultMu = Math.log(median)
-const defaultSigma = 2
-// const mean = Math.exp(defaultMu + Math.pow(defaultSigma, 2) / 2)
+const defaultSigma = 3
 const mode = Math.exp(defaultMu - Math.pow(defaultSigma, 2))
-// console.log(`mean: ${mean} median: ${median} mode: ${mode}`)
-
 /**
  * Calculates the log-normal probability density
  * @param x the value at which you want to calculate the probability density
@@ -25,10 +27,21 @@ const logNormalProbabilityDensity = (x: number, mu: number = defaultMu, sigma: n
  * For a lognormal distribution, the peak of the distribution is the mode
  */
 const maxProbabilityDensity = logNormalProbabilityDensity(mode)
-// console.log(`mode: ${mode} maxDensity: ${maxProbabilityDensity}`)
 
 const maxScore = 10
 
+/**
+ * We're working on some assumptions here:
+ * - If there's < 1000 NFTs in your collection it starts becoming too niche
+ * - If there's > 20,000 NFTs in your collection it starts becoming too broad
+ * So there's a sweet spot somewhere between 2000 and 10,000
+ * where a collection has enough NFTs to be interesting, but
+ * not so many that it's teetering on a diluted money grab.
+ * To model that we're using a log-normal distribution optimized
+ * to maximally reward collections in the aforementioned range
+ * @param nft
+ * @returns
+ */
 export const scoreTotal = (nft: NftCollectionCount): Score => {
   const density = logNormalProbabilityDensity(nft.total)
   const score: Score = [density, maxProbabilityDensity]