Base URI

加密貨幣中的 Base URI 是什麼？

Base URI 是智能合約用來建立加密貨幣系列中代幣完整中繼資料連結的共用起始路徑。

在 NFT 和代幣中繼資料系統中，URI 會告訴錢包、區塊鏈瀏覽器和應用程式，JSON 中繼資料的位置；這些資料用來描述代幣。

官方 ERC-721 標準將 tokenURI 定義為一項函式，會為指定資產傳回專屬的統一資源識別碼（Uniform Resource Identifier）。

Base URI 通常會與代幣 ID 結合，產生完整的 tokenURI。

例如，Base URI 可能是 ipfs://exampleCID/，而代幣 ID 25 解析後可能是 ipfs://exampleCID/25。

另一種設計則會在完整中繼資料路徑中加入副檔名，例如 ipfs://exampleCID/25.json。

實際結果取決於智能合約建立 tokenURI 的方式。

OpenZeppelin 的 ERC-721 文件說明，_baseURI 函式用於計算 ERC721.tokenURI，產生的 URI 可以是 baseURI 與 tokenId 的串接結果。

因此，Base URI 是節省 Gas、整理中繼資料，以及更輕鬆管理大型 NFT 系列的實用工具。

對加密貨幣使用者而言，Base URI 很重要，因為它會影響 NFT 圖片、特徵、描述和其他中繼資料的載入位置。

Base URI 為何重要

Base URI 很重要，因為代幣所有權和代幣中繼資料不一定儲存在同一處。

區塊鏈可能會儲存代幣持有者、代幣 ID、轉帳紀錄、授權和合約邏輯。

圖片、名稱、描述、屬性、動畫和外部媒體則通常儲存在區塊鏈之外。

Base URI 是鏈上代幣與鏈下或去中心化中繼資料位置之間的橋梁。

如果 Base URI 正確，錢包和應用程式便能正常顯示代幣。

如果 Base URI 錯誤、失效、由中心化服務控制或遭到惡意變更，代幣可能會顯示缺失的圖片、錯誤特徵或誤導資訊。

這對 NFT 尤其重要，因為使用者感知到的許多價值都可能取決於中繼資料。

只有在中繼資料可取得且值得信賴時，具有稀有特徵的收藏品才可能顯得有價值。

遊戲道具可能需要中繼資料來顯示等級、職業、視覺設計或用途。

會員 NFT 可能需要中繼資料來顯示會員等級或存取權限。

因此，Base URI 會影響使用者體驗、中繼資料完整性、系列可信度，以及資產資訊的長期可讀性。

Base URI 的運作方式

Base URI 通常會以共用前綴的形式儲存或回傳於代幣合約中。

接著，合約會附加代幣專屬的值（通常是代幣 ID），以建立完整的中繼資料 URI。

例如，若 Base URI 是 ipfs://bafyExampleCollection/，代幣 ID 為 100，最終的 tokenURI 可能會是 ipfs://bafyExampleCollection/100。

如果合約會加上 JSON 後綴，最終 tokenURI 可能會是 ipfs://bafyExampleCollection/100.json。

有些合約會將 Base URI 儲存為狀態變數，並允許獲授權的地址更新。

有些合約則會在部署時將 Base URI 寫死，之後無法變更。

有些合約會依據揭露狀態、代幣類型、鏈 ID 或自訂邏輯，回傳不同的 Base URI。

有些合約完全不使用 Base URI，而是為每個代幣儲存各自的完整 URI。

並非所有 NFT 合約都必須使用 Base URI。

Base URI 是常見的實作模式，可有效建立代幣中繼資料路徑。

Base URI 與 tokenURI

tokenURI 是特定代幣所傳回的完整 URI。

Base URI 是可重複使用的前綴，可用來建立多個 tokenURI。

在 ERC-721 合約中，tokenURI 屬於可選的中繼資料擴充功能。

ERC-721 標準指出，tokenURI 可以指向符合 ERC-721 Metadata JSON Schema 的 JSON 檔案。

該 JSON 檔案通常包含 name、description 和 image 等欄位。

Base URI 並不是 JSON 中繼資料本身。

它是協助錢包或應用程式找到 JSON 中繼資料的路徑。

簡單的合約可能會將 Base URI 與代幣 ID 串接，以回傳 tokenURI。

較複雜的合約則可能為每個代幣回傳完全自訂的 URI。

動態 NFT 合約可能會依鏈上狀態產生 tokenURI，而非使用固定的 Base URI。

使用者應留意 tokenURI 的回傳結果，因為那才是應用程式實際使用的中繼資料位置。

ERC-721 NFT 中的 Base URI

ERC-721 是最常用於一對一 NFT 和唯一代幣 ID 的代幣標準。

每個 ERC-721 代幣在特定合約中都有唯一的代幣 ID。

