Tapioca Bar🍹 & Mixologist 🤙

The gist of it

BeachBar : Serves as a vault to store assets/collaterals, strategies can later be used on those vaults to yield farm.

• deposit(uint256 assetId, address from, address to, uint256 amount, uint256 share) Used to deposit, it’s the first step to enter a market.
• withdraw(uint256 assetId, address from, address to, uint256 amount, uint256 share, bool withdrawNative) Used to withdraw asset from BeachBar , if the asset if the wrapped native, the last parameter is to decide to unwrap or not the asset.
• setApprovalForAll(address operator, bool approved) Used to allow a Mixologist market to use the user’s BeachBar assets.
• toShare(uint256 assetId, uint256 amount, roundUp) Convert from an asset amount to a BeachBar share.
• toAmount(uint256 assetId, uint256 share, roundUp) Convert from a Beachbar share to an asset amount.
• amountOf(address user, uint256 assetId) The amount in underlying token that a user has stored in.
• balanceOf(address user, uint256 assetId) The amount of shares a user has.

Mixologist : Users can deposit / withdraw from Beachbar to Mixologist to enter / exit markets.

• addCollateral(address to, bool skim, uint256 share) Users can add collateral from the Beachbar deposit to the Mixologist market.
• removeCollateral(address to, uint256 share) Users can remove collateral and exit their position, if they are solvent.
• addAsset(address to, bool skim, uint256 share) Users can lend Beachbar deposited asset with it.
• removeAsset(address to, uint256 fraction) Users can exist lending position with this.
• borrow(address to, uint256 amount) Users can borrow the lent asset of the market, they need to addCollateral first.
• repay(address to, bool skim, uint256 part) Users can repay their positions with it. Since we’ll have self-repaying loans technically it’s not gonna be used but it’s good to have it.
• mix(uint8[] calldata actions, uint256[] calldata values, bytes[] calldata datas) Used to make multiple actions in one Tx.
• balanceOf(address user) The balance in fraction unit of a user, we can use MixologistHelper to compute the real asset amount.

MixologistHelper : A helper contract for Mixologist .

• getCollateralSharesForBorrowPart(Mixologist mixologist, uint256 borrowPart) Used to compute the amount of shares needed for an amount of asset to be borrowed.
• getAmountForAssetFraction(Mixologist mixologist, uint256 fraction) Used to compute the amount of assets based on a fraction. Can be used to get asset amounts from Mixologist.balanceOf.