什麼是代幣中繼資料綱要?
代幣中繼資料綱要(Token Metadata Schema)是一種結構化格式,定義加密貨幣代幣相關資訊應如何由錢包、去中心化應用程式(dApp)、瀏覽器、市集、遊戲及索引工具寫入、儲存和讀取。在大多數加密貨幣討論中,代幣中繼資料綱要是指用於描述 NFT 與其他代幣化資產的 JSON 結構。此綱要會告訴應用程式可預期哪些欄位,例如
官方 ERC-721 標準指出,代幣 URI 可指向符合 ERC-721 Metadata JSON Schema 的 JSON 檔案。
官方 ERC-1155 標準則為多代幣合約定義了 ERC-1155 Metadata URI JSON Schema。
中繼資料綱要很重要,因為它有助於不同應用程式一致地顯示同一個代幣。若沒有綱要,每個專案都可能以不同方式命名欄位,錢包便難以判斷哪個值是圖片、哪個值是描述,以及哪個值代表特徵。對新手而言,理解代幣中繼資料綱要最簡單的方式,就是將其視為加密資產的標籤格式。區塊鏈可證明代幣存在及其擁有者,而中繼資料綱要則說明該代幣代表什麼。代幣中繼資料綱要為何在加密貨幣領域重要
代幣中繼資料綱要之所以重要,是因為使用者不會只與原始代幣 ID 互動。使用者會與圖片、名稱、描述、特徵、等級、徽章、稀有度資訊、可解鎖內容及其他人類可讀的詳細資料互動。錢包只有在知道如何讀取中繼資料時,才能正確顯示代幣。遊戲只有在理解物品的屬性與媒體欄位時,才能正確顯示該物品。市集只有在特徵以可預測方式建構時,才能正確篩選系列。接受 NFT 作為抵押品的借貸協議,可能需要準確的系列、特徵和媒體資訊,以支援估值流程。現實世界資產平台可能需要引用文件、發行方、估值、法律條款或驗證狀態的中繼資料欄位。代幣門檻應用程式可能需要中繼資料,以驗證代幣是否授予特定會員等級的存取權。當中繼資料結構清楚時,應用程式便可自動讀取。當中繼資料雜亂或不一致時,使用者可能看到損壞的圖片、缺少的特徵、不正確的名稱或過時的資產詳細資料。這也是為何中繼資料綱要設計屬於加密貨幣使用者體驗的一環,而不僅是開發人員的技術細節。代幣中繼資料綱要與 Token URI
Token URI 是指向代幣中繼資料的連結或識別碼。代幣中繼資料綱要則是該連結所取得,或該編碼回應內資料的結構。例如,ERC-721 合約可透過
ERC-721 中的代幣中繼資料綱要
ERC-721 是 Ethereum 類型網路上用於獨特 NFT 的經典標準。ERC-721 中繼資料擴充功能包含
ERC-721 標準透過簡單的 JSON 綱要描述中繼資料,其中可包含
這表示代幣 ID
ERC-1155 中的代幣中繼資料綱要
ERC-1155 是一種多代幣標準,可在同一份合約內管理同質化、半同質化與非同質化代幣。ERC-1155 中繼資料綱要尤其重要,因為一份合約可能包含許多具有不同意義的代幣 ID。單一 ERC-1155 合約可代表遊戲幣、武器、盔甲、票券、徽章、限量版物品和獨特收藏品。ERC-1155 標準允許 URI 包含
用戶端軟體會在擷取中繼資料前,以實際代幣 ID 取代
官方 OpenZeppelin ERC-1155 Metadata URI 文件說明,中繼資料 URI 擴充功能會將每個代幣指向符合 ERC-1155 Metadata URI JSON Schema 的 JSON 檔案。
ERC-1155 中繼資料可包含
代幣中繼資料綱要中的常見欄位
最常見的欄位是
另一個常見欄位是
在用戶端支援的情況下,
有些專案會新增
基本 NFT 中繼資料綱要範例
簡單的 NFT 中繼資料檔案通常是一個包含數個清楚欄位的 JSON 物件。"name": "Example NFT #1",
"description": "A sample NFT metadata object used to explain token metadata schema.",
"image": "ipfs://bafyExampleCID/image.png",
"attributes": [
{
"trait_type": "Background",
"value": "Blue"
},
{
"trait_type": "Level",
"value": 5
}
]
}
名稱欄位
例如
遊戲物品可能使用
會員代幣可能使用
描述欄位
圖片欄位
屬性欄位
每項屬性通常是包含
例如,
對遊戲物品而言,
Properties 欄位
ERC-1155 中繼資料範例通常使用
代幣中繼資料綱要與 IPFS
IPFS 常用於儲存代幣中繼資料與媒體檔案。官方 IPFS 內容定址文件說明,IPFS 使用內容識別碼(CID),依據資料內容本身來參照資料。
這對中繼資料很有幫助,因為 CID 可顯示被參照的內容是否已變更。若 JSON 中繼資料變更,CID 也應變更。相較於可在相同位址變更內容的一般伺服器 URL,這可為使用者提供更強的完整性保障。然而,IPFS 並不會自動保證永久可用性。中繼資料和圖片檔案需要被釘選或由節點提供服務,才能讓用戶端取得。儲存在 IPFS 的中繼資料綱要,若無人維持內容可用,仍可能失效。開發人員應在鑄造代幣前規劃釘選與長期儲存方案。使用者應了解,內容定址可提升完整性,但可用性仍需要儲存支援。代幣中繼資料綱要與 HTTP 儲存
有些專案將中繼資料儲存在標準 HTTPS 伺服器上。這可使中繼資料更容易更新、生成及快速提供。這種方式常見於動態 NFT、遊戲資產、揭露機制,以及依賴活躍後端系統的資產。缺點是 HTTP 中繼資料依賴伺服器正常運作、網域控制權、託管安全性及專案營運。若伺服器離線,代幣中繼資料可能從使用者介面消失。若網域到期,中繼資料端點可能變得不安全或無法使用。若伺服器營運者變更 JSON,使用者可能在沒有鏈上變更的情況下看到不同內容。HTTP 中繼資料不一定有問題,但應清楚揭露。開發人員應說明中繼資料是否可變動,以及儲存將維持多久。使用者對完全依賴集中式中繼資料伺服器的高價值資產應更為謹慎。代幣中繼資料綱要與鏈上中繼資料
鏈上中繼資料是指代幣中繼資料直接由智能合約儲存或生成。這可降低對外部儲存系統的依賴。合約可能回傳包含編碼中繼資料的
代幣中繼資料綱要與動態 NFT
動態 NFT 是其中繼資料可依事件、時間、遊戲進度、預言機資料、治理決策或使用者操作而變更的代幣。動態中繼資料可讓 NFT 更具實用性與互動性。遊戲角色可以升級。會員通行證可從有效狀態變更為到期狀態。使用者完成新成就後,憑證可更新。現實世界資產代幣可更新驗證狀態或文件參照。中繼資料綱要應清楚標示動態欄位。使用者應知道哪些欄位可以變更,以及誰控制這些變更。動態 NFT 不應在模糊的中繼資料文字背後隱藏任意的管理員控制權。良好的動態中繼資料具備可預測性、文件說明,並與有意義的代幣行為連結。代幣中繼資料綱要與中繼資料更新
中繼資料更新常見於揭露、遊戲進度、資產驗證及錯誤修正。官方 ERC-4906 中繼資料更新擴充功能定義了當 NFT 中繼資料變更時通知用戶端的事件。
這很重要,因為錢包與索引器常為提升速度而快取中繼資料。若中繼資料變更卻未發出更新訊號,使用者可能持續看到舊資訊。中繼資料綱要應搭配清楚的更新行為。對於揭露,專案應說明預留位置中繼資料何時將變更為最終中繼資料。對於動態資產,專案應說明哪些事件會觸發中繼資料變更。對於由管理員控制的更新,專案應揭露誰可變更中繼資料及其條件。透明的中繼資料更新可建立信任。隱藏的中繼資料更新會造成不確定性,並可能損害代幣價值。代幣中繼資料綱要與合約層級中繼資料
代幣層級中繼資料描述特定代幣 ID。合約層級中繼資料描述整份合約或整個系列。代幣中繼資料綱要與 ERC-1046
ERC-1046 將代幣 URI 的概念擴展到基本 NFT 使用案例以外。官方 ERC-1046 tokenURI 互通性提案為 ERC-20 新增 token URI 支援,並擴展不同代幣類型的中繼資料互通性。
這很重要,因為同質化代幣也可能需要中繼資料。同質化代幣可能需要 Logo、描述、發行方詳細資料、官方連結、合規說明或文件參照。標準化中繼資料可協助錢包與應用程式更清楚地呈現同質化代幣。然而,使用者不應將中繼資料欄位視為合法性的證明。詐騙代幣也可能提供精美的 Logo 與描述。合約地址、發行方、流動性、安全性、代幣經濟學及官方來源仍然重要。ERC-1046 顯示中繼資料綱要不僅關乎收藏品圖片。它們也是讓代幣資訊具備互通性的更廣泛努力之一。代幣中繼資料綱要與 ERC-5625
ERC-5625 是一項與 NFT 去中心化儲存資訊相關的提議中繼資料擴充功能。官方 ERC-5625 NFT Metadata JSON Schema dStorage Extension會在 NFT 中繼資料中新增去中心化儲存屬性,讓資產儲存資訊可更清楚地描述。
這很重要,因為中繼資料通常指向儲存在區塊鏈外部的檔案。代幣可能看似耐久,但其媒體可能依賴不明確的儲存安排。新增與儲存相關的中繼資料,可協助使用者與應用程式理解資產資料的儲存位置。這也有助於辨識內容是否儲存在 IPFS、Arweave 或其他去中心化儲存系統。儲存中繼資料本身並不保證永久性。它讓應用程式能以更清楚的方式描述及檢查儲存假設。對高價值 NFT 而言,去中心化儲存詳細資料可能是盡職調查的重要部分。當中繼資料綱要同時說明資產是什麼,以及其資料如何保存時,會更為完善。綱要驗證
綱要驗證是指檢查中繼資料是否遵循預期結構。驗證工具可檢查 JSON 是否有效。它可檢查必要欄位是否存在。它可檢查圖片欄位是否為有效 URI。它可檢查 attributes 是否格式化為陣列。它可檢查數值是否以一致方式儲存。它可檢查媒體欄位是否指向支援的檔案類型。綱要驗證有助於避免錢包顯示損壞與市集錯誤。它也有助於開發人員在鑄造或揭露前發現錯誤。專案應在將中繼資料永久發布至去中心化儲存前完成驗證。中繼資料綱要與稀有度
稀有度工具通常依賴 NFT 中繼資料的
例如,某些工具可能將
若一個代幣使用
中繼資料綱要與遊戲資產
遊戲資產通常需要比簡單藝術 NFT 更豐富的中繼資料綱要。遊戲物品可能需要等級、耐久度、攻擊力、防禦力、稀有度、類別、元素、冷卻時間、升級狀態或裝備欄位等欄位。角色 NFT 可能需要經驗值、技能、物品欄、陣營、生命值和視覺狀態等欄位。其中部分欄位可能在遊戲過程中變更。開發人員應決定哪些值屬於鏈上,哪些值屬於中繼資料。重要的遊戲邏輯不應只依賴未經驗證的鏈下中繼資料。遊戲合約或伺服器應在允許高價值操作前驗證關鍵值。中繼資料可改善顯示,但遊戲規則應受可信邏輯保護。使用者應了解物品價值是否取決於遊戲持續營運。中繼資料綱要可以描述遊戲資產,但遊戲生態系統賦予它效用。中繼資料綱要與現實世界資產
現實世界資產代幣可能使用中繼資料綱要描述鏈下資產。範例可包括不動產紀錄、商品、發票、債券、基金單位、收藏品、碳權或與身分連結的憑證。中繼資料綱要可能包含發行方、資產類別、文件 URI、估值日期、管轄區、保管機構、驗證狀態及文件雜湊值等欄位。這些欄位可協助使用者理解代幣,但不會自動產生法律所有權。法律權利取決於發行方文件、合約、保管安排、管轄區及贖回規則。現實世界資產中繼資料綱要應將行銷資訊與法律上重要的參照資料區隔開來。它應避免無法驗證的模糊聲明。在可行時,應透過雜湊值或耐久儲存維護文件完整性。使用者在依賴現實世界資產中繼資料前,應閱讀官方法律文件。中繼資料可支援揭露,但無法取代法律盡職調查。中繼資料綱要與安全風險
代幣中繼資料可能產生安全風險,因為錢包與 dApp 會從外部來源擷取及顯示資料。惡意中繼資料檔案可能包含網路釣魚連結、假獎勵訊息、誤導性圖片或危險的外部 URL。垃圾 NFT 可能出現在錢包中,並透過中繼資料要求使用者造訪假冒的領取頁面。假冒系列可能複製真實系列的名稱、圖片和屬性。遭入侵的中繼資料伺服器,日後可能將原本看似安全的中繼資料變更為惡意內容。錢包與 dApp 應將中繼資料視為不受信任的輸入內容。它們不應執行中繼資料中的指令碼。應盡可能淨化外部連結與媒體內容。使用者絕不應僅因中繼資料要求,就輸入助記詞、私鑰或錢包備份資訊。外觀清楚的中繼資料綱要並不能證明代幣安全。中繼資料綱要與可變性
可變性是指中繼資料可在代幣鑄造後變更。某些專案因代幣具動態性而需要可變性。其他專案則承諾中繼資料將永久且不變。中繼資料綱要應符合專案的承諾。若系列以不可變藝術品行銷,中繼資料不應仍由管理員不受限制地控制。若代幣是遊戲物品,動態中繼資料可能是預期功能。若代幣是憑證,更新可能有必要,但應可稽核。使用者應檢查誰控制中繼資料更新。開發人員應記錄中繼資料是否不可變、動態、由管理員控制或由治理機制控制。隱藏的可變性是 NFT 中繼資料最大的信任風險之一。中繼資料綱要與快取
快取是指暫時儲存中繼資料,讓應用程式可更快載入代幣。錢包、市集、瀏覽器和索引器常會快取中繼資料。快取很有用,因為重複擷取每個中繼資料檔案會很慢。問題在於快取的中繼資料可能過時。在揭露期間,某些應用程式可能在最終中繼資料發布後,仍顯示預留位置圖片。在動態更新期間,某些應用程式可能在快取重新整理前,仍顯示舊屬性。中繼資料更新標準可協助用戶端知道何時重新整理快取資料。當預期中繼資料會變更時,開發人員應支援更新事件。使用者應了解,顯示延遲可能源自快取,而非代幣失效。完善的中繼資料綱要搭配良好的快取重新整理行為時效果最佳。中繼資料綱要與索引器
索引器收集區塊鏈資料,並為應用程式整理資料。對代幣中繼資料而言,索引器可能呼叫
開發人員最佳實務
使用廣泛支援的中繼資料欄位,例如
使用者最佳實務
檢查代幣中繼資料儲存在 IPFS、伺服器、Arweave 或鏈上。驗證官方合約地址,而非信任代幣名稱或圖片。對包含外部連結或獎勵聲明的中繼資料保持謹慎。不要僅為查看中繼資料而簽署交易。不要在代幣中繼資料連結的任何頁面輸入助記詞。檢查中繼資料是否可由管理員變更。在 NFT 揭露期間仔細檢查屬性。了解顯示的圖片並不能證明真實性。對現實世界資產代幣,應閱讀中繼資料檔案以外的法律文件。應將中繼資料視為有用資訊,而非價值或安全性的獨立證明。常見代幣中繼資料綱要錯誤
第一項錯誤是發布無效 JSON。第二項錯誤是在不同代幣之間使用不一致的屬性名稱。第三項錯誤是讓圖片欄位指向無法使用的檔案。第四項錯誤是在未揭露的情況下依賴集中式伺服器。第五項錯誤是在鑄造後沒有清楚規則地變更中繼資料。第六項錯誤是忘記 ERC-1155 的
常見問題
Token Metadata Schema 是什麼意思?
Token Metadata Schema 是指用於描述加密貨幣代幣中繼資料的結構化格式,通常採用 JSON。Token Metadata Schema 僅適用於 NFT 嗎?
不是。它最常見於 NFT,但中繼資料綱要也可支援同質化代幣、現實世界資產代幣和應用程式專屬代幣。NFT 中繼資料有哪些常見欄位?
常見欄位包括
Token URI 與 Token Metadata Schema 有何差異?
Token URI 指向中繼資料,而 Token Metadata Schema 定義該處中繼資料的結構。什麼是 ERC-721 Metadata JSON Schema?
這是 ERC-721 為透過 token URI 回傳的 NFT 中繼資料所描述的基本中繼資料綱要。什麼是 ERC-1155 Metadata URI JSON Schema?
這是 ERC-1155 代幣使用的中繼資料綱要,支援透過
代幣中繼資料可以儲存在 IPFS 嗎?
可以。代幣中繼資料可透過 IPFS 儲存,並使用有助於驗證內容完整性的內容識別碼。IPFS 是否保證中繼資料永遠可用?
不是。IPFS 可改善內容定址,但檔案仍需被釘選或提供服務,使用者才能取得。代幣中繼資料能在鑄造後變更嗎?
可以。若專案使用動態中繼資料、可變伺服器、管理員控制的基礎 URI 或可更新的解析器邏輯,中繼資料便可變更。什麼是動態代幣中繼資料?
動態代幣中繼資料是指會依時間、遊戲進度、使用者活動、預言機資料、合約狀態或專案更新而變更的中繼資料。ERC-4906 的用途是什麼?
ERC-4906 定義中繼資料更新事件,讓錢包與應用程式知道何時應重新整理 NFT 中繼資料。ERC-7572 的用途是什麼?
ERC-7572 將
中繼資料可能具有惡意嗎?
可能。中繼資料可包含網路釣魚連結、假獎勵聲明、誤導性圖片或不安全的外部參照。為什麼 NFT 特徵有時會顯示不正確?
NFT 特徵可能因屬性不一致、缺失、拼寫錯誤、遭快取,或格式不受用戶端理解而顯示不正確。什麼樣的 Token Metadata Schema 才算良好?
良好的 Token Metadata Schema 應有效、一致、耐久、有文件說明、與常見工具相容,並清楚說明中繼資料是否可變更。結論
代幣中繼資料綱要是告訴錢包、dApp、瀏覽器、遊戲、市集及索引器如何讀取加密貨幣代幣資訊的結構化格式。它對 NFT 最為重要,因為 NFT 所有權儲存在鏈上,而名稱、圖片、特徵、描述與媒體通常透過中繼資料檔案儲存。ERC-721 和 ERC-1155 都定義了中繼資料模式,協助應用程式一致地解析與顯示代幣資訊。良好的中繼資料綱要可讓代幣更容易理解、篩選、交易、驗證及在應用程式中使用。不完善的中繼資料綱要可能造成圖片損壞、特徵缺失、資料過時、網路釣魚風險與使用者困惑。重要欄位包括
您可能也喜歡
WhatsMiner M30S++
Web3 網域
Web3 專案
熱門
目前熱門備受市場關注的加密貨幣
最高成交量
按交易量計算交易量最大的加密貨幣