合約地址與代幣 ID 這組資料可在該區塊鏈上唯一識別 NFT。

中繼資料擴充功能讓應用程式可以向合約查詢 tokenURI。

Base URI 可讓合約不必為每個代幣都儲存完整 URI。

這很實用，因為在鏈上儲存長字串的成本可能很高。

系列可以只儲存一個 Base URI，並使用代幣 ID 建立個別連結，而不必儲存 10,000 個完整中繼資料連結。

個人頭像系列、遊戲道具、會員通行證、藝術系列和收藏品套組都常採用這種設計。

例如，代幣 1、代幣 2 和代幣 3 可以共用相同的 Base URI，但各自指向不同的中繼資料檔案。

共用 Base URI 能讓結構簡單且易於預測。

ERC-1155 代幣中的 Base URI

ERC-1155 是一種多代幣標準，可在同一份合約中支援同質化代幣、半同質化代幣和 NFT。

ERC-1155 的中繼資料處理方式與許多 ERC-721 實作不同。

官方 ERC-1155 標準指出，當 URI 字串中出現 {id} 時，客戶端可在 URI 中替換該 ID。

客戶端必須將 {id} 替換為實際代幣 ID，並使用小寫十六進位格式；必要時補足至 64 個字元。

這讓大量代幣 ID 能共用同一種 URI 模式。

例如，URI 可能如下：https://example.com/metadata/{id}.json。

錢包或應用程式會將 {id} 替換為格式化後的代幣 ID，以找到正確的 JSON 檔案。

這與 Base URI 的用途相似，都是透過共用模式建立多個代幣中繼資料連結。

不過，ERC-1155 使用特定的替換規則，並非許多 ERC-721 合約所採用的簡單「Base URI 加上代幣 ID」模式。

開發者不應假設 ERC-721 和 ERC-1155 的中繼資料路徑建構方式相同。

Base URI 與 NFT 中繼資料

NFT 中繼資料是用來告訴使用者代幣代表什麼的結構化資訊。

中繼資料可能包含名稱、描述、圖片、動畫 URL、屬性、背景、稀有特徵、等級、可解鎖內容的參照、外部連結和其他欄位。

ERC-721 中繼資料結構描述包含 name、description 和 image 等基本欄位。

ERC-1155 中繼資料結構描述也包含常見描述欄位，並支援代幣專屬的顯示資料。

Base URI 通常指向儲存中繼資料檔案的目錄或端點。

如果中繼資料以 JSON 檔案儲存，每個代幣 ID 通常會對應一個 JSON 檔案。

如果中繼資料是動態的，Base URI 可能會指向 API 端點，並隨時間回傳不同的 JSON。

如果中繼資料採用內容定址，Base URI 可能會指向去中心化儲存識別碼。

Base URI 的品質會決定應用程式能否穩定地找到並顯示中繼資料。

即使代幣的中繼資料缺失，它仍可能存在於鏈上，但使用者會更難理解或評估其價值。

Base URI 與 IPFS

IPFS 是常用於 NFT 中繼資料和媒體的去中心化儲存系統。

官方 IPFS NFT 資料指南建議使用 IPFS URI，讓智能合約連結至儲存在 IPFS 的外部 NFT 資料。

IPFS URI 通常以 ipfs:// 開頭，並包含內容識別碼（CID）。

使用 IPFS 的 Base URI 可能如下：ipfs://bafyExampleCID/。

接著，每個代幣的中繼資料檔案都可以儲存在該 IPFS 目錄中。

相較於一般網頁連結，這種設計可能讓 NFT 中繼資料更能抵抗竄改，因為 CID 是依據資料內容識別內容，而非只識別伺服器位置。

如果內容變更，CID 也會隨之改變。

這有助於使用者察覺中繼資料是否遭到修改。

不過，使用者仍須透過至少一個節點或固定服務商（pinning provider）取得 IPFS 內容。

使用 IPFS Base URI 有助於提升完整性，但仍須規劃長期儲存。

Base URI 與 HTTP URL

Base URI 也可以使用一般 HTTPS URL。

例如，某個系列可能使用 https://example.com/metadata/ 作為 Base URI。

代幣 100 的 tokenURI 可能因此成為 https://example.com/metadata/100.json。

HTTPS 中繼資料簡單且彈性高，因為專案可以更新網頁伺服器上的檔案。

這種彈性對遊戲、動態 NFT、會員資格或持續演變的藝術作品可能很有用。

但這也帶來信任風險，因為伺服器擁有者可能變更、刪除或重新導向中繼資料，也可能封鎖存取。

如果網域到期或託管服務商離線，NFT 可能就無法正常顯示。

如果專案管理員遭到入侵，Base URI 或中繼資料端點可能會提供惡意或誤導內容。

