@xyo-network/crypto-nft-collection-witness-plugin 2.75.0 → 2.75.2

package/dist/node/index.js

@@ -15,22 +15,208 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  CryptoNftCollectionWitnessPlugin: () => import_Plugin.CryptoNftCollectionWitnessPlugin,
-  default: () => src_default
+  CryptoNftCollectionWitness: () => CryptoNftCollectionWitness,
+  CryptoNftCollectionWitnessPlugin: () => CryptoNftCollectionWitnessPlugin,
+  default: () => src_default,
+  getNftCollectionCount: () => getNftCollectionCount,
+  getNftCollectionMetadata: () => getNftCollectionMetadata,
+  getNftCollectionMetrics: () => getNftCollectionMetrics,
+  getNftCollectionNfts: () => getNftCollectionNfts
 });
 module.exports = __toCommonJS(src_exports);
-var import_Plugin = require("./Plugin");
-__reExport(src_exports, require("./lib"), module.exports);
-__reExport(src_exports, require("./Witness"), module.exports);
-var src_default = import_Plugin.CryptoNftCollectionWitnessPlugin;
+
+// src/Plugin.ts
+var import_crypto_nft_payload_plugin3 = require("@xyo-network/crypto-nft-payload-plugin");
+var import_payload_model = require("@xyo-network/payload-model");
+var import_payloadset_plugin = require("@xyo-network/payloadset-plugin");
+
+// src/Witness.ts
+var import_assert = require("@xylabs/assert");
+var import_core = require("@xyo-network/core");
+var import_crypto_nft_collection_payload_plugin = require("@xyo-network/crypto-nft-collection-payload-plugin");
+var import_witness = require("@xyo-network/witness");
+
+// src/lib/collectionMetrics/lib/calculateAllPropertiesDistribution.ts
+var calculateAllPropertiesDistribution = (array) => {
+  const distribution = {};
+  array.forEach((item) => {
+    for (const property in item) {
+      if (Object.prototype.hasOwnProperty.call(item, property)) {
+        const value = item[property];
+        if (value !== void 0 && value !== null) {
+          const valueString = value.toString();
+          if (!distribution[property]) {
+            distribution[property] = { [valueString]: 1 };
+          } else if (!distribution[property][valueString]) {
+            ;
+            distribution[property][valueString] = 1;
+          } else {
+            ;
+            distribution[property][valueString] += 1;
+          }
+        }
+      }
+    }
+  });
+  return distribution;
+};
+
+// src/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromProbability.ts
+var calculateBinomialParamsFromProbability = (n, p) => {
+  const mean = n * p;
+  const variance = n * p * (1 - p);
+  const stdDev = Math.sqrt(variance);
+  return { mean, p, stdDev, variance };
+};
+
+// src/lib/collectionMetrics/getNftCollectionMetrics.ts
+var getNftCollectionMetrics = (nfts) => {
+  const traits = nfts.map((nft) => {
+    var _a;
+    return (_a = nft == null ? void 0 : nft.metadata) == null ? void 0 : _a.attributes;
+  }).filter((v) => v !== void 0).map((attributes2) => {
+    return Object.fromEntries(attributes2.map((attribute) => [attribute.trait_type, attribute.value]));
+  });
+  const distribution = calculateAllPropertiesDistribution(traits);
+  const n = nfts.length;
+  const attributes = Object.fromEntries(
+    Object.entries(distribution).filter((v) => v[1] !== void 0).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: p2 } = calculateBinomialParamsFromProbability(n, traitValueCount / n);
+          const metrics = { binomial: { p: p2 }, count: traitValueCount };
+          return [value, metrics];
+        })
+      );
+      return [trait, { metrics: { binomial: { p }, count: traitCount }, values }];
+    })
+  );
+  return { metadata: { attributes } };
+};
+
+// src/lib/getNftCollectionCount.ts
+var import_sdk = require("@infura/sdk");
+
+// src/lib/nonEvaluableContractAddresses.ts
+var nonEvaluableContractAddresses = [
+  // ENS
+  "0xC18360217D8F7Ab5e7c516566761Ea12Ce7F9D72"
+].map((address) => address.toUpperCase());
+
+// src/lib/getNftCollectionCount.ts
+var getNftCollectionCount = async (contractAddress, chainId, privateKey) => {
+  if (nonEvaluableContractAddresses.includes(contractAddress.toUpperCase())) {
+    throw new Error(`Unable to evaluate collection with contractAddress: ${contractAddress}`);
+  }
+  const sdk = new import_sdk.SDK(new import_sdk.Auth({ chainId, privateKey, projectId: process.env.INFURA_PROJECT_ID, secretId: process.env.INFURA_PROJECT_SECRET }));
+  const opts = { contractAddress };
+  const { total } = await sdk.api.getNFTsForCollection(opts);
+  return total;
+};
+
+// src/lib/getNftCollectionMetadata.ts
+var import_sdk2 = require("@infura/sdk");
+var import_crypto_nft_payload_plugin = require("@xyo-network/crypto-nft-payload-plugin");
+var getNftCollectionMetadata = async (contractAddress, chainId, privateKey) => {
+  if (nonEvaluableContractAddresses.includes(contractAddress.toUpperCase())) {
+    throw new Error(`Unable to evaluate collection with contractAddress: ${contractAddress}`);
+  }
+  const sdk = new import_sdk2.SDK(new import_sdk2.Auth({ chainId, privateKey, projectId: process.env.INFURA_PROJECT_ID, secretId: process.env.INFURA_PROJECT_SECRET }));
+  const opts = { contractAddress };
+  const { name, symbol, tokenType } = await sdk.api.getContractMetadata(opts);
+  const type = (0, import_crypto_nft_payload_plugin.toTokenType)(tokenType);
+  return { address: contractAddress, chainId, name, symbol, type };
+};
+
+// src/lib/getNftCollectionNfts.ts
+var import_sdk3 = require("@infura/sdk");
+var import_crypto_nft_payload_plugin2 = require("@xyo-network/crypto-nft-payload-plugin");
+var getNftCollectionNfts = async (contractAddress, chainId, privateKey, maxNfts = 100) => {
+  if (nonEvaluableContractAddresses.includes(contractAddress.toUpperCase())) {
+    throw new Error(`Unable to evaluate collection with contractAddress: ${contractAddress}`);
+  }
+  const sdk = new import_sdk3.SDK(new import_sdk3.Auth({ chainId, privateKey, projectId: process.env.INFURA_PROJECT_ID, secretId: process.env.INFURA_PROJECT_SECRET }));
+  const nfts = [];
+  let cursor = void 0;
+  do {
+    const opts = { contractAddress, cursor };
+    const { cursor: nextCursor, pageSize, total, assets } = await sdk.api.getNFTsForCollection(opts);
+    const batch = assets.slice(0, Math.min(pageSize, total - nfts.length)).map((asset) => {
+      const { contract: address, type: tokenType, ...rest } = asset;
+      const type = (0, import_crypto_nft_payload_plugin2.toTokenType)(tokenType);
+      return { address, chainId, type, ...rest };
+    });
+    nfts.push(...batch);
+    cursor = nextCursor;
+    if (nfts.length >= total || !cursor)
+      break;
+  } while (nfts.length < maxNfts);
+  return nfts.map((nft) => {
+    return { ...nft, schema: import_crypto_nft_payload_plugin2.NftSchema };
+  });
+};
+
+// src/Witness.ts
+var defaultMaxNfts = 100;
+var NoOp = Promise.resolve();
+var CryptoNftCollectionWitness = class extends import_witness.AbstractWitness {
+  static configSchemas = [import_crypto_nft_collection_payload_plugin.NftCollectionWitnessConfigSchema];
+  async observeHandler(payloads) {
+    await this.started("throw");
+    const queries = (payloads == null ? void 0 : payloads.filter(import_crypto_nft_collection_payload_plugin.isNftCollectionWitnessQuery)) ?? [];
+    const observations = await Promise.all(
+      queries.map(async (query) => {
+        const address = (0, import_assert.assertEx)((query == null ? void 0 : query.address) || this.config.address, "params.address is required");
+        const chainId = (0, import_assert.assertEx)((query == null ? void 0 : query.chainId) || this.config.chainId, "params.chainId is required");
+        const maxNfts = (query == null ? void 0 : query.maxNfts) || defaultMaxNfts;
+        const [info, total, nfts, archivist] = await Promise.all([
+          getNftCollectionMetadata(address, chainId, this.account.private.hex),
+          getNftCollectionCount(address, chainId, this.account.private.hex),
+          getNftCollectionNfts(address, chainId, this.account.private.hex, maxNfts),
+          this.writeArchivist()
+        ]);
+        const metrics = getNftCollectionMetrics(nfts);
+        const [sources] = await Promise.all([
+          // Hash all the payloads
+          Promise.all(nfts.map((nft) => import_core.PayloadHasher.hashAsync(nft))),
+          // Insert them into the archivist if we have one
+          archivist ? archivist.insert(nfts) : NoOp
+        ]);
+        const payload = { ...info, metrics, schema: import_crypto_nft_collection_payload_plugin.NftCollectionSchema, sources, total };
+        return payload;
+      })
+    );
+    return observations.flat();
+  }
+};
+
+// src/Plugin.ts
+var CryptoNftCollectionWitnessPlugin = () => (0, import_payloadset_plugin.createPayloadSetWitnessPlugin)(
+  { required: { [import_crypto_nft_payload_plugin3.NftSchema]: 1 }, schema: import_payload_model.PayloadSetSchema },
+  {
+    witness: async (params) => {
+      const result = await CryptoNftCollectionWitness.create(params);
+      return result;
+    }
+  }
+);
+
+// src/index.ts
+var src_default = CryptoNftCollectionWitnessPlugin;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CryptoNftCollectionWitness,
   CryptoNftCollectionWitnessPlugin,
