Skip to main content

Borrow Recovery

Borrow Recovery is a frontend-only recovery UI for discovering and operating EVM ZeroDev Kernel loan wallets if the main service ceases to exist or becomes unavailable.
This app is frontend-only with no backend signer, no database, and no paymaster abstraction. All signatures happen in your connected wallet.

What is Borrow Recovery?

Borrow Recovery provides a self-service control panel for managing loan positions created through ZeroDev Kernel v3.3 smart accounts. If the hosted service becomes unavailable, you can use this recovery UI to:
  • Discover your deployed loan wallets by scanning address ranges
  • View loan positions across Aave V3 and Morpho Blue protocols
  • Execute rescue operations to manage collateral and debt
  • Transfer assets out of your smart wallets

Quickstart

Get started with wallet connection, scanning, and your first recovery action

Prerequisites

Required tools, supported chains, and what you need before using the recovery UI

Wallet Scanning

Learn how to discover deployed loan wallets across multiple chains

Rescue Operations

Execute repay, withdraw, and transfer operations on Aave and Morpho

Key Features

Deterministic Address Derivation

The app derives deterministic ZeroDev Kernel v3.3 smart account addresses from your EOA (Externally Owned Account) plus a wallet index. This allows you to recover access to any loan wallet created through the service.

Multi-Chain Scanning

Scan index ranges across supported chains to find deployed loan wallets:
  • Ethereum (Chain ID: 1)
  • Base (Chain ID: 8453)
  • Arbitrum (Chain ID: 42161)
  • BNB Chain (Chain ID: 56)
Scan up to 2,000 indices per run with filtering options to show only deployed wallets.

Protocol Integration

Aave V3
  • Read loan positions (debt, collateral, health factor)
  • Repay debt
  • Withdraw collateral
Morpho Blue
  • Read loan positions on supported market
  • Repay debt
  • Withdraw collateral
  • Market ID: 0x9103c3b4e834476c9a62ea009ba2c884ee42e94e6e314a26f04d312434191836

Rescue Actions via ERC-4337

All rescue operations are submitted through ERC-4337 UserOperations using EntryPoint v0.7:
  • Repay debt (sends 2 UserOps: approve + repay)
  • Withdraw collateral (sends 1 UserOp)
  • Transfer out token balances (sends 1 UserOp)

No Backend Dependencies

The application runs entirely in your browser:
  • No API keys required for reading onchain positions
  • Direct blockchain interaction through your wallet
  • ZeroDev Project ID only needed when submitting rescue UserOperations
  • Complete transparency and auditability

Scope and Limitations

EVM Only: This recovery UI supports EVM loans only. Solana loans are not supported.
The application is designed as a safety measure for scenarios where the main service is unavailable. It provides essential recovery functionality without the full feature set of the hosted platform.

Safety First

  • Never paste or type private keys into this app
  • Always validate addresses, chain, and amounts before signing
  • You are fully responsible for transaction execution and operational safety
All transaction signing happens in your connected wallet (MetaMask, Rabby, etc.). The recovery UI constructs the operations but never has access to your private keys.

Next Steps

Check Prerequisites

Ensure you have the required tools and setup

Start Recovery

Follow the quickstart guide to begin recovering your loans

Build docs developers (and LLMs) love