中心化 HTTP 中繼資料易於使用，但可能削弱長期持續性。

使用者應確認專案採用內容定址儲存、中心化網頁伺服器，或混合式方案。

Base URI 與 Arweave 類型的儲存方式

有些 NFT 專案會使用永久儲存系統來保存中繼資料和媒體。

在這類系統中，中繼資料可能透過交易識別碼或永久內容路徑參照。

Base URI 可以指向永久儲存閘道或清單路徑，以整理多個代幣中繼資料檔案。

這種方式可降低一般網頁伺服器消失的風險。

如果儲存系統的設計著重長期保存，也可能減少持續支付固定服務費的需求。

不過，使用者仍應了解確切的 URI 格式和閘道運作方式。

閘道 URL 不一定等同於其底層的永久內容識別碼。

如果合約只儲存閘道形式的 URL，顯示結果可能取決於該閘道是否可用。

較完善的設計會讓永久識別碼清楚可見且可供驗證。

Base URI 的設計應讓長期資料位置容易查核。

Base URI 與鏈上中繼資料

有些代幣不依賴外部 Base URI，因為其中繼資料完全儲存於鏈上或由鏈上產生。

鏈上中繼資料可以透過 data URI 回傳，直接在智能合約中包含編碼後的 JSON。

這種設計中的 tokenURI 可能會回傳以 data:application/json 開頭的字串，而不是 ipfs:// 或 https://。

由於代幣合約本身會產生中繼資料，這種方式可讓中繼資料更完整自足。

鏈上中繼資料可用於生成式藝術、全鏈上遊戲、身分系統和不可變收藏品。

其代價是鏈上儲存和運算可能相當昂貴。

大型圖片、動畫和複雜中繼資料可能不適合直接儲存在鏈上。

因此，許多專案會使用 Base URI 指向外部中繼資料，僅在特殊用途下採用完全鏈上中繼資料。

沒有任何一種模式適用於所有專案。

最佳中繼資料設計取決於成本、永久性、彈性、使用者預期和技術複雜度。

Base URI 與中繼資料揭露

許多 NFT 系列會在揭露流程中使用 Base URI。

揭露前，每個代幣可能都會回傳相同的佔位中繼資料。

佔位內容可能顯示神祕圖片或通用的系列描述。

揭露後，專案會更新 Base URI，讓每個代幣指向最終的中繼資料檔案。

這可能讓鑄造過程顯得更公平，因為使用者在揭露前不知道每個代幣的最終特徵。

不過，揭露設計需要建立信任。

如果專案控制 Base URI，便可能在鑄造後變更中繼資料。

如果揭露流程不透明，使用者可能會擔心稀有特徵分配不公。

專案可以透過發布來源雜湊、使用可驗證的隨機性、在揭露後鎖定中繼資料，或讓中繼資料產生過程可供查核，降低這類疑慮。

使用者應了解系列的 Base URI 是暫時性、已揭露、可變更，還是已永久鎖定。

可變更的 Base URI

可變更的 Base URI 是指合約部署後仍可修改的 Base URI。

如果上線時中繼資料尚未準備完成、媒體需要遷移，或動態 NFT 需要更新，可變更的 Base URI 可能很有用。

但這也可能帶來危險，因為控制更新函式的人可能會改變所有代幣的顯示內容。

專案可能更換藝術作品、變更特徵、將中繼資料重新導向至新伺服器，或移除內容。

惡意管理員可能以損害代幣價值或誤導使用者的方式變更中繼資料。

即使原團隊誠信可靠，管理員金鑰遭到入侵也可能造成相同結果。

使用者應確認 Base URI 是否仍可變更。

使用者也應確認誰有權變更。

由單一外部擁有錢包控制的可變 Base URI，風險高於受到妥善治理的更新流程。

應清楚揭露中繼資料是否可變，因為這會改變代幣的信任模式。

不可變的 Base URI

不可變的 Base URI 是指部署後或執行最終鎖定操作後，無法再變更的 Base URI。

這有助於提升信任，因為使用者知道管理員日後無法變更中繼資料路徑。

希望收藏品能長期永久保存的專案，常採用不可變的 Base URI。

若搭配 IPFS CID 等內容定址儲存，效果尤其顯著。

不過，如果原始 URI 有誤，不可變設計也可能造成問題。

如果中繼資料檔案缺失、格式錯誤或上傳至錯誤路徑，專案可能無法修正。

如果儲存閘道改變運作方式，合約也可能無法配合調整。

開發者應在鎖定 Base URI 前仔細測試中繼資料路徑。

使用者應了解，不可變設計能防止日後變更，但不能保證原始中繼資料正確無誤。

永久存在的錯誤仍然是永久錯誤。

Base URI 與 ERC-4906 中繼資料更新

