البيانات الوصفية للرمز
tokenURI وJSON
البيانات الوصفية للرمز درس مجاني في Web3 & DApp Development Fundamentals على CoddyKit. هذا هو الدرس 3 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Web3 & DApp Development Fundamentals، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Web3 & DApp Development Fundamentals 4 دروس في المجموع.
بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.
What Is Token Metadata?
Metadata describes what an NFT actually represents: its name, description, image, and attributes. While ownership is stored on-chain, the descriptive data usually lives off-chain in a JSON file.
The link between them is the tokenURI.
The tokenURI Function
The metadata extension defines tokenURI(tokenId), which returns a URL pointing to the JSON metadata for that specific token.
<code>function tokenURI(uint256 tokenId) external view returns (string memory);</code>The Metadata JSON Schema
The standard JSON has a few well-known fields. Marketplaces like OpenSea read these to display the NFT.
<code>{
'name': 'Cool Cat #42',
'description': 'A very cool cat.',
'image': 'ipfs://Qm.../42.png',
'attributes': [
{ 'trait_type': 'Color', 'value': 'Blue' }
]
}</code>Attributes and Traits
The attributes array lists traits as objects with trait_type and value. These power rarity rankings and filtering on marketplaces.
<code>'attributes': [
{ 'trait_type': 'Background', 'value': 'Sky' },
{ 'trait_type': 'Level', 'value': 5 }
]</code>Per-Token URIs
One approach stores a unique URI per token in a mapping. This is flexible but uses more storage.
<code>mapping(uint256 => string) private _tokenURIs;
function tokenURI(uint256 id) public view returns (string memory) {
return _tokenURIs[id];
}</code>Base URI Pattern
A cheaper approach stores a single base URI and appends the token id. This works when files are named sequentially like 1.json, 2.json, and so on.
<code>string private baseURI = 'ipfs://QmFolder/';
function tokenURI(uint256 id) public view returns (string memory) {
return string(abi.encodePacked(baseURI, _toString(id), '.json'));
}</code>Why IPFS?
Hosting metadata on a normal server is risky: if the server goes down or the file changes, the NFT breaks. IPFS uses content-addressed hashes, so a URI like ipfs://Qm... always points to the exact same immutable content.
Content Addressing
An IPFS hash (CID) is derived from the file's content. Change one byte and the hash changes. This guarantees the metadata cannot be silently swapped, preserving the NFT's integrity.
<code>// image: 'ipfs://bafybeih.../art.png'
// the CID itself proves the content is unaltered</code>On-Chain Metadata
For fully decentralized NFTs, you can store metadata entirely on-chain by returning a base64-encoded data URI. This costs more gas but removes any off-chain dependency.
<code>// returns: data:application/json;base64,<encoded JSON>
// fully on-chain, no IPFS or server needed</code>Reveal Mechanics
Many drops mint with a placeholder URI, then switch the base URI after sale to reveal the real art. This prevents buyers from sniping rare traits before mint.
<code>bool public revealed = false;
function setRevealed() public onlyOwner {
baseURI = 'ipfs://QmRealArt/';
revealed = true;
}</code>How Marketplaces Read It
A marketplace calls tokenURI(id), fetches the returned JSON, then loads the image and renders attributes. Following the standard schema is what makes your NFT display correctly everywhere.
Quick Check
Test your understanding of token metadata.
Recap
You learned about NFT metadata:
tokenURI(id)returns a link to the token's JSON metadata- The JSON holds name, description, image, and attributes
- Use per-token URIs or a base URI + id pattern
- IPFS content addressing keeps metadata immutable; on-chain metadata removes dependencies entirely
- Reveal patterns hide art until after mint
الأسئلة الشائعة
هل درس «البيانات الوصفية للرمز» مجاني؟
نعم — نص درس «البيانات الوصفية للرمز» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Web3 & DApp Development Fundamentals، انتقل إلى CoddyKit PRO. تتضمن دورة Web3 & DApp Development Fundamentals 4 دروس في المجموع.
ماذا ستتعلم في «البيانات الوصفية للرمز»؟
tokenURI وJSON تتمرن على Web3 & DApp Development Fundamentals مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ Web3 & DApp Development Fundamentals؟
لا تُشترط خبرة سابقة. Web3 & DApp Development Fundamentals على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 3 من أصل 4.
كم من الوقت يستغرق درس «البيانات الوصفية للرمز»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس Web3 & DApp Development Fundamentals هذا؟
نعم. كل درس في Web3 & DApp Development Fundamentals يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- المعيار ERC-721
- سك NFTs
- البيانات الوصفية للرمز
- الأسواق