Community Land Trust Token Governance Tool

WHAT IT DOES

Community Land Trust Token Governance Tool is a DAO governance tool designed for community land trusts (CLTs) that use tokenized land parcels. It reads the land trust contract address, land parcel token IDs and metadata, member token balances, governance proposal details, voting power distribution, land use restrictions, transfer restrictions, community vote history, account nonce, gas estimates for governance actions, and previous governance records. The tool then guides members through submitting governance proposals, voting on proposals, executing approved proposals, updating land use permissions, transferring land trust tokens, and updating member voting power.

HOW TO USE

Connect your wallet via the built-in connector. Select the network where the land trust contract is deployed. Enter the land trust contract address, the land parcel token ID you wish to govern, a proposal action description, the proposal target (address or value), your voting power (tokens held), and the payment token address (use address(0) for native token). The tool will read on-chain data and display a preview including: land trust, parcel ID, parcel metadata, proposal action, proposal target, your voting power, payment token, land use restrictions, transfer restrictions, vote history, and estimated gas. Review all details carefully. Click "submit proposal & vote" to submit the governance proposal and cast your vote. The tool will guide you through three steps: submitting the proposal, casting your vote, and executing the proposal if approved.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the land trust contract. It reads land parcel metadata using `getParcelMetadata(tokenId)` which returns location, size, and zoning information. Member token balances are read via `balanceOf(member)` on the land trust token. Governance proposal details are read using `getProposal(proposalId)` which returns the action, target, and status. Voting power distribution is read via `getVotingPower(member)` which returns the weight of the member's vote based on token holdings. Land use restrictions are read using `getLandUseRestrictions(tokenId)` which returns permitted uses. Transfer restrictions are read via `getTransferRestrictions(tokenId)` which returns approval requirements. Vote history is scanned using `eth_getLogs` for `ProposalSubmitted` and `VoteCast` events, with adaptive chunking (halving chunk size on failure) to handle different RPC limits—the tool walks backward from the current block and continues even if some ranges are rejected. The governance transaction calls `submitProposal(action, target)` and then `vote(proposalId, support)` on the contract. Gas estimates are calculated using `estimateGas` with EIP-1559 fee data from `feeData`. All transactions are built with EIP-1559 fee data, and the tool uses `effectiveGasPrice` from receipts for accurate cost accounting.

WHAT IT CANNOT SEE

This tool cannot verify that land parcel data is accurate off-chain—it reads on-chain metadata only. It cannot detect if members are misrepresenting their identity. It cannot guarantee that land use restrictions are enforced off-chain. It cannot prevent front-running of governance proposals. It cannot validate that voting power is correctly calculated—it relies on the contract's calculation. It cannot detect if the land trust contract has been modified. It cannot ensure that governance decisions are legally binding. It cannot verify that land parcel ownership is recognized off-chain.

PLEASE NOTE

This tool is EVM-only and supports Ethereum, Polygon, BNB Chain, Arbitrum, Optimism, and Avalanche. Governance actions are signed by the connected wallet, and the user pays gas fees. Land trust governance involves real-world implications—ensure you understand the legal framework before submitting proposals. The tool does not store or transmit any land data. Always verify land parcel details through official sources.