ERC-4906 是 ERC-721 代幣的中繼資料更新擴充功能。

官方 ERC-4906 標準新增 MetadataUpdate 和 BatchMetadataUpdate 事件，用來通知中繼資料變更。

這很重要，因為錢包、索引器和應用程式通常會快取中繼資料。

如果 Base URI 已變更，但應用程式沒有更新快取，使用者可能仍會看到舊中繼資料。

ERC-4906 為合約提供標準方式，通知第三方系統代幣中繼資料已變更。

這對揭露活動、動態 NFT、持續演變的遊戲道具，以及鑄造後修正中繼資料都很有用。

不過，該標準本身不會讓中繼資料變更變得安全。

它只協助發出中繼資料已變更的通知。

中繼資料變更的權限控管仍然重要。

如果專案使用可變 Base URI 或動態中繼資料，更新權限應受到妥善保護並清楚記錄。

Base URI 與 ERC-7160 多重中繼資料

ERC-7160 是支援每個代幣使用多個中繼資料 URI 的 ERC-721 擴充功能。

官方 ERC-7160 標準描述一種系統：代幣可擁有多個中繼資料 URI，並指定一個固定的主要 URI。

這與 Base URI 有關，因為中繼資料不再總是位於單一靜態位置。

代幣可能會有多個版本、格式、修訂版或顯示選項。

例如，動態藝術作品可能有多種經核准的中繼資料狀態。

遊戲道具在升級或參加活動後，可能會有不同的中繼資料。

協作 NFT 可能包含多位創作者提供的中繼資料。

支援多重中繼資料可以提高彈性，但也會讓中繼資料查核更複雜。

使用者和應用程式需要知道哪個 URI 是主要 URI，以及舊 URI 是否仍可存取。

Base URI 仍然重要，因為它通常是其中一個或多個中繼資料位置的根路徑。

Base URI 與 Gas 效率

使用 Base URI 通常是為了降低 Gas 成本。

為每個代幣儲存完整中繼資料 URI 可能很昂貴，因為鏈上儲存需要支付 Gas。

共用 Base URI 可減少合約需要儲存的資訊。

合約只需儲存一個前綴，並在需要時計算代幣專屬路徑，而不必儲存數千個長字串。

這對含有大量代幣 ID 的大型系列尤其有用。

例如，含有 10,000 個代幣的系列可以使用一個 Base URI，並以代幣 ID 為 10,000 個 JSON 檔案命名。

合約只需要具備串接 Base URI 與代幣 ID 的邏輯。

這種方式能節省儲存空間，但與為每個代幣儲存自訂 URI 相比，彈性較低。

開發者必須在節省 Gas 與中繼資料彈性之間做出選擇。

即使是低成本設計，如果讓中繼資料太容易變更或太難驗證，仍可能不安全。

Base URI 與檔案命名

檔案命名很重要，因為 tokenURI 的建構方式必須與實際中繼資料檔案相符。

如果合約回傳 ipfs://CID/1，儲存位置就應有名為 1 的檔案或物件。

如果儲存位置包含 1.json，但合約只回傳 1，部分應用程式可能無法載入中繼資料。

如果合約回傳 0001.json，但檔案名稱是 1.json，中繼資料也可能無法正常顯示。

ERC-1155 又增加了一層複雜度，因為代幣 ID 替換時須採用補足長度的小寫十六進位格式。

開發者應在部署前決定檔案命名方式。

他們應在測試網路上將 tokenURI 輸出與實際中繼資料檔案比對測試。

測試時應涵蓋多個代幣 ID，包括較小、較大的 ID，以及非連續 ID。

也應測試錢包和索引器如何解析中繼資料。

小小的命名錯誤可能導致整個系列出現嚴重的顯示問題。

Base URI 與結尾斜線

結尾斜線是 Base URI 最後面的斜線。

它可能決定最終 tokenURI 是否有效。

例如，ipfs://CID/ 加上代幣 ID 1 會成為 ipfs://CID/1。

如果沒有斜線，ipfs://CID 加上代幣 ID 1 會成為 ipfs://CID1，這可能不正確。

HTTPS 路徑也可能出現相同問題。

https://example.com/metadata/ 加上 1.json 會形成清楚的檔案路徑。

https://example.com/metadata 加上 1.json 則會成為 https://example.com/metadata1.json，該檔案可能不存在。

開發者應在合約中一致處理斜線和後綴。

使用者不一定能從交易市場的顯示畫面看出這類問題。

中繼資料無法載入時，通常應先檢查合約實際回傳的 tokenURI 字串。

Base URI 與中繼資料快取

許多錢包、交易市場、區塊鏈瀏覽器和索引服務都會快取 NFT 中繼資料。

快取能提升速度，因為應用程式不必每次都從頭擷取中繼資料。

