Steps to create a proposal

Create a proposal script:

[Option 1] Use release builder tool
- Define the list of change in a YAML file, e.g. release.yaml in aptos-core
- After the YAML file is approved, run cargo run -p aptos-release-builder -- generate-proposals --release-config <PATH_TO_YAML> --output-dir <PATH_TO_OUTPUT_DIR> to generate upgrade scripts
[Option 2] Manual process
- Use the following template:
```
script {
    use aptos_framework::aptos_governance;

    fun main(proposal_id: u64) {
  	    let framework_signer = aptos_governance::resolve(proposal_id, @1);
  			...
  	}
}
```
- Upgrade the framework, the account must match where the package is intended to be published. This will create a proposal in stdlib.move:
```
cargo run -p -- governance generate-upgrade-proposal --account 0x1 --output stdlib.move \
    --package-dir aptos-move/framework/move-stdlib/
```
- Upgrade the gas configuration, this will create a proposal in gas/sources/update_gas_schedule.move:
```
cargo run -p aptos-gas -- --output gas
```
Upload the proposal to this GitHub repository:
- Add the metadata to the metadata folder.
- Add the move file to the sources folder.
- Please ensure consistent and accurate naming for both files.
To create a proposal on-chain, in the aptos-core repo, run

cargo run -p aptos -- governance propose --metadata-url <url-to-metadata-file.json> \
   --pool-address $pool_address --script-path /path/to/proposal.move \
   --framework-local-dir /path/to/aptos-core/aptos-move/framework/aptos-framework/ \
   --is_multi-step \
   --profile mainnet-voter

--is-multi-step is required for proposals that have multiple steps 4. To vote on a proposer, use the UI at https://governance.aptosfoundation.org/ or run cargo run -p aptos -- governance vote --proposal-id <proposal-id> --pool-addresses $pool_address_1,$pool_address_2 --yes/no 5. To execute a proposal that has passed, in the aptos-core repo, run

cargo run -p aptos -- governance execute-proposal --proposal-id <proposal-id> \
   --script-path path/to/proposal.move --max-gas 500000 \
   --framework-local-dir /path/to/aptos-core/aptos-move/framework/aptos-framework/

If the proposal has multiple steps, run the above command for each of the steps (with --script-path pointing to each specific step)

vgao1996 / mainnet-proposals

Steps to create a proposal

About

Languages