-  ...require("./lib"),
-  ...require("./Witness")
+  getNftCollectionCount,
+  getNftCollectionMetadata,
+  getNftCollectionMetrics,
+  getNftCollectionNfts
 });
 //# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["import { CryptoNftCollectionWitnessPlugin } from './Plugin'\n\nexport * from './lib'\nexport * from './Witness'\n\nexport { CryptoNftCollectionWitnessPlugin }\n\n// eslint-disable-next-line import/no-default-export\nexport default CryptoNftCollectionWitnessPlugin\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,oBAAiD;AAEjD,wBAAc,kBAFd;AAGA,wBAAc,sBAHd;AAQA,IAAO,cAAQ;","names":[]}
+{"version":3,"sources":["../../src/index.ts","../../src/Plugin.ts","../../src/Witness.ts","../../src/lib/collectionMetrics/lib/calculateAllPropertiesDistribution.ts","../../src/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromProbability.ts","../../src/lib/collectionMetrics/getNftCollectionMetrics.ts","../../src/lib/getNftCollectionCount.ts","../../src/lib/nonEvaluableContractAddresses.ts","../../src/lib/getNftCollectionMetadata.ts","../../src/lib/getNftCollectionNfts.ts"],"sourcesContent":["import { CryptoNftCollectionWitnessPlugin } from './Plugin'\n\nexport * from './lib'\nexport * from './Witness'\n\nexport { CryptoNftCollectionWitnessPlugin }\n\n// eslint-disable-next-line import/no-default-export\nexport default CryptoNftCollectionWitnessPlugin\n","import { NftSchema } from '@xyo-network/crypto-nft-payload-plugin'\nimport { PayloadSetSchema } from '@xyo-network/payload-model'\nimport { createPayloadSetWitnessPlugin } from '@xyo-network/payloadset-plugin'\n\nimport { CryptoNftCollectionWitness } from './Witness'\n\nexport const CryptoNftCollectionWitnessPlugin = () =>\n  createPayloadSetWitnessPlugin<CryptoNftCollectionWitness>(\n    { required: { [NftSchema]: 1 }, schema: PayloadSetSchema },\n    {\n      witness: async (params) => {\n        const result = await CryptoNftCollectionWitness.create(params)\n        return result\n      },\n    },\n  )\n","import { assertEx } from '@xylabs/assert'\nimport { PayloadHasher } from '@xyo-network/core'\nimport {\n  isNftCollectionWitnessQuery,\n  NftCollectionInfo,\n  NftCollectionSchema,\n  NftCollectionWitnessConfig,\n  NftCollectionWitnessConfigSchema,\n} from '@xyo-network/crypto-nft-collection-payload-plugin'\nimport { AnyConfigSchema } from '@xyo-network/module'\nimport { Payload } from '@xyo-network/payload-model'\nimport { AbstractWitness, WitnessParams } from '@xyo-network/witness'\n\nimport { getNftCollectionCount, getNftCollectionMetadata, getNftCollectionMetrics, getNftCollectionNfts } from './lib'\n\nexport type CryptoNftCollectionWitnessParams = WitnessParams<AnyConfigSchema<NftCollectionWitnessConfig>>\n\nconst defaultMaxNfts = 100\n\n/**\n * A \"no operation\" Promise to be used\n * when no action is desired but a Promise\n * is required to be returned\n */\nconst NoOp = Promise.resolve()\n\nexport class CryptoNftCollectionWitness<\n  TParams extends CryptoNftCollectionWitnessParams = CryptoNftCollectionWitnessParams,\n> extends AbstractWitness<TParams> {\n  static override configSchemas = [NftCollectionWitnessConfigSchema]\n\n  protected override async observeHandler(payloads?: Payload[]): Promise<Payload[]> {\n    await this.started('throw')\n    const queries = payloads?.filter(isNftCollectionWitnessQuery) ?? []\n    const observations = await Promise.all(\n      queries.map<Promise<NftCollectionInfo>>(async (query) => {\n        const address = assertEx(query?.address || this.config.address, 'params.address is required')\n        const chainId = assertEx(query?.chainId || this.config.chainId, 'params.chainId is required')\n        const maxNfts = query?.maxNfts || defaultMaxNfts\n        const [info, total, nfts, archivist] = await Promise.all([\n          getNftCollectionMetadata(address, chainId, this.account.private.hex),\n          getNftCollectionCount(address, chainId, this.account.private.hex),\n          getNftCollectionNfts(address, chainId, this.account.private.hex, maxNfts),\n          this.writeArchivist(),\n        ])\n        const metrics = getNftCollectionMetrics(nfts)\n        const [sources] = await Promise.all([\n          // Hash all the payloads\n          Promise.all(nfts.map((nft) => PayloadHasher.hashAsync(nft))),\n          // Insert them into the archivist if we have one\n          archivist ? archivist.insert(nfts) : NoOp,\n        ])\n        const payload: NftCollectionInfo = { ...info, metrics, schema: NftCollectionSchema, sources, total }\n        return payload\n      }),\n    )\n    return observations.flat()\n  }\n}\n","import { Distribution } from './distribution'\n\nexport const calculateAllPropertiesDistribution = <T>(array: T[]): Distribution<T> => {\n  const distribution: Distribution<T> = {}\n\n  array.forEach((item) => {\n    for (const property in item) {\n      if (Object.prototype.hasOwnProperty.call(item, property)) {\n        const value = item[property as keyof T]\n        if (value !== undefined && value !== null) {\n          const valueString = value.toString()\n          if (!distribution[property]) {\n            distribution[property] = { [valueString]: 1 }\n          } else if (!distribution[property]![valueString]) {\n            ;(distribution[property] as Record<string, number>)[valueString] = 1\n          } else {\n            ;(distribution[property] as Record<string, number>)[valueString] += 1\n          }\n        }\n      }\n    }\n  })\n\n  return distribution\n}\n","import { BinomialDistributionParameters } from '@xyo-network/crypto-nft-collection-payload-plugin'\n\n/**\n * Calculates the parameters of a binomial distribution given the number of trials and success probability\n * @param n Number of trials\n * @param p Success probability\n * @returns The binomial distribution parameters\n */\nexport const calculateBinomialParamsFromProbability = (n: number, p: number): BinomialDistributionParameters => {\n  // Mean (µ)\n  const mean = n * p\n\n  // Variance (σ^2)\n  const variance = n * p * (1 - p)\n\n  // Standard Deviation (σ)\n  const stdDev = Math.sqrt(variance)\n\n  return { mean, p, stdDev, variance }\n}\n","import { NftCollectionMetrics, NftTraitMetrics } from '@xyo-network/crypto-nft-collection-payload-plugin'\nimport { NftInfoFields, OpenSeaNftAttribute } from '@xyo-network/crypto-nft-payload-plugin'\n\nimport { calculateAllPropertiesDistribution, calculateBinomialParamsFromProbability } from './lib'\n\ntype TraitDistributionEntry = [string, { [key: string]: number }]\n\nexport const getNftCollectionMetrics = (nfts: NftInfoFields[]): NftCollectionMetrics => {\n  const traits = nfts\n    .map((nft) => nft?.metadata?.attributes as OpenSeaNftAttribute[] | undefined)\n    .filter((v): v is OpenSeaNftAttribute[] => v !== undefined)\n    .map((attributes) => {\n      return Object.fromEntries(attributes.map((attribute) => [attribute.trait_type, attribute.value]))\n    })\n  const distribution = calculateAllPropertiesDistribution(traits)\n  const n = nfts.length\n  const attributes = Object.fromEntries(\n    Object.entries(distribution)\n      .filter((v): v is TraitDistributionEntry => v[1] !== undefined)\n      .map(([trait, entries]) => {\n        const traitCount = Object.values(entries).reduce((prev, curr) => prev + curr, 0)\n        const { p } = calculateBinomialParamsFromProbability(nfts.length, traitCount / n)\n        const values = Object.fromEntries(\n          Object.entries(entries).map(([value, traitValueCount]) => {\n            const { p } = calculateBinomialParamsFromProbability(n, traitValueCount / n)\n            const metrics: NftTraitMetrics = { binomial: { p }, count: traitValueCount }\n            return [value, metrics]\n          }),\n        )\n        return [trait, { metrics: { binomial: { p }, count: traitCount }, values }]\n      }),\n  )\n  return { metadata: { attributes } }\n}\n","import { Auth, SDK } from '@infura/sdk'\n\nimport { nonEvaluableContractAddresses } from './nonEvaluableContractAddresses'\n\ntype ContractAddressOptions = {\n  contractAddress: string\n  cursor?: string\n}\n\nexport const getNftCollectionCount = async (\n  /**\n   * The address of the NFT contract to search for\n   */\n  contractAddress: string,\n  /**\n   * The chain ID (1 = Ethereum Mainnet, 4 = Rinkeby, etc.) of the chain to search for NFTs on\n   */\n  chainId: number,\n  // /**\n  //  * The ethers provider to use to search for NFTs\n  //  */\n  // provider: ExternalProvider | JsonRpcFetchFunc,\n  /**\n   * The private key of the wallet to use to search for NFTs\n   */\n  privateKey: string,\n): Promise<number> => {\n  if (nonEvaluableContractAddresses.includes(contractAddress.toUpperCase())) {\n    throw new Error(`Unable to evaluate collection with contractAddress: ${contractAddress}`)\n  }\n  const sdk = new SDK(new Auth({ chainId, privateKey, projectId: process.env.INFURA_PROJECT_ID, secretId: process.env.INFURA_PROJECT_SECRET }))\n  const opts: ContractAddressOptions = { contractAddress }\n  const { total } = await sdk.api.getNFTsForCollection(opts)\n  return total\n}\n","/**\n * These contracts are not evaluable for some\n * reason (too large, nonsensical, etc.)\n */\nexport const nonEvaluableContractAddresses = [\n  // ENS\n  '0xC18360217D8F7Ab5e7c516566761Ea12Ce7F9D72',\n].map((address) => address.toUpperCase())\n","import { Auth, SDK } from '@infura/sdk'\nimport { NftCollectionMetadata } from '@xyo-network/crypto-nft-collection-payload-plugin'\nimport { toTokenType } from '@xyo-network/crypto-nft-payload-plugin'\n\nimport { nonEvaluableContractAddresses } from './nonEvaluableContractAddresses'\n\ntype ContractAddressOptions = {\n  contractAddress: string\n  cursor?: string\n}\n\nexport const getNftCollectionMetadata = async (\n  /**\n   * The address of the NFT contract to search for\n   */\n  contractAddress: string,\n  /**\n   * The chain ID (1 = Ethereum Mainnet, 4 = Rinkeby, etc.) of the chain to search for NFTs on\n   */\n  chainId: number,\n  // /**\n  //  * The ethers provider to use to search for NFTs\n  //  */\n  // provider: ExternalProvider | JsonRpcFetchFunc,\n  /**\n   * The private key of the wallet to use to search for NFTs\n   */\n  privateKey: string,\n): Promise<Omit<NftCollectionMetadata, 'total'>> => {\n  if (nonEvaluableContractAddresses.includes(contractAddress.toUpperCase())) {\n    throw new Error(`Unable to evaluate collection with contractAddress: ${contractAddress}`)\n  }\n  const sdk = new SDK(new Auth({ chainId, privateKey, projectId: process.env.INFURA_PROJECT_ID, secretId: process.env.INFURA_PROJECT_SECRET }))\n  const opts: ContractAddressOptions = { contractAddress }\n  const { name, symbol, tokenType } = await sdk.api.getContractMetadata(opts)\n  const type = toTokenType(tokenType)\n  return { address: contractAddress, chainId, name, symbol, type }\n}\n","import { Auth, SDK } from '@infura/sdk'\nimport { NftInfo, NftInfoFields, NftSchema, toTokenType } from '@xyo-network/crypto-nft-payload-plugin'\n\nimport { nonEvaluableContractAddresses } from './nonEvaluableContractAddresses'\n\ntype ContractAddressOptions = {\n  contractAddress: string\n  cursor?: string\n}\n\nexport const getNftCollectionNfts = async (\n  /**\n   * The address of the NFT contract to search for\n   */\n  contractAddress: string,\n  /**\n   * The chain ID (1 = Ethereum Mainnet, 4 = Rinkeby, etc.) of the chain to search for NFTs on\n   */\n  chainId: number,\n  // /**\n  //  * The ethers provider to use to search for NFTs\n  //  */\n  // provider: ExternalProvider | JsonRpcFetchFunc,\n  /**\n   * The private key of the wallet to use to search for NFTs\n   */\n  privateKey: string,\n  /**\n   * The maximum number of NFTs to return. Configurable to prevent\n   * large wallets from exhausting Infura API credits. Ideally a\n   * multiple of 100 as that appears to be the default page size.\n   */\n  maxNfts = 100,\n): Promise<NftInfo[]> => {\n  if (nonEvaluableContractAddresses.includes(contractAddress.toUpperCase())) {\n    throw new Error(`Unable to evaluate collection with contractAddress: ${contractAddress}`)\n  }\n  const sdk = new SDK(new Auth({ chainId, privateKey, projectId: process.env.INFURA_PROJECT_ID, secretId: process.env.INFURA_PROJECT_SECRET }))\n  const nfts: NftInfoFields[] = []\n  let cursor: string | undefined = undefined\n  do {\n    const opts: ContractAddressOptions = { contractAddress, cursor }\n    const { cursor: nextCursor, pageSize, total, assets } = await sdk.api.getNFTsForCollection(opts)\n    const batch: NftInfoFields[] = assets.slice(0, Math.min(pageSize, total - nfts.length)).map((asset) => {\n      const { contract: address, type: tokenType, ...rest } = asset\n      const type = toTokenType(tokenType)\n      return { address, chainId, type, ...rest }\n    })\n    nfts.push(...batch)\n    cursor = nextCursor\n    if (nfts.length >= total || !cursor) break\n  } while (nfts.length < maxNfts)\n  return nfts.map((nft) => {\n    return { ...nft, schema: NftSchema }\n  })\n}\n"],"mappings":"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","names":["import_crypto_nft_payload_plugin","attributes","p","import_sdk","import_sdk","import_crypto_nft_payload_plugin"]}

