👨‍🌾User Guide

A simple overview that helps new users navigate Ursa.

Wallet

Before a user can begin using Ursa, they need to connect to the protocol with their crypto wallet. Ursa Finance has integrated WalletConnect and users can access the dApp with any supported wallets.

Once you have your wallet set up, head over to https://app.ursa.finance/ and click ENTER APP at the top right of the page.

Protocol Guide

Basic requirements

All a user needs to interact with the Ursa protocol is a supported wallet, supported asset(s), and funds to pay for transaction fees.

How to access the dApp

Navigate to https://app.ursa.finance/. The dApp is comprised of the market dashboard which shows the available markets to participate in.

How to Supply Tokens

To supply assets to a market, first click on the desired asset. After doing so, a prompt will be shown to confirm the contract's ability to deposit assets into the market. Once approved, the supply panel will be visible, allowing the user to enter the amount of underlying assets they wish to deposit and click the "Supply" button at the bottom of the panel.

How to Collateralize Tokens

Once a user has deposited into a market, the supplied assets can be enabled as collateral by toggling the radio button on the left side of the action modal for a particular market. A prompt will be shown upon clicking the slider confirming the decision to enable the supplied assets as collateral. Following confirmation, the supplied assets are able to be used as collateral to borrow against.

How to Borrow Tokens

To borrow assets, first select the desired asset to be borrowed and the borrowing panel will be shown. Key in the desired amount of assets to borrow and click the "Borrow" button at the bottom of the panel.

How to Repay Borrowed Tokens

To repay some or all of an outstanding borrow balance, select the asset to be repaid in the borrowing pane. Select "Repay" in the action modal and key in the desired amount of assets to be repaid. Finally, click the "Repay" at the bottom of the panel. After the transaction is processed, the displayed borrow balance will be updated to reflect the repayment.

How to keep a Healthy account

To keep an account healthy, users should monitor the health factor of their account. If a user's health factor falls below 1.0, they can be liquidated. Ursa advises users to keep a healthy buffer above 1.0 on their accounts to plan for any unforeseen circumstances.

A user can check their health factor by taking the summation of the ETH denominated values of their collateral multiplied by their respective collateral factor and dividing by the ETH denominated value of the account's outstanding borrow balance (including accrued interest).

ex: (Asset One value denominated in ETH multiplied by Collateral Factor) + ( Asset Two value denominated in ETH multiplied by Collateral Factor). Divide by the ETH denominated value of your outstanding debt plus accrued interest.

Additionally, the market dashboard is equipped with a borrow limit graphic to visualize a user's account health in real time. At 50% of your borrow limit your accounts health is 2, at 66.66% of your borrow limit your health is 1.5, at 80% of your borrow limit your health is 1.25 and at 100% of your borrow limit your health is 1.

It is suggested that positions with volatility risk keep their accounts health above 1.5 to be prepared for sudden and unexpected changes in market conditions.