@xyo-network/crypto-nft-collection-witness-plugin 2.70.12 → 2.70.13

package/dist/esm/Witness.js

@@ -25,14 +25,15 @@ export class CryptoNftCollectionWitness extends AbstractWitness {
                 getNftCollectionNfts(address, chainId, this.account.private.hex, maxNfts),
                 this.writeArchivist(),
             ]);
-            const distribution = getNftCollectionMetrics(nfts);
+            const metrics = getNftCollectionMetrics(nfts);
             const [sources] = await Promise.all([
                 // Hash all the payloads
                 Promise.all(nfts.map((nft) => PayloadHasher.hashAsync(nft))),
                 // Insert them into the archivist if we have one
                 archivist ? archivist.insert(nfts) : NoOp,
             ]);
-            return { ...info, ...distribution, schema: NftCollectionSchema, sources, total };
+            const payload = { ...info, metrics, schema: NftCollectionSchema, sources, total };
+            return payload;
         }));
         return observations.flat();
     }

package/dist/esm/Witness.js.map

@@ -1 +1 @@
-{"version":3,"file":"Witness.js","sourceRoot":"","sources":["../../src/Witness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EACL,kCAAkC,EAElC,mBAAmB,EAEnB,gCAAgC,GACjC,MAAM,mDAAmD,CAAA;AAG1D,OAAO,EAAE,eAAe,EAAiB,MAAM,sBAAsB,CAAA;AAErE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,OAAO,CAAA;AAItH,MAAM,cAAc,GAAG,GAAG,CAAA;AAE1B;;;;GAIG;AACH,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAA;AAE9B,MAAM,OAAO,0BAEX,SAAQ,eAAwB;IAChC,MAAM,CAAU,aAAa,GAAG,CAAC,gCAAgC,CAAC,CAAA;IAE/C,KAAK,CAAC,cAAc,CAAC,QAAoB;QAC1D,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC3B,MAAM,OAAO,GAAG,QAAQ,EAAE,MAAM,CAAC,kCAAkC,CAAC,IAAI,EAAE,CAAA;QAC1E,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,OAAO,CAAC,GAAG,CAAoC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAA;YAC7F,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAA;YAC7F,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,IAAI,cAAc,CAAA;YAChD,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACvD,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;gBAChE,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;gBACrE,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC;gBACzE,IAAI,CAAC,cAAc,EAAE;aACtB,CAAC,CAAA;YACF,MAAM,YAAY,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAA;YAClD,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAClC,wBAAwB;gBACxB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC5D,gDAAgD;gBAChD,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;aAC1C,CAAC,CAAA;YACF,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,YAAY,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;QAClF,CAAC,CAAC,CACH,CAAA;QACD,OAAO,YAAY,CAAC,IAAI,EAAE,CAAA;IAC5B,CAAC"}
+{"version":3,"file":"Witness.js","sourceRoot":"","sources":["../../src/Witness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EACL,kCAAkC,EAElC,mBAAmB,EAEnB,gCAAgC,GACjC,MAAM,mDAAmD,CAAA;AAG1D,OAAO,EAAE,eAAe,EAAiB,MAAM,sBAAsB,CAAA;AAErE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,OAAO,CAAA;AAItH,MAAM,cAAc,GAAG,GAAG,CAAA;AAE1B;;;;GAIG;AACH,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAA;AAE9B,MAAM,OAAO,0BAEX,SAAQ,eAAwB;IAChC,MAAM,CAAU,aAAa,GAAG,CAAC,gCAAgC,CAAC,CAAA;IAE/C,KAAK,CAAC,cAAc,CAAC,QAAoB;QAC1D,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC3B,MAAM,OAAO,GAAG,QAAQ,EAAE,MAAM,CAAC,kCAAkC,CAAC,IAAI,EAAE,CAAA;QAC1E,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,OAAO,CAAC,GAAG,CAAoC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAA;YAC7F,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAA;YAC7F,MAAM,OAAO,GAAG,KAAK,EAAE,OAAO,IAAI,cAAc,CAAA;YAChD,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACvD,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;gBAChE,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;gBACrE,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC;gBACzE,IAAI,CAAC,cAAc,EAAE;aACtB,CAAC,CAAA;YACF,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAA;YAC7C,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAClC,wBAAwB;gBACxB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC5D,gDAAgD;gBAChD,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;aAC1C,CAAC,CAAA;YACF,MAAM,OAAO,GAA6B,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;YAC3G,OAAO,OAAO,CAAA;QAChB,CAAC,CAAC,CACH,CAAA;QACD,OAAO,YAAY,CAAC,IAAI,EAAE,CAAA;IAC5B,CAAC"}

package/dist/esm/lib/collectionMetrics/getNftCollectionMetrics.js

@@ -1,17 +1,24 @@
-import { calculateAllPropertiesDistribution } from './lib';
+import { calculateAllPropertiesDistribution, calculateBinomialParamsFromProbability } from './lib';
 export const getNftCollectionMetrics = (nfts) => {
-    const attributes = nfts
+    const traits = nfts
         .map((nft) => nft.metadata?.attributes)
         .map((attributes) => {
         return Object.fromEntries(attributes.map((attribute) => [attribute.trait_type, attribute.value]));
     });
-    const distribution = calculateAllPropertiesDistribution(attributes);
-    return {
-        distribution: {
-            metadata: {
-                attributes: distribution,
-            },
-        },
-    };
+    const distribution = calculateAllPropertiesDistribution(traits);
+    const n = nfts.length;
+    const attributes = Object.fromEntries(Object.entries(distribution)
+        .filter((v) => v[1] !== undefined)
+        .map(([trait, entries]) => {
+        const traitCount = Object.values(entries).reduce((prev, curr) => prev + curr, 0);
+        const { p } = calculateBinomialParamsFromProbability(nfts.length, traitCount / n);
+        const values = Object.fromEntries(Object.entries(entries).map(([value, traitValueCount]) => {
+            const { p } = calculateBinomialParamsFromProbability(n, traitValueCount / n);
+            const metrics = { binomial: { p }, count: traitValueCount };
+            return [value, metrics];
+        }));
+        return [trait, { metrics: { binomial: { p }, count: traitCount }, values }];
+    }));
+    return { metadata: { attributes } };
 };
 //# sourceMappingURL=getNftCollectionMetrics.js.map

package/dist/esm/lib/collectionMetrics/getNftCollectionMetrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"getNftCollectionMetrics.js","sourceRoot":"","sources":["../../../../src/lib/collectionMetrics/getNftCollectionMetrics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kCAAkC,EAAgB,MAAM,OAAO,CAAA;AAYxE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,IAAe,EAAwB,EAAE;IAC/E,MAAM,UAAU,GAAG,IAAI;SACpB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAmC,CAAC;SAC/D,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QAClB,OAAO,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACnG,CAAC,CAAC,CAAA;IACJ,MAAM,YAAY,GAAG,kCAAkC,CAAC,UAAU,CAAC,CAAA;IACnE,OAAO;QACL,YAAY,EAAE;YACZ,QAAQ,EAAE;gBACR,UAAU,EAAE,YAAY;aACzB;SACF;KACF,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"getNftCollectionMetrics.js","sourceRoot":"","sources":["../../../../src/lib/collectionMetrics/getNftCollectionMetrics.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kCAAkC,EAAE,sCAAsC,EAAE,MAAM,OAAO,CAAA;AAIlG,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,IAAe,EAAwB,EAAE;IAC/E,MAAM,MAAM,GAAG,IAAI;SAChB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAmC,CAAC;SAC/D,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QAClB,OAAO,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACnG,CAAC,CAAC,CAAA;IACJ,MAAM,YAAY,GAAG,kCAAkC,CAAC,MAAM,CAAC,CAAA;IAC/D,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAA;IACrB,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CACnC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC;SACzB,MAAM,CAAC,CAAC,CAAC,EAA+B,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;SAC9D,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE;QACxB,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC,CAAA;QAChF,MAAM,EAAE,CAAC,EAAE,GAAG,sCAAsC,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,CAAC,CAAA;QACjF,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAC/B,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,EAAE;YACvD,MAAM,EAAE,CAAC,EAAE,GAAG,sCAAsC,CAAC,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC,CAAA;YAC5E,MAAM,OAAO,GAAoB,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAA;YAC5E,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;QACzB,CAAC,CAAC,CACH,CAAA;QACD,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;IAC7E,CAAC,CAAC,CACL,CAAA;IACD,OAAO,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,EAAE,CAAA;AACrC,CAAC,CAAA"}

package/dist/esm/lib/collectionMetrics/lib/index.js

@@ -1,3 +1,4 @@
 export * from './calculateAllPropertiesDistribution';
 export * from './distribution';
+export * from './probabilityDistributions';
 //# sourceMappingURL=index.js.map

package/dist/esm/lib/collectionMetrics/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/collectionMetrics/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAA;AACpD,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/collectionMetrics/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAA;AACpD,cAAc,gBAAgB,CAAA;AAC9B,cAAc,4BAA4B,CAAA"}

package/dist/esm/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromOutcomes.js

@@ -0,0 +1,19 @@
+/**
+ * Calculates the parameters of a binomial distribution given a list of outcomes
+ * @param outcomes List of outcomes, where 1 is a success and 0 is a failure
+ * @returns The mean, standard deviation, and variance of the binomial distribution
+ */
+export const calculateBinomialParamsFromOutcomes = (outcomes) => {
+    const n = outcomes.length;
+    // Calculate p: the proportion of successes
+    const sum = outcomes.reduce((acc, value) => acc + value, 0);
+    const p = sum / n;
+    // Mean (µ)
+    const mean = n * p;
+    // Variance (σ^2)
+    const variance = n * p * (1 - p);
+    // Standard Deviation (σ)
+    const stdDev = Math.sqrt(variance);
+    return { mean, p, stdDev, variance };
+};
+//# sourceMappingURL=calculateBinomialParamsFromOutcomes.js.map

package/dist/esm/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromOutcomes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculateBinomialParamsFromOutcomes.js","sourceRoot":"","sources":["../../../../../../../src/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromOutcomes.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,QAAkB,EAAkC,EAAE;IACxG,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAA;IACzB,2CAA2C;IAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAA;IAC3D,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,CAAA;IACjB,WAAW;IACX,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;IAClB,iBAAiB;IACjB,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IAChC,yBAAyB;IACzB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAClC,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AACtC,CAAC,CAAA"}

package/dist/esm/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromProbability.js

@@ -0,0 +1,16 @@
+/**
+ * Calculates the parameters of a binomial distribution given the number of trials and success probability
+ * @param n Number of trials
+ * @param p Success probability
+ * @returns The binomial distribution parameters
+ */
+export const calculateBinomialParamsFromProbability = (n, p) => {
+    // Mean (µ)
+    const mean = n * p;
+    // Variance (σ^2)
+    const variance = n * p * (1 - p);
+    // Standard Deviation (σ)
+    const stdDev = Math.sqrt(variance);
+    return { mean, p, stdDev, variance };
+};
+//# sourceMappingURL=calculateBinomialParamsFromProbability.js.map

package/dist/esm/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromProbability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculateBinomialParamsFromProbability.js","sourceRoot":"","sources":["../../../../../../../src/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromProbability.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAS,EAAE,CAAS,EAAkC,EAAE;IAC7G,WAAW;IACX,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;IAElB,iBAAiB;IACjB,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IAEhC,yBAAyB;IACzB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAElC,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AACtC,CAAC,CAAA"}

package/dist/esm/lib/collectionMetrics/lib/probabilityDistributions/binomial/index.js

@@ -0,0 +1,3 @@
+export * from './calculateBinomialParamsFromOutcomes';
+export * from './calculateBinomialParamsFromProbability';
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/collectionMetrics/lib/probabilityDistributions/binomial/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/lib/collectionMetrics/lib/probabilityDistributions/binomial/index.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA;AACrD,cAAc,0CAA0C,CAAA"}

package/dist/esm/lib/collectionMetrics/lib/probabilityDistributions/index.js

@@ -0,0 +1,2 @@
+export * from './binomial';
+//# sourceMappingURL=index.js.map

package/dist/esm/lib/collectionMetrics/lib/probabilityDistributions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/lib/collectionMetrics/lib/probabilityDistributions/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA"}

package/dist/types/Witness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Witness.d.ts","sourceRoot":"","sources":["../../src/Witness.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,0BAA0B,EAE3B,MAAM,mDAAmD,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAIrE,MAAM,MAAM,gCAAgC,GAAG,aAAa,CAAC,eAAe,CAAC,0BAA0B,CAAC,CAAC,CAAA;AAWzG,qBAAa,0BAA0B,CACrC,OAAO,SAAS,gCAAgC,GAAG,gCAAgC,CACnF,SAAQ,eAAe,CAAC,OAAO,CAAC;IAChC,OAAgB,aAAa,uDAAqC;cAEzC,cAAc,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CA0BlF"}
+{"version":3,"file":"Witness.d.ts","sourceRoot":"","sources":["../../src/Witness.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,0BAA0B,EAE3B,MAAM,mDAAmD,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAIrE,MAAM,MAAM,gCAAgC,GAAG,aAAa,CAAC,eAAe,CAAC,0BAA0B,CAAC,CAAC,CAAA;AAWzG,qBAAa,0BAA0B,CACrC,OAAO,SAAS,gCAAgC,GAAG,gCAAgC,CACnF,SAAQ,eAAe,CAAC,OAAO,CAAC;IAChC,OAAgB,aAAa,uDAAqC;cAEzC,cAAc,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CA2BlF"}

package/dist/types/lib/collectionMetrics/getNftCollectionMetrics.d.ts

@@ -1,13 +1,4 @@
+import { NftCollectionMetrics } from '@xyo-network/crypto-nft-collection-payload-plugin';
 import { NftInfo } from '@xyo-network/crypto-nft-payload-plugin';
-import { Distribution } from './lib';
-export interface NftCollectionMetrics {
-    distribution: {
-        metadata: {
-            attributes: Distribution<{
-                [key: string]: string | number;
-            }>;
-        };
-    };
-}
 export declare const getNftCollectionMetrics: (nfts: NftInfo[]) => NftCollectionMetrics;
 //# sourceMappingURL=getNftCollectionMetrics.d.ts.map

package/dist/types/lib/collectionMetrics/getNftCollectionMetrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getNftCollectionMetrics.d.ts","sourceRoot":"","sources":["../../../../src/lib/collectionMetrics/getNftCollectionMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAuB,MAAM,wCAAwC,CAAA;AAErF,OAAO,EAAsC,YAAY,EAAE,MAAM,OAAO,CAAA;AAExE,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE;QACZ,QAAQ,EAAE;YACR,UAAU,EAAE,YAAY,CAAC;gBACvB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;aAC/B,CAAC,CAAA;SACH,CAAA;KACF,CAAA;CACF;AAED,eAAO,MAAM,uBAAuB,SAAU,OAAO,EAAE,KAAG,oBAczD,CAAA"}
+{"version":3,"file":"getNftCollectionMetrics.d.ts","sourceRoot":"","sources":["../../../../src/lib/collectionMetrics/getNftCollectionMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAmB,MAAM,mDAAmD,CAAA;AACzG,OAAO,EAAE,OAAO,EAAuB,MAAM,wCAAwC,CAAA;AAMrF,eAAO,MAAM,uBAAuB,SAAU,OAAO,EAAE,KAAG,oBAyBzD,CAAA"}

package/dist/types/lib/collectionMetrics/lib/index.d.ts

@@ -1,3 +1,4 @@
 export * from './calculateAllPropertiesDistribution';
 export * from './distribution';
+export * from './probabilityDistributions';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/lib/collectionMetrics/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/collectionMetrics/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAA;AACpD,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/collectionMetrics/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,sCAAsC,CAAA;AACpD,cAAc,gBAAgB,CAAA;AAC9B,cAAc,4BAA4B,CAAA"}

package/dist/types/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromOutcomes.d.ts

@@ -0,0 +1,8 @@
+import { BinomialDistributionParameters } from '@xyo-network/crypto-nft-collection-payload-plugin';
+/**
+ * Calculates the parameters of a binomial distribution given a list of outcomes
+ * @param outcomes List of outcomes, where 1 is a success and 0 is a failure
+ * @returns The mean, standard deviation, and variance of the binomial distribution
+ */
+export declare const calculateBinomialParamsFromOutcomes: (outcomes: number[]) => BinomialDistributionParameters;
+//# sourceMappingURL=calculateBinomialParamsFromOutcomes.d.ts.map

package/dist/types/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromOutcomes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculateBinomialParamsFromOutcomes.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromOutcomes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAA;AAElG;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,aAAc,MAAM,EAAE,KAAG,8BAYxE,CAAA"}

package/dist/types/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromProbability.d.ts

@@ -0,0 +1,9 @@
+import { BinomialDistributionParameters } from '@xyo-network/crypto-nft-collection-payload-plugin';
+/**
+ * Calculates the parameters of a binomial distribution given the number of trials and success probability
+ * @param n Number of trials
+ * @param p Success probability
+ * @returns The binomial distribution parameters
+ */
+export declare const calculateBinomialParamsFromProbability: (n: number, p: number) => BinomialDistributionParameters;
+//# sourceMappingURL=calculateBinomialParamsFromProbability.d.ts.map

package/dist/types/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromProbability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculateBinomialParamsFromProbability.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromProbability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,mDAAmD,CAAA;AAElG;;;;;GAKG;AACH,eAAO,MAAM,sCAAsC,MAAO,MAAM,KAAK,MAAM,KAAG,8BAW7E,CAAA"}

package/dist/types/lib/collectionMetrics/lib/probabilityDistributions/binomial/index.d.ts

@@ -0,0 +1,3 @@
+export * from './calculateBinomialParamsFromOutcomes';
+export * from './calculateBinomialParamsFromProbability';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/lib/collectionMetrics/lib/probabilityDistributions/binomial/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../src/lib/collectionMetrics/lib/probabilityDistributions/binomial/index.ts"],"names":[],"mappings":"AAAA,cAAc,uCAAuC,CAAA;AACrD,cAAc,0CAA0C,CAAA"}

package/dist/types/lib/collectionMetrics/lib/probabilityDistributions/index.d.ts

@@ -0,0 +1,2 @@
+export * from './binomial';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/lib/collectionMetrics/lib/probabilityDistributions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/collectionMetrics/lib/probabilityDistributions/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA"}

package/package.json

@@ -12,13 +12,13 @@
   "dependencies": {
     "@infura/sdk": "^2.4.3",
     "@xylabs/assert": "^2.9.3",
-    "@xyo-network/core": "~2.70.12",
-    "@xyo-network/crypto-nft-collection-payload-plugin": "~2.70.12",
-    "@xyo-network/crypto-nft-payload-plugin": "~2.70.12",
-    "@xyo-network/module": "~2.70.12",
-    "@xyo-network/payload-model": "~2.70.12",
-    "@xyo-network/payloadset-plugin": "~2.70.12",
-    "@xyo-network/witness": "~2.70.12"
+    "@xyo-network/core": "~2.70.13",
+    "@xyo-network/crypto-nft-collection-payload-plugin": "~2.70.13",
+    "@xyo-network/crypto-nft-payload-plugin": "~2.70.13",
+    "@xyo-network/module": "~2.70.13",
+    "@xyo-network/payload-model": "~2.70.13",
+    "@xyo-network/payloadset-plugin": "~2.70.13",
+    "@xyo-network/witness": "~2.70.13"
   },
   "devDependencies": {
     "@xylabs/jest-helpers": "^2.9.3",
@@ -61,5 +61,5 @@
   },
   "sideEffects": false,
   "types": "dist/types/index.d.ts",
-  "version": "2.70.12"
+  "version": "2.70.13"
 }

package/src/Witness.ts

@@ -43,14 +43,15 @@ export class CryptoNftCollectionWitness<
           getNftCollectionNfts(address, chainId, this.account.private.hex, maxNfts),
           this.writeArchivist(),
         ])
-        const distribution = getNftCollectionMetrics(nfts)
+        const metrics = getNftCollectionMetrics(nfts)
         const [sources] = await Promise.all([
           // Hash all the payloads
           Promise.all(nfts.map((nft) => PayloadHasher.hashAsync(nft))),
           // Insert them into the archivist if we have one
           archivist ? archivist.insert(nfts) : NoOp,
         ])
-        return { ...info, ...distribution, schema: NftCollectionSchema, sources, total }
+        const payload: NftCollectionInfoPayload = { ...info, metrics, schema: NftCollectionSchema, sources, total }
+        return payload
       }),
     )
     return observations.flat()

