Superfluid Protocol

🌊 实时可编程现金流协议

Superfluid 实时金融协议知识库,提供 CFA/GDA 流式转账、Super App 开发、宏转发器与清算机制的完整合约接口文档,适合构建可编程现金流与自动化 DeFi 集成。

收藏
4.5k
安装
1k
版本
1.2.4
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用途

Superfluid Protocol Skill 是一个面向实时金融(real-time finance)的链上协议知识库,专注于「流式转账」——即每秒结算的代币流而非传统批量转账。该技能为开发者提供从合约 ABI、SDK 集成到架构设计的完整技术参考,覆盖 Constant Flow Agreement (CFA)、General Distribution Agreement (GDA)、Super App 回调机制、宏转发器(Macro Forwarders)及清算系统(Sentinels/TOGA)等核心模块。

显著优点

  • 实时可编程现金流:CFA 支持 1:1 无限期流式转账,GDA 实现 O(1) 复杂度的多对多分账,适合薪资、订阅、收益分配等场景。
  • 原子化批量操作:通过 Host.batchCall 或 ClearMacroForwarder 将多笔流操作、代币兑换等打包为单一交易,保证执行原子性。
  • Super App 可组合性:开发者可构建接收流式资金的智能合约应用,利用「应用信用」(app credit)实现零余额中继,支持嵌套回调(最多两级深度)。
  • 开发者体验分层:区分「合约开发者」(Solidity 库、原始 ABI)与「应用开发者」(SDK、subgraph、API 服务),提供针对性的参考路径与代码示例。
  • EIP-712 清晰签名:ClearMacroForwarder 替代盲签宏转发器,提供人类可读的钱包提示、第三方中继支持及可选 Permit2 授权,提升安全与 UX。

潜在缺点与局限

  • 学习曲线陡峭:协议涉及 Host-Agreement-Token 三层架构、实时余额公式(BasicParticle)、回调上下文(ctx)等概念,新手需理解「语义货币」理论才能正确集成。
  • Gas 与连接池限制:GDA 池成员无上限,但单个账户每代币最多连接 256 个池,超出需手动 claim;balanceOf 查询 gas 随连接池数量线性增长。
  • GDA 无应用信用:与 CFA 不同,GDA 分发不享受 app credit 缓冲,Super App 需自备资金或从用户处 ERC-20 转账,否则 CFA→GDA 分流合约易因存款不足失败。
  • Super Token 精度锁定:upgrade/downgrade 金额固定为 18 位 decimals,与底层代币精度无关,易在 approve 阶段因单位混淆导致错误。
  • 清算风险:流发送方余额可能因实时流逝降至负值(critical),需依赖链下 sentinel 监控与清算;若 sentinel 未能及时介入,协议累积坏账。

适合人群

  • DeFi 协议开发者:需实现实时收益分配、 vesting 解锁、订阅支付或 DCA(定投)策略。
  • DAO 与薪酬工具:需链上自动化、可审计的实时工资流或拨款流。
  • 智能合约工程师:需构建可组合 Super App,处理流入流出回调、信用管理与嵌套调用。
  • 前端/全栈开发者:需集成 @sfpro/sdk、实时余额动画、流式 UI 组件及历史数据查询。

常规风险

  • 智能合约风险:协议虽经审计,但宏合约、自定义 Super App 及第三方中继代码仍可能引入漏洞。
  • 流动性与清算风险:发送方未及时补充余额或 sentinel 网络失效,可能导致流被清算、接收方收益中断。
  • 权限与签名风险:ClearMacroForwarder 的第三方中继模式需验证 SimpleACL 角色;盲签宏转发器(Legacy)已废弃,继续使用存在 UX 与安全降级风险。
  • 汇率与预言机依赖:部分生态项目(如 TOREX)依赖链上 TWAP,极端市场条件下可能出现价格操纵或滑点损失。

Superfluid Protocol 内容

references文件夹
contracts文件夹
deep-researches文件夹
guides文件夹
subgraphs文件夹
scripts文件夹
手动下载zip · 279.3 kB
_rich-abi-yaml-format.mdtext/markdown
请选择文件