[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77VRST27MQNBDFK284TT0EF":3,"skill-same:01M77VRST27MQNBDFK284TT0EF":50},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":30,"repositoryHtmlUrl":31,"repositoryHomepageUrl":32,"ownerHtmlUrl":33,"ownerBlogUrl":6,"ownerDescription":34,"updatedAt":35,"install":36,"resources":49},"01M77VRST27MQNBDFK284TT0EF","superfluid",null,"Knowledge base for the Superfluid Protocol and its ecosystem. Use BEFORE searching the web for Superfluid information. Keywords: Superfluid, CFA, GDA, Super App, Super Token, stream, flow rate, real-time balance, pool (member\u002Fdistributor), IDA, sentinels, liquidation, TOGA, @sfpro\u002Fsdk, semantic money, yellowpaper, whitepaper","Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fs\u002Fsuperfluid\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: superfluid\ndescription: >\n  Knowledge base for the Superfluid Protocol and its ecosystem.\n  Use BEFORE searching the web for Superfluid information.\n  Keywords: Superfluid, CFA, GDA, Super App, Super Token, stream, flow rate,\n  real-time balance, pool (member\u002Fdistributor), IDA, sentinels, liquidation,\n  TOGA, @sfpro\u002Fsdk, semantic money, yellowpaper, whitepaper\nmetadata:\n  version: 1.2.2\n---\n\n# Superfluid Protocol Skill\n\nComplete interface documentation for Superfluid Protocol smart contracts via\nRich ABI YAML references. Read `references\u002Fguides\u002Farchitecture.md` for the full\nprotocol architecture. This file maps use-cases to the right references.\n\n## Developer Tracks\n\nDetermine the track first, then follow the Use-Case Map below.\n\n**Smart Contract dev:** SuperTokenV1Library, CFASuperAppBase, BlindMacroForwarder\u002FClearMacroForwarder, raw agreements via Host. ABI source: `@superfluid-finance\u002Fethereum-contracts`. Addresses: `@superfluid-finance\u002Fmetadata` + `tokenlist`. Data: on-chain calls. Key refs: `.abi.yaml` files, `super-apps.md`, `macro-forwarders.md`, `clear-macro.md`.\n\n**App (frontend\u002Fbackend) dev:** `@sfpro\u002Fsdk` (ABIs, wagmi hooks, addresses), subgraphs, API services. ABI source: `@sfpro\u002Fsdk`. Addresses: `@superfluid-finance\u002Fmetadata` + `tokenlist`. Data: subgraphs + API services. Key refs: `sdks.md`, `api-services.md`, subgraph guides.\n\n**Investigating (one-off):** Scripts (`tokenlist.mjs`, `metadata.mjs`, `balance.mjs`, `cast call`). ABI source: `scripts\u002Fabi.mjs`. Addresses: `scripts\u002Fmetadata.mjs` + `tokenlist.mjs`. Data: `cast call` + `scripts\u002Fbalance.mjs`. Key refs: `scripts.md`.\n\nFor SDK import paths, ABI tables, and deprecated package warnings, see `references\u002Fguides\u002Fsdks.md`.\nFor script command syntax and examples, see `references\u002Fguides\u002Fscripts.md`.\n\n## Architecture Summary\n\n**Host** (`Superfluid.sol`) — central router. Agreement calls go through\n`Host.callAgreement()` or `Host.batchCall()`. Manages the app registry,\ngovernance, and SuperTokenFactory.\n\n**Agreements** — stateless financial primitives that store data on the token:\nCFA (1:1 streams), GDA (many-to-many via pools), IDA (deprecated, replaced by GDA).\n\n**Super Token** — ERC-20\u002FERC-777\u002FERC-2612 with real-time balance. Three\nvariants: Wrapper (ERC-20 backed), Native Asset\u002FSETH (ETH backed), Pure\n(pre-minted).\n\n**Forwarders** (CFAv1Forwarder, GDAv1Forwarder) — convenience wrappers. Each\ncall is a standalone transaction with readable wallet descriptions. Cannot be\nbatched — use `Host.batchCall` with raw agreement calls for atomicity.\n\n**BlindMacroForwarder** (legacy name `MacroForwarder`; SDK: `blindMacroForwarderAbi`, addr\n`0xFD0268E33111565dE546af2675351A4b1587F89F`) — extensible batch executor. Developers deploy\ncustom macro contracts (`IUserDefinedMacro`) and call `runMacro()` to execute complex multi-step\noperations atomically. The caller must be the signer. **Legacy — superseded by ClearMacroForwarder\nfor new integrations**: self-relay only, and the caller broadcasts raw (unreadable) calldata in the\nwallet. See `references\u002Fguides\u002Fmacro-forwarders.md`.\n\n**ClearMacroForwarder** (SDK: `clearMacroForwarderAbi`, addr `0xC1EaB73855155D4e021f7EB4f866996Bac2fe25e`,\ndeployed across ~16 networks) — **recommended default; supersedes BlindMacroForwarder.** EIP-712\nsigned macro executor with human-readable clear-signing,\nthird-party relaying, and optional Permit2 token upgrade in one signature. Two modes: self-submit\n(`security.provider = \"self\"`) and provider-relay (relayer holds a Host SimpleACL role). See\n`references\u002Fguides\u002Fclear-macro.md` and `references\u002Fcontracts\u002FClearMacroForwarder.abi.yaml`.\n\n**Automation** (Vesting Scheduler, FlowScheduler, Auto-Wrap) — schedule\non-chain intent, require off-chain keepers to trigger execution.\n\n## Use-Case → Reference Map\n\nRead only the files needed for the task. Each Rich ABI YAML documents every\npublic function, event, and error for one contract — plus `notes:` fields\nthat flag non-obvious behavior, edge cases, and common mistakes not apparent\nfrom signatures alone.\n\n### Streaming money (CFA)\n\n- Create\u002Fupdate\u002Fdelete a stream (simple) → `references\u002Fcontracts\u002FCFAv1Forwarder.abi.yaml`\n- ACL, operator permissions, flow metadata → also `references\u002Fcontracts\u002FConstantFlowAgreementV1.abi.yaml`\n- Batch streams with other ops atomically → also `references\u002Fcontracts\u002FSuperfluid.abi.yaml` (Host batch call)\n\n### Distributing to many recipients (GDA)\n\n- Create pools, distribute, stream to pool → `references\u002Fcontracts\u002FGDAv1Forwarder.abi.yaml`\n- Pool member management, units, claims → also `references\u002Fcontracts\u002FSuperfluidPool.abi.yaml`\n- Low-level agreement details → also `references\u002Fcontracts\u002FGeneralDistributionAgreementV1.abi.yaml`\n- How GDA achieves O(1) scalability (formal math deep-dive) → also `references\u002Fdeep-researches\u002Fgda-scalability.md`\n\n### Token operations\n\n- Wrap\u002Funwrap, balances, ERC-20\u002F777, permit → `references\u002Fcontracts\u002FSuperToken.abi.yaml`\n- Deploy a new Super Token → `references\u002Fcontracts\u002FSuperTokenFactory.abi.yaml`\n\n### Automation\n\n- Vesting with cliffs and streams → `references\u002Fcontracts\u002FVestingSchedulerV3.abi.yaml`\n- Schedule future stream start\u002Fstop → `references\u002Fcontracts\u002FFlowScheduler.abi.yaml`\n- Auto-wrap when Super Token balance is low → `references\u002Fcontracts\u002FAutoWrapManager.abi.yaml` and `references\u002Fcontracts\u002FAutoWrapStrategy.abi.yaml`\n\n### Writing Solidity integrations (SuperTokenV1Library)\n\n- Token-centric Solidity API (`using SuperTokenV1Library for ISuperToken`) → `references\u002Fcontracts\u002FSuperTokenV1Library.abi.yaml`\n\nThe library wraps CFA and GDA agreement calls into ergonomic methods like\n`token.flow(receiver, flowRate)`. Use it for any Solidity contract that\ninteracts with Superfluid — Super Apps, automation contracts, DeFi\nintegrations. Includes agreement-abstracted functions (`flowX`, `transferX`)\nthat auto-route to CFA or GDA, plus `WithCtx` variants for Super App\ncallbacks. See the YAML header and glossary for Foundry testing gotchas.\n\n### Building Super Apps\n\n- App credit, callback lifecycle, jailing, app levels → `references\u002Fguides\u002Fsuper-apps.md`\n- CFA callback hooks (simplified base) → `references\u002Fcontracts\u002FCFASuperAppBase.abi.yaml`\n- Token-centric API for callback logic → `references\u002Fcontracts\u002FSuperTokenV1Library.abi.yaml` (use `WithCtx` variants)\n- App registration, Host context, batch calls → `references\u002Fcontracts\u002FSuperfluid.abi.yaml`\n- Smart contract patterns (GDA pools, callbacks, custom tokens, automation, proxies) → `references\u002Fguides\u002Fsmart-contract-patterns.md`\n\nSuper Apps that relay incoming flows use **app credit** — a temporary deposit\nallowance enabling zero-balance operation. A 1:1 relay (one in, one out at\nthe same rate) always works without tokens. Fan-out (1:N) requires the app to\nhold tokens for extra deposits. The sender's locked capital roughly doubles\nbecause outgoing stream deposits are backed as owed deposit on the sender.\n**App credit is CFA-only** — GDA has no app credit rule. See Common Gotchas below.\nSee `references\u002Fguides\u002Fsuper-apps.md` for the full guide.\n\n### Macro forwarders (composable batch operations)\n\n- Write a macro for complex batched operations → `references\u002Fguides\u002Fmacro-forwarders.md`\n- BlindMacroForwarder (legacy MacroForwarder) contract address and interface → `references\u002Fguides\u002Fmacro-forwarders.md`; why ClearMacroForwarder supersedes blind → `references\u002Fguides\u002Fmacro-forwarders.md`\n- Batch operation types and encoding rules → also `references\u002Fcontracts\u002FSuperfluid.abi.yaml` (batch_operation_types)\n- EIP-712 signed macro patterns → `references\u002Fguides\u002Fmacro-forwarders-eip712-example.md`\n- **ClearMacroForwarder** — SDK-shipped (`clearMacroForwarderAbi`, `clearMacroForwarderAddress`,\n  metadata key `contractsV1.clearMacroForwarderV1WithPermit2`), deployed at\n  `0xC1EaB73855155D4e021f7EB4f866996Bac2fe25e` across ~16 networks. EIP-712 clear signing for\n  human-readable wallet prompts, third-party provider relaying, optional Permit2 token upgrade in\n  one signature. Two modes: **self-submit** (`security.provider = \"self\"`, tx executor = signer) and\n  **provider-relay** (relayer holds a Host SimpleACL role, enabling gasless-for-signer flows).\n  → `references\u002Fguides\u002Fclear-macro.md`, `references\u002Fcontracts\u002FClearMacroForwarder.abi.yaml`,\n  `references\u002Fcontracts\u002FClearMacroBase.abi.yaml`\n\n### Sentinels and liquidation\n\n- Batch liquidation of critical flows → `references\u002Fcontracts\u002FBatchLiquidator.abi.yaml`\n- PIC auction, bond management, exit rates → `references\u002Fcontracts\u002FTOGA.abi.yaml`\n\n### SUP Token \u002F Reserve System\n\nContracts use \"FLUID\" and \"Locker\" internally — public-facing names are \"SUP\" and \"Reserve\".\n\n- Lock, stake, unstake SUP; provide LP; unlock → `references\u002Fcontracts\u002FFluidLocker.abi.yaml`\n- Create a Reserve (Locker) for a user → `references\u002Fcontracts\u002FFluidLockerFactory.abi.yaml`\n- Claim from emission programs (signed messages) → `references\u002Fcontracts\u002FFluidLocker.abi.yaml` and `references\u002Fcontracts\u002FFluidEPProgramManager.abi.yaml`\n- Create \u002F fund \u002F stop emission programs → `references\u002Fcontracts\u002FFluidEPProgramManager.abi.yaml`\n- Understand tax distribution to stakers and LPs → `references\u002Fcontracts\u002FStakingRewardController.abi.yaml`\n- Unlock SUP via time-delayed stream (Fontaine) → `references\u002Fcontracts\u002FFluidLocker.abi.yaml` and `references\u002Fcontracts\u002FFontaine.abi.yaml`\n\n### ERC-8004 Agent Pools\n\n- ERC-8004 standard, Identity\u002FReputation\u002FValidation registries, AgentPoolDistributor integration → `references\u002Fdeep-researches\u002Ferc8004-agent-pools.md`\n- GDA pool mechanics (units, claims, connections) → `references\u002Fcontracts\u002FGDAv1Forwarder.abi.yaml` and `references\u002Fcontracts\u002FSuperfluidPool.abi.yaml`\n\n### Querying indexed data (Subgraphs)\n\n- Understand how The Graph generates query schemas, plus cross-cutting gotchas → `references\u002Fsubgraphs\u002F_query-patterns.md`\n- Query streams, pools, tokens, accounts (entities) → also `references\u002Fsubgraphs\u002Fprotocol-v1-guide.md` and `protocol-v1-entities.graphql`\n- Query protocol events (flow updates, liquidations, distributions) → also `references\u002Fsubgraphs\u002Fprotocol-v1-guide.md` and `protocol-v1-events.graphql`\n- Query vesting schedules and execution history → also `references\u002Fsubgraphs\u002Fvesting-scheduler-guide.md` and `vesting-scheduler.graphql`\n- Query scheduled flows and automation tasks → also `references\u002Fsubgraphs\u002Fflow-scheduler-guide.md` and `flow-scheduler.graphql`\n- Query auto-wrap schedules and execution history → also `references\u002Fsubgraphs\u002Fauto-wrap-guide.md` and `auto-wrap.graphql`\n- Query SUP lockers, staking, emission programs, unlock history → also `references\u002Fsubgraphs\u002Fsup-subgraph-guide.md` and `sup-subgraph.graphql`\n\n### Legacy\n\n- Old IDA (instant distribution, deprecated) → `references\u002Fcontracts\u002FInstantDistributionAgreementV1.abi.yaml`\n\n### Ecosystem & tooling\n\n- SDK import paths, ABI tables, package choice → `references\u002Fguides\u002Fsdks.md`\n- Script command syntax and examples → `references\u002Fguides\u002Fscripts.md`\n- API endpoint details, Swagger links, gotchas → `references\u002Fguides\u002Fapi-services.md`\n- SUP token, governance, DAO, distribution → `references\u002Fguides\u002Fsup-and-dao.md`\n- Token prices, filtered token list, CoinGecko IDs → See API Services (CMS) below\n- Stream accounting, per-day chunking → See API Services (Accounting) below (CFA + ERC-20 only, no GDA)\n- Comprehensive balances \u002F point-in-time (historical) balance \u002F buffer+connected+disconnected breakdown \u002F CSV exports (CFA + GDA + IDA) → See API Services (Balance API) below\n- Generate or deep-link an accounting\u002Ftax report → https:\u002F\u002Freporter.superfluid.org; param spec: https:\u002F\u002Freporter.superfluid.org\u002Fllms.txt\n- Resolve ENS \u002F Farcaster \u002F Lens handles → See API Services (Whois) below\n- Query protocol data via GraphQL → See Subgraphs below\n- Run a sentinel \u002F liquidation bot → See Sentinels below\n- Get a Super Token listed → https:\u002F\u002Ftokens.superfluid.org\u002Flisting (submit via GitHub) — See also Processes below\n\n### Displaying flowing balances (frontend)\n\n- Animate a real-time streaming balance counter → `references\u002Fguides\u002Fflowing-balances.md`\n  **Read the guide first** — it has production-ready implementations (React, vanilla JS, Vue, Svelte, Solid). Do not generate flowing balance code from scratch.\n- Fix layout shift \u002F jumping in a flowing balance display → also `references\u002Fguides\u002Fflowing-balances.md`\n- Format wei amounts, flow rates, token prices → also `references\u002Fguides\u002Fflowing-balances.md`\n\n### Ecosystem deep-dives\n\n- Protocol history, founding, exploit, SUP launch → `references\u002Fdeep-researches\u002Fsuperfluid-history.md`\n- Semantic Money formal spec (yellowpaper, Haskell reference, BasicParticle, agreement hierarchy) → `references\u002Fdeep-researches\u002Fsemantic-money-yellowpaper.md`\n- GDA scalability (PDPool math, O(1) distributions, rounding model, settle-on-write) → `references\u002Fdeep-researches\u002Fgda-scalability.md`\n- GoodDollar (G$ Pure Super Token on Celo, UBI, streaming) → `references\u002Fdeep-researches\u002Fgooddollar.md`\n- Flow State (Streaming Quadratic Funding, cooperative) → `references\u002Fdeep-researches\u002Fflowstate.md`\n- ERC-8004 Agent Pools (AI agent identity + GDA distribution on Base) → `references\u002Fdeep-researches\u002Ferc8004-agent-pools.md`\n- Planet IX (GameFi, CFA, custom Super Tokens, SuperApp callbacks) → `references\u002Fdeep-researches\u002Fplanet-ix.md`\n- Nerite (USND stablecoin, Custom Pure Super Token, CFA+GDA) → `references\u002Fdeep-researches\u002Fnerite.md`\n- SuperBoring (DCA, CFA→GDA TOREX pattern, Superfluid Labs) → `references\u002Fdeep-researches\u002Fsuperboring.md`\n- TOREX (TWAP Oracle Exchange — streaming DEX, discount model, back charge\u002Frefund between LMEs, liquidity movers, Twin TOREX) → `references\u002Fdeep-researches\u002Ftorex.md`\n- Giveth (zero-fee donations, CFA recurring streams) → `references\u002Fdeep-researches\u002Fgiveth.md`\n- Streme.fun (token launcher, Pure Super Tokens, GDA staking) → `references\u002Fdeep-researches\u002Fstreme.md`\n\n### Superfluid team brand & design\n\n- Color palette, typography, visual identity → `references\u002Fguides\u002Fbrand-design.md`\n  Covers the Superfluid team's product design, not the broader protocol ecosystem.\n\n### Formal specification and protocol theory\n\n- Yellowpaper foundations (payment primitives, conservation of value, agreement framework) → `references\u002Fdeep-researches\u002Fsemantic-money-yellowpaper.md`\n- How GDA achieves O(1) streaming to unlimited receivers → `references\u002Fdeep-researches\u002Fgda-scalability.md`\n- BasicParticle and the real-time balance formula → also `references\u002Fdeep-researches\u002Fsemantic-money-yellowpaper.md`\n\n## Debugging Reverts\n\nError prefixes map to contracts:\n\n- `CFA_*` → ConstantFlowAgreementV1\n- `CFA_FWD_*` → CFAv1Forwarder\n- `GDA_*` → GeneralDistributionAgreementV1\n- `SUPERFLUID_POOL_*` → SuperfluidPool\n- `SF_TOKEN_*` → SuperfluidToken (base of SuperToken)\n- `SUPER_TOKEN_*` → SuperToken\n- `SUPER_TOKEN_FACTORY_*` → SuperTokenFactory\n- `HOST_*` → Superfluid (Host)\n- `IDA_*` → InstantDistributionAgreementV1\n- `APP_RULE` → Superfluid (Host) — Super App callback violation\n- `NOT_LOCKER_OWNER`, `FORBIDDEN`, `INSUFFICIENT_*`, `STAKING_*`, `LP_*`, `TTE_*` → FluidLocker\n- `LOCKER_CREATION_PAUSED`, `NOT_GOVERNOR` → FluidLockerFactory\n- `PROGRAM_*`, `INVALID_SIGNATURE`, `NOT_PROGRAM_ADMIN` → FluidEPProgramManager\n- `NOT_APPROVED_LOCKER`, `NOT_LOCKER_FACTORY`, `NOT_PROGRAM_MANAGER` → StakingRewardController\n- `NOT_CONNECTED_LOCKER`, `NO_ACTIVE_UNLOCK`, `TOO_EARLY_TO_TERMINATE_UNLOCK` → Fontaine\n- `NotAgentOwner`, `AlreadyJoined`, `AgentNotRegistered`, `InsufficientFee`, `FeeTransferFailed` → AgentPoolDistributor\n- `InvalidSignature`, `InvalidPayload`, `MacroContractMismatch`, `ProviderNotAuthorized`, `OutsideValidityWindow`, `InvalidNonce` → ClearMacroForwarder (SDK-shipped, multi-network)\n\nEach YAML's `errors:` section is the complete error index for that contract,\nwith descriptions. Per-function `errors:` fields show which errors a specific\nfunction can throw. To look up a hex selector (function, event, or error),\nread the companion `.selectors.yaml` file — every `Foo.abi.yaml` has a\n`Foo.selectors.yaml` alongside it with full signatures and computed hashes.\n\n## Common Gotchas (Quick Reference)\n\nSubset of non-obvious behaviors. The authoritative source is the `notes:`\nfield on each function in the `.abi.yaml` files — always read those for\nthe complete picture. This section covers only the most common ones.\n\n**Super Token decimals always 18** — `upgrade()` and `downgrade()` amounts are\nalways in 18-decimal SuperToken units, regardless of underlying token decimals.\nThe contract handles scaling internally. The only place underlying decimals\nmatter is the ERC-20 `approve()` call. Example: to wrap 100 USDC, approve\n100e6 on USDC, then call `upgrade(100e18)`.\n\n**GDA pool connections vs. membership** — Pool membership is unlimited (an\naccount can hold units in any number of pools). However, only 256 pools can be\n**connected** per account per token — connected means the balance auto-reflects\nin the member's SuperToken balance. Unconnected members must call `claimAll()`\nto receive their tokens. Gas for `balanceOf` \u002F `realtimeBalanceOf` scales\nlinearly with connected pools.\n\n**GDA distribution rounding** — `distributeFlow`: per-unit rate =\n`requestedFlowRate \u002F totalUnits` (integer division, rounds down). The\nrounding remainder becomes an **adjustment flow to the pool admin**. If\n`requestedFlowRate \u003C totalUnits`, per-unit rate truncates to 0 and the\nentire flow goes to admin. `distribute` (instant): the remainder simply\nisn't taken from the distributor — actual distributed amount \u003C requested.\nPools hold no balance; tokens flow through directly to members.\nSee `references\u002Fdeep-researches\u002Fgda-scalability.md` for the full rounding\nmodel with `align2` and adjustment flow math.\n\n**SuperTokenV1Library `address(this)`** — Convenience functions (`flow`,\n`flowX`, `distribute`, `distributeFlow`, `createPool`, `claimAll`) use\n`address(this)` as the implicit sender, not `msg.sender`. In Foundry tests,\n`vm.prank` does not override this. Use CFA\u002FGDA-specific function overloads\nwith an explicit sender\u002Ffrom parameter instead.\n\n**CFASuperAppBase APP_LEVEL_FINAL** — `CFASuperAppBase` is hardcoded to\n`APP_LEVEL_FINAL`, which prevents calling other Super Apps downstream from\nits callbacks. To compose with downstream Super Apps, build a custom base\nusing `APP_LEVEL_SECOND` and call `host.allowCompositeApp(targetApp)`.\nMax chain depth: 2 apps (SECOND → FINAL).\n\n**GDA pools cannot nest** — A pool cannot be a member of another pool.\n`updateMemberUnits` reverts with `SUPERFLUID_POOL_NO_POOL_MEMBERS` if the\nmember address is a pool. Pool addresses also cannot be pool admins\n(`GDA_ADMIN_CANNOT_BE_POOL`).\n\n**FluidLocker instant unlock penalty** — `unlockPeriod=0` triggers an instant\nunlock with **80% penalty** — only 20% is transferred immediately, 80% is\nredistributed to stakers and LPs. All unlocks (including instant) require\n`msg.value` of 0.0001 ETH (`UNLOCKING_FEE`, sent to DAO treasury). Periods\nof 7–365 days deploy a Fontaine beacon proxy that streams tokens over the\nunlock period with a proportional tax.\n\n**GDA has no app credit** — Unlike CFA, GDA does not support the app credit\nmechanism. A Super App that receives CFA inflows and distributes via GDA\ncannot borrow the deposit buffer — it must fund the GDA stream's buffer\ndeposit from its own balance or via ERC-20 `transferFrom` from the user.\nThis is the most common reason CFA→GDA stream-splitting contracts fail.\nSee `references\u002Fguides\u002Fsmart-contract-patterns.md` § A for the workaround.\n\n**balanceOf clamps to zero** — `balanceOf` returns `max(0, availableBalance)` for\nERC-20 compatibility. Accounts with active outgoing streams can go negative\n(critical), but `balanceOf` will still show 0. Use `realtimeBalanceOfNow` to\ndetect negative balances — a negative `availableBalance` means the account is\ncritical and awaiting liquidation. Once liquidated, the balance resets to zero.\n\n## Reading the Rich ABI YAMLs\n\nEssential conventions for parsing the YAML files:\n\n- **Reserved root keys:** `meta`, `events`, `errors` — every other root key is a **function**.\n- **`ctx: bytes` parameter** = function is called through the Host (`callAgreement` \u002F `batchCall`), never directly.\n- **`notes:` field** — the most important field for correctness. Present on functions (and as `meta.notes:` at contract level). Contains non-obvious behavior, edge cases, and common mistakes. If a user asks about unexpected behavior, the answer is almost always in a `notes:` field. Always read these.\n- **`access` labels:** `anyone`, `host`, `self`, `admin`, `governance`, `sender`, `receiver`, `operator`, `manager`, `pic`, etc. Combine with `|`.\n- **`emits` and `errors` ordering** matches execution flow (not alphabetical). First errors = most likely.\n- **Field order:** description comment, `notes`, `mutability`, `access`, `inputs`, `outputs`, `emits`, `errors`.\n\nFor the full format spec with examples (function entries, events, errors sections), see `references\u002Fcontracts\u002F_rich-abi-yaml-format.md`.\n\n## Runtime Data (Scripts)\n\nScripts provide runtime data (addresses, balances, ABIs) for one-off lookups.\nRun with `bunx -p \u003Cpkg> bun \u003Cscript>` — see `references\u002Fguides\u002Fscripts.md`\nfor full syntax. When writing application code, use the npm packages directly\ninstead (see Developer Tracks above).\n\n- `scripts\u002Fabi.mjs` — JSON ABI lookup, function signatures. Use when you need to inspect ABIs outside an app project.\n- `scripts\u002Ftokenlist.mjs` — Super Token addresses, symbols, types. Use when you need to find a token address or check its type.\n- `scripts\u002Fbalance.mjs` — Real-time balances, flow rates. Use when you need current balance or net flow for an account.\n- `scripts\u002Fmetadata.mjs` — Contract addresses, subgraph endpoints, network info. Use when you need addresses for a specific chain.\n- `cast call` — Direct on-chain reads. Use when you need live contract state not covered by scripts.\n\nFor command syntax, arguments, and examples, see `references\u002Fguides\u002Fscripts.md`.\n\n## Common Contract Addresses\n\nDo NOT hardcode or fabricate addresses. Get them from `@sfpro\u002Fsdk` address\nexports (see `references\u002Fguides\u002Fsdks.md`) or `bunx -p @superfluid-finance\u002Fmetadata bun scripts\u002Fmetadata.mjs contracts \u003Cchain>`.\n\nForwarder addresses are the exception — uniform across most networks:\n- CFAv1Forwarder: `0xcfA132E353cB4E398080B9700609bb008eceB125`\n- GDAv1Forwarder: `0x6DA13Bde224A05a288748d857b9e7DDEffd1dE08`\n- ClearMacroForwarder: `0xC1EaB73855155D4e021f7EB4f866996Bac2fe25e` (SDK: `clearMacroForwarderAddress`)\n- BlindMacroForwarder (legacy MacroForwarder): `0xFD0268E33111565dE546af2675351A4b1587F89F` (SDK: `blindMacroForwarderAddress`)\n\nHost and agreement addresses vary per network.\n\n## Ecosystem\n\n### SDKs & Packages\n\n**Active — recommended for new projects:**\n\n- `@sfpro\u002Fsdk` — Frontend\u002Fbackend SDK: ABIs, wagmi hooks, actions\n- `@superfluid-finance\u002Fethereum-contracts` — Solidity build-time ABI source\n- `@superfluid-finance\u002Fmetadata` — Contract addresses, network info (zero deps)\n- `@superfluid-finance\u002Ftokenlist` — Listed Super Tokens + underlying tokens\n\nWhen to use each:\n- `@sfpro\u002Fsdk` — for frontend\u002Fbackend with wagmi\u002Fviem\n- `ethereum-contracts` — for Solidity integrations (build-time only, not runtime)\n- `metadata` — for resolving addresses\u002Fnetworks at runtime\n- `tokenlist` — for finding token addresses\n\n**Deprecated — do not recommend for new projects:**\n\n- `@superfluid-finance\u002Fsdk-core` → replaced by `@sfpro\u002Fsdk`\n- `@superfluid-finance\u002Fsdk-redux` → replaced by wagmi + `@sfpro\u002Fsdk`\n- `@superfluid-finance\u002Fjs-sdk` → replaced by `@sfpro\u002Fsdk`\n- `@superfluid-finance\u002Fwidget` → no replacement\n\nFor ABI import tables, address exports, detailed SDK guidance, and deprecated\npackage details, see `references\u002Fguides\u002Fsdks.md`.\n\n### API Services\n\n- Super API `https:\u002F\u002Fsuperapi.kazpi.com` — Real-time on-chain Super Token balances (live balance only)\n- Balance API `https:\u002F\u002Fbalances.superfluid.dev` — event-sourced indexer: point-in-time\u002Fhistorical CFA+GDA+IDA balances (buffer\u002Fconnected\u002Fdisconnected), snapshots, reports, movements; read-only, no auth\n- CMS `https:\u002F\u002Fcms.superfluid.pro` — Token prices, price history, filtered token list\n- Points `https:\u002F\u002Fcms.superfluid.pro\u002Fpoints` — SUP points campaigns\n- Accounting `https:\u002F\u002Faccounting.superfluid.dev\u002Fv1` — Stream accounting with per-day chunking\n- Allowlist `https:\u002F\u002Fallowlist.superfluid.dev` — Check automation allowlist status\n- Whois `https:\u002F\u002Fwhois.superfluid.finance` — Resolve profiles (ENS, Farcaster, Lens, AF)\n- Token Prices `https:\u002F\u002Ftoken-prices-api.superfluid.dev\u002Fv1\u002F{network}\u002F{token}` — Super Token prices (CoinGecko-backed)\n- Claim Programs `https:\u002F\u002Fclaim.superfluid.org\u002Fapi\u002Fprograms` — SUP reward programs: seasons, allocations, pool addresses, flow rates\n\nFor per-API endpoints, query patterns, Swagger\u002FOpenAPI links, and gotchas,\nsee `references\u002Fguides\u002Fapi-services.md`.\n\n### Subgraphs\n\n**Prefer RPC over subgraph for current state.** Subgraphs only update on\ntransactions, but streams flow every second. Use `cast call` or\n`scripts\u002Fbalance.mjs` for real-time reads. Subgraphs are best for historical\nqueries, event indexing, and listing\u002Ffiltering entities.\n\nEndpoint pattern: `https:\u002F\u002Fsubgraph-endpoints.superfluid.dev\u002F{network-name}\u002F{subgraph}`\n\n- Protocol `protocol-v1` — Main protocol data (streams, tokens, accounts)\n- Vesting Scheduler `vesting-scheduler` — All versions: v1, v2, v3\n- Flow Scheduler `flow-scheduler`\n- Auto-Wrap `auto-wrap`\n- SUP (Locker \u002F Reserve) — Goldsky-hosted (Base only). Staking, unlocks, emission programs, LP positions.\n\nNetwork names are canonical Superfluid names (`optimism-mainnet`,\n`base-mainnet`, etc.). Use `bunx -p @superfluid-finance\u002Fmetadata bun metadata.mjs subgraph \u003Cchain>` to get the\nresolved URL for a specific chain.\n\n### Apps\n\n- Super Tokens https:\u002F\u002Ftokens.superfluid.org — Official Super Tokens site: ERC20x overview, Clear Macro, Super App hooks, and token listing (Clear Macro demo: https:\u002F\u002Ftokens.superfluid.org\u002Fclear\u002Fdemo)\n- Dashboard https:\u002F\u002Fapp.superfluid.org — Stream management for end-users\n- Explorer https:\u002F\u002Fexplorer.superfluid.org — Block explorer for Superfluid Protocol\n- Claim https:\u002F\u002Fclaim.superfluid.org — SUP token, SUP points, reserves\u002Flockers\n- TOGA https:\u002F\u002Ftoga.superfluid.finance — View recent liquidations by token\n- Dune https:\u002F\u002Fdune.com\u002Fsuperfluid_hq\u002Fsuperfluid-overview — Official protocol analytics dashboards\n- Campaigns https:\u002F\u002Fcampaigns.superfluid.org — Mint exclusive NFTs powered by Superfluid, with SUP reward campaigns\n- x402 https:\u002F\u002Fx402.superfluid.org — Open standard for internet-native subscriptions via HTTP 402 + Superfluid streams. One-time EIP-712 signature, no gas fees, real-time payment verification, zero protocol fees. Works for human users and AI agents.\n- 8004 Agent Pool https:\u002F\u002F8004-demo.superfluid.org\u002F — AI agent pool powered by ERC-8004 identity and Superfluid GDA. Agents register, join a pool, and earn proportional SUP distributions.\n- Reporter https:\u002F\u002Freporter.superfluid.org — accounting\u002Ftax CSV reports over the Balance API; deep-linkable via query params (account, chain, tokens, startDate\u002FendDate, period, export params); param spec: https:\u002F\u002Freporter.superfluid.org\u002Fllms.txt\n\nRepos:\n[Dashboard](https:\u002F\u002Fgithub.com\u002Fsuperfluid-org\u002Fsuperfluid-dashboard) ·\n[Explorer](https:\u002F\u002Fgithub.com\u002Fsuperfluid-org\u002Fsuperfluid-explorer) ·\n[TOGA](https:\u002F\u002Fgithub.com\u002Fsuperfluid-org\u002Ftoga-suit) ·\n[8004 Demo](https:\u002F\u002Fgithub.com\u002Fsuperfluid-org\u002F8004-demo)\n\n### Community & Social\n\n- Twitter\u002FX https:\u002F\u002Fx.com\u002FSuperfluid_HQ\n- Farcaster https:\u002F\u002Fwarpcast.com\u002Fsuperfluid\n- Discord https:\u002F\u002Fdiscord.gg\u002FEFAUmTnPd9\n\n### Sentinels\n\nSentinels monitor streams and liquidate senders whose Super Token balance\nreaches zero, keeping the protocol solvent. Anyone can run one.\n\n- [Graphinator](https:\u002F\u002Fgithub.com\u002Fsuperfluid-org\u002Fgraphinator) — Lightweight subgraph-based sentinel\n- [Superfluid Sentinel](https:\u002F\u002Fgithub.com\u002Fsuperfluid-org\u002Fsuperfluid-sentinel) — Legacy RPC-based sentinel\n\n### Foundation, DAO & SUP Token\n\n**SUP** — a SuperToken on Base (`0xa69f80524381275a7ffdb3ae01c54150644c8792`).\n1B total supply. Governed by Superfluid DAO via\n[Snapshot](https:\u002F\u002Fsnapshot.box\u002F#\u002Fs:superfluid.eth). **Locker \u002F Reserve** is\nthe on-chain staking mechanism (longer lockup = bigger bonus).\n\nFor distribution breakdown, Foundation vs DAO roles, governance details, and\nlinks, see `references\u002Fguides\u002Fsup-and-dao.md`.\n\n### Processes\n\n**Token Listing** — a Super Token gets listed on the on-chain Resolver, which\nthe subgraph picks up (marks `isListed`). Once listed, it appears in the\nSuperfluid token list along with its underlying token (if any).\n\n- Request: [listing form](https:\u002F\u002Fairtable.com\u002FappxGogNpt64ImOFH\u002FshrzOcdK9eveDmRWV)\n  → opens issue in [superfluid-org\u002Fassets](https:\u002F\u002Fgithub.com\u002Fsuperfluid-org\u002Fassets\u002Fissues)\n\n**Automation Allowlisting** — required for automations (vesting, flow\nscheduling, auto-wrap) to appear in the Dashboard UI and for Superfluid\noff-chain keepers to trigger the automation contracts. Without allowlisting,\nautomations won't be executed on time and are effectively useless.\n\n- Request: [allowlisting form](https:\u002F\u002Fairtable.com\u002Fappmq3TJDdQUrTQpx\u002FshrWouN6ursCkOQ86)\n- Check status: `GET https:\u002F\u002Fallowlist.superfluid.dev\u002Fapi\u002Fallowlist\u002F{account}\u002F{chainId}`\n","# Superfluid Protocol Skill\n\nComplete interface documentation for Superfluid Protocol smart contracts via\nRich ABI YAML references. Read `references\u002Fguides\u002Farchitecture.md` for the full\nprotocol architecture. This file maps use-cases to the right references.\n\n## Developer Tracks\n\nDetermine the track first, then follow the Use-Case Map below.\n\n**Smart Contract dev:** SuperTokenV1Library, CFASuperAppBase, BlindMacroForwarder\u002FClearMacroForwarder, raw agreements via Host. ABI source: `@superfluid-finance\u002Fethereum-contracts`. Addresses: `@superfluid-finance\u002Fmetadata` + `tokenlist`. Data: on-chain calls. Key refs: `.abi.yaml` files, `super-apps.md`, `macro-forwarders.md`, `clear-macro.md`.\n\n**App (frontend\u002Fbackend) dev:** `@sfpro\u002Fsdk` (ABIs, wagmi hooks, addresses), subgraphs, API services. ABI source: `@sfpro\u002Fsdk`. Addresses: `@superfluid-finance\u002Fmetadata` + `tokenlist`. Data: subgraphs + API services. Key refs: `sdks.md`, `api-services.md`, subgraph guides.\n\n**Investigating (one-off):** Scripts (`tokenlist.mjs`, `metadata.mjs`, `balance.mjs`, `cast call`). ABI source: `scripts\u002Fabi.mjs`. Addresses: `scripts\u002Fmetadata.mjs` + `tokenlist.mjs`. Data: `cast call` + `scripts\u002Fbalance.mjs`. Key refs: `scripts.md`.\n\nFor SDK import paths, ABI tables, and deprecated package warnings, see `references\u002Fguides\u002Fsdks.md`.\nFor script command syntax and examples, see `references\u002Fguides\u002Fscripts.md`.\n\n## Architecture Summary\n\n**Host** (`Superfluid.sol`) — central router. Agreement calls go through\n`Host.callAgreement()` or `Host.batchCall()`. Manages the app registry,\ngovernance, and SuperTokenFactory.\n\n**Agreements** — stateless financial primitives that store data on the token:\nCFA (1:1 streams), GDA (many-to-many via pools), IDA (deprecated, replaced by GDA).\n\n**Super Token** — ERC-20\u002FERC-777\u002FERC-2612 with real-time balance. Three\nvariants: Wrapper (ERC-20 backed), Native Asset\u002FSETH (ETH backed), Pure\n(pre-minted).\n\n**Forwarders** (CFAv1Forwarder, GDAv1Forwarder) — convenience wrappers. Each\ncall is a standalone transaction with readable wallet descriptions. Cannot be\nbatched — use `Host.batchCall` with raw agreement calls for atomicity.\n\n**BlindMacroForwarder** (legacy name `MacroForwarder`; SDK: `blindMacroForwarderAbi`, addr\n`0xFD0268E33111565dE546af2675351A4b1587F89F`) — extensible batch executor. Developers deploy\ncustom macro contracts (`IUserDefinedMacro`) and call `runMacro()` to execute complex multi-step\noperations atomically. The caller must be the signer. **Legacy — superseded by ClearMacroForwarder\nfor new integrations**: self-relay only, and the caller broadcasts raw (unreadable) calldata in the\nwallet. See `references\u002Fguides\u002Fmacro-forwarders.md`.\n\n**ClearMacroForwarder** (SDK: `clearMacroForwarderAbi`, addr `0xC1EaB73855155D4e021f7EB4f866996Bac2fe25e`,\ndeployed across ~16 networks) — **recommended default; supersedes BlindMacroForwarder.** EIP-712\nsigned macro executor with human-readable clear-signing,\nthird-party relaying, and optional Permit2 token upgrade in one signature. Two modes: self-submit\n(`security.provider = \"self\"`) and provider-relay (relayer holds a Host SimpleACL role). See\n`references\u002Fguides\u002Fclear-macro.md` and `references\u002Fcontracts\u002FClearMacroForwarder.abi.yaml`.\n\n**Automation** (Vesting Scheduler, FlowScheduler, Auto-Wrap) — schedule\non-chain intent, require off-chain keepers to trigger execution.\n\n## Use-Case → Reference Map\n\nRead only the files needed for the task. Each Rich ABI YAML documents every\npublic function, event, and error for one contract — plus `notes:` fields\nthat flag non-obvious behavior, edge cases, and common mistakes not apparent\nfrom signatures alone.\n\n### Streaming money (CFA)\n\n- Create\u002Fupdate\u002Fdelete a stream (simple) → `references\u002Fcontracts\u002FCFAv1Forwarder.abi.yaml`\n- ACL, operator permissions, flow metadata → also `references\u002Fcontracts\u002FConstantFlowAgreementV1.abi.yaml`\n- Batch streams with other ops atomically → also `references\u002Fcontracts\u002FSuperfluid.abi.yaml` (Host batch call)\n\n### Distributing to many recipients (GDA)\n\n- Create pools, distribute, stream to pool → `references\u002Fcontracts\u002FGDAv1Forwarder.abi.yaml`\n- Pool member management, units, claims → also `references\u002Fcontracts\u002FSuperfluidPool.abi.yaml`\n- Low-level agreement details → also `references\u002Fcontracts\u002FGeneralDistributionAgreementV1.abi.yaml`\n- How GDA achieves O(1) scalability (formal math deep-dive) → also `references\u002Fdeep-researches\u002Fgda-scalability.md`\n\n### Token operations\n\n- Wrap\u002Funwrap, balances, ERC-20\u002F777, permit → `references\u002Fcontracts\u002FSuperToken.abi.yaml`\n- Deploy a new Super Token → `references\u002Fcontracts\u002FSuperTokenFactory.abi.yaml`\n\n### Automation\n\n- Vesting with cliffs and streams → `references\u002Fcontracts\u002FVestingSchedulerV3.abi.yaml`\n- Schedule future stream start\u002Fstop → `references\u002Fcontracts\u002FFlowScheduler.abi.yaml`\n- Auto-wrap when Super Token balance is low → `references\u002Fcontracts\u002FAutoWrapManager.abi.yaml` and `references\u002Fcontracts\u002FAutoWrapStrategy.abi.yaml`\n\n### Writing Solidity integrations (SuperTokenV1Library)\n\n- Token-centric Solidity API (`using SuperTokenV1Library for ISuperToken`) → `references\u002Fcontracts\u002FSuperTokenV1Library.abi.yaml`\n\nThe library wraps CFA and GDA agreement calls into ergonomic methods like\n`token.flow(receiver, flowRate)`. Use it for any Solidity contract that\ninteracts with Superfluid — Super Apps, automation contracts, DeFi\nintegrations. Includes agreement-abstracted functions (`flowX`, `transferX`)\nthat auto-route to CFA or GDA, plus `WithCtx` variants for Super App\ncallbacks. See the YAML header and glossary for Foundry testing gotchas.\n\n### Building Super Apps\n\n- App credit, callback lifecycle, jailing, app levels → `references\u002Fguides\u002Fsuper-apps.md`\n- CFA callback hooks (simplified base) → `references\u002Fcontracts\u002FCFASuperAppBase.abi.yaml`\n- Token-centric API for callback logic → `references\u002Fcontracts\u002FSuperTokenV1Library.abi.yaml` (use `WithCtx` variants)\n- App registration, Host context, batch calls → `references\u002Fcontracts\u002FSuperfluid.abi.yaml`\n- Smart contract patterns (GDA pools, callbacks, custom tokens, automation, proxies) → `references\u002Fguides\u002Fsmart-contract-patterns.md`\n\nSuper Apps that relay incoming flows use **app credit** — a temporary deposit\nallowance enabling zero-balance operation. A 1:1 relay (one in, one out at\nthe same rate) always works without tokens. Fan-out (1:N) requires the app to\nhold tokens for extra deposits. The sender's locked capital roughly doubles\nbecause outgoing stream deposits are backed as owed deposit on the sender.\n**App credit is CFA-only** — GDA has no app credit rule. See Common Gotchas below.\nSee `references\u002Fguides\u002Fsuper-apps.md` for the full guide.\n\n### Macro forwarders (composable batch operations)\n\n- Write a macro for complex batched operations → `references\u002Fguides\u002Fmacro-forwarders.md`\n- BlindMacroForwarder (legacy MacroForwarder) contract address and interface → `references\u002Fguides\u002Fmacro-forwarders.md`; why ClearMacroForwarder supersedes blind → `references\u002Fguides\u002Fmacro-forwarders.md`\n- Batch operation types and encoding rules → also `references\u002Fcontracts\u002FSuperfluid.abi.yaml` (batch_operation_types)\n- EIP-712 signed macro patterns → `references\u002Fguides\u002Fmacro-forwarders-eip712-example.md`\n- **ClearMacroForwarder** — SDK-shipped (`clearMacroForwarderAbi`, `clearMacroForwarderAddress`,\n  metadata key `contractsV1.clearMacroForwarderV1WithPermit2`), deployed at\n  `0xC1EaB73855155D4e021f7EB4f866996Bac2fe25e` across ~16 networks. EIP-712 clear signing for\n  human-readable wallet prompts, third-party provider relaying, optional Permit2 token upgrade in\n  one signature. Two modes: **self-submit** (`security.provider = \"self\"`, tx executor = signer) and\n  **provider-relay** (relayer holds a Host SimpleACL role, enabling gasless-for-signer flows).\n  → `references\u002Fguides\u002Fclear-macro.md`, `references\u002Fcontracts\u002FClearMacroForwarder.abi.yaml`,\n  `references\u002Fcontracts\u002FClearMacroBase.abi.yaml`\n\n### Sentinels and liquidation\n\n- Batch liquidation of critical flows → `references\u002Fcontracts\u002FBatchLiquidator.abi.yaml`\n- PIC auction, bond management, exit rates → `references\u002Fcontracts\u002FTOGA.abi.yaml`\n\n### SUP Token \u002F Reserve System\n\nContracts use \"FLUID\" and \"Locker\" internally — public-facing names are \"SUP\" and \"Reserve\".\n\n- Lock, stake, unstake SUP; provide LP; unlock → `references\u002Fcontracts\u002FFluidLocker.abi.yaml`\n- Create a Reserve (Locker) for a user → `references\u002Fcontracts\u002FFluidLockerFactory.abi.yaml`\n- Claim from emission programs (signed messages) → `references\u002Fcontracts\u002FFluidLocker.abi.yaml` and `references\u002Fcontracts\u002FFluidEPProgramManager.abi.yaml`\n- Create \u002F fund \u002F stop emission programs → `references\u002Fcontracts\u002FFluidEPProgramManager.abi.yaml`\n- Understand tax distribution to stakers and LPs → `references\u002Fcontracts\u002FStakingRewardController.abi.yaml`\n- Unlock SUP via time-delayed stream (Fontaine) → `references\u002Fcontracts\u002FFluidLocker.abi.yaml` and `references\u002Fcontracts\u002FFontaine.abi.yaml`\n\n### ERC-8004 Agent Pools\n\n- ERC-8004 standard, Identity\u002FReputation\u002FValidation registries, AgentPoolDistributor integration → `references\u002Fdeep-researches\u002Ferc8004-agent-pools.md`\n- GDA pool mechanics (units, claims, connections) → `references\u002Fcontracts\u002FGDAv1Forwarder.abi.yaml` and `references\u002Fcontracts\u002FSuperfluidPool.abi.yaml`\n\n### Querying indexed data (Subgraphs)\n\n- Understand how The Graph generates query schemas, plus cross-cutting gotchas → `references\u002Fsubgraphs\u002F_query-patterns.md`\n- Query streams, pools, tokens, accounts (entities) → also `references\u002Fsubgraphs\u002Fprotocol-v1-guide.md` and `protocol-v1-entities.graphql`\n- Query protocol events (flow updates, liquidations, distributions) → also `references\u002Fsubgraphs\u002Fprotocol-v1-guide.md` and `protocol-v1-events.graphql`\n- Query vesting schedules and execution history → also `references\u002Fsubgraphs\u002Fvesting-scheduler-guide.md` and `vesting-scheduler.graphql`\n- Query scheduled flows and automation tasks → also `references\u002Fsubgraphs\u002Fflow-scheduler-guide.md` and `flow-scheduler.graphql`\n- Query auto-wrap schedules and execution history → also `references\u002Fsubgraphs\u002Fauto-wrap-guide.md` and `auto-wrap.graphql`\n- Query SUP lockers, staking, emission programs, unlock history → also `references\u002Fsubgraphs\u002Fsup-subgraph-guide.md` and `sup-subgraph.graphql`\n\n### Legacy\n\n- Old IDA (instant distribution, deprecated) → `references\u002Fcontracts\u002FInstantDistributionAgreementV1.abi.yaml`\n\n### Ecosystem & tooling\n\n- SDK import paths, ABI tables, package choice → `references\u002Fguides\u002Fsdks.md`\n- Script command syntax and examples → `references\u002Fguides\u002Fscripts.md`\n- API endpoint details, Swagger links, gotchas → `references\u002Fguides\u002Fapi-services.md`\n- SUP token, governance, DAO, distribution → `references\u002Fguides\u002Fsup-and-dao.md`\n- Token prices, filtered token list, CoinGecko IDs → See API Services (CMS) below\n- Stream accounting, per-day chunking → See API Services (Accounting) below (CFA + ERC-20 only, no GDA)\n- Comprehensive balances \u002F point-in-time (historical) balance \u002F buffer+connected+disconnected breakdown \u002F CSV exports (CFA + GDA + IDA) → See API Services (Balance API) below\n- Generate or deep-link an accounting\u002Ftax report → https:\u002F\u002Freporter.superfluid.org; param spec: https:\u002F\u002Freporter.superfluid.org\u002Fllms.txt\n- Resolve ENS \u002F Farcaster \u002F Lens handles → See API Services (Whois) below\n- Query protocol data via GraphQL → See Subgraphs below\n- Run a sentinel \u002F liquidation bot → See Sentinels below\n- Get a Super Token listed → https:\u002F\u002Ftokens.superfluid.org\u002Flisting (submit via GitHub) — See also Processes below\n\n### Displaying flowing balances (frontend)\n\n- Animate a real-time streaming balance counter → `references\u002Fguides\u002Fflowing-balances.md`\n  **Read the guide first** — it has production-ready implementations (React, vanilla JS, Vue, Svelte, Solid). Do not generate flowing balance code from scratch.\n- Fix layout shift \u002F jumping in a flowing balance display → also `references\u002Fguides\u002Fflowing-balances.md`\n- Format wei amounts, flow rates, token prices → also `references\u002Fguides\u002Fflowing-balances.md`\n\n### Ecosystem deep-dives\n\n- Protocol history, founding, exploit, SUP launch → `references\u002Fdeep-researches\u002Fsuperfluid-history.md`\n- Semantic Money formal spec (yellowpaper, Haskell reference, BasicParticle, agreement hierarchy) → `references\u002Fdeep-researches\u002Fsemantic-money-yellowpaper.md`\n- GDA scalability (PDPool math, O(1) distributions, rounding model, settle-on-write) → `references\u002Fdeep-researches\u002Fgda-scalability.md`\n- GoodDollar (G$ Pure Super Token on Celo, UBI, streaming) → `references\u002Fdeep-researches\u002Fgooddollar.md`\n- Flow State (Streaming Quadratic Funding, cooperative) → `references\u002Fdeep-researches\u002Fflowstate.md`\n- ERC-8004 Agent Pools (AI agent identity + GDA distribution on Base) → `references\u002Fdeep-researches\u002Ferc8004-agent-pools.md`\n- Planet IX (GameFi, CFA, custom Super Tokens, SuperApp callbacks) → `references\u002Fdeep-researches\u002Fplanet-ix.md`\n- Nerite (USND stablecoin, Custom Pure Super Token, CFA+GDA) → `references\u002Fdeep-researches\u002Fnerite.md`\n- SuperBoring (DCA, CFA→GDA TOREX pattern, Superfluid Labs) → `references\u002Fdeep-researches\u002Fsuperboring.md`\n- TOREX (TWAP Oracle Exchange — streaming DEX, discount model, back charge\u002Frefund between LMEs, liquidity movers, Twin TOREX) → `references\u002Fdeep-researches\u002Ftorex.md`\n- Giveth (zero-fee donations, CFA recurring streams) → `references\u002Fdeep-researches\u002Fgiveth.md`\n- Streme.fun (token launcher, Pure Super Tokens, GDA staking) → `references\u002Fdeep-researches\u002Fstreme.md`\n\n### Superfluid team brand & design\n\n- Color palette, typography, visual identity → `references\u002Fguides\u002Fbrand-design.md`\n  Covers the Superfluid team's product design, not the broader protocol ecosystem.\n\n### Formal specification and protocol theory\n\n- Yellowpaper foundations (payment primitives, conservation of value, agreement framework) → `references\u002Fdeep-researches\u002Fsemantic-money-yellowpaper.md`\n- How GDA achieves O(1) streaming to unlimited receivers → `references\u002Fdeep-researches\u002Fgda-scalability.md`\n- BasicParticle and the real-time balance formula → also `references\u002Fdeep-researches\u002Fsemantic-money-yellowpaper.md`\n\n## Debugging Reverts\n\nError prefixes map to contracts:\n\n- `CFA_*` → ConstantFlowAgreementV1\n- `CFA_FWD_*` → CFAv1Forwarder\n- `GDA_*` → GeneralDistributionAgreementV1\n- `SUPERFLUID_POOL_*` → SuperfluidPool\n- `SF_TOKEN_*` → SuperfluidToken (base of SuperToken)\n- `SUPER_TOKEN_*` → SuperToken\n- `SUPER_TOKEN_FACTORY_*` → SuperTokenFactory\n- `HOST_*` → Superfluid (Host)\n- `IDA_*` → InstantDistributionAgreementV1\n- `APP_RULE` → Superfluid (Host) — Super App callback violation\n- `NOT_LOCKER_OWNER`, `FORBIDDEN`, `INSUFFICIENT_*`, `STAKING_*`, `LP_*`, `TTE_*` → FluidLocker\n- `LOCKER_CREATION_PAUSED`, `NOT_GOVERNOR` → FluidLockerFactory\n- `PROGRAM_*`, `INVALID_SIGNATURE`, `NOT_PROGRAM_ADMIN` → FluidEPProgramManager\n- `NOT_APPROVED_LOCKER`, `NOT_LOCKER_FACTORY`, `NOT_PROGRAM_MANAGER` → StakingRewardController\n- `NOT_CONNECTED_LOCKER`, `NO_ACTIVE_UNLOCK`, `TOO_EARLY_TO_TERMINATE_UNLOCK` → Fontaine\n- `NotAgentOwner`, `AlreadyJoined`, `AgentNotRegistered`, `InsufficientFee`, `FeeTransferFailed` → AgentPoolDistributor\n- `InvalidSignature`, `InvalidPayload`, `MacroContractMismatch`, `ProviderNotAuthorized`, `OutsideValidityWindow`, `InvalidNonce` → ClearMacroForwarder (SDK-shipped, multi-network)\n\nEach YAML's `errors:` section is the complete error index for that contract,\nwith descriptions. Per-function `errors:` fields show which errors a specific\nfunction can throw. To look up a hex selector (function, event, or error),\nread the companion `.selectors.yaml` file — every `Foo.abi.yaml` has a\n`Foo.selectors.yaml` alongside it with full signatures and computed hashes.\n\n## Common Gotchas (Quick Reference)\n\nSubset of non-obvious behaviors. The authoritative source is the `notes:`\nfield on each function in the `.abi.yaml` files — always read those for\nthe complete picture. This section covers only the most common ones.\n\n**Super Token decimals always 18** — `upgrade()` and `downgrade()` amounts are\nalways in 18-decimal SuperToken units, regardless of underlying token decimals.\nThe contract handles scaling internally. The only place underlying decimals\nmatter is the ERC-20 `approve()` call. Example: to wrap 100 USDC, approve\n100e6 on USDC, then call `upgrade(100e18)`.\n\n**GDA pool connections vs. membership** — Pool membership is unlimited (an\naccount can hold units in any number of pools). However, only 256 pools can be\n**connected** per account per token — connected means the balance auto-reflects\nin the member's SuperToken balance. Unconnected members must call `claimAll()`\nto receive their tokens. Gas for `balanceOf` \u002F `realtimeBalanceOf` scales\nlinearly with connected pools.\n\n**GDA distribution rounding** — `distributeFlow`: per-unit rate =\n`requestedFlowRate \u002F totalUnits` (integer division, rounds down). The\nrounding remainder becomes an **adjustment flow to the pool admin**. If\n`requestedFlowRate \u003C totalUnits`, per-unit rate truncates to 0 and the\nentire flow goes to admin. `distribute` (instant): the remainder simply\nisn't taken from the distributor — actual distributed amount \u003C requested.\nPools hold no balance; tokens flow through directly to members.\nSee `references\u002Fdeep-researches\u002Fgda-scalability.md` for the full rounding\nmodel with `align2` and adjustment flow math.\n\n**SuperTokenV1Library `address(this)`** — Convenience functions (`flow`,\n`flowX`, `distribute`, `distributeFlow`, `createPool`, `claimAll`) use\n`address(this)` as the implicit sender, not `msg.sender`. In Foundry tests,\n`vm.prank` does not override this. Use CFA\u002FGDA-specific function overloads\nwith an explicit sender\u002Ffrom parameter instead.\n\n**CFASuperAppBase APP_LEVEL_FINAL** — `CFASuperAppBase` is hardcoded to\n`APP_LEVEL_FINAL`, which prevents calling other Super Apps downstream from\nits callbacks. To compose with downstream Super Apps, build a custom base\nusing `APP_LEVEL_SECOND` and call `host.allowCompositeApp(targetApp)`.\nMax chain depth: 2 apps (SECOND → FINAL).\n\n**GDA pools cannot nest** — A pool cannot be a member of another pool.\n`updateMemberUnits` reverts with `SUPERFLUID_POOL_NO_POOL_MEMBERS` if the\nmember address is a pool. Pool addresses also cannot be pool admins\n(`GDA_ADMIN_CANNOT_BE_POOL`).\n\n**FluidLocker instant unlock penalty** — `unlockPeriod=0` triggers an instant\nunlock with **80% penalty** — only 20% is transferred immediately, 80% is\nredistributed to stakers and LPs. All unlocks (including instant) require\n`msg.value` of 0.0001 ETH (`UNLOCKING_FEE`, sent to DAO treasury). Periods\nof 7–365 days deploy a Fontaine beacon proxy that streams tokens over the\nunlock period with a proportional tax.\n\n**GDA has no app credit** — Unlike CFA, GDA does not support the app credit\nmechanism. A Super App that receives CFA inflows and distributes via GDA\ncannot borrow the deposit buffer — it must fund the GDA stream's buffer\ndeposit from its own balance or via ERC-20 `transferFrom` from the user.\nThis is the most common reason CFA→GDA stream-splitting contracts fail.\nSee `references\u002Fguides\u002Fsmart-contract-patterns.md` § A for the workaround.\n\n**balanceOf clamps to zero** — `balanceOf` returns `max(0, availableBalance)` for\nERC-20 compatibility. Accounts with active outgoing streams can go negative\n(critical), but `balanceOf` will still show 0. Use `realtimeBalanceOfNow` to\ndetect negative balances — a negative `availableBalance` means the account is\ncritical and awaiting liquidation. Once liquidated, the balance resets to zero.\n\n## Reading the Rich ABI YAMLs\n\nEssential conventions for parsing the YAML files:\n\n- **Reserved root keys:** `meta`, `events`, `errors` — every other root key is a **function**.\n- **`ctx: bytes` parameter** = function is called through the Host (`callAgreement` \u002F `batchCall`), never directly.\n- **`notes:` field** — the most important field for correctness. Present on functions (and as `meta.notes:` at contract level). Contains non-obvious behavior, edge cases, and common mistakes. If a user asks about unexpected behavior, the answer is almost always in a `notes:` field. Always read these.\n- **`access` labels:** `anyone`, `host`, `self`, `admin`, `governance`, `sender`, `receiver`, `operator`, `manager`, `pic`, etc. Combine with `|`.\n- **`emits` and `errors` ordering** matches execution flow (not alphabetical). First errors = most likely.\n- **Field order:** description comment, `notes`, `mutability`, `access`, `inputs`, `outputs`, `emits`, `errors`.\n\nFor the full format spec with examples (function entries, events, errors sections), see `references\u002Fcontracts\u002F_rich-abi-yaml-format.md`.\n\n## Runtime Data (Scripts)\n\nScripts provide runtime data (addresses, balances, ABIs) for one-off lookups.\nRun with `bunx -p \u003Cpkg> bun \u003Cscript>` — see `references\u002Fguides\u002Fscripts.md`\nfor full syntax. When writing application code, use the npm packages directly\ninstead (see Developer Tracks above).\n\n- `scripts\u002Fabi.mjs` — JSON ABI lookup, function signatures. Use when you need to inspect ABIs outside an app project.\n- `scripts\u002Ftokenlist.mjs` — Super Token addresses, symbols, types. Use when you need to find a token address or check its type.\n- `scripts\u002Fbalance.mjs` — Real-time balances, flow rates. Use when you need current balance or net flow for an account.\n- `scripts\u002Fmetadata.mjs` — Contract addresses, subgraph endpoints, network info. Use when you need addresses for a specific chain.\n- `cast call` — Direct on-chain reads. Use when you need live contract state not covered by scripts.\n\nFor command syntax, arguments, and examples, see `references\u002Fguides\u002Fscripts.md`.\n\n## Common Contract Addresses\n\nDo NOT hardcode or fabricate addresses. Get them from `@sfpro\u002Fsdk` address\nexports (see `references\u002Fguides\u002Fsdks.md`) or `bunx -p @superfluid-finance\u002Fmetadata bun scripts\u002Fmetadata.mjs contracts \u003Cchain>`.\n\nForwarder addresses are the exception — uniform across most networks:\n- CFAv1Forwarder: `0xcfA132E353cB4E398080B9700609bb008eceB125`\n- GDAv1Forwarder: `0x6DA13Bde224A05a288748d857b9e7DDEffd1dE08`\n- ClearMacroForwarder: `0xC1EaB73855155D4e021f7EB4f866996Bac2fe25e` (SDK: `clearMacroForwarderAddress`)\n- BlindMacroForwarder (legacy MacroForwarder): `0xFD0268E33111565dE546af2675351A4b1587F89F` (SDK: `blindMacroForwarderAddress`)\n\nHost and agreement addresses vary per network.\n\n## Ecosystem\n\n### SDKs & Packages\n\n**Active — recommended for new projects:**\n\n- `@sfpro\u002Fsdk` — Frontend\u002Fbackend SDK: ABIs, wagmi hooks, actions\n- `@superfluid-finance\u002Fethereum-contracts` — Solidity build-time ABI source\n- `@superfluid-finance\u002Fmetadata` — Contract addresses, network info (zero deps)\n- `@superfluid-finance\u002Ftokenlist` — Listed Super Tokens + underlying tokens\n\nWhen to use each:\n- `@sfpro\u002Fsdk` — for frontend\u002Fbackend with wagmi\u002Fviem\n- `ethereum-contracts` — for Solidity integrations (build-time only, not runtime)\n- `metadata` — for resolving addresses\u002Fnetworks at runtime\n- `tokenlist` — for finding token addresses\n\n**Deprecated — do not recommend for new projects:**\n\n- `@superfluid-finance\u002Fsdk-core` → replaced by `@sfpro\u002Fsdk`\n- `@superfluid-finance\u002Fsdk-redux` → replaced by wagmi + `@sfpro\u002Fsdk`\n- `@superfluid-finance\u002Fjs-sdk` → replaced by `@sfpro\u002Fsdk`\n- `@superfluid-finance\u002Fwidget` → no replacement\n\nFor ABI import tables, address exports, detailed SDK guidance, and deprecated\npackage details, see `references\u002Fguides\u002Fsdks.md`.\n\n### API Services\n\n- Super API `https:\u002F\u002Fsuperapi.kazpi.com` — Real-time on-chain Super Token balances (live balance only)\n- Balance API `https:\u002F\u002Fbalances.superfluid.dev` — event-sourced indexer: point-in-time\u002Fhistorical CFA+GDA+IDA balances (buffer\u002Fconnected\u002Fdisconnected), snapshots, reports, movements; read-only, no auth\n- CMS `https:\u002F\u002Fcms.superfluid.pro` — Token prices, price history, filtered token list\n- Points `https:\u002F\u002Fcms.superfluid.pro\u002Fpoints` — SUP points campaigns\n- Accounting `https:\u002F\u002Faccounting.superfluid.dev\u002Fv1` — Stream accounting with per-day chunking\n- Allowlist `https:\u002F\u002Fallowlist.superfluid.dev` — Check automation allowlist status\n- Whois `https:\u002F\u002Fwhois.superfluid.finance` — Resolve profiles (ENS, Farcaster, Lens, AF)\n- Token Prices `https:\u002F\u002Ftoken-prices-api.superfluid.dev\u002Fv1\u002F{network}\u002F{token}` — Super Token prices (CoinGecko-backed)\n- Claim Programs `https:\u002F\u002Fclaim.superfluid.org\u002Fapi\u002Fprograms` — SUP reward programs: seasons, allocations, pool addresses, flow rates\n\nFor per-API endpoints, query patterns, Swagger\u002FOpenAPI links, and gotchas,\nsee `references\u002Fguides\u002Fapi-services.md`.\n\n### Subgraphs\n\n**Prefer RPC over subgraph for current state.** Subgraphs only update on\ntransactions, but streams flow every second. Use `cast call` or\n`scripts\u002Fbalance.mjs` for real-time reads. Subgraphs are best for historical\nqueries, event indexing, and listing\u002Ffiltering entities.\n\nEndpoint pattern: `https:\u002F\u002Fsubgraph-endpoints.superfluid.dev\u002F{network-name}\u002F{subgraph}`\n\n- Protocol `protocol-v1` — Main protocol data (streams, tokens, accounts)\n- Vesting Scheduler `vesting-scheduler` — All versions: v1, v2, v3\n- Flow Scheduler `flow-scheduler`\n- Auto-Wrap `auto-wrap`\n- SUP (Locker \u002F Reserve) — Goldsky-hosted (Base only). Staking, unlocks, emission programs, LP positions.\n\nNetwork names are canonical Superfluid names (`optimism-mainnet`,\n`base-mainnet`, etc.). Use `bunx -p @superfluid-finance\u002Fmetadata bun metadata.mjs subgraph \u003Cchain>` to get the\nresolved URL for a specific chain.\n\n### Apps\n\n- Super Tokens https:\u002F\u002Ftokens.superfluid.org — Official Super Tokens site: ERC20x overview, Clear Macro, Super App hooks, and token listing (Clear Macro demo: https:\u002F\u002Ftokens.superfluid.org\u002Fclear\u002Fdemo)\n- Dashboard https:\u002F\u002Fapp.superfluid.org — Stream management for end-users\n- Explorer https:\u002F\u002Fexplorer.superfluid.org — Block explorer for Superfluid Protocol\n- Claim https:\u002F\u002Fclaim.superfluid.org — SUP token, SUP points, reserves\u002Flockers\n- TOGA https:\u002F\u002Ftoga.superfluid.finance — View recent liquidations by token\n- Dune https:\u002F\u002Fdune.com\u002Fsuperfluid_hq\u002Fsuperfluid-overview — Official protocol analytics dashboards\n- Campaigns https:\u002F\u002Fcampaigns.superfluid.org — Mint exclusive NFTs powered by Superfluid, with SUP reward campaigns\n- x402 https:\u002F\u002Fx402.superfluid.org — Open standard for internet-native subscriptions via HTTP 402 + Superfluid streams. One-time EIP-712 signature, no gas fees, real-time payment verification, zero protocol fees. Works for human users and AI agents.\n- 8004 Agent Pool https:\u002F\u002F8004-demo.superfluid.org\u002F — AI agent pool powered by ERC-8004 identity and Superfluid GDA. Agents register, join a pool, and earn proportional SUP distributions.\n- Reporter https:\u002F\u002Freporter.superfluid.org — accounting\u002Ftax CSV reports over the Balance API; deep-linkable via query params (account, chain, tokens, startDate\u002FendDate, period, export params); param spec: https:\u002F\u002Freporter.superfluid.org\u002Fllms.txt\n\nRepos:\n[Dashboard](https:\u002F\u002Fgithub.com\u002Fsuperfluid-org\u002Fsuperfluid-dashboard) ·\n[Explorer](https:\u002F\u002Fgithub.com\u002Fsuperfluid-org\u002Fsuperfluid-explorer) ·\n[TOGA](https:\u002F\u002Fgithub.com\u002Fsuperfluid-org\u002Ftoga-suit) ·\n[8004 Demo](https:\u002F\u002Fgithub.com\u002Fsuperfluid-org\u002F8004-demo)\n\n### Community & Social\n\n- Twitter\u002FX https:\u002F\u002Fx.com\u002FSuperfluid_HQ\n- Farcaster https:\u002F\u002Fwarpcast.com\u002Fsuperfluid\n- Discord https:\u002F\u002Fdiscord.gg\u002FEFAUmTnPd9\n\n### Sentinels\n\nSentinels monitor streams and liquidate senders whose Super Token balance\nreaches zero, keeping the protocol solvent. Anyone can run one.\n\n- [Graphinator](https:\u002F\u002Fgithub.com\u002Fsuperfluid-org\u002Fgraphinator) — Lightweight subgraph-based sentinel\n- [Superfluid Sentinel](https:\u002F\u002Fgithub.com\u002Fsuperfluid-org\u002Fsuperfluid-sentinel) — Legacy RPC-based sentinel\n\n### Foundation, DAO & SUP Token\n\n**SUP** — a SuperToken on Base (`0xa69f80524381275a7ffdb3ae01c54150644c8792`).\n1B total supply. Governed by Superfluid DAO via\n[Snapshot](https:\u002F\u002Fsnapshot.box\u002F#\u002Fs:superfluid.eth). **Locker \u002F Reserve** is\nthe on-chain staking mechanism (longer lockup = bigger bonus).\n\nFor distribution breakdown, Foundation vs DAO roles, governance details, and\nlinks, see `references\u002Fguides\u002Fsup-and-dao.md`.\n\n### Processes\n\n**Token Listing** — a Super Token gets listed on the on-chain Resolver, which\nthe subgraph picks up (marks `isListed`). Once listed, it appears in the\nSuperfluid token list along with its underlying token (if any).\n\n- Request: [listing form](https:\u002F\u002Fairtable.com\u002FappxGogNpt64ImOFH\u002FshrzOcdK9eveDmRWV)\n  → opens issue in [superfluid-org\u002Fassets](https:\u002F\u002Fgithub.com\u002Fsuperfluid-org\u002Fassets\u002Fissues)\n\n**Automation Allowlisting** — required for automations (vesting, flow\nscheduling, auto-wrap) to appear in the Dashboard UI and for Superfluid\noff-chain keepers to trigger the automation contracts. Without allowlisting,\nautomations won't be executed on time and are effectively useless.\n\n- Request: [allowlisting form](https:\u002F\u002Fairtable.com\u002Fappmq3TJDdQUrTQpx\u002FshrWouN6ursCkOQ86)\n- Check status: `GET https:\u002F\u002Fallowlist.superfluid.dev\u002Fapi\u002Fallowlist\u002F{account}\u002F{chainId}`\n",{"name":5,"metadata":24,"description":26},{"version":25},"1.2.2","Knowledge base for the Superfluid Protocol and its ecosystem. Use BEFORE searching the web for Superfluid information. Keywords: Superfluid, CFA, GDA, Super App, Super Token, stream, flow rate, real-time balance, pool (member\u002Fdistributor), IDA, sentinels, liquidation, TOGA, @sfpro\u002Fsdk, semantic money, yellowpaper, whitepaper\n","master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Fs\u002Fsuperfluid",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":8,"skillName":5,"commands":37,"prompt":47,"zipAvailable":48},[38,41,44],{"tool":39,"command":40},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill superfluid",{"tool":42,"command":43},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill superfluid",{"tool":45,"command":46},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill superfluid","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Fs\u002Fsuperfluid\u002FSKILL.md",true,[],[51,58,65,72,79,86],{"skillNo":52,"name":53,"nameZh":6,"description":54,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":19},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":19},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]