Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trusset.org/llms.txt

Use this file to discover all available pages before exploring further.

Once your lending market is live, the Issuers App provides tools for monitoring positions, managing liquidity, tracking transactions, and adjusting configuration. Most operations are observable—the market runs autonomously while you maintain oversight.

​
Dashboard Overview

The market detail view displays real-time metrics:

Total Deposits

USDC provided by liquidity providers

Total Borrowed

Outstanding loan principal

Utilization

Borrowed / Deposits ratio

Current Rates

Supply and borrow APY

​
Monitoring Positions

​
Position List

The Positions tab shows all active loans:
ColumnDescription
UserBorrower wallet address
BorrowedOutstanding debt (principal + interest)
CollateralLocked token amount
InterestAccrued interest to date
HealthCurrent health factor
StatusActive, At Risk, or Liquidated

​
Health Factor Alerts

Positions are color-coded by risk:
  • 🟢 Green (> 1.2): Healthy, well-collateralized
  • 🟡 Yellow (1.0 - 1.2): Approaching threshold, may need monitoring
  • 🔴 Red (< 1.0): Liquidatable
The system sends notifications when positions approach liquidation thresholds. Configure webhook endpoints in your instance settings to receive these alerts.

​
Position Details

Click any position to view:
  • Full transaction history
  • Price at borrow vs current price
  • Collateral value over time
  • Interest accumulation
  • Liquidation price (price at which position becomes unhealthy)

​
Liquidity Management

​
Providing Liquidity

The Provide button opens the liquidity modal:
  1. Enter USDC amount
  2. Confirm transaction from connected wallet
  3. Receive LP shares representing pool ownership
LP shares appreciate as interest accumulates—withdrawing later returns more USDC than deposited.

​
Withdrawing Liquidity

The Withdraw button converts shares back to USDC:
  1. Enter share amount or USDC value
  2. System calculates current share value
  3. Confirm withdrawal
Withdrawals require available liquidity. If most USDC is borrowed, withdrawals may be limited until borrowers repay or get liquidated.

​
Provider Tracking

The Providers tab lists all liquidity providers:
ColumnDescription
ProviderWallet address
DepositedOriginal USDC deposit
SharesCurrent share balance
ValueCurrent USDC value of shares
StatusActive or Withdrawn

​
Oracle Management

​
Price Synchronization

Automated: Click Authorize Signer to automate price feeds with our backend relayer (no funding required). We will soon implement the IVC to automate price-feeds for lending. Manual: Click Sync Oracle to update the on-chain price:
  1. System fetches current price from configured feed
  2. Signs price update with authorized signer
  3. Submits to oracle contract
  4. New price becomes effective immediately

​
Stale Price Handling

If the oracle price becomes stale (exceeds max age):
  • New borrows are blocked
  • Existing positions continue operating
  • Liquidations use last valid price
  • Alert appears prompting price sync

​
Price History

View historical prices in the position detail view. The chart shows:
  • Oracle price over time
  • Position-specific liquidation price
  • Current market price from external feeds

​
Transaction History

The Transactions tab logs all market activity:
TypeDescription
DEPOSITLiquidity provider deposit
WITHDRAWLiquidity withdrawal
BORROWNew loan opened
REPAYDebt repayment
LIQUIDATEPosition liquidation
CONFIGURATIONSettings change
Each transaction links to the block explorer for verification.

​
Configuration Updates

​
Risk Parameters

Go to the tab Settings → Edit Config to modify:
ParameterLive UpdateNotes
Collateral Factor✅Affects new borrows only
Liquidation Threshold✅Changes health factor calculations
Liquidation Penalty✅Applies to future liquidations
Close Factor✅Limits liquidation size
Min Borrow Amount✅Filters small loans
Supply Caps✅Can increase or decrease
Dutch Auction Toggle✅Switches liquidation mode
Auction Duration✅For new auctions only
Auction Premiums✅For new auctions only
Lowering the liquidation threshold can make healthy positions suddenly liquidatable. Review position health factors before reducing thresholds.

​
Trading Venue

Configure where liquidated collateral goes for sale:
Uses Trusset’s built-in orderbook. Liquidated tokens list automatically, and USDC proceeds return to the lending pool.Recommended for most deployments.

​
Custom Price Feed

Override default price sources: 
https://your-api.com/price?symbol={symbol}
The API must return JSON with a price field. Test your endpoint in the interface before configuring, invalid feeds will cause oracle sync failures.

​
Alerts and Notifications

The dashboard shows contextual alerts:
AlertAction Required
Signer Not AuthorizedConnect owner wallet and authorize
Oracle Price StaleSync oracle price
Liquidation Not ConfiguredComplete liquidation setup
Pending LiquidationsMonitor or trigger settlement
Active AuctionsAuctions in progress, can bid

​
Emergency Controls

​
Pausing

Admins can pause the market during emergencies:
  • Stops new loans and borrows
  • Allows repayments (users can exit)
  • Liquidations continue (protects pool)
  • Liquidity withdrawals permitted
Pause when: suspicious activity detected, contract upgrade needed, or external market conditions warrant caution.

​
Upgrading

Contract upgrades require Admin role:
  1. Deploy new implementation
  2. Call upgrade function with new address
  3. Verify functionality in staging first
Contract upgrades are irreversible. Always test on testnet with identical conditions before production upgrades.

Setup Guide

Initial deployment and configuration

Liquidation

Liquidation modes and integration