Skip to content

docs(liquidity-hub): add Liquidity Hub documentation#353

Draft
Debugger022 wants to merge 2 commits into
mainfrom
feat/VPD-1351
Draft

docs(liquidity-hub): add Liquidity Hub documentation#353
Debugger022 wants to merge 2 commits into
mainfrom
feat/VPD-1351

Conversation

@Debugger022

Copy link
Copy Markdown
Contributor

Document the Liquidity Hub — the per-asset ERC-4626 allocator vault that routes a single deposited asset across the Core, Flux, and FRV yield families and returns a yield-bearing share token (yield via a rising exchange rate).

What's New:

  • whats-new/liquidity-hub.md: user-facing overview — Sources, deposit/ withdraw routing, Operator rebalancing, safety envelope, fees, APY

Technical reference (new reference-liquidity-hub/ section):

  • README.md: architecture, three yield families, contract index, audits
  • hub.md: Hub ERC-4626 API, operation flows, dual caps, fees, APY, multi-level pause, reentrancy, invariants
  • yield-groups.md: YieldGroupCore/Flux/FRV, ISource surface, FRV 11-state lifecycle, per-resource caps
  • adapters.md: stateless delegatecall adapters (Core/Flux/FRV)
  • interfaces.md: ISource and IResourceAdapter boundaries

Wire all pages into SUMMARY.md.

Scope: v1 (Core/Flux/FRV on BNB Chain, USDT first). Contracts not yet deployed — addresses to be published once live.

Document the Liquidity Hub — the per-asset ERC-4626 allocator vault that
routes a single deposited asset across the Core, Flux, and FRV yield
families and returns a yield-bearing share token (yield via a rising
exchange rate).

What's New:
- whats-new/liquidity-hub.md: user-facing overview — Sources, deposit/
  withdraw routing, Operator rebalancing, safety envelope, fees, APY

Technical reference (new reference-liquidity-hub/ section):
- README.md: architecture, three yield families, contract index, audits
- hub.md: Hub ERC-4626 API, operation flows, dual caps, fees, APY,
  multi-level pause, reentrancy, invariants
- yield-groups.md: YieldGroupCore/Flux/FRV, ISource surface, FRV
  11-state lifecycle, per-resource caps
- adapters.md: stateless delegatecall adapters (Core/Flux/FRV)
- interfaces.md: ISource and IResourceAdapter boundaries

Wire all pages into SUMMARY.md.

Scope: v1 (Core/Flux/FRV on BNB Chain, USDT first). Contracts not yet
deployed — addresses to be published once live.
@github-actions

github-actions Bot commented Jun 4, 2026

Copy link
Copy Markdown

@Debugger022 Debugger022 self-assigned this Jun 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants