How to Liquidate a TCAP Vault Through Etherscan
- Select the correct vault handler
- WETH Vault Handler
- WBTC Vault Handler
- DAI Vault Handler
Use the numeric vault ID, such as 3. Do not enter the vault owner’s wallet address where Etherscan requests a uint256 vaultId.
- Check the vault
Under Contract → Read Contract, query:
- paused() — must return false.
- getVault(vaultId) — confirms the collateral, owner and outstanding TCAP debt.
- getVaultRatio(vaultId) — displays the current collateral ratio.
- requiredLiquidationTCAP(vaultId) — returns the exact TCAP required.
- liquidationReward(vaultId) — returns the collateral the liquidator will receive.
- Confirm the liquidator has enough TCAP
The wallet executing the transaction must hold at least the amount returned by requiredLiquidationTCAP.
TCAP uses 18 decimals:
1 TCAP = 1000000000000000000
500 TCAP = 500000000000000000000
No token approval is required. The vault handler burns TCAP directly from the wallet calling liquidateVault.
- Determine the required ETH value
Still under Read Contract, call:
getFee(requiredTCAP)
Enter the raw amount returned by requiredLiquidationTCAP.
getFee returns the required ETH payment in wei. Convert that result to ETH before entering it as Etherscan’s payable transaction value.
Example:
10000000000000000 wei = 0.01 ETH
- Execute the liquidation
- Open Contract → Write Contract.
- Select Connect to Web3.
- Connect the wallet that holds the TCAP.
- Open liquidateVault.
- Enter:
_vaultId: numeric vault ID
_maxTCAP: maximum TCAP to burn, using 18-decimal units
- Enter the required ETH amount in the payable-value field.
- Review and submit the transaction.
The contract recalculates the actual TCAP requirement when the transaction executes. Setting _maxTCAP slightly above the displayed requirement can prevent a small oracle-price movement from causing the transaction to revert.
- Verify the transaction
After confirmation:
- Check the transaction logs for VaultLiquidated.
- Confirm the liquidator’s TCAP balance decreased.
- Confirm the recovered collateral reached the liquidating wallet.
- Query getVault(vaultId) again to confirm the updated debt and collateral.
- Query getVaultRatio(vaultId) again to confirm the resulting position.
The recovered collateral is sent to the wallet that executes the liquidation. If the DAO treasury should receive the collateral directly, the treasury wallet or Safe must make the call and hold the required TCAP.