Token URI

什麼是 Token URI？

Token URI 是指向加密貨幣代幣中繼資料的連結或識別碼。

在多數加密貨幣討論中，Token URI 用於 NFT，因為 NFT 通常需要名稱、描述、圖片、動畫、屬性、特徵和外部檔案等中繼資料。

官方的 RFC 3986 URI 標準將 URI 定義為可識別抽象或實體資源的精簡字元序列。

在 NFT 合約中，Token URI 通常識別與特定代幣 ID 連結的中繼資料資源。

官方的 ERC-721 標準定義了一項名為

的選用中繼資料函式，可為特定非同質化代幣回傳不同 URI。

Token URI 可以指向儲存在 IPFS、Arweave、一般網頁伺服器上的中繼資料，或透過 data URI 直接指向智能合約內的資料。

Token URI 通常不會將藝術作品本身儲存在區塊鏈上。

相反地，它通常會告訴錢包、市場、瀏覽器和去中心化應用程式，到哪裡尋找描述代幣的中繼資料檔案。

因此，Token URI 是 NFT 顯示背後最重要的技術細節之一。

在加密貨幣詞彙表中，Token URI 應理解為將鏈上代幣 ID 連結到使用者實際看到的鏈下或鏈上資訊的中繼資料指標。

為何 Token URI 在加密貨幣領域很重要

Token URI 很重要，因為區塊鏈已針對所有權、轉移和驗證進行最佳化，並不適合以低成本儲存大型媒體檔案。

NFT 可代表數位藝術、音樂、遊戲裝備、會員憑證、類網域身分、票券、憑證或現實世界資產紀錄。

區塊鏈可記錄代幣的擁有者，但使用者仍需要方式了解代幣代表什麼。

Token URI 提供此連結。

若 Token URI 無法正常運作，NFT 可能顯示為空白項目、損壞圖片，或僅顯示合約地址和代幣 ID。

對收藏者而言，Token URI 品質會影響信任、轉售價值和長期信心。

對開發者而言，Token URI 設計會影響錢包相容性、市場顯示、中繼資料更新、揭露機制和使用者體驗。

對交易者而言，Token URI 結構可揭示中繼資料是否永久、可變更、集中化或由管理員控制。

對遊戲和現實世界資產專案而言，Token URI 設計可決定動態物品資料或文件參照能否保持正確。

因此，Token URI 不只是技術連結，因為它會影響使用者如何理解代幣。

Token URI 的運作方式

Token URI 通常透過接受代幣 ID 並回傳 URI 字串的智能合約函式運作。

對於 ERC-721 NFT，錢包或 dApp 可呼叫

，向合約詢問中繼資料的位置。

合約會回傳如

、 或 等字串。

錢包或 dApp 接著擷取或解碼中繼資料。

中繼資料通常是 JSON，包含

、、 和 等欄位。

若中繼資料包含圖片欄位，錢包會擷取該圖片並顯示給使用者。

若中繼資料包含特徵，市場或應用程式可顯示稀有度詳情、遊戲數值或類別篩選條件。

此流程可透過直接合約呼叫、索引器、API、快取或錢包中繼資料服務完成。

使用者通常只會看到最終圖片和詳情，而不會看到完整解析流程。

不過，了解 Token URI 有助於使用者評估 NFT 中繼資料是否可靠。

ERC-721 中的 Token URI

ERC-721 是 Ethereum 類型網路上獨特 NFT 的主要代幣標準。

ERC-721 中繼資料擴充功能包括

、 和 。

函式在標準中屬於選用功能，但被廣泛使用，因為使用者期待 NFT 顯示中繼資料。

基本 ERC-721 專案可能儲存基礎 URI，並將其與代幣 ID 結合。

例如，合約可將

與 結合，形成 。

官方的 OpenZeppelin ERC-721 文件說明，基礎 URI 可用於計算

，產生的 URI 可以是基礎 URI 加上代幣 ID。

其他專案可能為每個代幣 ID 儲存不同 URI。

部分專案可能直接在鏈上生成完整中繼資料。

部分專案可能指向可按需建立動態中繼資料的伺服器。

由於 ERC-721 專案可透過不同方式實作中繼資料，使用者應確認特定系列如何處理其 Token URI。

ERC-1155 中的 Token URI

