# MaxButton ## Description The Max Button is a user interface element that serves a specific purpose: when clicked, it selects the maximum amount. This component is particularly useful in scenarios where users need to quickly and easily choose the highest available value, such as their balance. ## Variants ### Max BTC `(BTC balance - 0.000402832 BTC)` or `0` if the amount would go negative with this formula ``` Example 1: User BTC balance is 1 BTC Max is (1 - 0.000402832) = 0.999597168 BTC Example 2: User BTC balance is 0.0004 BTC Max is (0.0004 - 0.000402832) = -0.000002832 -> 0 BTC ``` ### Max token Token balance ``` Example: User token balance is 1000 DLLR Max is 1000 DLLR ``` ### Max AMM pool deposit The lesser of `(Token balance, (BTC balance - 0.000402832) * BTC price denominated in the token according to the given AMM pool)` ``` Example: User token balance is 1000 DLLR User BTC balance is 0.01 BTC BTC price according to DLLR/BTC pool is 30000 DLLR per 1 BTC (0.01 - 0.000402832) * 30000 = 287.91504 287.91504 < 1000, max deposit is 287.91504 DLLR Example: User token balance is 1000 DLLR User BTC balance is 0.05 BTC BTC price according to DLLR/BTC pool is 30000 DLLR per 1 BTC (0.05 - 0.000402832) * 30000 = 1487.91504 1487.91504 > 1000, max deposit is 1000 DLLR ``` ### Default max borrow with BTC collateral: The lesser of `(available liquidity in the lending pool, ((((BTC balance - 0.000402832) * (1 - Origination fee rate)) * BTC price in the loan asset) * Maximum initial loan-to-value ratio) - Prepaid interest amount)` If the user hasn't changed the prepaid interest duration, Prepaid interest amount is calculated using the default prepaid interest duration specified in the Lend page frontend spec. Prepaid interest amount formula:\ `(maxBorrow / (1 - interestRateForDuration)) - maxBorrow`\ \ maxBorrow is `((((BTC balance - 0.000402832) * (1 - Origination fee rate)) * BTC price denominated in the loan asset) * Maximum initial loan-to-value ratio)`\ \ interestRateForDuration is `(Borrow APR * (60 * 60 * 24 * Prepaid interest duration) / 31536000)`\ \ Putting it all together:\ `((((BTC balance - 0.000402832) * (1 - Origination fee rate)) * BTC price denominated in the loan asset) * Maximum initial loan-to-value ratio) / (1 - (Borrow APR * (60 * 60 * 24 * Prepaid interest duration) / 31536000)) - ((((BTC balance - 0.000402832) * (1 - Origination fee rate)) * BTC price in the loan asset) * Maximum initial loan-to-value ratio)` ``` Example: User BTC balance is 1 BTC Origination fee rate is 0.09% Borrow asset is DLLR BTC price is 30,000 DLLR Minimum initial collateral ratio is 150% = 0.6666666666666667 maximum initial loan-to-value (LTV) ratio APR is 5% Prepaid interest amount, given a default prepaid interest of 28 days: ((((1 - 0.000402832) * (1 - 0.0009)) * 30000) * 0.6666666666666667) / (1 - (0.05 * (60 * 60 * 24 * 28) / 31536000)) - ((((1 - 0.000402832) * (1 - 0.0009)) * 30000) * 0.6666666666666667) = 76.90740059231757 DLLR Max is (((((1 - 0.000402832) * (1 - 0.0009)) * 30000) * 0.6666666666666667) - 76.90740059231757) = 19897.043210383683 DLLR ``` ### Default max borrow with token collateral: The lesser of `(available liquidity in the lending pool, (((Collateral token balance * (1 - Origination fee rate)) * Collateral asset price in the loan asset) * Maximum initial loan-to-value ratio) - Prepaid interest amount)` If the user hasn't changed the prepaid interest duration, Prepaid interest amount is calculated using the default prepaid interest duration specified in the Lend page frontend spec. Prepaid interest amount formula:\ `(maxBorrow / (1 - interestRateForDuration)) - maxBorrow`\ \ maxBorrow is `(((Collateral token balance * (1 - Origination fee rate)) * Collateral asset price denominated in the loan asset) * Maximum initial loan-to-value ratio)`\ \ interestRateForDuration is `(Borrow APR * (60 * 60 * 24 * Prepaid interest duration) / 31536000)`\ \ Putting it all together:\ `(((Collateral token balance * (1 - Origination fee rate)) * Collateral asset price denominated in the loan asset) * Maximum initial loan-to-value ratio) / (1 - (Borrow APR * (60 * 60 * 24 * Prepaid interest duration) / 31536000)) - (((Collateral token balance * (1 - Origination fee rate)) * Collateral asset price in the loan asset) * Maximum initial loan-to-value ratio)` ``` Example: User DLLR balance is 100000 DLLR Origination fee rate is 0.09% Collateral asset is DLLR Borrow asset is BTC DLLR price is 0.00003333333333333 BTC per DLLR Minimum initial collateral ratio is 150% = 0.6666666666666667 maximum initial loan-to-value (LTV) ratio APR is 2% Prepaid interest amount, given a default prepaid interest of 28 days: (((100000 * (1 - 0.0009)) * 0.00003333333333333) * 0.6666666666666667) / (1 - (0.02 * (60 * 60 * 24 * 28) / 31536000)) - (((100000 * (1 - 0.0009)) * 0.00003333333333333) * 0.6666666666666667) = 0.003411602580519091 BTC Max is ((((100000 * (1 - 0.0009)) * 0.00003333333333333) * 0.6666666666666667) - 0.003411602580519091) = 2.2168106196414814 BTC ``` ### Max borrow: The lesser of `(available liquidity in the lending pool, (((Collateral amount * (1 - Origination fee rate)) * Collateral asset price denominated in the loan asset) * Maximum initial loan-to-value ratio) - Prepaid interest amount)` Prepaid interest amount formula:\ `(((Collateral amount * (1 - Origination fee rate)) * Collateral asset price denominated in the loan asset) * Maximum initial loan-to-value ratio) / (1 - (Borrow APR * (60 * 60 * 24 * Prepaid interest duration) / 31536000)) - (((Collateral amount * (1 - Origination fee rate)) * Collateral asset price in the loan asset) * Maximum initial loan-to-value ratio)` ``` Example 1: Collateral amount is 0.75 BTC Origination fee rate is 0.09% Borrow asset is DLLR BTC price is 30,000 DLLR Minimum initial collateral ratio is 150% = 0.6666666666666667 maximum initial loan-to-value (LTV) ratio APR is 5% Prepaid interest amount, given a prepaid interest duration of 100 days: (((0.75 * (1 - 0.0009)) * 30000) * 0.6666666666666667) / (1 - (0.05 * (60 * 60 * 24 * 100) / 31536000)) - (((0.75 * (1 - 0.0009)) * 30000) * 0.6666666666666667) = 208.14583333333394 DLLR Max is ((((0.75 * (1 - 0.0009)) * 30000) * 0.6666666666666667) - 208.14583333333394) = 14778.354166666668 DLLR ``` ### Default max borrow increase with BTC collateral: The lesser of `(available liquidity in the lending pool, ((((Current collateral + (BTC balance - 0.000402832)) * (1 - Origination fee rate)) * Collateral asset price denominated in the loan asset) * Maximum initial loan-to-value ratio) - Prepaid interest amount - Current debt)` Prepaid interest amount formula: `((((Current collateral + (BTC balance - 0.000402832)) * (1 - Origination fee rate)) * Collateral asset price denominated in the loan asset) * Maximum initial loan-to-value ratio) / (1 - (Borrow APR * (60 * 60 * 24 * Prepaid interest duration) / 31536000)) - ((((Current collateral + (BTC balance - 0.000402832)) * (1 - Origination fee rate)) * Collateral asset price in the loan asset) * Maximum initial loan-to-value ratio)` ``` Example 1: Current collateral balance is 1 BTC Current debt is 20000 DLLR Current BTC balance is 0.1 BTC Origination fee rate is 0.09% BTC price is 30,000 DLLR Minimum initial collateral ratio is 115% = 0.8695652173913043 maximum initial loan-to-value (LTV) ratio APR is 5% Prepaid interest amount, given a prepaid interest duration of 1 hour: ((((1 + (0.1 - 0.000402832)) * (1 - 0.0009))f * 30000) * 0.8695652173913043) / (1 - (0.05 * (60 * 60) / 31536000)) - ((((1 + (0.1 - 0.000402832)) * (1 - 0.0009)) * 30000) * 0.8695652173913043) = 0.16358156658316148 DLLR Max is (((((1 + (0.1 - 0.000402832)) * (1 - 0.0009)) * 30000) * 0.8695652173913043) - 0.16358156658316148 - 20000) = 8659.163302315159 DLLR ``` ### Default max borrow increase with token collateral: The lesser of `(available liquidity in the lending pool, ((((Current collateral + Collateral token balance) * (1 - Origination fee rate)) * Collateral asset price denominated in the loan asset) * Maximum initial loan-to-value ratio) - Prepaid interest amount - Current debt)` Prepaid interest amount formula: `((((Current collateral + Collateral token balance) * (1 - Origination fee rate)) * Collateral asset price denominated in the loan asset) * Maximum initial loan-to-value ratio) / (1 - (Borrow APR * (60 * 60 * 24 * Prepaid interest duration) / 31536000)) - ((((Current collateral + Collateral token balance) * (1 - Origination fee rate)) * Collateral asset price in the loan asset) * Maximum initial loan-to-value ratio)` ``` Example 1: Current collateral balance is 100000 DLLR Current debt is 2 BTC Current DLLR balance is 10000 DLLR Origination fee rate is 0.09% DLLR price is 0.00003333333333333 BTC per DLLR Minimum initial collateral ratio is 115% = 0.8695652173913043 maximum initial loan-to-value (LTV) ratio APR is 5% Prepaid interest amount, given a prepaid interest duration of 1 hour: ((((100000 + 10000) * (1 - 0.0009)) * 0.00003333333333333) * 0.8695652173913043) / (1 - (0.05 * (60 * 60) / 31536000)) - ((((100000 + 10000) * (1 - 0.0009)) * 0.00003333333333333) * 0.8695652173913043) = 0.00001818238820927 BTC Max is ((((100000 + 10000) * (1 - 0.0009)) * 0.00003333333333333) * 0.8695652173913043) - 0.00001818238820927 - 2 = 1.18551804949553 BTC ``` ### Max BTC collateral: `(BTC balance - 0.000402832) * (1 - origination fee rate)` ``` Example: BTC balance is 1 BTC Origination fee rate is 0.09% Max is (1 - 0.000402832) * (1 - 0.0009) = 0.9986975305488 BTC ``` ### Max token collateral: `Token balance * (1 - origination fee rate)` ``` Example: Token balance is 100000 DLLR Origination fee rate is 0.09% Max is 100000 * (1 - 0.0009) = 99910.0 DLLR ``` ### Max collateral withdrawal: `Collateral balance - ((Total debt * Maintenance margin) / Collateral price denominated in loan asset)` ``` Example: Collateral balance is 1 BTC Total debt is 10000 DLLR BTC price is 30000 DLLR Maintenance margin is 115% Max is 1 - ((10000 * 1.15) / 30000) = 0.6166666666666667 BTC ``` ### Max BTC repayment: The lesser of `(total debt - interest refund, BTC balance - 0.000402832 BTC, 0 if the amount would go negative with the previous formula)` ``` Example 1: (Total debt - interest refund) is 0.5 BTC User BTC balance is 1 BTC Max is 0.5 BTC Example 2: (Total debt - interest refund) is 1 BTC User BTC balance is 1 BTC Max is (1 - 0.000402832) = 0.999597168 BTC Example 3: (Total debt - interest refund) is 1 BTC User BTC balance is 0.0004 BTC Max is (0.0004 - 0.000402832) = -0.000002832 -> 0 BTC ``` ### Max token repayment: The lesser of `(total debt - interest refund, token balance)` ``` Example 1: (Total debt - interest refund) is 800 DLLR User token balance is 1000 DLLR Max is 800 DLLR Example 2: (Total debt - interest refund) is 1500 DLLR User token balance is 1000 DLLR Max is 1000 DLLR ``` ### Max contract withdrawal: The lesser of `(balance in the contract owned by or owed to the user, contract balance available liquidity)` ``` Example 1: Balance in the contract owned by or owed to the user is 1 BTC Contract balance available liquidity is 2 BTC Max is 1 BTC Example 2: Balance in the contract owned by or owed to the user is 1 BTC Contract balance available liquidity is 0.1 BTC Max is 0.1 BTC ``` ### Max aggregator withdrawal: The lesser of `(token balance, aggregator balance + conversion fee)` ``` Example 1: User token balance is 100000 DLLR Aggregator balance is 200000 ZUSD Max is 100000 DLLR Example 2: User token balance is 100000 DLLR Aggregator balance is 20000 DOC and conversion fee is 5 DLLR Max is 20005 DLLR ``` ### Max bridge: The lesser of `(token balance, aggregator balance, destination bridge max limit, destination chain bridge balance)` ``` Example 1: User token balance is 100000 XUSD Aggregator balance is 150000 USDT Destination bridge max limit is 250000 USDT Destination chain bridge balance is 150000 Max is 100000 USDT Example 2: User token balance is 100000 XUSD Aggregator balance is 90000 USDT Destination bridge max limit is 250000 USDT Destination chain bridge balance is 150000 Max is 90000 USDT Example 3: User token balance is 300000 XUSD Aggregator balance is 500000 USDT Destination bridge max limit is 250000 USDT Destination chain bridge balance is 300000 Max is 250000 USDT Example 4: User token balance is 225000 XUSD Aggregator balance is 300000 USDT Destination bridge max limit is 250000 USDT Destination chain bridge balance is 150000 Max is 150000 USDT ``` ### Max FastBTC: The lesser of `(FastBTC max limit, BTC balance - 0.000402832 BTC, 0 if the amount would go negative with the previous formula)` ``` Example 1: FastBTC max limit is 3 BTC User BTC balance is 4 BTC Max is (4 - 0.000402832) = 3.999597168 -> 3 BTC Example 2: FastBTC max limit is 3 BTC User BTC balance is 1 BTC Max is (1 - 0.000402832) = 0.999597168 BTC FastBTC max limit is 3 BTC User BTC balance is 0.0004 BTC Max is (0.0004 - 0.000402832) = -0.000002832 -> 0 BTC ```