פיתוח מטא-דאטה של NFT: ארכיטקטורת On-Chain ו-Off-Chain

פיתוח מטא-דאטה של NFT (on-chain/off-chain)

בחירה שגויה בארכיטקטורת מטא-דאטה מובילה לאובדן נתונים או לגז גבוה מיותר במהלך הטבעה. אנו צוות של מהנדסי בלוקצ'יין עם ניסיון בפיתוח חוזים חכמים וקולקציות NFT. אנו עוזרים לכם לבחור את הארכיטקטורה: on-chain לדצנטרליזציה מקסימלית או off-chain על IPFS לוויזואליות מורכבת. אנו מפתחים מטא-דאטה לקולקציה שלכם—מהקונספט ועד לפריסה.

function tokenURI(uint256 tokenId) public view override returns (string memory) { string memory json = Base64.encode(bytes(string(abi.encodePacked( '{"name":"Token #', Strings.toString(tokenId), '","description":"On-chain NFT","image":"data:image/svg+xml;base64,', Base64.encode(bytes(_generateSVG(tokenId))), '"}' )))); return string(abi.encodePacked("data:application/json;base64,", json)); } מחזיר מחרוזת—URL או JSON מקודד ב-Base64. מאחורי הפשטות הזו עומדת החלטה ארכיטקטונית שתקבע את גורל הקולקציה לשנים. מטא-דאטה על שער IPFS מרכזי אינו דצנטרליזציה; זה קישור לשרת Pinata שיכול להיעלם. NFT עם מטא-דאטה על החוזה ישרוד כל אירוח. עלות הפריסה הממוצעת של קולקציית on-chain של 10,000 טוקנים היא כ-0.1 ETH עם אריזה אופטימלית, בעוד ש-off-chain עולה פחות מ-0.01 ETH.

On-chain או off-chain: מה לבחור?

On-chain מלא

המטא-דאטה מאוחסן ישירות בחוזה החכם. tokenId → struct מייצר JSON ו-SVG בזמן ריצה באמצעות שרשור מחרוזות:

function tokenURI(uint256 tokenId) public view override returns (string memory) {
    string memory json = Base64.encode(bytes(string(abi.encodePacked(
        '{"name":"Token #',
        Strings.toString(tokenId),
        '","description":"On-chain NFT","image":"data:image/svg+xml;base64,',
        Base64.encode(bytes(_generateSVG(tokenId))),
        '"}'
    ))));
    return string(abi.encodePacked("data:application/json;base64,", json));
}

יתרון: קביעות מלאה, ללא תלות בשירותים חיצוניים. חיסרון: גז הפריסה גדל עם גודל ה-SVG. עבור קולקציות גנרטיביות פשוטות (בסגנון Loot, Nouns) זה עובד. עבור תצלומים—לא.

אחסון תכונות באחסון: מיפוי uint8 עם ערכי תכונות. כל תכונה היא bytes32 או uint8 כדי לחסוך בחריצים. ipfs://CID/tokenId.json תכונות נארזות 32 לחריץ אחסון אחד.

IPFS off-chain

גישה סטנדרטית לרוב הקולקציות. המטא-דאטה מועלה ל-IPFS, ipfs://QmHash/1.json מחזיר https://ipfs.io/ipfs/QmHash/1.json. דרישה קריטית: אין להשתמש בשער HTTP ב-URI.

נכון: uint256 לא נכון: uint8

השני הוא קישור לשרת HTTP ספציפי—הוא עלול להיעלם. הראשון הוא כתובת תוכן שעובדת עם כל שער IPFS.

לפינינג—Pinata + Web3.Storage כגיבוי. עבור הקולקציות החשובות ביותר—Filecoin דרך NFT.Storage לאחסון ארוך טווח עם ערובה קריפטוגרפית.

השוואה בין on-chain ל-off-chain

מטא-דאטה on-chain אמין פי 3 מ-off-chain בעת שימוש בשירות פינינג יחיד ללא גיבוי. עם זאת, עבור קולקציות עם מאות מגה-בייט של מדיה, off-chain נשאר האפשרות הריאלית היחידה.

