💎Liquidity Guide

This comprehensive guide walks you through the complete lifecycle of providing liquidity on Oasis - from initial setup to final withdrawal. Follow these steps to start earning rewards, understand your position, and manage your tokens effectively.

Prerequisites

Before you begin, ensure you have:

• Hathor Mobile Wallet. Learn how to set up a wallet

• hUSDC tokens in your wallet. Learn how to use the Bridge

• Enough HTR for transaction fees

Providing Liquidity

Step 1: Access Oasis

1. Visit Dozer

2. Click the "Connect" button in the top right corner

3. Read the QR Code or paste the string in the Reown option of the Hathor Wallet

4. Accept the connection with Dozer Finance

Step 2: Choose Your Deposit

Select Token

• Click the token selector dropdown (default is hUSDC)

Enter Amount

1. In the "Amount to lock up" field, enter your desired deposit amount

2. The interface will show:

   • Amount to be deposited

   • HTR to be matched

   • HTR bonus you'll receive

Choose Lock Period

1. Click the "Lock up time" dropdown

2. Select your preferred duration:

   • 6 months (10% bonus)

   • 9 months (15% bonus)

   • 12 months (20% bonus)

💡 Tip: Longer lock periods offer higher bonus rewards. Consider your investment timeline when choosing.

Step 3: Review Position Details

Before confirming, verify:

1. Token and amount

2. Lock period and bonus percentage

3. HTR matching amount

4. Unlock date

If providing non-stable tokens, you can also:

1. Use the price change slider to simulate different scenarios

2. Click "Simulate Gains" to view potential returns

3. Compare "Hold Bonus" vs "Sell Immediately" strategies

Step 4: Add Liquidity

1. Click the "Add Liquidity" button

2. Review the transaction in your wallet

3. Confirm the transaction

4. Wait for confirmation

⚠️ Note: Ensure you understand the lock period. Your deposited tokens will be locked until the unlock date shown.

Understanding Your Position

After providing liquidity, you can view and understand your position details:

Accessing Your Positions

1. Visit oasis.dozer.finance

2. Connect your wallet

3. Click the "My Position" tab

Core Position Information

Your position display includes several key metrics:

• Locked Amount: The original amount of tokens you deposited

• Unlock Date: The exact date and time when your position becomes available for withdrawal

• Max withdraw USDC: Maximum amount of deposited token you can withdraw

• Max withdraw HTR: Maximum HTR amount, including matching and protection

• HTR Bonus available: HTR bonus tokens available for immediate withdrawal

Position Status

Your position will display its status:

• Locked: Position is still within the lock period

• Available for withdrawal: Position has reached maturity and can be withdrawn

Simulation Tool

To understand potential returns:

1. Click "Simulate Gains"

2. Adjust the token price slider

3. View the chart showing:

   • Yellow line: Returns if holding bonus

   • Green line: Returns if selling bonus immediately

Managing Your Position

Increasing Your Position

You can increase an existing position by adding more tokens:

1. Navigate to the "Deposit Now" tab

2. Enter the additional deposit amount on the "Amount to lock up" input field

3. Choose a lock period for the new deposit

4. Review the new unlock date calculation

5. Confirm transaction

Understanding Unlock Date Calculation

When you add to a position, the new unlock date is calculated using a weighted average:

• The original amount and unlock date

• The new amount and selected lock period

• Weights based on deposit amounts

For example:

• Current position: 1000 hUSDC unlocking in 3 months

• New deposit: 500 hUSDC with a 6-month lock

• The new unlock date will be weighted:

  • (1000 × 3 months + 500 × 6 months) ÷ (1000 + 500)

  • Resulting in approximately 4 months to unlock

Benefits of Increasing Position

• Keep positions consolidated

• Single withdrawal at maturity

• Combined IL protection

• Unified bonus management

💡 Tip: Consider aligning lock periods with your existing position to maintain your preferred timeline.

Managing HTR Bonus

Your HTR bonus is separate from your locked position and offers flexible management options.

Immediate Withdrawal Strategy

If you choose to withdraw your bonus immediately:

1. Navigate to "My Position"

2. Locate your active position

3. Click "Remove Liquidity" or "Withdraw Bonus"

4. Choose the amount of HTR bonus to withdraw

5. Confirm the transaction in your wallet

Hold Strategy

If you choose to hold your bonus:

• The bonus remains in your position

• Can be withdrawn later with your main position

• May benefit from HTR price appreciation

• There is no impact on your position's IL protection

Position Lifecycle

During Lock Period

While your position is locked:

• The main deposit remains locked until the unlock date

• HTR bonus can be withdrawn at any time

• Position accumulates trading fees

• IL protection remains active

At Maturity

When your position reaches its unlock date:

• Status changes to "Available for withdrawal"

• The whole position (deposit + remaining bonus) can be withdrawn

• IL protection is automatically calculated

• Trading fees are included in the withdrawal

Withdrawing Your Position

Full Position Withdrawal

Once unlocked:

1. Navigate to "My Position"

2. Click "Close Position" then "Remove Liquidity"

3. Review withdrawal amounts

4. Confirm the transaction

Withdrawal Calculations

Your withdrawal amount includes:

• Original deposit (adjusted for IL protection if needed)

• HTR amount from the IL protection (if needed)

• Accumulated trading fees

• Any remaining HTR bonus

💡 Tip: The "Max withdraw" amounts shown include all IL protection calculations.

Monitoring Tools

Position Performance

Track your position's status:

• The current value of locked tokens

• Available HTR bonus

• Time remaining until unlock

• Accumulated trading fees

Market Impact

• Use the price change slider to simulate market movements

• View potential returns under different scenarios

• Understand IL protection impact

Common Scenarios

HTR Price Increases

• The original deposit remains protected

• HTR bonus value may increase

• No impermanent loss impact

HTR Price Decreases

• Original deposit protected up to 4x price divergence

• Protection paid in HTR

Token Price Changes

• IL protection considers both token prices

• The protection ensures value preservation within limits

• Withdrawal amounts are updated in real-time

Next Steps

• Understand protection calculations in Protection Mechanics

• Review technical implementation in Technical Details