文件系统

Decentraland 协议中不同内容 API 的基础是分布式文件系统的实现。每个内容服务器都保存整个存储的一份副本，并将接收到的更新与其他实例同步。

上传到系统的文件是 不可变的。一旦部署，它们的标识符和内容都不会改变。它们只能以这样的方式更新：上传一个新版本，由应用程序选择使用它，而旧版本可以被丢弃。

你可以在……中试验文件 练习 部分使用可运行的代码来尝试快照。

文件标识符

Decentraland 的文件系统组织为一个扁平索引（即没有自然的目录层次结构），其中每个文件都由一个唯一字符串标识。

标识符字符串以前缀 base32 编码的文件内容 SHA-256 哈希为前缀，使用 IPFS CID v1 算法。它们看起来像这样：

bafybeicgclohdfaccu2sqqkzrzuenjxzcry3m5vcb4mpxgucjl3oheq5tq

前几个字节中的前缀表示该标识符本身的编码、版本和哈希类型。

由于历史原因，一些 API 将文件标识符称为 hash 而不是 id，但它们指的是同一件事。你也可能在旧内容中发现一些看起来稍有不同的旧版标识符。

在实践中，这些细节对于发现和下载内容并不是必需的。该协议的大多数客户端都可以把标识符当作不透明字符串来处理，而不会损失任何能力。

请注意，现代 CIDv1 标识符与 IPFS 兼容，同一文件会得到相同的 CID，因此可以将 IPFS 用作文件提供方。

所有权与持久性

除 快照之外，存储在网络中的文件都关联到一个 实体 由一个 Ethereum 账户拥有。只有所有者才被允许更新该实体及其相关文件。

协议要求内容服务器始终存储一个实体及其文件的最新版本，但可以根据各自的配置选择是否保留旧版本。

下载文件

该 /contents/<fileId> 内容服务器的端点可用于下载任何文件。它们的标识符可在父级 实体的清单中找到。

上传文件

文件不会被单独上传。相反，它们被打包在实体内部，并在该实体部署到内容服务器时上传。

请参阅 内容创建者文档 了解更多详情。