Base URI

什么是加密货币中的 Base URI？

Base URI 是智能合约用于构建加密收藏品中代币完整元数据链接的共享起始路径。

在 NFT 和代币元数据系统中，URI 会告知钱包、区块链浏览器和应用在哪里查找描述代币的 JSON 元数据。

官方ERC-721 标准将 tokenURI 定义为一个函数，用于返回给定资产对应的唯一统一资源标识符。

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 也会随之变化。

这有助于用户发现元数据是否遭到篡改。

不过，用户要轻松获取 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 元数据简单灵活，因为项目可以更新 Web 服务器上的文件。

这种灵活性对游戏、动态 NFT、会员权益或不断演变的艺术作品可能很有用。

但这也会带来信任风险，因为服务器所有者可以更改、删除、重定向或屏蔽元数据。

如果域名过期或托管服务商下线，NFT 可能无法正常显示。

如果项目管理员遭到入侵，Base URI 或元数据端点可能会提供恶意或误导性内容。

中心化 HTTP 元数据易于使用，但可能削弱长期持久性。

用户应确认项目使用的是内容寻址存储、中心化 Web 服务器，还是混合方案。

Base URI 与 Arweave 类存储

一些 NFT 项目会使用永久存储系统来保存元数据和媒体。

在这些系统中，元数据可能通过交易标识符或永久内容路径进行引用。

Base URI 可以指向永久存储网关或清单路径，以组织多个代币的元数据文件。

这种方式可以降低普通 Web 服务器消失带来的风险。

如果存储系统旨在长期保存内容，这种方式也可以减少持续支付固定服务费用的需要。

不过，用户仍应了解具体的 URI 格式和网关行为。

网关 URL 并不总是等同于其底层的永久内容标识符。

如果合约只存储网关形式的 URL，内容显示可能取决于该网关是否可用。

更可靠的设计会让永久标识符清晰可见且可验证。

Base URI 的设计应让长期数据位置易于审计。

Base URI 与链上元数据

有些代币不依赖外部 Base URI，因为其元数据完全存储在链上或由链上生成。

链上元数据可以通过数据 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 以及任何非连续 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 指向由单一主体控制的服务器或域名时，可能产生中心化风险。

如果项目将元数据存储在普通 Web 域名上，域名所有者就可以更改文件。

域名也可能过期、被查封、遭到黑客攻击或停止运行。

关于NFT 元数据中心化风险的研究指出，中心化元数据存储可能使 NFT 数据面临审查、泄露和管理方更改等风险。

这很重要，因为许多用户认为拥有 NFT 就意味着整个资产永久存储在链上。

实际上，代币可能只是指向存储在其他位置的元数据。

如果这个指向脆弱，面向用户展示的资产也可能变得脆弱。

内容寻址存储和明确的元数据锁定机制可以降低这种风险。

不过，每个项目都需要制定长期存储计划。

如果 Base URI 管理不善，再精美的 NFT 也可能变成失效链接。

Base URI 与内容寻址

内容寻址是指根据内容本身生成标识符。

IPFS CID 是加密货币元数据中常见的内容寻址示例。

元数据采用内容寻址时，内容一旦更改，标识符也会随之改变。

这有助于更轻松地发现篡改行为。

因此，包含 CID 的 Base URI 可以让用户更有把握地确认引用的文件没有被悄悄更改。

这与普通 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。

链上数据 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 是统一资源标识符，指用于标识资源（例如元数据文件）的字符串。

tokenURI 是 ERC-721 函数，用于返回特定代币 ID 对应的元数据 URI。

ERC-721 是一种常见的 Ethereum 非同质化代币标准。

ERC-1155 是一种多代币标准，可支持同质化、半同质化和非同质化资产。

NFT 元数据是描述代币名称、图片、特征和其他属性的 JSON 或结构化数据。

IPFS 是星际文件系统，是一种常用于 NFT 数据的内容寻址存储网络。

CID 是内容标识符，是 IPFS 使用的一种内容寻址引用。

数据 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 设计则可能让一个看似有价值的代币变成失效链接、可随意更改的承诺，或元数据安全风险。