CDP Position Viewer

WHAT IT DOES

CDP Position Viewer is a read-only tool that displays comprehensive information about Collateralized Debt Positions (CDPs) across EVM-compatible chains. It reads real-time on-chain data including collateral balances, debt amounts, collateral ratios, liquidation thresholds, health factors, and protocol parameters. The tool supports any CDP protocol — you provide the contract address you are using, and the tool reads the view functions to display your position status. No transactions are signed or sent; this is purely a monitoring and analysis tool.

HOW TO USE

Connect your wallet using the BGWallet bridge. Select your target network (Ethereum, Arbitrum, Optimism, or Polygon). Enter the CDP address you want to view and the protocol contract address that manages that CDP — you vouch for this contract, not the tool. Click "Look up position" to fetch and display the current state. Results appear in a clean grid showing collateral value, debt value, collateral ratio, liquidation threshold, health factor, and a status badge indicating whether the position is safe, at warning level, or at risk. The tool provides clear error messages if the lookup fails, explaining what went wrong rather than showing generic failures.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 with the provider from the BGWallet bridge to call view functions on the contract you specify. No hardcoded contract addresses are used — you are always in control of which contract you trust, preventing any risk of being directed to a malicious or unauthorized protocol. When fetching data, the tool reads standard CDP interface functions that expose collateral, debt, and liquidation parameters. All numeric values are computed with proper decimal handling and formatted for human readability. Health factors are calculated from the collateral ratio and liquidation threshold, with color-coded status badges that change dynamically based on the position's risk level. The tool handles network switching gracefully, updating the displayed data for the currently selected chain. Since the tool is read-only, there is no gas cost for the user beyond the read operation (which is free on most RPC providers).

WHAT IT CANNOT SEE

This tool cannot predict price movements or guarantee that displayed health factors reflect real-time market conditions before transaction execution. It reads on-chain state only at the moment of the lookup — prices can change between reads, and liquidation can occur after the data is displayed. The tool does not monitor positions continuously; each lookup is a snapshot. It cannot detect off-chain price feeds, oracle updates that haven't been pushed to chain, or mempool congestion. It does not store any data persistently; all state is in-memory and resets on reload. The tool cannot recover liquidated funds or prevent liquidation — it only displays the current state.

PLEASE NOTE

CDP Position Viewer works exclusively with EVM-compatible chains. It requires a Web3 wallet (MetaMask or similar) and the BGWallet bridge. Always verify the contract address you are using — the tool does not validate or endorse any contract. The tool is read-only and does not sign transactions, making it safe to use for monitoring purposes. Use the displayed health factors as a guide only; always cross-check with the protocol's official interface for critical decisions.