Superfluid Protocol

🌊 实时流支付协议开发全指南

Superfluid Protocol 智能合约完整开发文档,涵盖流支付、实时余额计算、Super App 架构及 GDA 可扩展分发系统,提供 Rich ABI YAML 参考与多场景开发指南。

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

使用说明

概述

Superfluid Protocol 是领先的链上实时金融协议,支持流支付(streaming money)即时余额计算可编程现金流

核心用法

本技能提供完整的智能合约接口文档,按开发者角色分层:

  • Solidity 开发者:使用 SuperTokenV1Library 进行合约集成,CFASuperAppBase 构建回调应用
  • 应用开发者:通过 @sfpro/sdk 和 Subgraph 查询数据
  • 研究者:脚本工具链进行链上数据探查

关键组件包括:

  • CFA(Constant Flow Agreement):1:1 流支付,支持创建/更新/删除流
  • GDA(General Distribution Agreement):多对多池化分发,O(1) 复杂度实现无限接收者
  • Super Token:ERC-777 扩展,支持实时余额与包装/解包
  • MacroForwarder:原子化批量操作执行器

显著优点

1. 实时财务 primitives:余额每秒更新,无需链外预言机
2. Gas 效率:GDA 的 PDPool 数学实现恒定成本分发

3. 可组合性:Super App 回调机制支持复杂金融逻辑嵌套

4. 成熟生态:Dashboard、Explorer、TOGA、Vesting Scheduler 等全套工具

5. 正式规范:Semantic Money 黄皮书提供数学严谨性

局限性与风险

  • 学习曲线陡峭ctx 参数、notes 字段行为、App Credit 机制需仔细理解
  • GDA 无 App Credit:CFA→GDA 分流合约必须自备资金,常见失败原因
  • 连接池上限:每账户每代币最多 256 个连接池,超出需主动 claim
  • 清算风险:余额为负时进入 critical 状态,需 sentinel 监控清算
  • 测试陷阱:Foundry 中 vm.prank 无法覆盖 SuperTokenV1Libraryaddress(this) 假设

适合人群

  • 构建订阅、薪资、 vesting 等流支付场景的 DeFi 开发者
  • 需要实时财务数据的游戏/社交/DAO 工具开发者
  • 研究链上现金流形式化模型的学术开发者

常规风险

  • 智能合约风险(虽经审计,但自定义 Super App 需谨慎)
  • 流动性风险(流支付锁定资金,需管理 deposit buffer)
  • 预言机依赖(仅用于价格显示,非核心逻辑)
  • 网络拥堵时清算延迟(sentinel 经济激励设计缓解)

Superfluid Protocol 内容

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