Lucidly syUSD vault adapter (ILucidlyVault interface + wrapper)

[abhicris]

Add a LucidlyAdapter.sol so stablecoins in the toolkit can auto-park idle reserve into Lucidly's syUSD vault to earn yield. Unblocks CR8-USD Phase 2 (relaunch-plan.md) — we're not rebuilding yield infra.

Scope

• interfaces/ILucidlyVault.sol — Solidity interface matching Lucidly's BoringVault deposit/withdraw/share-price API.
• extensions/LucidlyAdapter.sol — wrapper that:
  • Takes configurable target reserve ratio (e.g. 20% of stablecoin reserve stays as liquid USDC, 80% into syUSD).
  • rebalance() — pulls excess USDC into vault; unpark(amount) — redeems from vault to satisfy redeems that exceed the liquid buffer.
  • Emits Parked, Unparked, YieldHarvested events.
• Mock MockLucidlyVault.sol for test-time integration — do not hit Lucidly mainnet in tests.
• Foundry tests: rebalance math, partial-fill on unpark, access control, pause path (if Lucidly vault paused).

Integration notes

• Lucidly team: Yashish Khurana / Samarpan Dutta. Close relationship — spec the interface in conversation before finalising.
• Target chains: Arbitrum first (matches CR8 deploy target).
• Yield harvest cadence: epoch-based, configurable (default 7 days).

Why

• Create Protocol relaunch deliberately outsources yield to Lucidly — see /Users/abhishekkrishna/internal/create-protocol/lucidly-partnership.md and relaunch-plan.md §Phase 2.
• gtm-review-2026-04-13.md §Resolve contradictions row "Custom yield infra or Lucidly?" resolves to Lucidly.

Labels

enhancement, help wanted.

[snakefood3232]

This adapter needs to handle configurable reserve ratios and epoch-based yield harvesting for CR8-USD Phase 2. I'd implement the ILucidlyVault interface and wrapper with rebalance/unpark logic, plus a full Foundry test suite using mocks. I can have a PR with tests up within two days—I've built several vault integrators with this exact security-first pattern.

[snakefood3232]

I can help create a LucidlyAdapter.sol to enable stablecoins in the toolkit to earn yield via Lucidly's syUSD vault as you've specified in your issue. I'd handle this by designing the adapter with a configurable reserve ratio and implementing the rebalance() and unpark() functions, ensuring thorough Foundry tests cover all scenarios. Can have a PR up in 4 days. I've built similar solutions with a focus on security and robust testing for decentralized finance projects.

[MyTH-zyxeon]

Opened PR #44 for the Lucidly syUSD reserve adapter: #44

It adds ILucidlyVault, LucidlyAdapter, MockLucidlyVault, and Foundry coverage for liquid-buffer rebalancing, partial unpark, access control, vault pause handling, and epoch yield harvest. Local validation: focused Lucidly tests -> 6 passed; full Foundry suite -> 65 passed; npx hardhat compile passes with the local Node v25 warning.