Liquidity Mining Program Enrollment Tool

WHAT IT DOES

This tool enables DeFi users and liquidity providers to enroll in liquidity mining programs. Liquidity mining is a DeFi mechanism where users provide liquidity to a pool and earn rewards in return, typically in the protocol's native token. It connects to your wallet and reads the liquidity mining contract address, pool ID, staking amount, eligibility status, enrollment status, reward rate, enrollment history, and timestamps. The tool signs and submits transactions to enroll in liquidity mining programs, deposit liquidity, update enrollment status, record enrollment metadata, and emit enrollment 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 liquidity mining contract deployment.

3. Enter the liquidity mining contract address and the pool ID, then click "load contract" to initialize the connection.

4. Click "fetch pool status" to retrieve the pool information including total staked, reward rate (APR/APY), eligibility status, and your enrollment status.

5. Review the eligibility status — you must be eligible to enroll in the pool.

6. Enter the staking amount you want to deposit (in token units).

7. Click "validate enrollment" to verify that you are eligible and the amount is valid.

8. Click "check enrollment history" to view your past enrollment and withdrawal activity for this pool.

9. Review the pool details, staking amount, and reward rate before executing.

10. Click "enroll" to sign and submit the transaction that deposits your tokens into the liquidity mining pool.

11. Click "withdraw" to exit the pool and withdraw your staked tokens.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with any EVM-compatible liquidity mining contract that implements a standard interface (getPoolInfo(uint256) view returns (uint256 totalStaked, uint256 rewardRate, bool active), isEligible(address, uint256) view returns (bool), enrollmentStatus(address, uint256) view returns (uint8), enroll(uint256, uint256) external, withdraw(uint256) external, getEnrollmentHistory(address, uint256) view). The enroll function deposits the specified amount of tokens into the pool, updating the user's staked balance and the pool's total staked amount. Rewards are typically distributed over time based on the user's share of the pool and the current reward rate. The withdraw function returns the staked tokens plus any accrued rewards. The contract maintains a history of enrollments and withdrawals for audit purposes. Transaction handling follows EIP-1559 gas price calculations using receipt.effectiveGasPrice for accurate cost reporting. Enrollment 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 eligibility — it does not check whether the user meets community requirements, has completed KYC, or satisfies other off-chain conditions. It cannot validate liquidity provision — the tool cannot confirm that the user actually provides liquidity or that the tokens are correctly deployed. It cannot detect sybil accounts — the tool cannot identify users who create multiple wallets to farm rewards. It cannot ensure fair reward distribution — the tool does not verify that the reward rate is appropriate or that rewards are distributed fairly. The tool also cannot verify that liquidity is actually provided — it relies on the contract's state and does not independently verify that the tokens are contributing to a functional liquidity pool.

PLEASE NOTE

This tool works exclusively with EVM-compatible blockchain networks (Ethereum, Polygon, Arbitrum, Optimism, Base, etc.). It requires the liquidity mining 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. Liquidity mining involves risk — token values can fluctuate, rewards are not guaranteed, and smart contracts may have vulnerabilities. Only stake amounts you are willing to lock up for the program duration. Always test on a testnet first and verify that the reward rate and pool terms are correct before enrolling with real funds.