ERC-1155 是多代幣標準，可在一個合約內處理同質化代幣、半同質化代幣和 NFT。

官方的 ERC-1155 標準定義了可包含

佔位符的中繼資料 URI 模式。

用戶端會以符合規範的十六進位格式，將

替換為實際代幣 ID。

這表示一個 URI 範本可支援許多代幣 ID。

例如，ERC-1155 合約可能回傳

。

錢包或 dApp 必須在擷取中繼資料前，以正確代幣 ID 取代

。

這種方法可有效用於遊戲資產、版本作品、票券、會員資格及具有多種代幣類型的系列。

當用戶端錯誤處理代幣 ID 替換時，這也會成為常見的顯示錯誤來源。

官方的 OpenZeppelin ERC-1155 Metadata URI 文件說明，中繼資料 URI 擴充功能可讓每個代幣指向符合 ERC-1155 中繼資料架構的 JSON 檔案。

若使用者看見損壞的 ERC-1155 中繼資料，應考慮問題是否來自合約、儲存層、用戶端或替換流程。

Token URI 與中繼資料

Token URI 與中繼資料並不相同。

Token URI 是指標。

中繼資料是位於該指標所指位置的資訊。

例如，

是 Token URI。

在該 URI 找到的 JSON 檔案才是中繼資料。

中繼資料可能包括代幣名稱、描述、圖片連結、動畫連結、屬性、背景顏色、外部頁面、授權資訊或其他欄位。

若 Token URI 變更，中繼資料位置可能變更。

若中繼資料檔案變更，即使 Token URI 保持不變，代幣仍可能顯示不同內容。

這項區別很重要，因為部分專案聲稱中繼資料已固定，但實際上僅固定了 Token URI 格式。

使用者應同時檢查 Token URI 和它回傳的內容。

Token URI 與圖片 URI

Token URI 也不同於圖片 URI。

Token URI 通常指向中繼資料 JSON 檔案。

中繼資料 JSON 檔案隨後可能包含指向實際藝術作品或媒體檔案的

欄位。

例如，

可能回傳 。

在

中， 欄位可能指向 。

這會形成兩層可靠性。

中繼資料檔案必須持續可用。

中繼資料中所參照的圖片或媒體檔案也必須持續可用。

若圖片 URI 失效，代幣可能正確載入中繼資料，卻仍顯示損壞圖片。

良好的 NFT 盡職調查會檢查這兩個層面。

常見 Token URI 格式

最常見的 Token URI 格式為

、、 和 。

Token URI 指向由 IPFS 內容定址的內容。

Token URI 指向一般網頁伺服器或 API 端點。

Token URI 可能指向由 Arweave 託管的資料。

Token URI 將中繼資料直接包含在 URI 中。

每種格式在永久性、成本、便利性、可變性和相容性方面都有不同取捨。

HTTP 中繼資料容易建立和更新，但可能集中化且脆弱。

IPFS 中繼資料可改善內容完整性，但內容仍需釘選且可擷取。

data URI 可支援完全鏈上中繼資料，但可能較大且較難實作。

Token URI 格式能讓使用者了解專案如何看待耐久性和控制權。

Token URI 與 IPFS

IPFS 是 NFT 中繼資料最常見的儲存選擇之一。

官方的 IPFS 內容定址文件說明，IPFS 使用內容識別碼（CID）處理內容定址資料。

內容定址表示識別碼與內容本身綁定，而不僅與伺服器位置綁定。

這有助於使用者驗證中繼資料或媒體沒有在相同識別碼下遭到悄然變更。

等 Token URI 會透過 CID 指向內容。

錢包和 dApp 通常會將

連結轉換為閘道 URL，讓瀏覽器載入內容。

此轉換只是擷取方法，不會變更底層 IPFS 內容識別碼。

IPFS 內容仍需由節點、釘選服務、閘道或其他儲存基礎設施提供。

若無人儲存或提供內容，CID 仍可能有效，但中繼資料會難以擷取。

因此，IPFS 可改善完整性，但不會自動保證內容永遠可用。

Token URI 與 HTTP 連結

許多 NFT 專案使用

Token URI，因為它簡單且易於理解。

伺服器可快速生成中繼資料、更新檔案、控制揭露時間並支援動態內容。

這對遊戲、會員憑證、即時活動票券和需要中繼資料變更的專案很有用。

