Token Holder Dissent Rights Exercise Tool

WHAT IT DOES

This tool enables token holders to exercise their dissent rights on governance proposals. Dissent rights allow token holders to formally object to a proposal they disagree with, recording their objection on-chain. Dissents may trigger review processes, alternative resolutions, or serve as a formal record of opposition. It connects to your wallet and reads the governance contract address, proposal ID, dissent reason, token balance, voting power, dissent period, dissent status, dissent history, and timestamps. The tool signs and submits transactions to exercise dissent rights, record dissent votes, update dissent status, record dissent metadata, and emit dissent 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 governance contract deployment.

3. Enter the governance contract address and the proposal ID, then click "load contract" to initialize the connection.

4. Click "fetch dissent status" to retrieve your token balance, voting power, dissent period, dissent status, and dissent history.

5. Review your voting power — this determines the weight of your dissent.

6. Enter a detailed dissent reason explaining your objection to the proposal.

7. Click "validate dissent" to verify that you have voting power and the dissent is valid.

8. Click "check dissent history" to view your past dissents.

9. Review the proposal details, dissent reason, voting power, and dissent period before executing.

10. Click "exercise dissent" to sign and submit the transaction that records your dissent on-chain.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with any EVM-compatible governance contract that implements a standard dissent interface (getTokenBalance(address) view returns (uint256), getVotingPower(address) view returns (uint256), getDissentPeriod(uint256) view returns (uint256, uint256), getDissentStatus(uint256) view returns (uint8), exerciseDissent(uint256, string) external, getDissentHistory(address) view). The getTokenBalance view returns the user's token holdings. The getVotingPower view returns the user's voting power, which determines the weight of their dissent. The getDissentPeriod view returns the start and end timestamps of the dissent period, during which dissents can be submitted. The exerciseDissent function records the user's dissent with a reason string, validating that the dissent period is open and the user has voting power. The getDissentStatus view returns the current status of the dissent (none, pending, recorded, resolved, rejected). The contract maintains a history of dissents, storing timestamps, proposal IDs, and reasons for audit purposes. Transaction handling follows EIP-1559 gas price calculations using receipt.effectiveGasPrice for accurate cost reporting. Dissent 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 dissent legitimacy — it does not check whether the dissent is based on valid reasoning or concerns. It cannot validate dissent reasons — the tool cannot confirm that the reason provided is accurate or substantive. It cannot detect sybil accounts — the tool cannot identify users who create multiple wallets to submit dissents. It cannot ensure a fair dissent process — the tool does not verify that the dissent process is unbiased or that dissents are given proper consideration. The tool also cannot guarantee that dissent leads to resolution — dissents may be recorded but may not trigger any action or change.

PLEASE NOTE

This tool works exclusively with EVM-compatible blockchain networks (Ethereum, Polygon, Arbitrum, Optimism, Base, etc.). It requires the governance contract to implement the dissent 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. Exercising dissent rights is a formal action that records your objection to a proposal — ensure you have valid reasons and that you are willing to have your dissent recorded on-chain. Dissents are typically time-limited — ensure you exercise your dissent within the dissent period. Consider the potential consequences of dissenting, as it may affect your standing in the community or your future participation in governance.