不過，快取可能讓 Base URI 的變更變得難以理解。

專案可能已更新中繼資料，但部分應用程式仍會顯示舊圖片或舊屬性。

這也是中繼資料更新事件可能派上用場的原因之一。

ERC-4906 的設計目的之一，是為合約提供標準方式來通知中繼資料變更。

然而，並非所有應用程式都會立即更新，或支援所有中繼資料事件。

使用者應了解，在更新延遲期間，同一代幣可能在不同應用程式中顯示不同的中繼資料。

這不一定代表代幣本身的所有權已變更或代幣發生故障。

也可能只是中繼資料快取尚未更新。

Base URI 與中心化風險

當 Base URI 指向由單一方控制的伺服器或網域時，可能帶來中心化風險。

如果專案將中繼資料儲存在一般網域，網域擁有者就能變更檔案。

網域也可能到期、遭到查封、遭駭客入侵或離線。

關於NFT 中繼資料中心化風險的研究指出，中心化中繼資料儲存可能使 NFT 資料面臨審查、資料外洩和管理者變更等風險。

這很重要，因為許多使用者以為擁有 NFT 就代表整項資產永久儲存在鏈上。

實際上，代幣可能只指向儲存在其他位置的中繼資料。

如果該指向路徑不可靠，使用者看到的資產也可能變得不可靠。

內容定址儲存和清楚的中繼資料鎖定機制可以降低這類風險。

不過，每個專案都需要長期儲存計畫。

Base URI 管理不當，可能讓精美的 NFT 最後只剩失效連結。

Base URI 與內容定址

內容定址是指識別碼以內容本身為依據。

IPFS CID 是加密貨幣中繼資料常見的例子。

中繼資料採用內容定址時，修改中繼資料會產生不同的識別碼。

這讓竄改更容易被察覺。

因此，包含 CID 的 Base URI 可讓使用者更有把握確認所參照的檔案沒有在未經告知的情況下遭到變更。

這與一般 URL 不同；一般 URL 的伺服器可以在相同地址提供新內容。

內容定址不代表內容會自動永久儲存。

仍須有人託管、固定或以其他方式保存資料。

這也不能保證原始中繼資料誠實或品質良好。

它只能協助驗證該識別碼連結的內容是否維持不變。

Base URI 與動態 NFT

動態 NFT 是指中繼資料會依事件、時間、使用者操作、遊戲狀態、預言機資料或合約邏輯而變更的代幣。

動態 NFT 可能會使用指向 API 或動態中繼資料服務的 Base URI。

也可能依據變動狀態在鏈上產生中繼資料。

動態 Base URI 能讓 NFT 更具互動性和實用性。

例如，遊戲角色 NFT 升級後，可能會顯示新的屬性。

會員 NFT 可能會在使用者達到某個身分等級時改變外觀。

實體資產代幣可能會在文件更新時同步更新中繼資料。

風險在於，動態中繼資料需要使用者信任其更新規則。

使用者應了解哪些內容可以變更、誰可以變更，以及變更是由程式碼、管理員還是鏈下系統控制。

只有在規則透明時，動態中繼資料才真正有用。

Base URI 與安全性

Base URI 的安全性取決於儲存方式、存取控制、合約邏輯和使用者預期。

如果 Base URI 可以更新，更新函式就必須有完善的權限控管。

如果 Base URI 由單一私鑰控制，該私鑰就會成為高價值攻擊目標。

如果 Base URI 由多重簽章錢包控制，安全性取決於簽署者的可靠程度和門檻設定。

如果 Base URI 由治理機制控制，安全性則取決於投票權分布和升級流程。

如果 Base URI 指向伺服器，伺服器和網域的安全性就很重要。

如果 Base URI 指向 IPFS，固定服務和內容可用性就很重要。

如果中繼資料在鏈上產生，合約正確性就很重要。

Base URI 並沒有單一通用的安全模式。

應該始終確認哪些內容可以變更、誰可以變更，以及使用者如何驗證。

Base URI 與智能合約升級

可升級的智能合約可以變更 tokenURI 的計算方式。

因此，即使可見的 Base URI 變數看似固定，Base URI 邏輯仍可能改變。

可升級的 NFT 合約可讓開發者修正錯誤或新增功能。

但也可能讓中繼資料行為在使用者購買代幣後發生變更。

使用者應確認合約是否可升級。

也應確認誰掌握升級權限，以及是否設有時間鎖或治理流程。

如果升級可以取代整個 tokenURI 函式，鎖定 Base URI 的意義就會降低。

若要確保中繼資料更可靠，應同時檢查 Base URI 和合約升級機制。

開發者應清楚揭露合約是否可升級，因為這會影響信任。

使用者不應只根據 Base URI 評估中繼資料是否永久不變。