弱點是一般網頁連結依賴伺服器、網域、託管帳戶和專案營運。

若伺服器離線，NFT 可能無法正確顯示。

若網域到期，其他人日後可能控制中繼資料端點。

若專案變更 JSON，使用者可能看到不同圖片或特徵。

這不代表所有 HTTP Token URI 都不好。

這表示使用者應了解中繼資料是否由集中化伺服器控制，以及專案是否有長期保存計畫。

對高價值 NFT 而言，伺服器依賴應納入風險審查。

Token URI 與 Data URI

data URI 可將中繼資料直接儲存在回傳的字串中。

許多完全鏈上 NFT 使用

Token URI。

這表示合約回傳編碼 JSON，而不是外部檔案連結。

JSON 可能包含內嵌 SVG 圖片或其他鏈上媒體參照。

此方法可降低對外部儲存的依賴。

它也可能使合約成本更高、複雜度更高。

錢包和 dApp 必須正確解碼 data URI 才能顯示代幣。

data URI 對生成式藝術、身分代幣、徽章，以及可由程式碼建立的簡單媒體而言很有力。

它對大型影片、高解析度圖片或複雜遊戲檔案可能較不實用。

data URI 顯示 Token URI 並不總是代表一般網頁連結。

Token URI 與基礎 URI

基礎 URI 是用於建立特定代幣中繼資料連結的共用起始路徑。

例如，合約可能將

儲存為基礎 URI。

當有人呼叫

時，合約可能回傳 。

此模式可節省儲存空間，因為合約不必為每個代幣儲存完整 URI。

基礎 URI 邏輯在 ERC-721 系列中很常見。

它也常見於以揭露為基礎的專案，其中基礎 URI 可能從佔位位置變更為最終中繼資料位置。

風險是管理員可能能在鑄造後變更基礎 URI。

若基礎 URI 可變更，使用者應了解誰控制該權限，以及是否可鎖定或放棄。

固定基礎 URI 可提升信任，而不受限制的基礎 URI 可能造成中繼資料變更風險。

因此，基礎 URI 設計是 NFT 中繼資料安全的重要部分。

Token URI 與 NFT 揭露

NFT 揭露機制通常依賴 Token URI 變更。

揭露前，每個代幣可能指向相同的佔位中繼資料。

揭露後，合約可能更新基礎 URI，使每個代幣指向最終中繼資料檔案。

這會形成常見使用者體驗：買家在最終藝術作品出現前先看到神祕圖片。

揭露系統在透明且公平時可能是合理機制。

若專案團隊能在看到鑄造結果後操縱中繼資料，也可能產生信任問題。

使用者應詢問中繼資料是否在鑄造前已準備完成，以及揭露流程是否可驗證。

開發者在更新中繼資料時應使用清楚事件和公開文件。

揭露不應成為內部人不公平分配稀有特徵的隱藏機會。

Token URI 行為是 NFT 揭露是否值得信任的核心。

Token URI 與中繼資料更新

部分 NFT 的設計會隨時間變更。

遊戲物品可以升級。

會員憑證可以續期或到期。

現實世界資產代幣可以更新文件參照。

動態藝術代幣可以依鏈上或鏈下資料改變。

官方的 ERC-4906 中繼資料更新擴充功能定義中繼資料更新事件，協助第三方平台了解代幣中繼資料何時變更。

這很重要，因為錢包和市場通常會為了速度而快取中繼資料。

若中繼資料變更而沒有清楚更新訊號，使用者可能持續看到過時資訊。

預期且有記錄的中繼資料更新很有用。

當中繼資料更新讓發行方可無限制控制使用者購買內容時，便具有風險。

Token URI 與合約層級中繼資料

Token URI 通常描述特定代幣 ID。

合約層級中繼資料描述整個系列或合約。

官方的 ERC-7572 合約層級中繼資料標準將

標準化，用於名稱、描述和圖片等系列層級資訊。

這項區別很重要，因為一個系列同時需要代幣層級和系列層級中繼資料。

Token URI 回答單一代幣代表什麼。

合約 URI 回答整個系列或合約代表什麼。

錢包可能使用 Token URI 顯示特定 NFT 圖片。

市場可能使用合約層級中繼資料顯示系列標誌、橫幅和描述。