package/src/lib/collectionMetrics/getNftCollectionMetrics.ts

@@ -1,29 +1,33 @@
+import { NftCollectionMetrics, NftTraitMetrics } from '@xyo-network/crypto-nft-collection-payload-plugin'
 import { NftInfo, OpenSeaNftAttribute } from '@xyo-network/crypto-nft-payload-plugin'
 
-import { calculateAllPropertiesDistribution, Distribution } from './lib'
+import { calculateAllPropertiesDistribution, calculateBinomialParamsFromProbability } from './lib'
 
-export interface NftCollectionMetrics {
-  distribution: {
-    metadata: {
-      attributes: Distribution<{
-        [key: string]: string | number
-      }>
-    }
-  }
-}
+type TraitDistributionEntry = [string, { [key: string]: number }]
 
 export const getNftCollectionMetrics = (nfts: NftInfo[]): NftCollectionMetrics => {
-  const attributes = nfts
+  const traits = nfts
     .map((nft) => nft.metadata?.attributes as OpenSeaNftAttribute[])
     .map((attributes) => {
       return Object.fromEntries(attributes.map((attribute) => [attribute.trait_type, attribute.value]))
     })
-  const distribution = calculateAllPropertiesDistribution(attributes)
-  return {
-    distribution: {
-      metadata: {
-        attributes: distribution,
-      },
-    },
-  }
+  const distribution = calculateAllPropertiesDistribution(traits)
+  const n = nfts.length
+  const attributes = Object.fromEntries(
+    Object.entries(distribution)
+      .filter((v): v is TraitDistributionEntry => v[1] !== undefined)
+      .map(([trait, entries]) => {
+        const traitCount = Object.values(entries).reduce((prev, curr) => prev + curr, 0)
+        const { p } = calculateBinomialParamsFromProbability(nfts.length, traitCount / n)
+        const values = Object.fromEntries(
+          Object.entries(entries).map(([value, traitValueCount]) => {
+            const { p } = calculateBinomialParamsFromProbability(n, traitValueCount / n)
+            const metrics: NftTraitMetrics = { binomial: { p }, count: traitValueCount }
+            return [value, metrics]
+          }),
+        )
+        return [trait, { metrics: { binomial: { p }, count: traitCount }, values }]
+      }),
+  )
+  return { metadata: { attributes } }
 }

