Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 38 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,43 @@

A collection of Solidity helper contracts that provide safe, slippage-protected operations for ERC-4626 tokenized vaults and collateral vaults.

### Safe ERC-4626 Helpers

Project provides the helper contracts that wrap ERC-4626 vault operations with built-in slippage protection and detailed error reporting:

- **Safe4626Helper**: For standard ERC-4626 vault operations
- **Safe4626CollateralHelper**: For collateral-specific ERC-4626 vault operations
- **Safe4626Helper**: For standard ERC-4626 vault operations with try/catch error handling and slippage protection
- **Safe4626CollateralHelper**: For collateral-specific ERC-4626 vault operations with try/catch error handling and slippage protection

### Flash Loan Helpers

Flash loan helpers that enable minting and redeeming LTV vault shares using flash loans, reducing the upfront capital requirements for users:

- **FlashLoanMintHelperWstethAndWeth**: Enables minting LTV vault shares using a flash loan. The helper:
- Takes a flash loan of WETH from Morpho
- Converts WETH to stETH and wraps it to wstETH
- Uses wstETH as collateral (combining flash loan collateral with user-provided collateral)
- Mints shares in the LTV vault via `executeLowLevelRebalanceShares`
- Repays the flash loan
- Allows users to mint shares with minimal upfront capital by leveraging the flash loan

- **FlashLoanRedeemHelperWstethAndWeth**: Enables redeeming LTV vault shares using a flash loan and Curve exchange. The helper:
- Takes a flash loan of WETH from Morpho
- Redeems shares from the LTV vault via `executeLowLevelRebalanceShares`
- Unwraps wstETH collateral to stETH
- Swaps stETH for ETH via Curve exchange
- Wraps ETH to WETH
- Repays the flash loan and sends remaining WETH to the user (if whitelisted)
- Includes slippage protection for the Curve swap

## Security Audit

These contracts have undergone a security audit by Oxorio:

- **Oxorio**: [Vault Craft Security Audit Report](./audits/oxorio_vault_craft_security_audit.pdf)

## Links

- **Website**: [LTV](https://ltv.finance)
- **Protocol implementation**: [GitHub Repository](https://github.com/ltvprotocol/ltv_v0)
- **Documentation**: [Protocol Documentation](https://docs.ltv.finance)
- **Twitter**: [@ltvprotocol](https://x.com/ltvprotocol)
Binary file added audits/oxorio_vault_craft_security_audit.pdf
Binary file not shown.