兩層中繼資料都應正確、耐久且透明。

完整 NFT 中繼資料設計不應只著重個別代幣檔案。

Token URI 與 ERC-1046

在所有標準討論中，Token URI 並不限於 NFT。

官方的 ERC-1046 tokenURI 互通性提案為 ERC-20 新增

函式，並擴展 ERC-20、ERC-721 和 ERC-1155 代幣類型間的中繼資料互通性。

這很重要，因為同質化代幣也可受益於更豐富的中繼資料。

同質化代幣可能需要標誌、描述、專案網站、發行方資訊、資產文件或合規詳情。

實務上，錢包和應用程式對 ERC-1046 的支援可能不同。

即使如此，該提案仍顯示代幣中繼資料是比 NFT 藝術作品更廣泛的設計議題。

隨著加密貨幣應用更為普及，標準化中繼資料可能在許多代幣類型中變得更重要。

使用者仍應驗證代幣合約和官方來源，而非只信任中繼資料欄位。

中繼資料可協助顯示資訊，但本身不能證明合法性。

Token URI 只有在回傳資訊正確且值得信任時才有用。

Token URI 與快取

快取是指暫時儲存中繼資料，讓應用程式更快載入代幣。

錢包、瀏覽器、市場和索引器通常會快取 Token URI 結果和中繼資料檔案。

這可提升效能，因為反覆擷取數千個中繼資料檔案會很慢。

缺點是快取的中繼資料可能過時。

代幣可能揭露新的藝術作品，但錢包仍顯示舊佔位圖片。

動態 NFT 可能更新特徵，但市場仍顯示先前版本。

中繼資料更新事件和重新整理按鈕可協助解決此問題。

使用者應記得，顯示問題可能來自快取，而非 NFT 合約本身。

開發者應使用可預測的中繼資料結構和標準更新事件，以便快取。

良好的 Token URI 設計可減少不必要的中繼資料混亂。

Token URI 與可變性

可變性是指 Token URI 或它所指向的中繼資料可以變更。

部分可變性對動態 NFT、遊戲、票券、憑證和演進中的會員資格很有用。

其他可變性會造成風險，因為發行方可能在使用者購買代幣後變更藝術作品或特徵。

Token URI 可不可變，但中繼資料伺服器可變更。

若智能合約擁有者可變更基礎 URI，Token URI 本身也可變更。

專案可透過鎖定基礎 URI、釘選最終 IPFS 內容或移除管理員更新權限來凍結中繼資料。

使用者應詢問中繼資料是否已凍結、動態、由管理員控制或完全位於鏈上。

開發者應在鑄造前清楚說明可變性。

隱藏的可變性可能損害信任並降低市場信心。

預期的可變性可創造實用且具吸引力的代幣體驗。

Token URI 與安全風險

Token URI 可能造成安全風險，因為錢包和 dApp 會擷取並顯示外部內容。

惡意中繼資料可能包含網路釣魚連結、虛假獎勵訊息、誤導圖片或不安全外部 URL。

垃圾 NFT 可能出現在錢包中，並透過中繼資料要求使用者前往假的領取頁面。

假系列可能複製真實系列的名稱和圖片。

遭入侵的伺服器可能變更中繼資料，將使用者導向惡意網站。

錢包和 dApp 應將中繼資料視為不受信任的輸入。

使用者不應點擊未知 NFT 中繼資料中的連結。

使用者絕不可因 NFT 圖片或描述要求而輸入助記詞、私鑰或錢包備份資訊。

Token URI 有助於顯示資料，但它也可能顯示由攻擊者控制的資料。

安全的加密貨幣操作需要對未主動要求的代幣和可疑中繼資料保持懷疑。

Token URI 與 NFT 永久性

NFT 的永久性部分取決於 Token URI 設計。

代幣可持續存在於鏈上，但其中繼資料可能消失。

若 Token URI 指向失效伺服器，NFT 可能不再正確顯示。

若 Token URI 指向未釘選的 IPFS 內容，中繼資料可能難以擷取。

若 Token URI 指向鏈上資料，永久性可能較強，但成本和彈性可能受限。

收藏者應在購買高價值 NFT 前了解這一點。

開發者應依資產的預期生命週期設計中繼資料儲存。

專案應說明中繼資料是否永久、可變更、去中心化、集中化，或依賴公司伺服器。