package/dist/node/index.mjs

@@ -1,9 +1,194 @@
-import { CryptoNftCollectionWitnessPlugin } from "./Plugin";
-export * from "./lib";
-export * from "./Witness";
+// src/Plugin.ts
+import { NftSchema as NftSchema2 } from "@xyo-network/crypto-nft-payload-plugin";
+import { PayloadSetSchema } from "@xyo-network/payload-model";
+import { createPayloadSetWitnessPlugin } from "@xyo-network/payloadset-plugin";
+
+// src/Witness.ts
+import { assertEx } from "@xylabs/assert";
+import { PayloadHasher } from "@xyo-network/core";
+import {
+  isNftCollectionWitnessQuery,
+  NftCollectionSchema,
+  NftCollectionWitnessConfigSchema
+} from "@xyo-network/crypto-nft-collection-payload-plugin";
+import { AbstractWitness } from "@xyo-network/witness";
+
+// src/lib/collectionMetrics/lib/calculateAllPropertiesDistribution.ts
+var calculateAllPropertiesDistribution = (array) => {
+  const distribution = {};
+  array.forEach((item) => {
+    for (const property in item) {
+      if (Object.prototype.hasOwnProperty.call(item, property)) {
+        const value = item[property];
+        if (value !== void 0 && value !== null) {
+          const valueString = value.toString();
+          if (!distribution[property]) {
+            distribution[property] = { [valueString]: 1 };
+          } else if (!distribution[property][valueString]) {
+            ;
+            distribution[property][valueString] = 1;
+          } else {
+            ;
+            distribution[property][valueString] += 1;
+          }
+        }
+      }
+    }
+  });
+  return distribution;
+};
+
+// src/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromProbability.ts
+var calculateBinomialParamsFromProbability = (n, p) => {
+  const mean = n * p;
+  const variance = n * p * (1 - p);
+  const stdDev = Math.sqrt(variance);
+  return { mean, p, stdDev, variance };
+};
+
+// src/lib/collectionMetrics/getNftCollectionMetrics.ts
+var getNftCollectionMetrics = (nfts) => {
+  const traits = nfts.map((nft) => {
+    var _a;
+    return (_a = nft == null ? void 0 : nft.metadata) == null ? void 0 : _a.attributes;
+  }).filter((v) => v !== void 0).map((attributes2) => {
+    return Object.fromEntries(attributes2.map((attribute) => [attribute.trait_type, attribute.value]));
+  });
+  const distribution = calculateAllPropertiesDistribution(traits);
+  const n = nfts.length;
+  const attributes = Object.fromEntries(
+    Object.entries(distribution).filter((v) => v[1] !== void 0).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: p2 } = calculateBinomialParamsFromProbability(n, traitValueCount / n);
+          const metrics = { binomial: { p: p2 }, count: traitValueCount };
+          return [value, metrics];
+        })
+      );
+      return [trait, { metrics: { binomial: { p }, count: traitCount }, values }];
+    })
+  );
+  return { metadata: { attributes } };
+};
+
+// src/lib/getNftCollectionCount.ts
+import { Auth, SDK } from "@infura/sdk";
+
+// src/lib/nonEvaluableContractAddresses.ts
+var nonEvaluableContractAddresses = [
+  // ENS
+  "0xC18360217D8F7Ab5e7c516566761Ea12Ce7F9D72"
+].map((address) => address.toUpperCase());
+
+// src/lib/getNftCollectionCount.ts
+var getNftCollectionCount = async (contractAddress, chainId, privateKey) => {
+  if (nonEvaluableContractAddresses.includes(contractAddress.toUpperCase())) {
+    throw new Error(`Unable to evaluate collection with contractAddress: ${contractAddress}`);
+  }
+  const sdk = new SDK(new Auth({ chainId, privateKey, projectId: process.env.INFURA_PROJECT_ID, secretId: process.env.INFURA_PROJECT_SECRET }));
+  const opts = { contractAddress };
+  const { total } = await sdk.api.getNFTsForCollection(opts);
+  return total;
+};
+
+// src/lib/getNftCollectionMetadata.ts
+import { Auth as Auth2, SDK as SDK2 } from "@infura/sdk";
+import { toTokenType } from "@xyo-network/crypto-nft-payload-plugin";
+var getNftCollectionMetadata = async (contractAddress, chainId, privateKey) => {
+  if (nonEvaluableContractAddresses.includes(contractAddress.toUpperCase())) {
+    throw new Error(`Unable to evaluate collection with contractAddress: ${contractAddress}`);
+  }
+  const sdk = new SDK2(new Auth2({ chainId, privateKey, projectId: process.env.INFURA_PROJECT_ID, secretId: process.env.INFURA_PROJECT_SECRET }));
+  const opts = { contractAddress };
+  const { name, symbol, tokenType } = await sdk.api.getContractMetadata(opts);
+  const type = toTokenType(tokenType);
+  return { address: contractAddress, chainId, name, symbol, type };
+};
+
+// src/lib/getNftCollectionNfts.ts
+import { Auth as Auth3, SDK as SDK3 } from "@infura/sdk";
+import { NftSchema, toTokenType as toTokenType2 } from "@xyo-network/crypto-nft-payload-plugin";
+var getNftCollectionNfts = async (contractAddress, chainId, privateKey, maxNfts = 100) => {
+  if (nonEvaluableContractAddresses.includes(contractAddress.toUpperCase())) {
+    throw new Error(`Unable to evaluate collection with contractAddress: ${contractAddress}`);
+  }
+  const sdk = new SDK3(new Auth3({ chainId, privateKey, projectId: process.env.INFURA_PROJECT_ID, secretId: process.env.INFURA_PROJECT_SECRET }));
+  const nfts = [];
+  let cursor = void 0;
+  do {
+    const opts = { contractAddress, cursor };
+    const { cursor: nextCursor, pageSize, total, assets } = await sdk.api.getNFTsForCollection(opts);
+    const batch = assets.slice(0, Math.min(pageSize, total - nfts.length)).map((asset) => {
+      const { contract: address, type: tokenType, ...rest } = asset;
+      const type = toTokenType2(tokenType);
+      return { address, chainId, type, ...rest };
+    });
+    nfts.push(...batch);
+    cursor = nextCursor;
+    if (nfts.length >= total || !cursor)
+      break;
+  } while (nfts.length < maxNfts);
+  return nfts.map((nft) => {
+    return { ...nft, schema: NftSchema };
+  });
+};
+
+// src/Witness.ts
+var defaultMaxNfts = 100;
+var NoOp = Promise.resolve();
+var CryptoNftCollectionWitness = class extends AbstractWitness {
+  static configSchemas = [NftCollectionWitnessConfigSchema];
+  async observeHandler(payloads) {
+    await this.started("throw");
+    const queries = (payloads == null ? void 0 : payloads.filter(isNftCollectionWitnessQuery)) ?? [];
+    const observations = await Promise.all(
+      queries.map(async (query) => {
+        const address = assertEx((query == null ? void 0 : query.address) || this.config.address, "params.address is required");
+        const chainId = assertEx((query == null ? void 0 : query.chainId) || this.config.chainId, "params.chainId is required");
+        const maxNfts = (query == null ? void 0 : query.maxNfts) || defaultMaxNfts;
+        const [info, total, nfts, archivist] = await Promise.all([
+          getNftCollectionMetadata(address, chainId, this.account.private.hex),
+          getNftCollectionCount(address, chainId, this.account.private.hex),
+          getNftCollectionNfts(address, chainId, this.account.private.hex, maxNfts),
+          this.writeArchivist()
+        ]);
+        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
+        ]);
+        const payload = { ...info, metrics, schema: NftCollectionSchema, sources, total };
+        return payload;
+      })
+    );
+    return observations.flat();
+  }
+};
+
+// src/Plugin.ts
+var CryptoNftCollectionWitnessPlugin = () => createPayloadSetWitnessPlugin(
+  { required: { [NftSchema2]: 1 }, schema: PayloadSetSchema },
+  {
+    witness: async (params) => {
+      const result = await CryptoNftCollectionWitness.create(params);
+      return result;
+    }
+  }
+);
+
+// src/index.ts
 var src_default = CryptoNftCollectionWitnessPlugin;
 export {
+  CryptoNftCollectionWitness,
   CryptoNftCollectionWitnessPlugin,
-  src_default as default
+  src_default as default,
+  getNftCollectionCount,
+  getNftCollectionMetadata,
+  getNftCollectionMetrics,
+  getNftCollectionNfts
 };
 //# sourceMappingURL=index.mjs.map

