Principal-Protected Vault Maturity Redemption Tool

WHAT IT DOES

This tool enables DeFi users to redeem their deposits from principal-protected vaults at maturity. When a vault deposit matures, users can claim both their principal and any yield earned during the lock period. The redemption amount includes the original principal plus the accumulated yield, with the principal protected by the vault's mechanism. It connects to your wallet and reads the vault contract address, deposit amount, maturity timestamp, redemption amount, yield earned, protection status, redemption history, and timestamps. The tool signs and submits transactions to redeem matured principal-protected vault deposits, claim principal and yield, update redemption status, record redemption metadata, and emit redemption events.

HOW TO USE

1. Connect your wallet using the wallet bridge (supports MetaMask, WalletConnect, and other EVM-compatible wallets).

2. Select the target network that matches your vault contract deployment.

3. Enter the vault contract address and click "load contract" to initialize the connection.

4. Click "fetch redemption status" to retrieve your deposit amount, maturity timestamp, redemption amount, yield earned, and protection status.

5. Review the deposit details — the maturity timestamp indicates when the vault deposit matures.

6. Check the protection status — the vault must be matured (not locked) to redeem.

7. Click "validate redemption" to verify that the deposit is matured and ready for redemption.

8. Click "check redemption history" to view your past redemptions.

9. Review the redemption amount, yield earned, and protection status before executing.

10. Click "redeem" to sign and submit the transaction that redeems your principal and yield.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with any EVM-compatible principal-protected vault contract that implements a standard redemption interface (getDeposit(address) view returns (uint256 amount, uint256 maturity, uint256 redemption, uint256 yield, uint8 status), redeem() external, getRedemptionHistory(address) view). The getDeposit view returns the deposit amount, maturity timestamp, redemption amount, yield earned, and status (none, locked, matured, redeemed). The redeem function validates that the deposit is matured and not already redeemed, then transfers the redemption amount (principal + yield) to the user. The contract updates the deposit status to "redeemed" and records the redemption in the history mapping. The redemption amount is calculated based on the principal, the yield rate, and the lock period, with the principal protected by the vault's mechanism. Transaction handling follows EIP-1559 gas price calculations using receipt.effectiveGasPrice for accurate cost reporting. Redemption metadata is recorded both in the contract's history and locally for the user's reference.

WHAT IT CANNOT SEE

This tool operates purely on-chain and cannot verify off-chain yield accuracy — it does not check whether the yield rate is accurate or generated from reliable strategies. It cannot validate the protection mechanism — the tool cannot confirm that the vault's protection mechanism is correctly implemented or that it will actually protect the principal. It cannot detect vault risks — the tool cannot identify vulnerabilities in the vault's strategy, smart contract risks, or external dependencies. It cannot ensure principal protection — the tool relies on the contract's implementation and does not independently verify that the principal is fully protected. The tool also cannot guarantee that principal is fully protected — while the vault is designed to protect principal, there is no guarantee of full protection under all circumstances.

PLEASE NOTE

This tool works exclusively with EVM-compatible blockchain networks (Ethereum, Polygon, Arbitrum, Optimism, Base, etc.). It requires the vault contract to implement the redemption interface described above. All transactions incur gas fees paid by the connected wallet. The tool maintains no persistent storage — all state is refreshed from the blockchain on each session. Redemption is only available after the vault deposit matures — ensure the maturity timestamp has passed before attempting to redeem. The redemption amount includes both principal and yield, but the yield may vary based on market conditions and the vault's performance. Always verify the redemption amount and protection status before executing. Consider the timing of your redemption to maximize yield.