🖼 use.nifti.es

A universal NFT metadata and rendering API.

🖼 use.nifti.es returns an NFT's metadata in a consistent, universal format, as well as domain-specific rendering logic in order to render arbitrary NFTs. It's like Noembed but for digital assets.

🖼 use.nifti.es is a work-in-progress, and was written for 📦 drop.nifti.es.

Usage

First, refer to your asset or collection using a ChainAgnostic CAIP-19 identifier that follows the CAIP-22 or CAIP-29 standard for Ethereum-chain assets (ERC721 or ERC1155).

It looks something like eip155:1/erc1155:0x28959Cf125ccB051E70711D0924a62FB28EAF186/0.

Then, fetch consistent metadata like so:

GET https://use.nifti.es/api/:id

{
  "tokenId": "0",
  "tokenAddress": "0x231D41A72E81fB4493908715CB77BCaCF0ce40b1",
  "metadata": {
    "name": "Aleatoric 0 // hammer drain",
    "description": "Aleatoric 0 // hammer drain\n\n> she already got one in the hammer drain\n\n> the high seas in the heal\n\n> hyped to hear\n\n>  it's dream dike hanger\n\n> made the hike here\n\nSeptember 10, 2021 at 03:09",
    "image": "ipfs://QmcisxwnYnxDvf7oTWNhpfPNuqE71VwPW2uBNawGBoCtDJ/0.mp4",
    "attributes": [
      {
        "display_type": "date",
        "trait_type": "Created",
        "value": 1631261340
      }
    ]
  },
  "tokenURI": "ipfs://QmSADMkhQPiGvJKnCGqnJLjkdPoE88gg5QG3cd4uprXYAV/0.json",
  "tokenType": "ERC721",
  "tokenURL": "https://gateway.ipfs.io/ipfs/QmSADMkhQPiGvJKnCGqnJLjkdPoE88gg5QG3cd4uprXYAV/0.json",
  "tokenURLMimeType": "application/json",
  "name": "Aleatoric 0 // hammer drain",
  "description": "Aleatoric 0 // hammer drain\n\n> she already got one in the hammer drain\n\n> the high seas in the heal\n\n> hyped to hear\n\n>  it's dream dike hanger\n\n> made the hike here\n\nSeptember 10, 2021 at 03:09",
  "imageURL": "https://gateway.ipfs.io/ipfs/QmcisxwnYnxDvf7oTWNhpfPNuqE71VwPW2uBNawGBoCtDJ/0.mp4",
  "imageURLMimeType": "video/mp4",
  "contentURL": "https://gateway.ipfs.io/ipfs/QmcisxwnYnxDvf7oTWNhpfPNuqE71VwPW2uBNawGBoCtDJ/0.mp4",
  "contentURLMimeType": "video/mp4",
  "attributes": [
    {
      "display_type": "date",
      "trait_type": "Created",
      "value": 1631261340
    }
  ]
}

Asset References (CAIP-19)

You can refer to a collection with an id like eip155:1/erc1155:0x28959Cf125ccB051E70711D0924a62FB28EAF186.

You can refer to an asset with an id like eip155:1/erc1155:0x28959Cf125ccB051E70711D0924a62FB28EAF186/0.

Check out CAIP-19 and CAIP-22 for more specifics, but it's basically chainId/assetStandard:contractAddress/tokenId.

Support

🖼 use.nifti.es supports the following Ethereum networks:

• eip155:1 — mainnet
• eip155:4 — rinkeby
• eip155:137 — matic
• 🔜 eip155:5 — görli

If you'd like to see support for more Ethereum-compatible networks, as well as other chains supported by CAIP addressing formats, please submit a PR to propose an integration.

🖼 use.nifti.es currently supports the following render types:

• empty (i.e. no metadata available)
• image (i.e. <img />, <picture />, .gif)
• oembed (i.e. any embedded media like youtube, vimeo, and other sites supported on noembed.com)
• video (i.e. <video /> or looping silent mp4 )
• audio (i.e. <audio />)
• model 3D models in gltf / glb formats, displayed via <model-viewer />
• 🔜 plaintext and other textual media types
• 🔜 artblocks
• 🔜 ethblocks
• 🔜 native rendering of Autoglyphs
• 🔜 Urbit ID sigils

see common/types/Render.ts for specifics

🖼 use.nifti.es supports well-known asset standards on Ethereum mainnet, namely:

• ERC1155
• ERC721
• CryptoPunks
• CryptoKitties
• 🔜 ERC20

If you'd like to see support for another contract standard, please submit a PR to propose an integration.

🖼 use.nifti.es supports the following URI schemas, but always rewrites them through an https proxy for ease-of-use:

• http[s]://
• ipfs://
• 🔜 dat://

References

• OpenSea metadata standard
• a list of ethereum art projects

Examples

Try out these asset references

• eip155:1/erc1155:0x495f947276749ce646f68ac8c248420045cb7b5e/27853175353995272517766450193869818424107874020190547876689048355767578525697
• eip155:1/cryptokitties:0x06012c8cf97BEaD5deAe237070F9587f8E7A266d/771769
• eip155:1/cryptopunks:0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb/1
• eip155:1/erc721:0x059edd72cd353df5106d2b9cc5ab83a52287ac3a/9083
• eip155:1/erc1155:0x28959Cf125ccB051E70711D0924a62FB28EAF186/0