package/dist/node/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts"],"sourcesContent":["import { CryptoNftCollectionWitnessPlugin } from './Plugin'\n\nexport * from './lib'\nexport * from './Witness'\n\nexport { CryptoNftCollectionWitnessPlugin }\n\n// eslint-disable-next-line import/no-default-export\nexport default CryptoNftCollectionWitnessPlugin\n"],"mappings":"AAAA,SAAS,wCAAwC;AAEjD,cAAc;AACd,cAAc;AAKd,IAAO,cAAQ;","names":[]}
+{"version":3,"sources":["../../src/Plugin.ts","../../src/Witness.ts","../../src/lib/collectionMetrics/lib/calculateAllPropertiesDistribution.ts","../../src/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromProbability.ts","../../src/lib/collectionMetrics/getNftCollectionMetrics.ts","../../src/lib/getNftCollectionCount.ts","../../src/lib/nonEvaluableContractAddresses.ts","../../src/lib/getNftCollectionMetadata.ts","../../src/lib/getNftCollectionNfts.ts","../../src/index.ts"],"sourcesContent":["import { NftSchema } from '@xyo-network/crypto-nft-payload-plugin'\nimport { PayloadSetSchema } from '@xyo-network/payload-model'\nimport { createPayloadSetWitnessPlugin } from '@xyo-network/payloadset-plugin'\n\nimport { CryptoNftCollectionWitness } from './Witness'\n\nexport const CryptoNftCollectionWitnessPlugin = () =>\n  createPayloadSetWitnessPlugin<CryptoNftCollectionWitness>(\n    { required: { [NftSchema]: 1 }, schema: PayloadSetSchema },\n    {\n      witness: async (params) => {\n        const result = await CryptoNftCollectionWitness.create(params)\n        return result\n      },\n    },\n  )\n","import { assertEx } from '@xylabs/assert'\nimport { PayloadHasher } from '@xyo-network/core'\nimport {\n  isNftCollectionWitnessQuery,\n  NftCollectionInfo,\n  NftCollectionSchema,\n  NftCollectionWitnessConfig,\n  NftCollectionWitnessConfigSchema,\n} from '@xyo-network/crypto-nft-collection-payload-plugin'\nimport { AnyConfigSchema } from '@xyo-network/module'\nimport { Payload } from '@xyo-network/payload-model'\nimport { AbstractWitness, WitnessParams } from '@xyo-network/witness'\n\nimport { getNftCollectionCount, getNftCollectionMetadata, getNftCollectionMetrics, getNftCollectionNfts } from './lib'\n\nexport type CryptoNftCollectionWitnessParams = WitnessParams<AnyConfigSchema<NftCollectionWitnessConfig>>\n\nconst defaultMaxNfts = 100\n\n/**\n * A \"no operation\" Promise to be used\n * when no action is desired but a Promise\n * is required to be returned\n */\nconst NoOp = Promise.resolve()\n\nexport class CryptoNftCollectionWitness<\n  TParams extends CryptoNftCollectionWitnessParams = CryptoNftCollectionWitnessParams,\n> extends AbstractWitness<TParams> {\n  static override configSchemas = [NftCollectionWitnessConfigSchema]\n\n  protected override async observeHandler(payloads?: Payload[]): Promise<Payload[]> {\n    await this.started('throw')\n    const queries = payloads?.filter(isNftCollectionWitnessQuery) ?? []\n    const observations = await Promise.all(\n      queries.map<Promise<NftCollectionInfo>>(async (query) => {\n        const address = assertEx(query?.address || this.config.address, 'params.address is required')\n        const chainId = assertEx(query?.chainId || this.config.chainId, 'params.chainId is required')\n        const maxNfts = query?.maxNfts || defaultMaxNfts\n        const [info, total, nfts, archivist] = await Promise.all([\n          getNftCollectionMetadata(address, chainId, this.account.private.hex),\n          getNftCollectionCount(address, chainId, this.account.private.hex),\n          getNftCollectionNfts(address, chainId, this.account.private.hex, maxNfts),\n          this.writeArchivist(),\n        ])\n        const metrics = getNftCollectionMetrics(nfts)\n        const [sources] = await Promise.all([\n          // Hash all the payloads\n          Promise.all(nfts.map((nft) => PayloadHasher.hashAsync(nft))),\n          // Insert them into the archivist if we have one\n          archivist ? archivist.insert(nfts) : NoOp,\n        ])\n        const payload: NftCollectionInfo = { ...info, metrics, schema: NftCollectionSchema, sources, total }\n        return payload\n      }),\n    )\n    return observations.flat()\n  }\n}\n","import { Distribution } from './distribution'\n\nexport const calculateAllPropertiesDistribution = <T>(array: T[]): Distribution<T> => {\n  const distribution: Distribution<T> = {}\n\n  array.forEach((item) => {\n    for (const property in item) {\n      if (Object.prototype.hasOwnProperty.call(item, property)) {\n        const value = item[property as keyof T]\n        if (value !== undefined && value !== null) {\n          const valueString = value.toString()\n          if (!distribution[property]) {\n            distribution[property] = { [valueString]: 1 }\n          } else if (!distribution[property]![valueString]) {\n            ;(distribution[property] as Record<string, number>)[valueString] = 1\n          } else {\n            ;(distribution[property] as Record<string, number>)[valueString] += 1\n          }\n        }\n      }\n    }\n  })\n\n  return distribution\n}\n","import { BinomialDistributionParameters } from '@xyo-network/crypto-nft-collection-payload-plugin'\n\n/**\n * Calculates the parameters of a binomial distribution given the number of trials and success probability\n * @param n Number of trials\n * @param p Success probability\n * @returns The binomial distribution parameters\n */\nexport const calculateBinomialParamsFromProbability = (n: number, p: number): BinomialDistributionParameters => {\n  // Mean (µ)\n  const mean = n * p\n\n  // Variance (σ^2)\n  const variance = n * p * (1 - p)\n\n  // Standard Deviation (σ)\n  const stdDev = Math.sqrt(variance)\n\n  return { mean, p, stdDev, variance }\n}\n","import { NftCollectionMetrics, NftTraitMetrics } from '@xyo-network/crypto-nft-collection-payload-plugin'\nimport { NftInfoFields, OpenSeaNftAttribute } from '@xyo-network/crypto-nft-payload-plugin'\n\nimport { calculateAllPropertiesDistribution, calculateBinomialParamsFromProbability } from './lib'\n\ntype TraitDistributionEntry = [string, { [key: string]: number }]\n\nexport const getNftCollectionMetrics = (nfts: NftInfoFields[]): NftCollectionMetrics => {\n  const traits = nfts\n    .map((nft) => nft?.metadata?.attributes as OpenSeaNftAttribute[] | undefined)\n    .filter((v): v is OpenSeaNftAttribute[] => v !== undefined)\n    .map((attributes) => {\n      return Object.fromEntries(attributes.map((attribute) => [attribute.trait_type, attribute.value]))\n    })\n  const distribution = calculateAllPropertiesDistribution(traits)\n  const n = nfts.length\n  const attributes = Object.fromEntries(\n    Object.entries(distribution)\n      .filter((v): v is TraitDistributionEntry => v[1] !== undefined)\n      .map(([trait, entries]) => {\n        const traitCount = Object.values(entries).reduce((prev, curr) => prev + curr, 0)\n        const { p } = calculateBinomialParamsFromProbability(nfts.length, traitCount / n)\n        const values = Object.fromEntries(\n          Object.entries(entries).map(([value, traitValueCount]) => {\n            const { p } = calculateBinomialParamsFromProbability(n, traitValueCount / n)\n            const metrics: NftTraitMetrics = { binomial: { p }, count: traitValueCount }\n            return [value, metrics]\n          }),\n        )\n        return [trait, { metrics: { binomial: { p }, count: traitCount }, values }]\n      }),\n  )\n  return { metadata: { attributes } }\n}\n","import { Auth, SDK } from '@infura/sdk'\n\nimport { nonEvaluableContractAddresses } from './nonEvaluableContractAddresses'\n\ntype ContractAddressOptions = {\n  contractAddress: string\n  cursor?: string\n}\n\nexport const getNftCollectionCount = async (\n  /**\n   * The address of the NFT contract to search for\n   */\n  contractAddress: string,\n  /**\n   * The chain ID (1 = Ethereum Mainnet, 4 = Rinkeby, etc.) of the chain to search for NFTs on\n   */\n  chainId: number,\n  // /**\n  //  * The ethers provider to use to search for NFTs\n  //  */\n  // provider: ExternalProvider | JsonRpcFetchFunc,\n  /**\n   * The private key of the wallet to use to search for NFTs\n   */\n  privateKey: string,\n): Promise<number> => {\n  if (nonEvaluableContractAddresses.includes(contractAddress.toUpperCase())) {\n    throw new Error(`Unable to evaluate collection with contractAddress: ${contractAddress}`)\n  }\n  const sdk = new SDK(new Auth({ chainId, privateKey, projectId: process.env.INFURA_PROJECT_ID, secretId: process.env.INFURA_PROJECT_SECRET }))\n  const opts: ContractAddressOptions = { contractAddress }\n  const { total } = await sdk.api.getNFTsForCollection(opts)\n  return total\n}\n","/**\n * These contracts are not evaluable for some\n * reason (too large, nonsensical, etc.)\n */\nexport const nonEvaluableContractAddresses = [\n  // ENS\n  '0xC18360217D8F7Ab5e7c516566761Ea12Ce7F9D72',\n].map((address) => address.toUpperCase())\n","import { Auth, SDK } from '@infura/sdk'\nimport { NftCollectionMetadata } from '@xyo-network/crypto-nft-collection-payload-plugin'\nimport { toTokenType } from '@xyo-network/crypto-nft-payload-plugin'\n\nimport { nonEvaluableContractAddresses } from './nonEvaluableContractAddresses'\n\ntype ContractAddressOptions = {\n  contractAddress: string\n  cursor?: string\n}\n\nexport const getNftCollectionMetadata = async (\n  /**\n   * The address of the NFT contract to search for\n   */\n  contractAddress: string,\n  /**\n   * The chain ID (1 = Ethereum Mainnet, 4 = Rinkeby, etc.) of the chain to search for NFTs on\n   */\n  chainId: number,\n  // /**\n  //  * The ethers provider to use to search for NFTs\n  //  */\n  // provider: ExternalProvider | JsonRpcFetchFunc,\n  /**\n   * The private key of the wallet to use to search for NFTs\n   */\n  privateKey: string,\n): Promise<Omit<NftCollectionMetadata, 'total'>> => {\n  if (nonEvaluableContractAddresses.includes(contractAddress.toUpperCase())) {\n    throw new Error(`Unable to evaluate collection with contractAddress: ${contractAddress}`)\n  }\n  const sdk = new SDK(new Auth({ chainId, privateKey, projectId: process.env.INFURA_PROJECT_ID, secretId: process.env.INFURA_PROJECT_SECRET }))\n  const opts: ContractAddressOptions = { contractAddress }\n  const { name, symbol, tokenType } = await sdk.api.getContractMetadata(opts)\n  const type = toTokenType(tokenType)\n  return { address: contractAddress, chainId, name, symbol, type }\n}\n","import { Auth, SDK } from '@infura/sdk'\nimport { NftInfo, NftInfoFields, NftSchema, toTokenType } from '@xyo-network/crypto-nft-payload-plugin'\n\nimport { nonEvaluableContractAddresses } from './nonEvaluableContractAddresses'\n\ntype ContractAddressOptions = {\n  contractAddress: string\n  cursor?: string\n}\n\nexport const getNftCollectionNfts = async (\n  /**\n   * The address of the NFT contract to search for\n   */\n  contractAddress: string,\n  /**\n   * The chain ID (1 = Ethereum Mainnet, 4 = Rinkeby, etc.) of the chain to search for NFTs on\n   */\n  chainId: number,\n  // /**\n  //  * The ethers provider to use to search for NFTs\n  //  */\n  // provider: ExternalProvider | JsonRpcFetchFunc,\n  /**\n   * The private key of the wallet to use to search for NFTs\n   */\n  privateKey: string,\n  /**\n   * The maximum number of NFTs to return. Configurable to prevent\n   * large wallets from exhausting Infura API credits. Ideally a\n   * multiple of 100 as that appears to be the default page size.\n   */\n  maxNfts = 100,\n): Promise<NftInfo[]> => {\n  if (nonEvaluableContractAddresses.includes(contractAddress.toUpperCase())) {\n    throw new Error(`Unable to evaluate collection with contractAddress: ${contractAddress}`)\n  }\n  const sdk = new SDK(new Auth({ chainId, privateKey, projectId: process.env.INFURA_PROJECT_ID, secretId: process.env.INFURA_PROJECT_SECRET }))\n  const nfts: NftInfoFields[] = []\n  let cursor: string | undefined = undefined\n  do {\n    const opts: ContractAddressOptions = { contractAddress, cursor }\n    const { cursor: nextCursor, pageSize, total, assets } = await sdk.api.getNFTsForCollection(opts)\n    const batch: NftInfoFields[] = assets.slice(0, Math.min(pageSize, total - nfts.length)).map((asset) => {\n      const { contract: address, type: tokenType, ...rest } = asset\n      const type = toTokenType(tokenType)\n      return { address, chainId, type, ...rest }\n    })\n    nfts.push(...batch)\n    cursor = nextCursor\n    if (nfts.length >= total || !cursor) break\n  } while (nfts.length < maxNfts)\n  return nfts.map((nft) => {\n    return { ...nft, schema: NftSchema }\n  })\n}\n","import { CryptoNftCollectionWitnessPlugin } from './Plugin'\n\nexport * from './lib'\nexport * from './Witness'\n\nexport { CryptoNftCollectionWitnessPlugin }\n\n// eslint-disable-next-line import/no-default-export\nexport default CryptoNftCollectionWitnessPlugin\n"],"mappings":"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","names":["NftSchema","attributes","p","Auth","SDK","SDK","Auth","Auth","SDK","toTokenType","SDK","Auth","toTokenType","NftSchema"]}

