> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sonaragent.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Non-custodial liquidation guardian for Bitcoin-native lending on Stacks

**Sonar monitors your sBTC lending positions on Stacks and alerts you before liquidation** — with a plain-English explanation of *why* your health is dropping, not just that it is.

When you borrow against sBTC on a Stacks protocol like Zest, your position carries a **health factor** — a number that tracks how safe you are from liquidation. At `1.0` you get liquidated. Most tools just show the number. Sonar tells you why it's moving and what to do about it.

<Card title="Launch the dashboard" icon="gauge-high" href="https://app.sonaragent.xyz">
  Enter any Stacks address and see its health factor computed live from mainnet.
</Card>

## Why Sonar

<CardGroup cols={2}>
  <Card title="Non-custodial" icon="lock">
    Read-only by design. Sonar never holds your keys or funds.
  </Card>

  <Card title="Stacks-native" icon="link">
    Reads directly from Clarity contracts. No proxy, no wrapper.
  </Card>

  <Card title="Explains itself" icon="comment">
    Not just "health dropped" — why, and what to do next.
  </Card>

  <Card title="Always watching" icon="eye">
    Continuous monitoring so you never have to check manually.
  </Card>
</CardGroup>

## How it works

<Steps>
  <Step title="Read">
    Sonar reads your position state directly from Clarity contracts on Stacks mainnet — collateral, debt, oracle price — via the Hiro public API. No wallet connection required.
  </Step>

  <Step title="Compute">
    It computes your health factor against each reserve's on-chain liquidation threshold, and tracks what's driving changes: sBTC price movement, rising borrow rates, or both.
  </Step>

  <Step title="Alert">
    When your position approaches the liquidation threshold, Sonar sends a Telegram alert with a plain-English explanation and a suggested action. You act in your own wallet.
  </Step>
</Steps>

<Note>
  Sonar requires only a Stacks address to monitor. It cannot move funds, sign transactions, or interact with any wallet.
</Note>