Base URI 與代幣驗證

Base URI 可協助使用者確認代幣中繼資料是否來自預期的系列來源。

不過，使用者不應只依賴圖片外觀或代幣名稱。

假代幣可以複製真實系列的中繼資料、名稱、代號和圖片。

真正的識別依據，是正確區塊鏈上的合約地址和代幣 ID。

Base URI 能顯示中繼資料的指向位置，但本身無法證明代幣真偽。

詐騙合約也可以指向合法系列的複製中繼資料。

使用者應驗證合約地址、代幣標準、創作者資訊、中繼資料路徑、所有權紀錄和專案官方來源。

開發者應讓 tokenURI 輸出可預測且容易檢查。

清楚的 Base URI 設計有助於驗證，但不能取代合約驗證。

真實性取決於代幣身分和中繼資料完整性。

Base URI 與系列層級中繼資料

Base URI 通常指的是代幣層級的中繼資料路徑。

系列層級中繼資料則不同，因為它描述的是整個合約或系列。

系列中繼資料可能包含系列名稱、描述、圖片、橫幅、外部連結、費用或社群資訊。

有些合約會透過 contractURI 等獨立函式提供系列層級中繼資料。

代幣 Base URI 不應與系列中繼資料 URI 混淆。

代幣 Base URI 用於建立個別代幣 ID 的中繼資料。

系列中繼資料 URI 則描述整個系列。

兩者都會影響錢包和應用程式如何呈現專案。

兩者也都可能帶來中心化或可變更風險。

使用者應了解，哪個 URI 控制個別代幣資料，哪個 URI 控制系列顯示資料。

Base URI 與中繼資料凍結

中繼資料凍結是指讓中繼資料永久無法變更，或表明其之後不應再變更。

專案可以移除 Base URI 更新功能，以凍結中繼資料。

也可以將 Base URI 設定為內容定址儲存路徑，並放棄更新權限，以凍結中繼資料。

有些專案會宣布在揭露後凍結中繼資料。

使用者應確認凍結是由程式碼強制執行，還是僅由團隊承諾。

口頭承諾不如合約層級的鎖定可靠。

如果合約仍可升級，合約層級的鎖定也不夠可靠。

要真正凍結中繼資料，必須檢查所有可能改變 tokenURI 結果的途徑。

當永久保存很重要時，凍結中繼資料可以提升收藏者的信心。

不過，過早凍結可能會讓錯誤永久保留，日後無法修正。

Base URI 與使用者體驗

Base URI 會影響使用者體驗，因為應用程式會使用中繼資料顯示使用者持有的資產。

如果 Base URI 載入迅速，NFT 就能順利顯示。

如果 Base URI 速度緩慢、無法使用或遭到封鎖，錢包可能會顯示空白圖片或一般佔位圖。

如果中繼資料 JSON 格式錯誤，應用程式可能無法解析。

如果中繼資料中的圖片連結失效，代幣可能只顯示文字而沒有媒體。

如果特徵不一致，稀有度工具和遊戲可能會誤判代幣資訊。

使用者往往會根據錢包中看到的內容評價系列。

因此，開發者應將 Base URI 設計視為產品品質的一部分。

中繼資料應有效、穩定、能以合理速度擷取，並在不同代幣 ID 間保持一致。

即使智能合約設計完善，如果 Base URI 和中繼資料管理不佳，使用者仍可能覺得產品無法正常運作。

Base URI 範例

簡單的 IPFS Base URI 可能如下：ipfs://bafyExampleCID/。

如果合約附加代幣 ID 7 和 .json 後綴，完整 tokenURI 可能會是 ipfs://bafyExampleCID/7.json。

簡單的 HTTPS Base URI 可能如下：https://example.com/api/token/。

如果合約附加代幣 ID 7，完整 tokenURI 可能會是 https://example.com/api/token/7。

ERC-1155 URI 範本可能如下：https://example.com/metadata/{id}.json。

在此情況下，相容的客戶端會將 {id} 替換為格式化後的代幣 ID。

鏈上 data URI 可能以 data:application/json;base64, 開頭，而非使用 Base URI。

這些例子說明，使用者應檢查實際回傳的 tokenURI，而非根據系列網站自行推測。

應用程式通常會查詢合約的 tokenURI 函式。

只有在 Base URI 能產生有效且可存取的 tokenURI 時，它才有用。

使用 Base URI 的優點

Base URI 的第一項優點是提高 Gas 效率。

共用前綴可以減少鏈上儲存的資料量。

第二項優點是更容易整理系列。

開發者可以將中繼資料檔案放在同一個資料夾或端點，再對應到代幣 ID。

第三項優點是簡化大型系列的鑄造流程。

新代幣可以自動解析至可預測的中繼資料路徑。