僅因所有權記錄於區塊鏈上，NFT 並不會自動具有永久性。

Token URI 和儲存計畫決定代幣能否在視覺及資訊層面持續具有實用性。

Token URI 與現實世界資產代幣

現實世界資產代幣可能使用 Token URI 參照文件、憑證、圖片、稽核、估價、法律條款或驗證紀錄。

這會使 Token URI 設計比一般收藏品中繼資料更為敏感。

現實世界資產 Token URI 可能需要版本控制、存取限制、文件雜湊值、發行方詳情和清楚法律背景。

損壞或過時的 Token URI 可能誤導使用者對所代表資產的理解。

僅憑 Token URI 無法證明實體資產的合法所有權。

法律協議、發行方、保管方、司法管轄區、贖回流程和文件仍然重要。

使用者應閱讀官方資產文件，而非只依賴錢包顯示的中繼資料。

開發者應避免以令人混淆的方式混合行銷圖片和具法律重要性的紀錄。

對現實世界資產而言，Token URI 品質是揭露品質的一部分。

中繼資料應支援驗證，而非取代法律盡職調查。

Token URI 與遊戲資產

遊戲資產常使用 Token URI 描述物品、角色、造型、土地、武器、徽章和成就。

遊戲 NFT 可能需要動態中繼資料，因為物品數值可在遊戲期間改變。

劍可以升級。

角色可以獲得新特徵。

土地物品可顯示升級後的建築。

Token URI 可回傳反映這些變化的中繼資料。

這讓區塊鏈遊戲資產更具互動性。

但這也表示遊戲伺服器或中繼資料引擎可能對資產效用變得重要。

若遊戲停止營運，部分動態中繼資料可能停止更新。

使用者應了解遊戲資產哪些部分真正位於鏈上，哪些部分依賴遊戲營運者。

如何檢查 Token URI

使用者可以在區塊鏈瀏覽器中查看代幣合約，並在可用時讀取

函式，以檢查 Token URI。

使用者也可使用開發者工具、錢包中繼資料檢視、NFT 分析工具或直接合約呼叫。

對 ERC-1155 代幣，使用者應記得 URI 可能包含

佔位符。

找到 URI 後，使用者可檢查它使用的是 IPFS、HTTP、Arweave 或 data URI。

若 URI 指向 JSON，使用者可透過安全檢視器開啟或擷取 JSON。

使用者應檢查圖片和屬性欄位是否指向可靠位置。

使用者應將合約地址與官方專案地址比對。

使用者應避免與中繼資料中的可疑連結互動。

檢查 Token URI 有助於盡職調查，但使用者應避免不安全網站和不受信任工具。

如有疑慮，請使用唯讀工具，且絕不可只是為了查看中繼資料而簽署交易。

常見 Token URI 問題

第一個常見問題是 Token URI 缺失或為空。

第二個常見問題是無效 JSON 中繼資料。

第三個常見問題是中繼資料內的圖片連結損壞。

第四個常見問題是無法透過任何閘道取得的 IPFS CID。

第五個常見問題是集中化伺服器離線。

第六個常見問題是揭露後快取的中繼資料過時。

第七個常見問題是 ERC-1155

佔位符處理錯誤。

第八個常見問題是中繼資料在未警告下變更。

第九個常見問題是 Token URI 由沒有明確限制的管理員金鑰控制。

第十個常見問題是惡意中繼資料誘騙使用者前往網路釣魚網站。

開發者最佳實務

建立 ERC-721 或 ERC-1155 代幣時，請使用標準中繼資料函式。

回傳錢包和應用程式可可靠解析的有效 URI 字串。

使用符合常見市場和錢包預期的清楚 JSON 中繼資料。

對長期資產優先使用耐久儲存。

中繼資料完整性重要時，使用內容定址儲存。

請釘選 IPFS 中繼資料和媒體，不要假設內容會自動持續可用。

記錄中繼資料是否可變更、已凍結、動態或由管理員控制。

中繼資料變更時，發出標準中繼資料更新事件。

公開鑄造前，請在多個錢包、瀏覽器和 dApp 中測試 Token URI 行為。

請勿依賴使用者無法理解或稽核的隱藏中繼資料控制。

使用者最佳實務

購買高價 NFT 前，請檢查 Token URI。

