Skip to main content

​
Quickstart Guide

This guide walks you through connecting your wallet, discovering your loan wallets, and executing your first recovery operation.
Before you begin, make sure you’ve reviewed the Prerequisites page to ensure you have everything needed.

​
Overview

The recovery workflow consists of four main steps:
  1. Connect your wallet
  2. Scan for deployed loan wallets
  3. Load position data
  4. Execute rescue actions

​
Step-by-Step Workflow

1

Export and Import Your Private Key

You must export your private key from the Sats Terminal dashboard first.
  1. Log in to the Sats Terminal dashboard
  2. Export your private key from your account settings
  3. Import that private key into MetaMask, Rabby, or another EIP-1193 compatible wallet
Do not connect a different wallet, or the derived wallet addresses will not match your loan positions.
Important: Never paste private keys directly into the recovery UI. Private keys should only be imported in your wallet application.
2

Connect Your Wallet

  1. Open the Borrow Recovery app at http://localhost:3000 (or your deployed URL)
  2. Click the wallet button in the top-right corner
  3. Select your wallet provider (MetaMask, Rabby, WalletConnect, etc.)
  4. Approve the connection request in your wallet
  5. Verify that your address appears in the connected status section
3

Scan for Deployed Wallets

Navigate to the /scan page and configure your scan:Configure Scan Parameters:
  • Start index: The beginning of your index range (e.g., 0)
  • End index: The end of your index range (e.g., 100)
  • Chain selection: Check the chains you want to scan
    • Ethereum
    • Base
    • Arbitrum
    • BNB Chain
Maximum scan size per run is 2,000 indices. Use “Show only deployed wallets” to filter out noise.
Run the Scan:
  1. Click Start scan
  2. The app will request chain switches while scanning each chain
  3. Approve the chain switch prompts in your wallet
  4. Review the scan results table
  5. Click any result row to open /wallet/<index> for that wallet
Skip Scanning (Optional): If you already know your wallet ID from the loan activation email, you can skip scanning and go directly to /wallet/<wallet-id> (e.g., /wallet/12).
4

Load Position Data

After opening a wallet details page (/wallet/<index>):
  1. The page displays the derived Kernel loan wallet address
  2. Click Copy address to copy the smart wallet address
  3. Fund the wallet with:
    • Native gas token (ETH, BNB) - required for all rescue actions
    • Repay token (USDC, USDT, etc.) - required for repay actions
  4. Select the correct chain from the chain dropdown if needed
  5. Click Load positions to fetch:
    • Wallet token balances
    • Aave V3 loan details (debt, collateral, health factor)
    • Morpho Blue loan details
5

Configure ZeroDev Bundler

Before executing rescue actions, you must configure the bundler:Get Your ZeroDev Project ID:
  1. Go to https://dashboard.zerodev.app/projects/general
  2. Sign in to your ZeroDev account
  3. Open your project (or create one if none exists)
  4. Copy the Project ID from the top-right of the project page
Configure in Recovery UI:
  1. Locate the “ZeroDev Project ID or RPC URL” input field
  2. Paste either:
    • Your ZeroDev Project ID, or
    • A full bundler URL (e.g., https://rpc.zerodev.app/api/v3/<project-id>/chain/<chain-id>)
  3. Rescue action buttons will become enabled when the input is valid
6

Execute Your First Rescue Action

Choose one of the available rescue operations:

​
Option A: Withdraw Collateral (Aave)

  1. Scroll to the Aave section
  2. Select action: Withdraw collateral
  3. Toggle full amount or enter custom amount
  4. Click Execute Aave action via Kernel
  5. Approve the transaction in your wallet
  6. Wait for the UserOp to complete

​
Option B: Repay Debt (Aave)

  1. Ensure the loan wallet has sufficient repay tokens
  2. Select action: Repay debt
  3. Toggle full amount or enter custom amount
  4. Click Execute Aave action via Kernel
  5. Approve both transactions in your wallet (approve + repay)
If using “Repay all”, keep a little extra loan token (USDC/USDT) in the wallet because interest accrues in real-time and debt can increase slightly before execution.

​
Option C: Transfer Out Tokens

  1. Locate the wallet balances section
  2. Find the token card you want to transfer
  3. Click Transfer all to connected wallet
  4. Approve the transaction in your wallet
7

Verify Results

After executing a rescue action:
  1. Review the status text displayed in the UI
  2. Copy the UserOp hash to track on a block explorer
  3. Click Load positions again to verify:
    • Updated token balances
    • Changed debt amounts
    • Updated collateral positions
    • New health factor (if applicable)

​
Operational Checklist

Before executing any rescue action, verify:
  • Connected wallet is on the intended chain
  • Loan wallet has enough native gas token
  • Repay token is funded to the loan wallet (for repay flows)
  • Bundler input is set correctly (ZeroDev Project ID)
  • Amount and action are correct (especially full-withdraw/full-repay toggles)

​
Common Workflows

​
Fully Close a Loan Position

1

Fund the wallet with repay tokens and gas

2

Execute: Repay all debt (Aave or Morpho)

3

Execute: Withdraw all collateral

4

Execute: Transfer out all token balances

​
Partially Reduce Risk

1

Fund the wallet with repay tokens and gas

2

Execute: Repay partial debt to improve health factor

3

Verify: Load positions to confirm new health factor

​
Extract Collateral Only

1

Ensure loan is fully repaid or over-collateralized

2

Execute: Withdraw collateral (full or partial)

3

Execute: Transfer withdrawn tokens to your EOA

​
Next Steps

Wallet Scanning Guide

Learn advanced scanning techniques and troubleshooting

Rescue Operations

Detailed guide for all Aave and Morpho rescue actions

​
Troubleshooting

See common issues and solutions:
  • Action button disabled: Missing or invalid bundler input, invalid amount, or an action is already submitting
  • “No gas” warning: Send native gas token to the loan wallet address
  • “Switch your wallet to <chain>”: Use chain selector and approve wallet switch prompt
  • Scan is slow: Reduce range size or number of selected chains
For detailed troubleshooting, see the main documentation sections for Wallet Scanning and Rescue Operations.

Build docs developers (and LLMs) love

Get started for freeTalk to us