ourzora / nft-metadata

generic nft metadata parsers
MIT License
65 stars 13 forks source link

@zoralabs/nft-metadata

Javascript library for parsing nft metadata.

This parses data following a variety of standards and contracts. All contracts on https://zora.co/ are parsed using this library.

Usage:

Add package:

yarn add @zoralabs/nft-metadata

Use in project:

import {Agent} from '@zoralabs/nft-metadata';
/* or const {Agent} = require('@zoralabs/nft-metadadata'); */

const parser = new Agent({
  // Use ethers.js Networkish here: numbers (1/4) or strings (homestead/rinkeby) work here
  network: 'homestead',
  // RPC url to access blockchain with. Optional: will fallback to using cloudflare eth
  networkUrl: RPC_URL,
  // IPFS Gateway URL (optional, defaults to cloudflare)
  ipfsGatewayUrl: IPFS_URL,
  // Timeout: defaults to 40 seconds, recommended timeout is 60 seconds (in milliseconds)
  timeout: 60 * 1000,
})

// Can use typical promises or async/await to get the return value of fetchMetadata
parser.fetchMetadata('0xb7F7F6C52F2e2fdb1963Eab30438024864c313F6', '23').then((data) => {
  console.log(data);
})

Supported data encoding methods:

  1. http server uri w/ json standard metadata
  2. ipfs server uri w/ json standard metadata
  3. on-chain data-uri for metadata
  4. on-chain data-uri for metadata and content
  5. handling for zNFT's seperate metadata and content uris
  6. normalization for multiple kinds of data in properties

Special-case contracts that are handled:

  1. Using FND, SuperRare, and ZORA custom IPFS gateways
  2. Wrapped Punks (fetch image and metadata tags from official on-chain published data)
  3. Hashmaps (use a different token address)
  4. Autoglyphs (generate metadata tags from scheme and reference official website for svg renderings)
  5. Decentraland metadata parsing