確認中繼資料儲存在 IPFS、Arweave、HTTP 或鏈上資料中。

確認專案是否可在鑄造後變更基礎 URI 或中繼資料。

對僅依賴集中化伺服器的 NFT 保持謹慎。

不要點擊 NFT 中繼資料內的可疑連結。

不要只因中繼資料頁面顯示有獎勵可領取就簽署交易。

確認代幣合約地址是否與官方專案來源相符。

與不熟悉的 NFT 合約或工具互動時，請使用小額測試交易。

請了解錢包中的代幣圖片不代表該系列為官方系列。

將 Token URI 審查視為 NFT 盡職調查的一部分。

FAQ

Token URI 是什麼意思？

Token URI 是指向加密貨幣代幣，尤其是 NFT，中繼資料的 URI。

tokenURI 有什麼作用？

函式通常回傳特定 ERC-721 代幣 ID 的中繼資料 URI。

Token URI 與 NFT 中繼資料相同嗎？

不相同。Token URI 是指標，中繼資料則是位於該指標位置的資訊。

Token URI 與 NFT 圖片相同嗎？

不相同。Token URI 通常指向中繼資料 JSON 檔案，而該 JSON 檔案可能包含獨立的圖片 URI。

什麼是 ERC-721 Token URI？

ERC-721 Token URI 是為獨特 NFT 由

回傳的 URI。

什麼是 ERC-1155 Token URI？

ERC-1155 Token URI 是可針對不同代幣 ID 使用

佔位符的中繼資料 URI。

IPFS Token URI 是什麼意思？

IPFS Token URI 表示中繼資料透過 IPFS 內容識別碼參照。

Token URI 可以變更嗎？

可以。若合約允許中繼資料更新、基礎 URI 變更、動態中繼資料或伺服器控制的回應，Token URI 可以變更。

NFT 中繼資料可以在 Token URI 不變的情況下變更嗎？

可以。若 Token URI 指向可變更的伺服器，或指向可在相同網頁位置被替換的檔案，中繼資料便可以變更。

鏈上 Token URI 較安全嗎？

鏈上 Token URI 可降低外部儲存依賴，但成本可能較高，且仍需要謹慎的合約設計。

為什麼我的 NFT 中繼資料沒有顯示？

中繼資料可能因 Token URI 缺失、JSON 無效、儲存無法使用、圖片連結損壞或應用程式快取過時而未顯示。

什麼是基礎 URI？

基礎 URI 是代幣合約可與代幣 ID 結合、用以建立完整 Token URI 的共用前綴。

Token URI 設計中的揭露是什麼？

揭露是一種中繼資料更新，其中佔位 Token URI 會被替換或重新導向至最終代幣中繼資料。

Token URI 中繼資料可以是惡意的嗎？

可以。中繼資料可能包含網路釣魚連結、誤導描述、虛假獎勵訊息或不安全外部參照。

使用者信任 Token URI 前應檢查什麼？

使用者應檢查儲存類型、合約權限、官方合約地址、中繼資料可用性、圖片連結、可變性規則和可疑外部連結。

結論

Token URI 是將區塊鏈代幣連結至使用者在錢包、瀏覽器、市場和 dApp 中看到資訊的中繼資料指標。

對 ERC-721 NFT 而言，它通常由

回傳。

對 ERC-1155 代幣而言，它可能透過使用

佔位符的 URI 範本回傳。

Token URI 可指向 IPFS、Arweave、HTTPS 伺服器，或直接儲存在智能合約內的資料。

每種格式在永久性、彈性、成本、相容性和信任方面都有不同取捨。

Token URI 設計會影響 NFT 是否正確顯示、中繼資料是否能變更、圖片是否持續可用，以及使用者能否驗證自己持有的內容。

開發者應使用標準函式、有效中繼資料、耐久儲存、清楚更新事件和透明可變性規則。

使用者在信任高價 NFT、動態資產、遊戲物品或現實世界資產代幣前，應檢查 Token URI 結構。

使用者也應避免可疑中繼資料連結，並記得錢包顯示不代表真實性證明。

Token URI 是 NFT 價值和可用性背後隱而重要的技術基礎之一。

在加密貨幣詞彙表中，Token URI 應理解為由代幣合約回傳或使用，用於識別描述特定代幣之中繼資料資源的 URI。