Position Loading

Overview

After scanning for wallets, you can load detailed position data from supported lending protocols. Borrow Recovery currently supports:

Aave V3 (Ethereum, Base, Arbitrum, BSC)
Morpho Blue (Base only)

Loading Positions

Navigate to Wallet Details

Click any wallet from the scan results or navigate directly to /wallet/{index} where {index} is your wallet index.

Select Chain

Choose the chain where your loan is deployed. The app will auto-detect the chain if the wallet is deployed.

Click Load Positions

The app will:

Switch your wallet to the selected chain (if needed)
Read the Kernel wallet’s native balance (for gas)
Query token balances (USDC, cbBTC/WBTC)
Fetch Aave position data
Fetch Morpho position data (Base only)

Your browser wallet must be connected and switched to the correct chain. You’ll be prompted to approve the network switch if needed.

Chain Auto-Detection

When you first load a wallet page, the app automatically scans all supported chains to find where the Kernel wallet is deployed:

// From: app/wallet/[index]/page.tsx
const checks = SUPPORTED_CHAINS.map(async (c) => {
  try {
    const res = await fetch(c.rpcUrl, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        jsonrpc: "2.0",
        id: 1,
        method: "eth_getCode",
        params: [kernelAddress, "latest"],
      }),
    });
    const json = await res.json();
    const code = json?.result as string | undefined;
    return code && code !== "0x" ? c.id : null;
  } catch {
    return null;
  }
});

const results = await Promise.all(checks);
const deployedChain = results.find((id): id is SupportedChainId => id !== null);
if (deployedChain && !manualChainSelectionRef.current) {
  setSelectedChainId(deployedChain);
}

Data Displayed

Wallet Balances

The app displays three key balances:

Native token (ETH/BNB): Required for gas to execute UserOperations
USDC: The debt asset, needed for repayment
Collateral (cbBTC/WBTC): The asset supplied to the lending protocol

If the native balance is 0, you’ll see a warning. You must send gas to the Kernel wallet address before executing rescue operations.

Aave V3 Position Data

For Aave positions, the app fetches:

Account Summary

// From: app/wallet/[index]/page.tsx
const summary = await fetchAaveUserSummaryWithBackendLogic({
  chain: refreshChain,
  walletAddress: kernelAddress,
});

This includes:

Health Factor: Ratio of collateral to debt (liquidation occurs below 1.0)
LTV: Current loan-to-value ratio
Liquidation Threshold: The LTV at which liquidation is triggered

Raw Position Data

The app also queries the Aave Pool contract directly:

// Get user account data from Aave Pool
const aaveRes = await request("eth_call", [
  { 
    to: refreshChain.aaveV3PoolAddress, 
    data: encodeAaveGetUserAccountData(kernelAddress) 
  }, 
  "latest"
]);
const accountData = decodeAaveGetUserAccountData(aaveRes);

Token Balances (aToken & Debt Tokens)

// Get reserve token addresses
const collateralReserveTokens = decodeAaveGetReserveTokensAddresses(
  collateralReserveTokensRes
);
const debtReserveTokens = decodeAaveGetReserveTokensAddresses(
  debtReserveTokensRes
);

// Query aToken balance (collateral)
const aTokenBalRes = await request("eth_call", [
  { 
    to: collateralReserveTokens.aTokenAddress, 
    data: encodeErc20BalanceOf(kernelAddress) 
  }, 
  "latest"
]);

// Query variable debt token balance
const variableDebtBalRes = await request("eth_call", [
  { 
    to: debtReserveTokens.variableDebtTokenAddress, 
    data: encodeErc20BalanceOf(kernelAddress) 
  }, 
  "latest"
]);

Morpho Blue Position Data (Base Only)

For Morpho positions on Base:

// Get Morpho position
const morphoRes = await request("eth_call", [
  { 
    to: refreshChain.morphoBlueAddress, 
    data: encodeMorphoBluePosition(
      MORPHO_BASE_MARKETS.cbBTC_USDC.marketId, 
      kernelAddress
    ) 
  }, 
  "latest"
]);
const position = decodeMorphoBluePosition(morphoRes);

This includes:

Supply shares: Your share of the lending pool
Borrow shares: Your share of the borrowing pool
Collateral supplied: Amount of cbBTC collateral
Borrow amount: Amount of USDC borrowed
LTV: Current loan-to-value ratio
Health Factor: Risk metric (liquidation threshold)
Liquidation Price: The price at which liquidation occurs

Understanding Health Factor

The health factor is the most critical metric for loan positions:

> 2.0: Healthy position (displayed with dark background)
1.2 - 2.0: Moderate risk (displayed with gray background)
< 1.2: High risk (displayed with red background)
< 1.0: Liquidation will occur

// Health factor display logic
{aaveSummary?.healthFactor ? (
  <span className={`rounded-full px-2.5 py-1 text-xs font-semibold ${
    Number(aaveSummary.healthFactor) > 2
      ? "bg-zinc-900 text-white"
      : Number(aaveSummary.healthFactor) > 1.2
        ? "bg-zinc-200 text-zinc-900"
        : "bg-red-500/10 text-red-700"
  }`}>
    HF: {aaveSummary.healthFactor}
  </span>
) : null}