Superfluid Protocol

🌊 实时流支付协议完整开发手册

Superfluid 协议完整开发文档库,涵盖 CFA/GDA 流支付、Super App、自动化调度、清算机制及 SUP 代币生态,适合智能合约与前端开发者集成实时金融流。

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

使用说明

核心用法

Superfluid Skill 是 Superfluid 流支付协议的权威知识库,提供三类开发者路径:

智能合约开发者:通过 SuperTokenV1Library 以 Solidity 直接操作 CFA(1:1 流)与 GDA(多对多池分配),利用 CFASuperAppBase 构建可回调的超级应用,或使用 ClearMacroForwarder 执行原子化批量操作。

应用开发者:借助 @sfpro/sdk 获取 wagmi hooks、预配置 ABI 与地址,结合 subgraph 查询历史数据,通过 Balance API 获取实时余额与报表。

调查/脚本用户:使用 bunx 运行现成脚本快速查询地址、余额、代币列表,或用 cast call 直接读取链上状态。

显著优点

  • 实时流支付:CFA 支持秒级更新的"流动余额",balanceOf 实时反映流入流出,适合订阅、薪资、奖励场景。
  • O(1) 可扩展分配:GDA 池通过 PDPool 数学实现单交易向无限接收者分配,gas 与接收者数量无关。
  • 丰富工具链:从 @sfpro/sdk 到 Clear Macro 的 EIP-712 签名执行,再到完整的 subgraph 索引,覆盖开发全生命周期。
  • ClearMacroForwarder 升级:支持人类可读签名、第三方中继、Permit2 代币升级,用户体验接近传统 Web2 支付。

局限性与风险

  • 仅 EVM 生态:协议合约部署于 Ethereum L2 及兼容链,无 Solana 等非 EVM 支持。
  • GDA 无 App Credit:CFA 的"应用信用"机制在 GDA 中不存在,CFA→GDA 的资金分流合约需自行准备押金,常见集成陷阱。
  • 清算风险:发送方余额归零后进入"临界状态",需 sentinel 机器人清算,否则可能损失押金。
  • 学习曲线陡峭:语义货币(Semantic Money)理论、回调生命周期、押金计算等概念对新手门槛较高。
  • 实时余额精度balanceOf 返回 ERC-20 兼容的 max(0, availableBalance),负余额需用 realtimeBalanceOfNow 检测,前端展示易有误导。

适合人群

  • DeFi 协议开发者:构建流式 DEX(如 TOREX)、流式 Quadratic Funding(Flow State)、DCA(SuperBoring)等创新金融原语。
  • DAO 与薪酬工具:需实时、可编程的代币分发(如 GoodDollar UBI、Nerite 稳定币)。
  • AI Agent 基础设施:ERC-8004 Agent Pool 结合 GDA,为 AI 代理提供身份+收益分配框架。
  • 传统企业支付:寻求链上实时订阅/薪资方案的产品团队。

常规风险提示

  • 合约升级与弃用BlindMacroForwarder 已标记为 legacy,新集成应使用 ClearMacroForwarder;旧 SDK(sdk-corejs-sdk)已弃用。
  • 网络特定地址:Host 与 Agreement 地址因链而异,严禁硬编码,须从 @superfluid-finance/metadata 动态获取。
  • 自动化白名单:Vesting/Flow Scheduler 等自动化需官方 allowlist 才能被 keeper 触发,否则无法执行。
  • 解锁惩罚:SUP Locker 即时解锁收取 80% 惩罚,时间解锁需部署 Fontaine 流合约。

Superfluid Protocol 内容

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