Proposal Submission Assistant

WHAT IT DOES

Proposal Submission Assistant is a governance tool that streamlines the process of creating and submitting on-chain governance proposals. Instead of manually encoding calldata, calculating proposal thresholds, and interacting with governor contracts through a block explorer, this tool provides a unified interface for proposal preparation. It reads your token voting power, checks proposal creation requirements (minimum voting power thresholds), and validates that your encoded calldata is properly formatted. The tool then constructs and submits the proposal transaction to the governor contract — including the target address, calldata, description, and optionally a value in ETH — in a single atomic operation.

HOW TO USE

Connect your EVM wallet via the BGWallet bridge. Enter your governor contract address and the target contract address that will execute the proposal. Write a clear description of your proposal in plain text. Enter the encoded function calldata (hex string starting with 0x) that will be executed if the proposal passes. Optionally, specify an ETH value to send with the execution. Click "Validate & Preview" to check your voting power against the proposal threshold, view the calldata size, and estimate gas costs. If validation passes, click "Submit Proposal" to sign and broadcast the transaction. The tool provides a transaction hash for tracking and confirms submission.

TECHNICAL MECHANISM

The tool reads your voting power from the governance token contract associated with the governor using `getVotes` or similar view functions. It calculates the proposal threshold by calling the governor's `proposalThreshold` function. The tool validates calldata format (hex string, even length, 0x prefix) and attempts to decode it using the target contract's ABI if available — otherwise, it checks for basic format compliance. When submitting, the tool encodes the proposal using the governor's `propose` function, which accepts target addresses, calldata arrays, descriptions, and values. The entire operation is atomic — if the transaction fails, the proposal is not created.

WHAT IT CANNOT SEE

This tool cannot guarantee that the proposal will pass the voting period or that the encoded calldata will execute correctly in the target contract. Calldata validation ensures format compliance but cannot verify that the function signature exists in the target contract or that the parameters are correct. The tool also cannot predict voter behavior, quorum attainment, or off-chain coordination that may affect the proposal's success. Always review your calldata carefully and consider testing on a testnet first. This tool is an aid for proposal preparation, not a guarantee of proposal passage or execution safety.

PLEASE NOTE

EVM chains only. This tool relies on the BGWallet connector and will not function on Solana, Tron, Starknet, SUI, TON, Aptos, Bitcoin, Cosmos, or XRP. The user is responsible for ensuring the supplied contract addresses are correct and that the governor supports the `propose` function standard (e.g., OpenZeppelin Governor or similar). Always double-check your calldata and description before submitting — on-chain proposals are generally immutable once created.