核心用法
Superfluid Protocol 是一套以太坊原生的实时金融协议，支持每秒更新的可编程货币流（money streaming）。本 Skill 提供完整的技术文档体系，覆盖三大开发者路径：
- 智能合约开发：通过
SuperTokenV1Library以 Solidity API 操作 CFA（1:1 流）与 GDA（多对多池分配），利用MacroForwarder执行原子批量操作，或构建接收流回调的 Super App - 前后端应用开发：使用
@sfpro/sdk（内置 wagmi hooks、ABIs、地址表）结合 Subgraph 与 API 服务查询流状态、 vesting 计划、SUP 质押数据 - 快速调研：通过 CLI 脚本（
tokenlist.mjs、balance.mjs、cast call）获取实时余额、合约地址与 ABI
关键架构组件
- Host：中央路由合约，管理批量调用、App 注册与治理
- CFA（Constant Flow Agreement）：1:1 恒定流，支持
flowRate实时计息 - GDA（General Distribution Agreement）：O(1) 复杂度的多接收方池分配，通过
units比例分润 - Super Token：ERC-777 扩展，支持实时余额计算与即时升级/降级（wrap/unwrap）
- Automation：VestingScheduler、FlowScheduler、Auto-Wrap 实现链上意图的链下 keeper 触发
显著优点
1. 金融原语创新："Semantic Money" 理论支撑，将支付解构为时间函数，原生支持薪资流、订阅、实时分成
2. Gas 效率：GDA 通过 settle-on-write 机制实现无限接收方的 O(1) 分配，颠覆传统迭代转账
3. 可组合性：Super App 支持在流生命周期中嵌入回调逻辑，可构建 DCA、流式 DEX、自动质押等复杂策略
4. 生态成熟：提供 React/Vue/Svelte 实时余额动画组件、Clear Signing EIP-712 方案、多链部署（Optimism、Base、Arbitrum 等）
潜在局限与风险
- 流动性风险：发送方余额可负（critical），依赖 sentinel 清算机器人维护协议偿付能力
- 智能合约复杂度：GDA 的 rounding 模型、app credit 机制、pool connection 限制（每账户每 token 最多 256 个连接池）易引发非直观行为
- 前端陷阱：
balanceOf钳制为零，需用realtimeBalanceOfNow检测负余额；SuperTokenV1Library隐式使用address(this)而非msg.sender - 自动化依赖：vesting/flow scheduling 需官方 keeper 网络，需提前申请 allowlisting
适合人群
- 构建实时薪资、订阅、收益分成的 DeFi 协议开发者
- 需集成流支付 SDK 的前端工程师（React/Web3 钱包连接）
- 研究 "Semantic Money" 与可编程货币理论的学术/协议设计人员
- 运行 sentinel 清算机器人的基础设施运维者
常规风险
- 清算延迟：若 sentinel 网络活性不足，critical 流可能累积坏账
- 升级风险：Super Token 底层 ERC-20 合约升级需信任治理
- Gas 波动：高频流更新虽链下计算，但链上操作（启动/停止/清算）仍受网络拥堵影响