概述
Superfluid 是一个支持实时资金流（streaming money）的智能合约协议，允许代币以每秒计价的流式方式转移，无需频繁转账。本 Skill 提供完整的协议开发文档，涵盖 CFA（恒定流协议）、GDA（通用分发协议）、Super Token、Super App 等核心组件的 ABI 参考与集成指南。
核心用法
三大开发者路径：
- 智能合约开发：使用
SuperTokenV1Library进行 Solidity 集成，通过 Host 合约调用callAgreement或batchCall - 前端/后端开发：使用
@sfpro/sdk提供 wagmi hooks、地址解析和 Subgraph 查询 - 一次性调查：通过 CLI 脚本（
tokenlist.mjs、balance.mjs等）快速查询链上数据
关键协议组件：
- Host：中央路由合约，管理应用注册、治理和 SuperTokenFactory
- Agreements：无状态的金融原语——CFA（1:1 流）、GDA（多对多池分发）、IDA（已弃用）
- Super Token：支持实时余额的 ERC-20/777/2612，含 Wrapper、Native Asset、Pure 三种变体
- Forwarders：CFAv1Forwarder / GDAv1Forwarder 提供易用的独立交易包装
- MacroForwarder：支持自定义宏合约的原子批量操作执行
显著优点
- 实时结算：资金流每秒计价，无需锁仓或预付，资本效率极高
- 原子可组合性：通过
Host.batchCall将流创建、代币转移、DeFi 操作捆绑为单笔交易 - 开发者体验完善：Rich ABI YAML 文档包含函数签名、事件、错误码及关键
notes字段标注边缘情况 - 多层抽象：从底层
callAgreement到高层SuperTokenV1Library，满足不同程度的控制需求 - 自动化生态：Vesting Scheduler、Flow Scheduler、Auto-Wrap 支持链上意图的链下 keeper 执行
- 跨网络一致：Forwarder 地址跨网络统一，metadata 包自动解析各链合约地址
潜在局限与风险
- 技术门槛：GDA 池连接限制（每账户每代币 256 个）、单位分配取整行为、Super Token 固定 18 位小数等非直观行为需要仔细阅读
notes字段 - Super App 复杂性：回调生命周期、应用信用（app credit）、jailing 机制、APP_LEVEL 限制（最大链深 2 层）易引发漏洞
- 链下依赖：自动化功能依赖 keeper 网络，需完成 allowlisting 才能被官方 keeper 执行
- 实时状态查询：Subgraph 仅更新于交易事件，当前流余额需通过 RPC 实时计算
- 流动性风险：流发送方需维持正余额，否则面临 sentinel 清算
- 解锁惩罚：SUP 代币的 FluidLocker 即时解锁（unlockPeriod=0）触发 80% 惩罚
适合人群
- DeFi 协议开发者：构建流式薪资、订阅支付、实时收益分配等应用
- 智能合约工程师：开发 Super App 实现自定义流逻辑（如 DCA、借贷自动还款）
- Web3 前端开发者：集成
@sfpro/sdk实现流创建、监控和管理界面 - 协议研究者：分析实时资金流的会计、清算和治理机制
- 自动化运营者：运行 sentinel 节点参与协议清算，或部署自定义 keeper
常规风险
- 智能合约风险：协议虽经审计，但 Super App 的自定义回调引入额外攻击面
- 预言机/keeper 风险：自动化功能的链下执行依赖 keeper 经济激励，可能存在执行延迟
- 治理风险：Host 参数和协议升级由 DAO 控制，需关注治理提案
- 流动性管理风险：流接收方显示的是"实时余额"，实际可提取金额受池连接状态和 claim 操作影响
- 升级兼容性：部分旧包（sdk-core、js-sdk 等）已弃用，需迁移至
@sfpro/sdk