第四項優點是更容易管理揭露流程。

若合約允許，專案只需變更一次 Base URI，就能從佔位中繼資料切換至最終中繼資料。

第五項優點是相容性。

錢包、區塊鏈瀏覽器和應用程式都熟悉讀取 tokenURI 和 URI 格式的中繼資料路徑。

第六項優點是彈性。

Base URI 可支援 IPFS、HTTPS、永久儲存連結、API 端點或混合式設計。

使用 Base URI 的風險

第一項風險是中繼資料失效。

錯誤的 Base URI 可能讓整個系列的所有代幣都無法正常顯示。

第二項風險是中心化。

指向一般伺服器的 Base URI 會依賴該伺服器、網域和營運者。

第三項風險是惡意更新。

如果管理員可以變更 Base URI，就可能改變所有代幣的顯示內容。

第四項風險是隱藏的可變更性。

使用者可能以為中繼資料永久不變，但 Base URI 其實仍可編輯。

第五項風險是快取混亂。

Base URI 更新後，應用程式可能仍顯示舊中繼資料。

第六項風險是儲存可用性。

即使中繼資料採用內容定址，如果沒有人託管或固定資料，仍可能難以取得。

第七項風險是可升級邏輯。

即使 Base URI 看似已鎖定，合約升級仍可能改變 tokenURI 的運作方式。

如何檢查 Base URI

使用者可以呼叫特定代幣 ID 的 tokenURI 函式，檢查 Base URI 的運作方式。

應將回傳的 URI 與專案對中繼資料來源的官方說明比對。

應確認 URI 是否以 ipfs://、https://、data:、ar:// 或其他協定開頭。

應測試中繼資料檔案是否能載入並回傳有效 JSON。

應檢查 JSON 是否包含 image、description、attributes 和其他預期欄位。

也應確認 JSON 中的圖片連結是否穩定且可存取。

應檢查合約，確認 Base URI 是否可以變更。

應確認合約是否可升級。

如果系列聲稱中繼資料已變更，應留意中繼資料更新事件。

不要只因代幣在某個錢包中顯示正常，就認定它安全無虞。

開發者最佳做法

開發者應在部署代幣合約前決定中繼資料儲存模式。

應決定 Base URI 是不可變、可變、依揭露流程變更、動態更新，還是完全採用鏈上中繼資料。

若重視長期完整性，應使用內容定址連結。

上線前應測試多個代幣 ID 的 tokenURI 輸出。

檔案命名、後綴和結尾斜線應保持一致。

應透過嚴謹的存取控制保護 Base URI 更新函式。

應揭露鑄造後中繼資料是否可能變更。

如果中繼資料有變更且合約支援此模式，應發出標準中繼資料更新事件。

應為所有中繼資料和媒體保留備份，並制定長期託管計畫。

請記住，中繼資料是使用者信任的一部分，不只是顯示功能。

使用者最佳做法

使用者應先驗證合約地址，再信任其中繼資料。

應檢查真實代幣的 tokenURI，而非只相信螢幕截圖。

應優先選擇清楚說明中繼資料儲存位置的專案。

應了解 Base URI 是否仍可變更。

應確認中繼資料儲存在內容定址系統還是中心化伺服器。

對於一方面承諾永久保存、另一方面仍保留管理員更新權限的專案，應保持謹慎。

揭露或銷售後如有突然的中繼資料變更，應特別留意。

請記住，擁有 NFT 不一定代表擁有媒體檔案、著作權或鏈下權利。

如果長期存取很重要，使用者應將重要中繼資料和媒體另存至本機。

應將失效或可疑的中繼資料視為風險訊號。

關於 Base URI 的常見誤解

一項常見誤解是 Base URI 儲存了 NFT 本身。

Base URI 通常指向中繼資料，而所有權則由智能合約追蹤。

另一項誤解是 NFT 圖片一定儲存在鏈上。

許多 NFT 圖片儲存在鏈下或去中心化儲存系統，並透過中繼資料參照。

第三項誤解是 IPFS 保證內容永遠在線。

IPFS 可提升內容完整性，但仍須有人提供內容。

第四項誤解是鎖定 Base URI 就能保證使用者依法擁有中繼資料所顯示的資產。

中繼資料是否永久保存，與法律權利是不同的問題。

第五項誤解是所有 Base URI 變更都是不好的。

有些變更可能是揭露、動態 NFT 或修正錯誤所需，但必須透明且受到妥善控管。

第六項誤解是只要某處能正確顯示，就代表 Base URI 安全。

快取可能掩蓋問題；若情況允許，使用者應檢查實際的 tokenURI。

相關加密貨幣術語

URI 是統一資源識別碼（Uniform Resource Identifier），用來識別中繼資料檔案等資源的字串。