package/src/lib/collectionMetrics/lib/index.ts

@@ -1,2 +1,3 @@
 export * from './calculateAllPropertiesDistribution'
 export * from './distribution'
+export * from './probabilityDistributions'

package/src/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromOutcomes.ts

@@ -0,0 +1,20 @@
+import { BinomialDistributionParameters } from '@xyo-network/crypto-nft-collection-payload-plugin'
+
+/**
+ * Calculates the parameters of a binomial distribution given a list of outcomes
+ * @param outcomes List of outcomes, where 1 is a success and 0 is a failure
+ * @returns The mean, standard deviation, and variance of the binomial distribution
+ */
+export const calculateBinomialParamsFromOutcomes = (outcomes: number[]): BinomialDistributionParameters => {
+  const n = outcomes.length
+  // Calculate p: the proportion of successes
+  const sum = outcomes.reduce((acc, value) => acc + value, 0)
+  const p = sum / n
+  // Mean (µ)
+  const mean = n * p
+  // Variance (σ^2)
+  const variance = n * p * (1 - p)
+  // Standard Deviation (σ)
+  const stdDev = Math.sqrt(variance)
+  return { mean, p, stdDev, variance }
+}

package/src/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromProbability.ts

@@ -0,0 +1,20 @@
+import { BinomialDistributionParameters } from '@xyo-network/crypto-nft-collection-payload-plugin'
+
+/**
+ * Calculates the parameters of a binomial distribution given the number of trials and success probability
+ * @param n Number of trials
+ * @param p Success probability
+ * @returns The binomial distribution parameters
+ */
+export const calculateBinomialParamsFromProbability = (n: number, p: number): BinomialDistributionParameters => {
+  // Mean (µ)
+  const mean = n * p
+
+  // Variance (σ^2)
+  const variance = n * p * (1 - p)
+
+  // Standard Deviation (σ)
+  const stdDev = Math.sqrt(variance)
+
+  return { mean, p, stdDev, variance }
+}

package/src/lib/collectionMetrics/lib/probabilityDistributions/binomial/index.ts

@@ -0,0 +1,2 @@
+export * from './calculateBinomialParamsFromOutcomes'
+export * from './calculateBinomialParamsFromProbability'

package/src/lib/collectionMetrics/lib/probabilityDistributions/index.ts

@@ -0,0 +1 @@
+export * from './binomial'