8 个版本 (有破坏性)

0.9.0 2024 年 1 月 11 日
0.8.0 2024 年 1 月 9 日
0.7.0 2023 年 12 月 12 日
0.6.0 2023 年 10 月 26 日
0.1.0 2022 年 12 月 26 日

#748魔法豆

Download history 20/week @ 2024-03-11 22/week @ 2024-03-18 15/week @ 2024-03-25 35/week @ 2024-04-01 10/week @ 2024-04-08 18/week @ 2024-04-15 20/week @ 2024-04-22 17/week @ 2024-04-29 19/week @ 2024-05-06 11/week @ 2024-05-13 26/week @ 2024-05-20 17/week @ 2024-05-27 24/week @ 2024-06-03 20/week @ 2024-06-10 10/week @ 2024-06-17 23/week @ 2024-06-24

每月 78 次下载
7 个 crate 中使用 (5 个直接使用)

Apache-2.0

18KB
380

AquaVM

crates.io version npm version Coverage Status

AquaVM 执行编译后的 Aqua,即 Aqua 中间表示 (AIR) 脚本,并在 Fluence 对等计算协议的实现中扮演着核心角色。具体来说,AquaVM 允许在脚本中表达网络编舞,并组合分布式、对等托管服务。此外,AquaVM 在促进 Fluence 网络中的 函数可寻址性 方面发挥着重要作用,参见图 1。

AquaVM & AIR model

图 1:风格化的 AquaVM 和 AIR 模型

由于 AquaVM 编译为 Wasm,它可以在客户端(如浏览器和 Node.js 应用)和服务器环境中运行。

AquaVM:解释器执行模型

AquaVM 的执行模型简化了 Fluence 协议的数据推送模型,该模型作为 粒子 实现,即由数据、AIR 和一些元数据组成的智能包。在这种情况下,AquaVM 可以被视为一个纯状态转换函数,它促进了粒子更新,包括通过将先前和当前状态结合来产生新状态,以及在剩余的 AIR 工作流中更新 peer 列表和调用请求。除了执行本地服务调用外,AquaVM 还处理来自远程 peer 的请求,例如,作为并行执行块的一部分,以调用本地服务并处理未来的响应,参见图 2。

interpreter execution model

图 2:AquaVM 解释器执行模型

总之,AquaVM 执行模型处理简单和高级组合模式(如(异步)并行服务执行)的拓扑跳跃。

海蓝宝石中间表示 (AIR):对等系统的 IR

AIR是一种基于S-expression的低级语言,具有二进制形式。目前它由十四条指令组成,未来还将增加更多指令。AIR的语义灵感来源于π-calculus、λ-calculus和范畴论。其语法受到Wasm Text Format(WAT)和Lisp的启发。AIR脚本控制Fluence点对点网络、其节点甚至其他(p2p)网络上的资源,例如IPFS和Filecoin,例如,通过Marine适配器服务使用Fluence IPFS库。

AIR值的描述以及指令列表及其用法示例可以在这里找到。AIR及其接口的主要特性在这里讨论这里

AIR指令的完整列表及其用法示例可以在这里找到。AquaVM接口的基本合约以及更详细的交互方案可以在这里找到。

仓库结构

  • air是AquaVM的核心
  • air-interpreter是一个crate,用于支持不同的编译目标(Marine和wasm-bindgen)
  • avm
    • client是用于浏览器和Node.js目标的AquaVM启动器
    • server是用于服务器端目标的AquaVM启动器
  • crates
    • air-lib包含AquaVM核心的所有主要crate
    • beautifier是AIR-beautifier的实现
    • data-store定义了Fluence节点使用的DataStore trait
    • interpreter-wasm是一个crate,用于更好地将编译后的Wasm代码集成到Fluence节点中
    • testing-framework是改进测试编写体验的框架的实现
  • tools包含与AquaVM相关的工具

支持

如果您发现错误,请提交问题。您也可以通过DiscordTelegram联系我们。我们将尽力尽快解决该问题。

贡献

任何感兴趣的人都可以为该项目做出贡献。请确保您阅读并遵循一些基本的规则

许可证

所有软件代码均为(c) Fluence Labs, Inc.的版权,根据Apache-2.0许可证。

依赖关系

~5–6.5MB
~136K SLoC