Minority Shareholder Token Exit Tool

WHAT IT DOES

This tool enables minority token holders to exercise their exit rights, selling their tokens back to the protocol or treasury at a predetermined exit price. Minority shareholder exit rights provide a mechanism for smaller token holders to exit their positions in a controlled manner, often as part of a DAO's governance framework or shareholder agreement. It connects to your wallet and reads the exit contract address, token balance, exit price, exit valuation, exit eligibility, exit window, exit history, and timestamps. The tool signs and submits transactions to initiate minority shareholder token exits, sell tokens at the exit price, claim exit proceeds, 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 exit contract deployment.

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

4. Click "fetch exit status" to retrieve your token balance, exit price, exit valuation, exit eligibility, exit window, and exit history.

5. Review your eligibility and the exit valuation — this is the amount you would receive if you exit.

6. Check the exit window — exits can only be initiated during the specified period.

7. Click "validate exit" to verify that you are eligible and have tokens to exit.

8. Click "check exit history" to view your past exits.

9. Review the token balance, exit price, exit valuation, and exit window before executing.

10. Click "initiate exit" to sign and submit the transaction that sells your tokens at the exit price.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with any EVM-compatible exit contract that implements a standard interface (getTokenBalance(address) view returns (uint256), getExitPrice() view returns (uint256), getExitValuation(address) view returns (uint256), isEligible(address) view returns (bool), getExitWindow() view returns (uint256, uint256), initiateExit() external, getExitHistory(address) view). The getTokenBalance view returns the user's token holdings. The getExitPrice view returns the fixed price per token at which exits are executed. The getExitValuation view calculates the total exit proceeds (balance * price). The isEligible view checks whether the user meets the exit criteria (e.g., holding period, minimum balance). The getExitWindow view returns the start and end timestamps of the exit period. The initiateExit function validates that the user is eligible, the exit window is open, and the user has tokens, then transfers the exit proceeds to the user and burns or transfers the tokens. The contract maintains a history of exits, storing timestamps and amounts 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 history and locally for the user's reference.

WHAT IT CANNOT SEE

This tool operates purely on-chain and cannot verify off-chain valuation accuracy — it does not check whether the exit price is fair or based on accurate valuation methods. It cannot validate exit eligibility — the tool cannot confirm that the user meets all eligibility criteria beyond the contract's logic. It cannot detect market manipulation — the tool cannot identify attempts to manipulate the token price before exits. It cannot ensure a fair exit price — the tool does not verify that the exit price reflects the true value of the tokens. The tool also cannot guarantee that exit is executed — the contract may reject exits due to insufficient funds or other conditions.

PLEASE NOTE

This tool works exclusively with EVM-compatible blockchain networks (Ethereum, Polygon, Arbitrum, Optimism, Base, etc.). It requires the exit 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. Exiting as a minority shareholder is a significant financial decision — ensure you understand the exit price, valuation, and the permanent nature of the exit. Once you exit, you will no longer hold tokens or have voting rights. Consider the tax implications of selling tokens before initiating an exit. Always verify the exit valuation and eligibility before executing.