Fee Sharing Program Enrollment Tool

WHAT IT DOES

This tool enables DeFi protocol administrators, dApp operators, and project teams to enroll users in fee sharing programs that distribute a portion of protocol fees to enrolled participants. It connects to your wallet and reads the fee sharing contract address, enrollment criteria (minimum fee contribution, minimum transaction count, minimum average fee), user eligibility status, enrollment status, share percentage, fee contribution history, earned fees, enrollment history, and timestamps. The tool signs and submits transactions to enroll users in the fee sharing program with configurable share percentages, update enrollment status, record enrollment metadata with timestamps, and emit enrollment events for transparency.

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 fee sharing contract deployment.

3. Enter the fee sharing contract address and click "load contract" to fetch the current state.

4. Define the enrollment criteria — key-value pairs such as minimum fee contribution, minimum transaction count, or minimum average fee (one per line).

5. Set the share percentage in basis points (e.g., 100 = 1%) that the user will receive from fee distributions.

6. Click "check eligibility" to verify whether the connected wallet meets the defined criteria based on on-chain data.

7. Click "fetch fee contribution" to view the user's historical fee generation as tracked by the contract.

8. Review the enrollment status, earned fees, share percentage, and enrollment history before executing.

9. Click "enroll" to sign and submit the transaction that officially enrolls the user in the fee sharing program with the specified share percentage.

10. Click "unenroll" to remove a user from the program if needed.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with any EVM-compatible fee sharing contract that implements a standard interface (isEnrolled(address) view, enrollmentStatus(address) view, getEarnedFees(address) view, enroll(address, uint256) external, unenroll(address) external, getEnrollmentHistory(address) view, getFeeContribution(address) view, getSharePercent(address) view). It reads on-chain state directly from the contract rather than relying on off-chain indexes, ensuring data freshness. The eligibility check validates user criteria by reading fee contribution data and enrollment status from the contract before any transaction is signed. The enroll function requires the contract to track the share percentage per user, enabling different rates for different user categories or tiers. The unenroll function safely removes users from the program while preserving their earned fees. Transaction handling follows EIP-1559 gas price calculations using receipt.effectiveGasPrice for accurate cost reporting. Enrollment metadata and timestamps are recorded in the contract's enrollment history mapping, providing an auditable trail of all enrollment actions.

WHAT IT CANNOT SEE

This tool operates purely on-chain and cannot verify off-chain eligibility — it does not check that users actually generated fees through legitimate activity, contributed to protocol growth, or met community standards. It cannot validate fee contribution accuracy — the contract's fee tracking may not capture all fees if users transact across multiple addresses or use different protocols. The tool cannot detect sybil accounts, identity fraud, or duplicate addresses that might unfairly receive multiple fee sharing enrollments. It cannot ensure fair fee distribution — the tool does not verify that the share percentage is appropriate for the user's contribution level or that the program is not being gamed. The tool also cannot verify that users actually generated the fees being shared — all fee contribution data is accepted from the contract and may reflect activity that was not genuinely beneficial to the protocol.

PLEASE NOTE

This tool works exclusively with EVM-compatible blockchain networks (Ethereum, Polygon, Arbitrum, Optimism, Base, etc.). It requires the fee sharing 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. For production deployments, ensure your fee sharing contract has been professionally audited and that share percentages are calibrated to be economically sustainable for your protocol. Consider implementing tiered fee sharing structures where higher contributors receive larger shares.