URI 协议

事件流 URL

每个在ceramic中的流会被识别成一个唯一的URL。该 URL 由 Ceramic 的协议标识符和下面定义的 StreamId 组成。当编码为字符串时，StreamID 前缀带有协议处理程序，并且通常使用 base36 编码 StreamID。这完全描述了流位于哪里以及在哪里可以找到它，在本例中它可以在 Ceramic 网络上找到。

ceramic://<StreamId>

例如，StreamId 可能如下所示：

ceramic://kjzl6fddub9hxf2q312a5qjt9ra3oyzb7lthsrtwhne0wu54iuvj852bw9wxfvs

事件 ID 也可以以同样的方式进行编码。s

ceramic://<EventId>

StreamID

StreamId由一个StreamId代码、流类型和CID组成，用于引用特定且唯一的事件流。StreamIds类似于IPLD中的CIDs，并使用多格式，但它们提供了与Ceramic事件流相关的附加信息。这也使它们可以与CIDs区分开来。事件流的init事件用于创建StreamId。定义如下：

<streamid> ::= <multibase-prefix><multicodec-streamid><stream-type><init-cid-bytes>

# e.g. using CIDv1
<streamid> ::= <multibase-prefix><multicodec-streamid><stream-type><multicodec-cidv1><multicodec-content-type><multihash-content-address>

在这里：

• <multibase-prefix> 是一个多基数代码（1或2字节），用以便于将StreamIds编码到各种基数中。注意：当编码明确时，二进制（非文本基础）的协议和格式可能会省略多基数前缀。

• <multicodec-streamid> 0xce 是一个用来表示这是一个StreamId的多编码，以变长整数编码

• <stream-type> 是代表流的类型的变长整数。

• <init-cid-bytes> 是从初始化事件的CID中获取的字节，去掉了多基数前缀。

StreamID的多编解码器为0xce。为了与浏览器URL兼容，建议使用[base36]对StreamId进行编码。目前，流类型值在协议级别上没有任何功能。相反，它被构建在Ceramic之上的应用程序（例如ComposeDB）用于区分处理事件时应用的不同逻辑。流类型值必须在CIP-59表中注册

事件ID

EventIds 扩展了 StreamIds，以引用特定流中的特定事件。在StreamId的末尾添加附加字节。如果它代表创世事件，则添加零字节（0x00），否则添加表示该事件的CID。 EventIds定义如下：

<streamid> ::= <multibase-prefix><multicodec-streamid><stream-type>
  <genesis-cid-bytes>
  <event-reference>

# e.g. using CIDv1 and representing the genesis event
<streamid> ::= <multibase-prefix><multicodec-streamid><stream-type>
  <multicodec-cidv1><multicodec-content-type><multihash-content-address>
  <0x00>

# e.g. using CIDv1 and representing an arbitrary event in the log
<streamid> ::= <multibase-prefix><multicodec-streamid><stream-type>
  <multicodec-cidv1><multicodec-content-type-1><multihash-content-address-1>
  <multicodec-cidv1><multicodec-content-type-2><multihash-content-address-2>

其中：<event-reference> 可以是零字节（0x00）或 CID 字节。流版本每个事件ID也可以被视为是对特定流版本的引用。在任何事件ID处，一个流可以被加载直到该事件和产生的一系列事件都被认为是一个版本的事件流