Metadata Guide

📋 Overview

This guide explains how to generate and use metadata for Innovation City Digital License NFTs. The metadata follows OpenSea standards and includes comprehensive business license information.

🎯 Metadata Structure

Example Metadata

{
  "name": "Standard Company - 0701013",
  "creator": "RAK DAO",
  "description": "An official, non-transferable business license issued by the RAK DAO. This specific credential, License Number 0701013, is held by Saurabh Limited. It serves as a verifiable, on-chain proof of licensure.",
  "image": "https://indigo-many-gecko-585.mypinata.cloud/ipfs/bafybeifgf67kdirmuucjai7dxqle6gwab2xvyshnmgztwxcmc3kpz2akpm",
  "external_url": "https://innovationcity.com/",
  "background_color": "FFFFFF",
  "type": "image/jpeg",
  "attributes": [
    {
      "trait_type": "License Type",
      "value": "Standard Company"
    },
    {
      "trait_type": "Identifier",
      "value": "0701013"
    },
    {
      "trait_type": "Holder Name",
      "value": "Saurabh Limited"
    },
    {
      "trait_type": "Issue Date",
      "value": 1721865600,
      "display_type": "date"
    },
    {
      "trait_type": "Expiry Date",
      "value": 1787184000,
      "display_type": "date"
    },
    {
      "trait_type": "Status",
      "value": "Active"
    },
    {
      "trait_type": "Activity Name",
      "value": "Cost Control & Risk Management Services"
    },
    {
      "trait_type": "Legal Type",
      "value": "Company Limited by Shares"
    }
  ]
}

🔧 Metadata Fields

Required Fields

Field	Type	Description	Example
name	string	License display name	"Standard Company - 0701013"
description	string	License description	"An official, non-transferable business license..."
image	string	License image URL	"https://ipfs.io/ipfs/..."
attributes	array	License attributes	See attributes section

Optional Fields

Field	Type	Description	Example
creator	string	License issuer	"RAK DAO"
external_url	string	External website	"https://innovationcity.com/"
background_color	string	Background color	"FFFFFF"
type	string	Image type	"image/jpeg"

📊 Attributes Structure

Required Attributes

{
  "trait_type": "License Type",
  "value": "Standard Company"
},
{
  "trait_type": "Identifier", 
  "value": "0701013"
},
{
  "trait_type": "Holder Name",
  "value": "Saurabh Limited"
},
{
  "trait_type": "Status",
  "value": "Active"
}

Date Attributes

{
  "trait_type": "Issue Date",
  "value": 1721865600,
  "display_type": "date"
},
{
  "trait_type": "Expiry Date", 
  "value": 1787184000,
  "display_type": "date"
}

Business Attributes

{
  "trait_type": "Activity Name",
  "value": "Cost Control & Risk Management Services"
},
{
  "trait_type": "Legal Type",
  "value": "Company Limited by Shares"
}

// Mint with metadata URI
function safeMint(
    address to,
    string calldata uri,  // Points to metadata JSON
    uint64 expiryTs
) external onlyRole(MINTER_ROLE) returns (uint256) {
    // ... minting logic
}

This metadata guide ensures Innovation City Digital Licenses are properly displayed and managed across all platforms while maintaining security and professional standards.