10 个版本 (6 个重大更改)
0.54.0 | 2024 年 8 月 12 日 |
---|---|
0.53.0 | 2024 年 5 月 14 日 |
0.52.0 | 2024 年 4 月 26 日 |
0.51.0 | 2024 年 3 月 26 日 |
0.48.1 | 2023 年 11 月 27 日 |
#836 在 魔法豆
每月下载量 1,484
用于 25 个 crate(直接使用 3 个)
140KB
3K SLoC
IBC 核心库
这是一个顶级库,它将跨链通信(IBC)核心模块作为元crate重新导出。它旨在简化将各种 IBC 核心模块导入和集成到您的区块链中的过程。
IBC 是一个分布式协议,它允许不同主权区块链之间的通信,IBC 核心是处理数据包传输、身份验证和排序(TAO)的协议部分。
ibc-core
crate 内部的结构设计为提供外部用户灵活性。您可以选择使用整个 ibc-core
crate,或者选择性地导入特定的库。从那里,您还可以选择引入整个子模块(例如 ibc-core-client
crate),或者仅引入模块相关的数据结构(例如 ibc-core-client-types
)。
这种多功能性赋予主机,包括链集成器、中继或任何IBC工具项目,在最适合其特定需求的层面上构建解决方案的能力。
子单元
目前,ibc-core
子单元包含了以下IBC核心规范的实现:
ICS-02:客户端语义
ICS-03:连接语义
ICS-04:通道和包语义
ICS-24:主机要求
ICS-25:处理程序接口
ICS-26:路由模块
与跨链标准(ICS)的差异
该子单元在多个方面与ICS规范存在差异。以下提供更多详细信息。
模块系统:不支持不可信模块
ICS-24(主机要求)对主机状态机必须支持的模块系统提出了以下要求。
主机状态机必须支持一个模块系统,其中自包含的、可能相互不信任的代码包可以安全地在同一账本上执行[...]。
该子单元目前不支持相互不信任的包。也就是说,假设主机状态机上的模块是完全可信的。在实践中,这意味着每个模块要么是由主机状态机开发者编写的,要么已经完全经过他们的审查。
端口系统:没有对象能力系统
ICS-05(端口分配)要求主机系统支持对象能力引用或模块的源认证。
在前一种对象能力情况下,IBC处理程序必须有能力生成对象能力,这些是唯一的、不可复制的引用,可以传递给一个模块,并且不会被其他模块复制。[...]在后一种源认证情况下,IBC处理程序必须有能力安全地读取调用模块的源标识符,这是主机状态机中每个模块的唯一字符串,不能被模块更改或被另一个模块伪造。
该子单元目前不要求主机系统提供这些。由于假设模块是可信的,因此不需要这种保护资源免受可能恶意模块侵害的对象能力系统。
有关此问题的更多背景信息,请参阅此问题。
端口系统:转移和释放端口
ICS-05(端口分配)要求IBC处理程序允许转移端口的所有权和释放端口。
我们目前不支持这两者。
异步确认
标准允许模块异步确认数据包。这允许模块接收数据包,但只在稍后时间(在此之后,它们会写入确认)应用更改。
我们目前强制应用程序将数据包作为onRecvPacket
的一部分进行处理。如果您需要为您的应用程序提供异步确认,请提出一个问题。
请注意,这仍然使我们的兼容性达到100%与ibc-go
。
贡献
IBC在cosmos/ibc存储库中以英语指定。任何协议更改或澄清都应在此贡献。
如果您有兴趣贡献,请查看贡献指南。我们欢迎并感谢社区贡献!
依赖项
约13MB
约265K SLoC