Token Lock Extension for Bonus Tool

WHAT IT DOES

This tool enables DeFi users and token holders to extend their token lock duration and claim bonus rewards for committing to longer lock periods. Token locking is a common mechanism in DeFi protocols where users lock their tokens for a fixed period to earn rewards, participate in governance, or signal long-term commitment. Extending the lock period often qualifies users for additional bonuses, higher yields, or enhanced voting power. It connects to your wallet and reads the lock contract address, current lock end timestamp, lock amount, bonus multiplier, extension duration, bonus criteria, lock history, and timestamps. The tool signs and submits transactions to extend token lock duration, claim bonus rewards, update lock status, record extension metadata, and emit extension 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 token lock contract deployment.

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

4. Click "fetch lock data" to retrieve your current lock end timestamp, lock amount, and current bonus multiplier.

5. Enter the extension duration in seconds — the longer you extend, the higher the potential bonus.

6. Optionally add bonus criteria (e.g., "staked: 1000" or "duration: 365") to calculate additional bonus multipliers.

7. Click "calculate bonus" to preview your bonus multiplier based on the extension duration and criteria.

8. Click "validate extension" to verify that the extension is valid and see the new lock end date.

9. Review the displayed current lock end, new lock end, extension duration, and bonus multiplier before executing.

10. Click "extend lock & claim bonus" to sign and submit the transaction that extends your lock period and claims any available bonus rewards.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with any EVM-compatible token lock contract that implements a standard interface (lockEnd() view, lockAmount() view, getBonusMultiplier() view, extendLock(uint256) external, claimBonus() external, getLockHistory() view). The extendLock function validates that the caller has an active lock and extends the lock end timestamp by the specified duration. The bonus multiplier is calculated on-chain based on the total lock duration (original + extension) and any bonus criteria defined in the contract. The claimBonus function distributes bonus rewards (typically additional tokens or yield) to users who have extended their locks beyond certain thresholds. The contract's getBonusMultiplier view returns the current bonus multiplier for the user, which is used to calculate bonus rewards. Transaction handling follows EIP-1559 gas price calculations using receipt.effectiveGasPrice for accurate cost reporting. Extension metadata, including timestamps and amounts, is recorded in the contract's lock history mapping, providing an auditable trail of all lock extensions.

WHAT IT CANNOT SEE

This tool operates purely on-chain and cannot verify off-chain bonus eligibility — it does not check that users meet community-defined criteria, participate in protocol activities, or complete off-chain tasks. It cannot validate lock commitment — the tool cannot confirm that users genuinely intend to hold tokens long-term or that their lock behavior is legitimate. It cannot detect sybil accounts — the tool cannot identify users who create multiple wallets to farm bonuses. It cannot ensure fair bonus distribution — the tool does not verify that bonus criteria are appropriate or that the bonus multiplier correctly reflects the user's contribution. The tool also cannot verify that bonus criteria are met — all bonus calculations are based on the contract's logic and the user's lock parameters, without off-chain verification.

PLEASE NOTE

This tool works exclusively with EVM-compatible blockchain networks (Ethereum, Polygon, Arbitrum, Optimism, Base, etc.). It requires the token 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. Extending token locks is a commitment that locks up your tokens for an extended period — ensure you are comfortable with the lock duration before executing. Bonus rewards are not guaranteed and may be subject to protocol terms and conditions. Always test on a testnet first and verify that the extension and bonus calculations are correct.