package/dist/node/lib/collectionMetrics/getNftCollectionMetrics.d.cts

@@ -0,0 +1,4 @@
+import { NftCollectionMetrics } from '@xyo-network/crypto-nft-collection-payload-plugin';
+import { NftInfoFields } from '@xyo-network/crypto-nft-payload-plugin';
+export declare const getNftCollectionMetrics: (nfts: NftInfoFields[]) => NftCollectionMetrics;
+//# sourceMappingURL=getNftCollectionMetrics.d.ts.map

package/dist/node/lib/collectionMetrics/getNftCollectionMetrics.d.cts.map

@@ -0,0 +1 @@
+{"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,aAAa,EAAuB,MAAM,wCAAwC,CAAA;AAM3F,eAAO,MAAM,uBAAuB,SAAU,aAAa,EAAE,KAAG,oBA0B/D,CAAA"}

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

@@ -16,25 +16,64 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/collectionMetrics/getNftCollectionMetrics.ts
 var getNftCollectionMetrics_exports = {};
 __export(getNftCollectionMetrics_exports, {
   getNftCollectionMetrics: () => getNftCollectionMetrics
 });
 module.exports = __toCommonJS(getNftCollectionMetrics_exports);
-var import_lib = require("./lib");
-const getNftCollectionMetrics = (nfts) => {
-  const traits = nfts.map((nft) => nft?.metadata?.attributes).filter((v) => v !== void 0).map((attributes2) => {
+
+// src/lib/collectionMetrics/lib/calculateAllPropertiesDistribution.ts
+var calculateAllPropertiesDistribution = (array) => {
+  const distribution = {};
+  array.forEach((item) => {
+    for (const property in item) {
+      if (Object.prototype.hasOwnProperty.call(item, property)) {
+        const value = item[property];
+        if (value !== void 0 && value !== null) {
+          const valueString = value.toString();
+          if (!distribution[property]) {
+            distribution[property] = { [valueString]: 1 };
+          } else if (!distribution[property][valueString]) {
+            ;
+            distribution[property][valueString] = 1;
+          } else {
+            ;
+            distribution[property][valueString] += 1;
+          }
+        }
+      }
+    }
+  });
+  return distribution;
+};
+
+// src/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromProbability.ts
+var calculateBinomialParamsFromProbability = (n, p) => {
+  const mean = n * p;
+  const variance = n * p * (1 - p);
+  const stdDev = Math.sqrt(variance);
+  return { mean, p, stdDev, variance };
+};
+
+// src/lib/collectionMetrics/getNftCollectionMetrics.ts
+var getNftCollectionMetrics = (nfts) => {
+  const traits = nfts.map((nft) => {
+    var _a;
+    return (_a = nft == null ? void 0 : nft.metadata) == null ? void 0 : _a.attributes;
+  }).filter((v) => v !== void 0).map((attributes2) => {
     return Object.fromEntries(attributes2.map((attribute) => [attribute.trait_type, attribute.value]));
   });
-  const distribution = (0, import_lib.calculateAllPropertiesDistribution)(traits);
+  const distribution = calculateAllPropertiesDistribution(traits);
   const n = nfts.length;
   const attributes = Object.fromEntries(
     Object.entries(distribution).filter((v) => v[1] !== void 0).map(([trait, entries]) => {
       const traitCount = Object.values(entries).reduce((prev, curr) => prev + curr, 0);
-      const { p } = (0, import_lib.calculateBinomialParamsFromProbability)(nfts.length, traitCount / n);
+      const { p } = calculateBinomialParamsFromProbability(nfts.length, traitCount / n);
       const values = Object.fromEntries(
         Object.entries(entries).map(([value, traitValueCount]) => {
-          const { p: p2 } = (0, import_lib.calculateBinomialParamsFromProbability)(n, traitValueCount / n);
+          const { p: p2 } = calculateBinomialParamsFromProbability(n, traitValueCount / n);
           const metrics = { binomial: { p: p2 }, count: traitValueCount };
           return [value, metrics];
         })

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/collectionMetrics/getNftCollectionMetrics.ts"],"sourcesContent":["import { NftCollectionMetrics, NftTraitMetrics } from '@xyo-network/crypto-nft-collection-payload-plugin'\nimport { NftInfoFields, OpenSeaNftAttribute } from '@xyo-network/crypto-nft-payload-plugin'\n\nimport { calculateAllPropertiesDistribution, calculateBinomialParamsFromProbability } from './lib'\n\ntype TraitDistributionEntry = [string, { [key: string]: number }]\n\nexport const getNftCollectionMetrics = (nfts: NftInfoFields[]): NftCollectionMetrics => {\n  const traits = nfts\n    .map((nft) => nft?.metadata?.attributes as OpenSeaNftAttribute[] | undefined)\n    .filter((v): v is OpenSeaNftAttribute[] => v !== undefined)\n    .map((attributes) => {\n      return Object.fromEntries(attributes.map((attribute) => [attribute.trait_type, attribute.value]))\n    })\n  const distribution = calculateAllPropertiesDistribution(traits)\n  const n = nfts.length\n  const attributes = Object.fromEntries(\n    Object.entries(distribution)\n      .filter((v): v is TraitDistributionEntry => v[1] !== undefined)\n      .map(([trait, entries]) => {\n        const traitCount = Object.values(entries).reduce((prev, curr) => prev + curr, 0)\n        const { p } = calculateBinomialParamsFromProbability(nfts.length, traitCount / n)\n        const values = Object.fromEntries(\n          Object.entries(entries).map(([value, traitValueCount]) => {\n            const { p } = calculateBinomialParamsFromProbability(n, traitValueCount / n)\n            const metrics: NftTraitMetrics = { binomial: { p }, count: traitValueCount }\n            return [value, metrics]\n          }),\n        )\n        return [trait, { metrics: { binomial: { p }, count: traitCount }, values }]\n      }),\n  )\n  return { metadata: { attributes } }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,iBAA2F;AAIpF,MAAM,0BAA0B,CAAC,SAAgD;AACtF,QAAM,SAAS,KACZ,IAAI,CAAC,QAAQ,KAAK,UAAU,UAA+C,EAC3E,OAAO,CAAC,MAAkC,MAAM,MAAS,EACzD,IAAI,CAACA,gBAAe;AACnB,WAAO,OAAO,YAAYA,YAAW,IAAI,CAAC,cAAc,CAAC,UAAU,YAAY,UAAU,KAAK,CAAC,CAAC;AAAA,EAClG,CAAC;AACH,QAAM,mBAAe,+CAAmC,MAAM;AAC9D,QAAM,IAAI,KAAK;AACf,QAAM,aAAa,OAAO;AAAA,IACxB,OAAO,QAAQ,YAAY,EACxB,OAAO,CAAC,MAAmC,EAAE,CAAC,MAAM,MAAS,EAC7D,IAAI,CAAC,CAAC,OAAO,OAAO,MAAM;AACzB,YAAM,aAAa,OAAO,OAAO,OAAO,EAAE,OAAO,CAAC,MAAM,SAAS,OAAO,MAAM,CAAC;AAC/E,YAAM,EAAE,EAAE,QAAI,mDAAuC,KAAK,QAAQ,aAAa,CAAC;AAChF,YAAM,SAAS,OAAO;AAAA,QACpB,OAAO,QAAQ,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,eAAe,MAAM;AACxD,gBAAM,EAAE,GAAAC,GAAE,QAAI,mDAAuC,GAAG,kBAAkB,CAAC;AAC3E,gBAAM,UAA2B,EAAE,UAAU,EAAE,GAAAA,GAAE,GAAG,OAAO,gBAAgB;AAC3E,iBAAO,CAAC,OAAO,OAAO;AAAA,QACxB,CAAC;AAAA,MACH;AACA,aAAO,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,GAAG,OAAO,WAAW,GAAG,OAAO,CAAC;AAAA,IAC5E,CAAC;AAAA,EACL;AACA,SAAO,EAAE,UAAU,EAAE,WAAW,EAAE;AACpC;","names":["attributes","p"]}
+{"version":3,"sources":["../../../../src/lib/collectionMetrics/getNftCollectionMetrics.ts","../../../../src/lib/collectionMetrics/lib/calculateAllPropertiesDistribution.ts","../../../../src/lib/collectionMetrics/lib/probabilityDistributions/binomial/calculateBinomialParamsFromProbability.ts"],"sourcesContent":["import { NftCollectionMetrics, NftTraitMetrics } from '@xyo-network/crypto-nft-collection-payload-plugin'\nimport { NftInfoFields, OpenSeaNftAttribute } from '@xyo-network/crypto-nft-payload-plugin'\n\nimport { calculateAllPropertiesDistribution, calculateBinomialParamsFromProbability } from './lib'\n\ntype TraitDistributionEntry = [string, { [key: string]: number }]\n\nexport const getNftCollectionMetrics = (nfts: NftInfoFields[]): NftCollectionMetrics => {\n  const traits = nfts\n    .map((nft) => nft?.metadata?.attributes as OpenSeaNftAttribute[] | undefined)\n    .filter((v): v is OpenSeaNftAttribute[] => v !== undefined)\n    .map((attributes) => {\n      return Object.fromEntries(attributes.map((attribute) => [attribute.trait_type, attribute.value]))\n    })\n  const distribution = calculateAllPropertiesDistribution(traits)\n  const n = nfts.length\n  const attributes = Object.fromEntries(\n    Object.entries(distribution)\n      .filter((v): v is TraitDistributionEntry => v[1] !== undefined)\n      .map(([trait, entries]) => {\n        const traitCount = Object.values(entries).reduce((prev, curr) => prev + curr, 0)\n        const { p } = calculateBinomialParamsFromProbability(nfts.length, traitCount / n)\n        const values = Object.fromEntries(\n          Object.entries(entries).map(([value, traitValueCount]) => {\n            const { p } = calculateBinomialParamsFromProbability(n, traitValueCount / n)\n            const metrics: NftTraitMetrics = { binomial: { p }, count: traitValueCount }\n            return [value, metrics]\n          }),\n        )\n        return [trait, { metrics: { binomial: { p }, count: traitCount }, values }]\n      }),\n  )\n  return { metadata: { attributes } }\n}\n","import { Distribution } from './distribution'\n\nexport const calculateAllPropertiesDistribution = <T>(array: T[]): Distribution<T> => {\n  const distribution: Distribution<T> = {}\n\n  array.forEach((item) => {\n    for (const property in item) {\n      if (Object.prototype.hasOwnProperty.call(item, property)) {\n        const value = item[property as keyof T]\n        if (value !== undefined && value !== null) {\n          const valueString = value.toString()\n          if (!distribution[property]) {\n            distribution[property] = { [valueString]: 1 }\n          } else if (!distribution[property]![valueString]) {\n            ;(distribution[property] as Record<string, number>)[valueString] = 1\n          } else {\n            ;(distribution[property] as Record<string, number>)[valueString] += 1\n          }\n        }\n      }\n    }\n  })\n\n  return distribution\n}\n","import { BinomialDistributionParameters } from '@xyo-network/crypto-nft-collection-payload-plugin'\n\n/**\n * Calculates the parameters of a binomial distribution given the number of trials and success probability\n * @param n Number of trials\n * @param p Success probability\n * @returns The binomial distribution parameters\n */\nexport const calculateBinomialParamsFromProbability = (n: number, p: number): BinomialDistributionParameters => {\n  // Mean (µ)\n  const mean = n * p\n\n  // Variance (σ^2)\n  const variance = n * p * (1 - p)\n\n  // Standard Deviation (σ)\n  const stdDev = Math.sqrt(variance)\n\n  return { mean, p, stdDev, variance }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEO,IAAM,qCAAqC,CAAI,UAAgC;AACpF,QAAM,eAAgC,CAAC;AAEvC,QAAM,QAAQ,CAAC,SAAS;AACtB,eAAW,YAAY,MAAM;AAC3B,UAAI,OAAO,UAAU,eAAe,KAAK,MAAM,QAAQ,GAAG;AACxD,cAAM,QAAQ,KAAK,QAAmB;AACtC,YAAI,UAAU,UAAa,UAAU,MAAM;AACzC,gBAAM,cAAc,MAAM,SAAS;AACnC,cAAI,CAAC,aAAa,QAAQ,GAAG;AAC3B,yBAAa,QAAQ,IAAI,EAAE,CAAC,WAAW,GAAG,EAAE;AAAA,UAC9C,WAAW,CAAC,aAAa,QAAQ,EAAG,WAAW,GAAG;AAChD;AAAC,YAAC,aAAa,QAAQ,EAA6B,WAAW,IAAI;AAAA,UACrE,OAAO;AACL;AAAC,YAAC,aAAa,QAAQ,EAA6B,WAAW,KAAK;AAAA,UACtE;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF,CAAC;AAED,SAAO;AACT;;;AChBO,IAAM,yCAAyC,CAAC,GAAW,MAA8C;AAE9G,QAAM,OAAO,IAAI;AAGjB,QAAM,WAAW,IAAI,KAAK,IAAI;AAG9B,QAAM,SAAS,KAAK,KAAK,QAAQ;AAEjC,SAAO,EAAE,MAAM,GAAG,QAAQ,SAAS;AACrC;;;AFZO,IAAM,0BAA0B,CAAC,SAAgD;AACtF,QAAM,SAAS,KACZ,IAAI,CAAC,QAAK;AATf;AASkB,4CAAK,aAAL,mBAAe;AAAA,GAA+C,EAC3E,OAAO,CAAC,MAAkC,MAAM,MAAS,EACzD,IAAI,CAACA,gBAAe;AACnB,WAAO,OAAO,YAAYA,YAAW,IAAI,CAAC,cAAc,CAAC,UAAU,YAAY,UAAU,KAAK,CAAC,CAAC;AAAA,EAClG,CAAC;AACH,QAAM,eAAe,mCAAmC,MAAM;AAC9D,QAAM,IAAI,KAAK;AACf,QAAM,aAAa,OAAO;AAAA,IACxB,OAAO,QAAQ,YAAY,EACxB,OAAO,CAAC,MAAmC,EAAE,CAAC,MAAM,MAAS,EAC7D,IAAI,CAAC,CAAC,OAAO,OAAO,MAAM;AACzB,YAAM,aAAa,OAAO,OAAO,OAAO,EAAE,OAAO,CAAC,MAAM,SAAS,OAAO,MAAM,CAAC;AAC/E,YAAM,EAAE,EAAE,IAAI,uCAAuC,KAAK,QAAQ,aAAa,CAAC;AAChF,YAAM,SAAS,OAAO;AAAA,QACpB,OAAO,QAAQ,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,eAAe,MAAM;AACxD,gBAAM,EAAE,GAAAC,GAAE,IAAI,uCAAuC,GAAG,kBAAkB,CAAC;AAC3E,gBAAM,UAA2B,EAAE,UAAU,EAAE,GAAAA,GAAE,GAAG,OAAO,gBAAgB;AAC3E,iBAAO,CAAC,OAAO,OAAO;AAAA,QACxB,CAAC;AAAA,MACH;AACA,aAAO,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,GAAG,OAAO,WAAW,GAAG,OAAO,CAAC;AAAA,IAC5E,CAAC;AAAA,EACL;AACA,SAAO,EAAE,UAAU,EAAE,WAAW,EAAE;AACpC;","names":["attributes","p"]}