כיצד לייעל גז עבור מטא-דאטה on-chain?

אריזת תכונות היא המפתח. אם אתם מאחסנים כל תכונה כ-tokenURI נפרד, 10 תכונות תופסות 10 חריצי אחסון. אריזת baseURI ב-32 לחריץ מפחיתה את גז הפריסה ב-40%. עבור קולקציה של 10,000 טוקנים, זה חוסך ~0.04 ETH. יצירת SVG באמצעות שרשור מחרוזות ללא ספריות חוסכת עד 30,000 גז לכל קריאת (tokenId + offset) % totalSupply. השתמשו בקידוד Base64 של JSON ישירות בחוזה—זה זול יותר מהחזרת URL.

כיצד פועל מנגנון החשיפה?

לפני החשיפה: כל הטוקנים מציגים מטא-דאטה מציין מקום. לאחר החשיפה: המטא-דאטה האמיתי נחשף. יישום נאיבי—הבעלים פשוט משנה את function fulfillRandomWords(uint256, uint256[] memory randomWords) internal override { revealOffset = randomWords[0] % maxSupply; revealed = true; } function tokenURI(uint256 tokenId) public view override returns (string memory) { require(revealed, "Not revealed yet"); uint256 metadataId = (tokenId + revealOffset) % maxSupply; return string(abi.encodePacked(baseURI, metadataId.toString(), ".json")); } —הוא מרכזי ומבוסס אמון.

סכמת Commit-reveal עם VRF: לפני ההטבעה, הבעלים מתחייב ל-hash של seed; לאחר השלמת ההטבעה, מפרסם את ה-seed וקורא ל-Chainlink VRF כדי לקבל היסט אקראי. המטא-דאטה מעורבב דטרמיניסטית דרך { "name": "Token #1", "description": "Description text", "image": "ipfs://CID/1.png", "external_url": "https://project.xyz/token/1", "attributes": [ {"trait_type": "Background", "value": "Blue"}, {"trait_type": "Rarity", "value": "Legendary", "display_type": "boost_percentage", "max_value": 100} ] } . אף אחד לא יכול לדעת מראש אילו תכונות יקבל כל טוקן.

function fulfillRandomWords(uint256, uint256[] memory randomWords) internal override {
    revealOffset = randomWords[0] % maxSupply;
    revealed = true;
}

function tokenURI(uint256 tokenId) public view override returns (string memory) {
    require(revealed, "Not revealed yet");
    uint256 metadataId = (tokenId + revealOffset) % maxSupply;
    return string(abi.encodePacked(baseURI, metadataId.toString(), ".json"));
}

השוואת שיטות חשיפה

מדוע מנגנון החשיפה חשוב להוגנות הקולקציה?

ללא מנגנון חשיפה, מטבעים יכולים לנתח מטא-דאטה לפני הרכישה—ולבחור רק טוקנים נדירים. זה הורס את הכלכלה והאמון של הקולקציה. Commit-reveal מבטיח שאף אחד לא יודע תכונות לפני הרכישה, ו-VRF מספק חלוקה אקראית. השקעה של 50,000 גז בחשיפה (פחות מ-$0.5 ב-50 gwei) מגנה על שווי השוק של הקולקציה ממניפולציה.

מבנה מטא-דאטה JSON

תקן המטא-דאטה של OpenSea ל-ERC-721 מתואר ב-EIP-721:

{
  "name": "Token #1",
  "description": "Description text",
  "image": "ipfs://CID/1.png",
  "external_url": "https://project.xyz/token/1",
  "attributes": [
    {
      "trait_type": "Background",
      "value": "Blue"
    },
    {
      "trait_type": "Rarity",
      "value": "Legendary",
      "display_type": "boost_percentage",
      "max_value": 100
    }
  ]
}

display_type שולט בתצוגה ב-OpenSea. תכונות מספריות: "number" (מספר רגיל), "boost_percentage" (פס התקדמות), "boost_number" (משנה), "date" (חותמת זמן unix → תאריך).

עבור ERC-1155 המבנה דומה, אבל tokenURI מקבל uint256 id ויכול להשתמש ב-placeholder {id} ב-URI.