Cooperative Membership Share Transfer Tool

WHAT IT DOES

Cooperative Membership Share Transfer Tool is a DAO tool that facilitates the transfer of membership shares within a cooperative. It reads the cooperative contract address, member addresses and share balances, share transfer approval status, transfer restrictions (minimum holding period and approval requirements), share price and valuation, governance parameters, transfer history, account nonce, gas estimates for transfer, and previous transfer records. The tool then guides members through submitting a share transfer request, obtaining governance approval, executing the share transfer, updating member share balances, and recording the transfer on-chain.

HOW TO USE

Connect your wallet via the built-in connector. Select the network where the cooperative contract is deployed. Enter the cooperative contract address, the buyer's address, the number of shares to transfer, the share price (in the payment token), and the payment token address (use address(0) for native token). The tool will read on-chain data and display a preview including: cooperative contract, buyer, shares, share price, payment token, your share balance, transfer approval status, restrictions, and estimated gas. Review all details carefully. Click "request share transfer" to submit the transfer request. The tool will guide you through three steps: submitting the transfer request, awaiting governance approval, and executing the transfer.

TECHNICAL MECHANISM

The tool uses ethers.js v5.7.2 to interact with the cooperative contract. It reads member share balances using `getShares(member)` or `balanceOf(member)`. Transfer approval status is checked using `getTransferApproval(transferId)` which returns pending/approved/rejected. Transfer restrictions are read via `getTransferRestrictions()` which returns the minimum holding period and approval requirements. Share price is read using `getSharePrice()` which returns the current valuation. Governance parameters are read using `votingPeriod()`, `quorum()`, and `proposalThreshold()`. Transfer history is scanned using `eth_getLogs` for `ShareTransferRequested` and `ShareTransferExecuted` 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 transfer transaction calls `requestShareTransfer(buyer, amount, price)` which submits the request to governance. After approval, the tool calls `executeShareTransfer(transferId)` which transfers the shares and updates balances. 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 the transfer complies with off‑chain cooperative bylaws—it only follows on‑chain rules. It cannot detect if members are misrepresenting their identity. It cannot guarantee that share valuation is accurate—valuation is based on the contract's calculation. It cannot prevent front‑running of transfer requests. It cannot validate that the buyer meets membership criteria—this is a governance decision. It cannot detect if the cooperative contract has been modified. It cannot ensure that transfer restrictions are enforced off‑chain. It cannot verify that share ownership is recognized off‑chain.

PLEASE NOTE

This tool is EVM-only and supports Ethereum, Polygon, BNB Chain, Arbitrum, Optimism, and Avalanche. Transfer requests are submitted by the connected wallet, and the user pays gas fees. Share transfers may require governance approval and are subject to cooperative bylaws. The tool does not store or transmit any member data. Always verify transfer restrictions and governance requirements before initiating a transfer.