4.7 KiB
Governance
This document gives an overview of how the various governance proposals interact with the CosmWasm contract lifecycle. It is a high-level, technical introduction meant to provide context before looking into the code, or constructing proposals.
Proposal Types
We have added 5 new wasm specific proposal types that cover the contract's live cycle and authorization:
StoreCodeProposal
- upload a wasm binaryInstantiateContractProposal
- instantiate a wasm contractMigrateContractProposal
- migrate a wasm contract to a new code versionUpdateAdminProposal
- set a new admin for a contractClearAdminProposal
- clear admin for a contract to prevent further migrations
For details see the proposal type implementation
A wasm message but no proposal type:
ExecuteContract
- execute a command on a wasm contract
Unit tests
Proposal Handler
The wasmd proposal_handler implements the gov.Handler
function
and executes the wasmd proposal types after a successful tally.
The proposal handler uses a GovAuthorizationPolicy
to bypass the existing contract's authorization policy.
Tests
Gov Integration
The wasmd proposal handler can be added to the gov router in the abci app to receive proposal execution calls.
govRouter.AddRoute(wasm.RouterKey, wasm.NewWasmProposalHandler(app.wasmKeeper, enabledProposals))
Wasmd Authorization Settings
Settings via sdk params
module:
code_upload_access
- who can upload a wasm binary:Nobody
,Everybody
,OnlyAddress
instantiate_default_permission
- platform default, who can instantiate a wasm binary when the code owner has not set it
See params.go
Init Params Via Genesis
"wasm": {
"params": {
"code_upload_access": {
"permission": "Everybody"
},
"instantiate_default_permission": "Everybody"
}
},
The values can be updated via gov proposal implemented in the params
module.
Enable gov proposals at compile time.
As gov proposals bypass the existing authorzation policy they are diabled and require to be enabled at compile time.
-X github.com/CosmWasm/wasmd/app.ProposalsEnabled=true - enable all x/wasm governance proposals (default false)
-X github.com/CosmWasm/wasmd/app.EnableSpecificProposals=MigrateContract,UpdateAdmin,ClearAdmin - enable a subset of the x/wasm governance proposal types (overrides ProposalsEnabled)
Tests
CLI
wasmd tx gov submit-proposal [command]
Available Commands:
wasm-store Submit a wasm binary proposal
instantiate-contract Submit an instantiate wasm contract proposal
migrate-contract Submit a migrate wasm contract to a new code version proposal
set-contract-admin Submit a new admin for a contract proposal
clear-contract-admin Submit a clear admin for a contract to prevent further migrations proposal
...
Rest
New ProposalHandlers
- Integration
gov.NewAppModuleBasic(append(wasmclient.ProposalHandlers, paramsclient.ProposalHandler, distr.ProposalHandler, upgradeclient.ProposalHandler)...),
In abci app