Token Lock Early Exit Penalty Payer

WHAT IT DOES

This tool enables DeFi users to exit token lock contracts before the scheduled end date by paying the associated early exit penalty. Token locks are designed to enforce long-term commitment by locking tokens for a fixed period. Early exits are typically penalized to discourage breaking the commitment, with penalties expressed as a percentage of the locked amount. It connects to your wallet and reads the lock contract address, lock amount, lock end timestamp, remaining lock duration, early exit penalty percentage, penalty amount, lock status, exit history, and timestamps. The tool signs and submits transactions to pay the early exit penalty, withdraw unlocked tokens, update lock status, record exit metadata, and emit exit 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 lock contract deployment.

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

4. Click "fetch lock status" to retrieve your current lock amount, lock end timestamp, remaining duration, penalty percentage, and lock status.

5. Review the penalty details displayed — the penalty amount and net withdrawal amount after penalty are automatically calculated.

6. Click "calculate penalty" to see a detailed breakdown of the penalty and net withdrawal amounts.

7. Click "validate exit" to verify that the lock is active and can be exited.

8. Review the lock amount, penalty amount, and net withdrawal carefully before executing.

9. Click "pay penalty & exit lock" to sign and submit the transaction that pays the penalty and withdraws your unlocked tokens.

10. After execution, the lock status will be updated and the exit will be recorded in the history.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with any EVM-compatible token lock contract that implements a standard interface (lockAmount() view, lockEnd() view, penaltyPercent() view, lockStatus() view, earlyExit() external, getExitHistory() view). The earlyExit function validates that the caller has an active lock and calculates the penalty as (lockAmount * penaltyPercent / 10000) basis points. The penalty is deducted from the withdrawal amount and typically sent to a treasury, burned, or redistributed to remaining lockers. The function then transfers the net amount (lockAmount - penalty) to the caller and updates the lock status to 'exited' or 'penalized'. The contract records the exit in its history mapping, storing the timestamp and amount for audit purposes. Transaction handling follows EIP-1559 gas price calculations using receipt.effectiveGasPrice for accurate cost reporting. Exit metadata is recorded both in the contract's immutable history and locally for the user's reference.

WHAT IT CANNOT SEE

This tool operates purely on-chain and cannot verify off-chain financial circumstances — it does not check whether the user is facing legitimate hardship, financial distress, or other extenuating circumstances that might justify an early exit. It cannot validate hardship claims — the tool cannot confirm that the user's stated reasons for early exit are truthful or legitimate. It cannot detect penalty evasion — the tool cannot identify users who try to circumvent penalties through multiple addresses or other methods. It cannot ensure fair penalty enforcement — the tool does not verify that the penalty percentage is appropriate or that the penalty funds are used for their intended purpose. The tool also cannot verify that the exit is justified — all exits are processed based solely on the contract's logic and the user's decision, without any off-chain validation.

PLEASE NOTE

This tool works exclusively with EVM-compatible blockchain networks (Ethereum, Polygon, Arbitrum, Optimism, Base, etc.). It requires the lock contract to implement the 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. Early exit penalties are significant and should not be taken lightly — ensure you understand the financial impact before executing. Always test on a testnet first and verify that the penalty calculation matches your expectations. Consider waiting until the lock period ends to avoid penalties if possible.