Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Satoshi Lending Protocol Workflow

This document outlines the high-level workflows and terminology for the Satoshi Lending protocol.

Terminology

TermDefinition
CollateralAny non-USDC asset deposited to secure a loan.
LendersUsers who supply assets to the pool to earn interest.
BorrowersUsers who provide collateral to take loans from the pool.
LTV (Loan to Value)A metric used to assess the health of a borrower’s position. Formula: total_borrow_value.div(total_collateral_value)
Insurance Allocation Rate(Also known as Reserve Factor) The percentage of the liquidation penalty diverted to the protocol’s Insurance Fund.
Liquidation PenaltyThe amount deducted and sent to the liquidation account when a liquidation occurs.

System Assumptions & Constraints

  • Asset Types:
    • Lending and borrowing are restricted to USDC.
    • Collateral deposits are restricted to non-USDC assets.
  • Contracts:
    • There is a single USDC contract for deposits.
    • There are currently three non-USDC contracts for collateral deposits.
    • The Near intents contract is used exclusively for liquidation.
  • Account Roles: A single account cannot function as both a lender and a borrower simultaneously.

Workflows

Lender Actions

Lending (Supply)

Involves the deposit of USDC into the protocol by a lender.

Unlending (Withdraw)

The withdrawal of principal USDC along with any accrued interest by the lender.

Borrower Actions

Collateral Deposit

A borrower deposits non-USDC assets to enable borrowing of USDC.

Repay

The repayment of borrowed USDC along with accrued interest by the borrower.

Withdraw Collateral

The withdrawal of deposited collateral by the borrower.

Borrow

The act of borrowing USDC from the protocol, secured by the deposited collateral.