- Total Prize Pool: $60,500 USDC
- HM awards: $41,250 USDC
- Analysis awards: $2,500 USDC
- QA awards: $1,250 USDC
- Bot Race awards: $3,750 USDC
- Gas awards: $1,250 USDC
- Judge awards: $6,000 USDC
- Lookout awards: $4,000 USDC
- Scout awards: $500 USDC
- Join C4 Discord to register
- Submit findings using the C4 form
- Read our guidelines for more details
- Starts June 23, 2023 20:00 UTC
- Ends July 3, 2023 20:00 UTC
Automated findings output for the audit can be found here.
Note for C4 wardens: Anything included in the automated findings output is considered a publicly known issue and is ineligible for awards.
Lybra Finance is a groundbreaking DeFi protocol focused on bringing stability to the volatile cryptocurrency market through its innovative stablecoin, eUSD. Built on LSD/LST's, the protocol initially utilizes Lido Finance-issued stETH as its primary components and plans to support additional LST's in the upcoming V2.
eUSD is an omnichain LSD/LST-based stablecoin solution. Lybra has been capitalizing on the fresh avenues ushered in by LSD/LST's to offer the world's first interest-bearing stablecoin. In doing so, it is creating exactly the kind of profit-generating utility that LSD/LST's need to start fulfilling their vast potential.
With the rollout of V2, Lybra will be introducing peUSD into its ecosystem. Consider peUSD as the DeFi-optimized version of eUSD. It's designed to be bridged to any supported L2's, without any constraints on liquidity.
| File | SLOC | Description | Libraries |
|---|---|---|---|
| Contracts (19) | |||
| contracts/lybra/Proxy/LybraProxyAdmin.sol | 3 | This contract is the admin of the lybra proxy contracts. | @openzeppelin/* |
| contracts/lybra/Proxy/LybraProxy.sol | 5 | This contract inherits TransparentUpgradeableProxy, used to upgrade LybraConfigurator. | @openzeppelin/* |
| contracts/lybra/governance/AdminTimelock.sol | 5 | Timelock for Lybra Admin | @openzeppelin/* |
| contracts/lybra/governance/GovernanceTimelock.sol ๐งฎ | 22 | Timelock for Lybra DAO | @openzeppelin/* |
| contracts/lybra/pools/LybraWbETHVault.sol ๐ฐ | 26 | This contract inherits from the LybraPeUSDVaultBase contract and supports collateralizing WbETH to borrow PeUSD. When users deposit ETH, the contract will deposit the ETH into the WbETH contract and convert it to WbETH. | @openzeppelin/* |
| contracts/lybra/token/esLBR.sol โป๏ธ | 29 | The eUSD contract is an interest-bearing ERC20-like token designed for the Lybra protocol. It represents the holder's share in the total amount of Ether controlled by the protocol. The contract stores the sum of all shares to calculate each account's token balance, which is based on the account's shares and the total supply of eUSD. | @openzeppelin/* |
| contracts/lybra/pools/LybraWstETHVault.sol ๐ฐ | 33 | This contract inherits from the LybraPeUSDVaultBase contract and supports collateralizing WstETH to borrow PeUSD. When users deposit ETH, the contract will deposit the ETH into the Lido contract and convert it to WstETH. | @openzeppelin/* |
| contracts/lybra/pools/LybraRETHVault.sol ๐ฐ ๐งฎ | 35 | This contract inherits from the LybraPeUSDVaultBase contract and supports collateralizing Rocket Pool ETH(rETH) to borrow PeUSD. When users deposit ETH, the contract will deposit the ETH into the RocketDepositPool contract and convert it to rETH. | @openzeppelin/* |
| contracts/lybra/token/PeUSD.sol | 37 | PeUSD is a stable, interest-free ERC20-like token minted through eUSD in the Lybra protocol. It is pegged to 1eUSD and does not undergo rebasing. The token operates by allowing users to deposit eUSD and mint an equivalent amount of PeUSD. When users redeem PeUSD, they can retrieve the corresponding proportion of eUSD. As a result, users can utilize PeUSD without sacrificing the yield on their eUSD holdings.In addition to minting PeUSD by using eUSD as collateral, PeUSD can also be minted by depositing assets (such as WstETH) into non-rebase asset vaults.PeUSD leverages the LayerZero's OFT protocol to enable native cross-chain functionality, allowing seamless transfers and interactions across different blockchain networks. By integrating with OFT, PeUSD is not constrained by liquidity pools and can freely move between chains. This interoperability enhances the versatility and utility of PeUSD, empowering users with the ability to utilize PeUSD's stable value and features across multiple blockchain ecosystems. | @openzeppelin/* |
| contracts/lybra/miner/esLBRBoost.sol | 48 | This contract is used to allow users to set the lock-up period for their esLBR tokens to accelerate mining. | @openzeppelin/* |
| contracts/lybra/token/LBR.sol | 52 | LBR is an ERC20-compliant token leverages the LayerZero's OFT protocol to enable native cross-chain functionality, allowing seamless transfers and interactions across different blockchain networks.Apart from the initial production, LBR can only be produced by destroying esLBR in the fund contract.LBR can only be exchanged to esLBR in the lybraFund contract. | @openzeppelin/* |
| contracts/lybra/pools/LybraStETHVault.sol ๐ฐ ๐ค ๐งฎ โป๏ธ | 63 | This contract inherits from the LybraEUSDVaultBase contract and supports collateralizing stETH to borrow eUSD. When users deposit ETH, the contract will deposit the ETH into the Lido contract and convert it to stETH.In addition, this contract implements the logic to convert the rebase earnings of stETH held in the vault into eUSD yield. The conversion process follows the Dutch auction mechanism, where the price remains unchanged for 1 hour during the rebase period and then decreases by 1% every 30 minutes to encourage users to initiate the conversion themselves. | |
| contracts/lybra/miner/stakerewardV2pool.sol ๐ค | 105 | This contract is a derivative version of Synthetix StakingRewards.sol, distributing rewards to LPs stakers. | @openzeppelin/* |
| contracts/lybra/governance/LybraGovernance.sol ๐งฎ | 111 | Lybra onchain governance module | @openzeppelin/* |
| contracts/lybra/token/PeUSDMainnetStableVision.sol ๐ฐ | 118 | This contract keeps track of the totalShares of eUSD deposited by users and the totalMinted PeUSD.When users redeem PeUSD, they can retrieve the corresponding proportion of eUSD.As a result, users can utilize PeUSD without sacrificing the yield on their eUSD holdings. | @openzeppelin/* |
| contracts/lybra/miner/ProtocolRewardsPool.sol ๐ค | 155 | This contract is a derivative version of Synthetix StakingRewards.sol, distributing Protocol revenue to esLBR stakers.Converting esLBR to LBR. | @openzeppelin/* |
| contracts/lybra/token/EUSD.sol ฮฃ | 174 | The eUSD contract is an interest-bearing ERC20-like token designed for the Lybra protocol. It represents the holder's share in the total amount of Ether controlled by the protocol. The contract stores the sum of all shares to calculate each account's token balance, which is based on the account's shares and the total supply of eUSD. | @openzeppelin/* |
| contracts/lybra/configuration/LybraConfigurator.sol ๐ค ๐งฎ | 183 | This contract is used for setting various parameters and control functionalities of the Lybra Protocol. | |
| contracts/lybra/miner/EUSDMiningIncentives.sol โป๏ธ | 193 | This contract is a stripped down version of Synthetix StakingRewards.sol, to reward esLBR to EUSD minters. | @openzeppelin/* @chainlink/* |
| Abstracts (2) | |||
| contracts/lybra/pools/base/LybraEUSDVaultBase.sol ๐ฐ ๐ค โป๏ธ | 180 | This contract is the base implementation for rebasing Lst vaults. This contract is abstract. All rebasing asset pool contracts inherit from LybraEUSDVaultBase. | @openzeppelin/* |
| contracts/lybra/pools/base/LybraPeUSDVaultBase.sol ๐ฐ ๐ค โป๏ธ | 185 | This contract is the base implementation for Non-rebasing Lst vaults. This contract is abstract. All Non-rebasing assets pool contracts inherit from LybraPeUSDVaultBase. | @openzeppelin/* |
| Total (over 21 files): | 1762 |
- @chainlink/contracts/src/v0.8/interfaces/AggregatorV3Interface.sol
- @openzeppelin/contracts/access/Ownable.sol
- @openzeppelin/contracts/governance/extensions/GovernorTimelockControl.sol
- @openzeppelin/contracts/governance/TimelockController.sol
- @openzeppelin/contracts/proxy/transparent/ProxyAdmin.sol
- @openzeppelin/contracts/proxy/transparent/TransparentUpgradeableProxy.sol
- @openzeppelin/contracts/token/ERC20/ERC20.sol
- @openzeppelin/contracts/token/ERC20/extensions/ERC20Votes.sol
- @openzeppelin/contracts/token/ERC20/IERC20.sol
- @openzeppelin/contracts/utils/Context.sol
- @openzeppelin/contracts/utils/introspection/ERC165.sol
- @openzeppelin/contracts/utils/introspection/IERC165.sol
- @openzeppelin/contracts/utils/math/SafeMath.sol
- If you have a public code repo, please share it here: https://github.com/LybraFinance/LybraV2
- How many contracts are in scope?: 27
- Total SLoC for these contracts?: 1866
- How many external imports are there?: 3
- How many separate interfaces and struct definitions are there for the contracts within scope?: 0 separate interfaces and 5 struct definitions
- Does most of your code generally use composition or inheritance?: Inheritance
- How many external calls?: 3
- What is the overall line coverage percentage provided by your tests?: 0
- Is there a need to understand a separate part of the codebase / get context in order to audit this part of the protocol?: false
- Please describe required context: n/a
- Does it use an oracle?: Yes, Chainlink
- Does the token conform to the ERC20 standard?: True
- Are there any novel or unique curve logic or mathematical models?: The Lybra Protocol introduces a novel design for eUSD interest rebases. When the balance of stETH increases through LSD or other reasons, the excess income is sold for eUSD. This additional stETH is exchanged for eUSD based on the current price, and the eUSD shares of the previous holder are destroyed. As a result, the balances of other eUSD holders increase due to the decrease in total shares. This design ensures that the interest rebases are conducted in a fair and efficient manner, allowing for the distribution of additional income to all eUSD holders.
- Does it use a timelock function?: True
- Is it an NFT?: no
- Does it have an AMM?: no
- Is it a fork of a popular project?: False
- Does it use rollups?: no
- Is it multi-chain?: True
- Does it use a side-chain?: False
No tests are available.
No gas reports are available.
rm -Rf 2023-06-lybra || true && git clone https://github.com/code-423n4/2023-06-lybra.git -j8 && cd 2023-06-lybra && npm install && npm run build
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent