核心用法
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-core、js-sdk)已弃用。 - 网络特定地址:Host 与 Agreement 地址因链而异,严禁硬编码,须从
@superfluid-finance/metadata动态获取。 - 自动化白名单:Vesting/Flow Scheduler 等自动化需官方 allowlist 才能被 keeper 触发,否则无法执行。
- 解锁惩罚:SUP Locker 即时解锁收取 80% 惩罚,时间解锁需部署 Fontaine 流合约。