Skip to content

docs(liquidity-hub): add HubLens, Centrifuge, NAV pause and audits - #415

Draft
Debugger022 wants to merge 3 commits into
mainfrom
docs/hub-lens-deposit-capacity
Draft

Debugger022 wants to merge 3 commits into
mainfrom
docs/hub-lens-deposit-capacity

Conversation

@Debugger022

@Debugger022 Debugger022 commented Sep 7, 2026 •

Copy link
Copy Markdown
Contributor

What changes

HubLens deposit sizing (venus-liquidity-hub#20)

  • technical-reference/reference-liquidity-hub/hub.md
    • New Sizing a deposit section: Hub.maxDeposit / maxMint are no longer limits, read the real ceiling from HubLens, plus depositCapacityBreakdown.
    • The ERC-4626 view list split: maxDeposit / maxMint are now inherited unmodified and return type(uint256).max; only maxWithdraw / maxRedeem stay overridden.
    • Three fault-isolation sentences corrected, the deposit-side isolation now lives on HubLens rather than the Hub.
    • The Hub-paused bullet no longer claims all four max* views return 0.
    • HubCapacityExceeded documented as carrying (assets, placed).
  • technical-reference/reference-liquidity-hub/README.md: HubLens added to Contracts.
  • deployed-contracts/liquidity-hub.md: HubLens rows on mainnet and testnet.
  • whats-new/liquidity-hub.md: one clause on the atomic-or-revert bullet noting the revert reports how much would have fit.

Other changes from venus-liquidity-hub#20 and #22

  • adapters.md: FRV spotAPYBps is net of the vault's reserveFactor (600 BPS at a 10% reserve factor reports 540).
  • adapters.md, interfaces.md: resourceName added to IResourceAdapter.
  • hub.md: a paused emergencyReallocate settles resources fail-open, and the new YieldGroupAccrualFailed event.

Centrifuge yield group (VIP-661, live on the USDT Hub)

  • yield-groups.md: YieldGroupCentrifuge, the async request and claim lifecycle, and the NAV band with the values VIP-661 set.
  • adapters.md: AdapterCentrifuge.
  • README, whats-new/liquidity-hub.md: Centrifuge as a yield family.
  • deployed-contracts/liquidity-hub.md: source, JTRSY and JAAA vaults, beacon and adapter, mainnet and testnet.

Hub pause on a NAV break (venus-periphery#75)

  • hub.md, yield-groups.md: keeper check in DeviationSentinel that pauses the whole Hub through EBrake. Marked not deployed.

Audits

  • security-and-audits.md: Liquidity Hub (HashDit 2026/07/07, Cantina 2026/08/11) and Centrifuge yield group (HashDit 2026/09/04).

Open before merge

  • venus-liquidity-hub#20 merged
  • venus-liquidity-hub#22 merged
  • venus-periphery#75 merged, or its section removed
  • HubLens deployed on BNB Chain mainnet, address filled in (currently TBD)
  • HubLens deployed on BSC testnet, address filled in (currently TBD)
  • Hub beacon upgraded by VIP

The Hub no longer overrides maxDeposit or maxMint, so both return
type(uint256).max and are not limits. The real ceiling now comes from
HubLens. Nothing on chain points at that contract, so its address has to
be documented or integrators cannot find it.

Describes the post-upgrade state. HubLens addresses are TBD until the
deploy lands.
- Centrifuge yield group from VIP-661: lifecycle, NAV band, adapter, addresses
- Hub pause on NAV break via DeviationSentinel, marked not deployed
- index the LH and Centrifuge audit reports
- FRV APY is net of reserve factor; add adapter resourceName
- paused emergencyReallocate settles fail-open, YieldGroupAccrualFailed
@Debugger022 Debugger022 changed the title docs(liquidity-hub): add HubLens deposit sizing docs(liquidity-hub): add HubLens, Centrifuge, NAV pause and audits Sep 22, 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.

1 participant