wasmd/x/wasm/Governance.md

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 binary
  • InstantiateContractProposal - instantiate a wasm contract
  • MigrateContractProposal - migrate a wasm contract to a new code version
  • UpdateAdminProposal - set a new admin for a contract
  • ClearAdminProposal - 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 type validations

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

Tests

Pull requests