tokenURI 是 ERC-721 函式，會回傳特定代幣 ID 的中繼資料 URI。

ERC-721 是常見的 Ethereum 非同質化代幣標準。

ERC-1155 是可支援同質化、半同質化和非同質化資產的多代幣標準。

NFT 中繼資料是描述代幣名稱、圖片、特徵和其他屬性的 JSON 或結構化資料。

IPFS 是星際檔案系統（InterPlanetary File System），是一種常用於 NFT 資料的內容定址儲存網路。

CID 是內容識別碼（content identifier），也是 IPFS 使用的內容定址參照。

Data URI 是將資料直接嵌入 URI 字串中的 URI。

中繼資料揭露是將代幣從佔位中繼資料切換為最終中繼資料的流程。

中繼資料凍結是指在特定時間點後，讓代幣中繼資料或中繼資料路徑無法再變更。

常見問題

NFT 中的 Base URI 是什麼意思？

Base URI 是智能合約用來建立每個 NFT 完整中繼資料 URI 的共用起始路徑。

Base URI 和 tokenURI 相同嗎？

不同。Base URI 通常是共用前綴，而 tokenURI 是特定代幣所回傳的完整中繼資料 URI。

Base URI 在 ERC-721 中如何運作？

在許多 ERC-721 合約中，Base URI 會與代幣 ID 結合，產生該 NFT 的最終 tokenURI。

Base URI 在 ERC-1155 中如何運作？

ERC-1155 通常使用包含 {id} 替換欄位的 URI 範本，由客戶端將 {id} 替換為格式化後的代幣 ID。

Base URI 可以變更嗎？

可以。如果合約設有更新函式，且仍有獲授權的帳戶控制該函式，Base URI 就可以變更。

可變的 Base URI 有風險嗎？

有。可變的 Base URI 有風險，因為控制者可能可以變更許多或所有代幣的中繼資料。

不可變的 Base URI 一定比較好嗎？

不可變的 Base URI 可以提升信任，但如果上線時的中繼資料路徑有誤，也可能讓錯誤永久無法修正。

NFT 專案為何使用 IPFS 作為 Base URI？

專案使用 IPFS，是因為 IPFS CID 採用內容定址，有助於使用者確認參照的中繼資料沒有在未經告知的情況下遭到變更。

IPFS 能保證 NFT 中繼資料永遠在線嗎？

不能。IPFS 有助於維持完整性，但仍須託管、固定或以其他方式提供內容。

我持有 NFT，為什麼圖片仍然沒有顯示？

可能是 Base URI 錯誤、中繼資料檔案無法使用、圖片連結失效，或應用程式快取尚未更新。

什麼是中繼資料揭露？

中繼資料揭露是專案將代幣從佔位中繼資料切換為最終中繼資料的流程，通常會更新 Base URI 或 tokenURI 邏輯。

如何確認 NFT 的 Base URI 是否安全？

可以檢查 tokenURI 輸出、儲存類型、更新權限、合約是否可升級、中繼資料格式，以及檔案是否能透過可靠的儲存方式取得。

結論

Base URI 是 NFT 和加密貨幣代幣合約中的重要中繼資料概念。

它是協助合約建立個別代幣完整中繼資料 URI 的共用路徑。

在許多 ERC-721 系列中，Base URI 會與代幣 ID 結合，以產生 tokenURI。

ERC-1155 通常透過使用 {id} 替換欄位的 URI 範本達成類似目的。

Base URI 讓大型系列更容易、成本更低地管理，因為一個共用前綴就能對應多個代幣中繼資料檔案。

它也帶來重要的信任問題，因為中繼資料通常儲存在區塊鏈之外。

如果 Base URI 指向中心化伺服器，使用者就必須依賴這些伺服器和營運者。

如果 Base URI 指向內容定址儲存，使用者可能獲得更強的完整性保障，但仍須確保內容可供存取。

如果 Base URI 可以變更，使用者就必須信任更新權限及其安全控管。

如果 Base URI 不可變，使用者可以獲得永久性，但若有錯誤就會失去修正彈性。

開發者應在上線前謹慎設計 Base URI 邏輯、徹底測試檔案路徑、保護更新權限，並清楚揭露中繼資料是否可變。

使用者應檢查 tokenURI、驗證合約地址、了解儲存類型，並避免假設顯示的媒體一定會永久保存或依法由自己擁有。

最重要的是，NFT 所有權和 NFT 中繼資料彼此相關，但並不相同。

智能合約證明代幣的所有權，而 Base URI 則協助應用程式找到說明代幣代表什麼的資料。

完善的 Base URI 設計能讓兩者之間的連結穩定、透明且容易驗證。

設計不佳的 Base URI 可能讓看似有價值的代幣淪為失效連結、可隨意變更的承諾，或中繼資料安全風險。