0g-chain/x/evmutil/spec/05_params.md

<!--
order: 5
-->

# Parameters

The evmutil module contains the following parameters:

| Key                    | Type                                 | Example       |
| ---------------------- | ------------------------------------ | ------------- |
| EnabledConversionPairs | array (ConversionPair)               | [{see below}] |
| AllowedCosmosDenoms    | array (AllowedCosmosCoinERC20Tokens) | [{see below}] |

Example parameters for `ConversionPair`:

| Key                | Type   | Example                                      | Description                        |
| ------------------ | ------ | -------------------------------------------- | ---------------------------------- |
| kava_erc20_Address | string | "0x43d8814fdfb9b8854422df13f1c66e34e4fa91fd" | ERC20 contract address             |
| denom              | string | "erc20/chain/usdc"                           | sdk.Coin denom for the ERC20 token |

Example parameters for `AllowedCosmosCoinERC20Token`:

| Key          | Type   | Example                                                                | Description                                         |
| ------------ | ------ | ---------------------------------------------------------------------- | --------------------------------------------------- |
| cosmos_denom | string | "ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2" | denom of the sdk.Coin                               |
| name         | string | "Kava-wrapped Atom"                                                    | name field of the erc20 token                       |
| symbol       | string | "kATOM"                                                                | symbol field of the erc20 token                     |
| decimals     | uint32 | 6                                                                      | decimals field of the erc20 token, for display only |

## EnabledConversionPairs

The enabled conversion pairs parameter is an array of ConversionPair entries mapping an erc20 address to a sdk.Coin denom. Only erc20 contract addresses that are in this list can be converted to sdk.Coin and vice versa.

## AllowedCosmosDenoms

The allowed cosmos denoms parameter is an array of AllowedCosmosCoinERC20Token entries. They include the cosmos-sdk.Coin denom and metadata for the ERC20 representation of the asset in Kava's EVM. Coins may only be transferred to the EVM if they are included in this list. A token in this list will have an ERC20 token contract deployed on first conversion. The token will be deployed with the metadata included in the AllowedCosmosCoinERC20Token. Once deployed, changes to the metadata will not affect or change the deployed contract.
update evmutil specs (#1356) 2022-11-03 15:16:16 +00:00			`<!--`
			`order: 5`
			`-->`

			`# Parameters`

			`The evmutil module contains the following parameters:`

feat(evmutil): add allow list for evm-convertible sdk denoms (#1590) * add proto for allowed sdk denoms -> evm conversion * add validation for AllowedNativeCoinERC20Token * add validation for AllowedNativeCoinERC20Tokens * add AllowedNativeDenoms into params & genesis * add evmutil Params.Validate() test * fix eip712 ante test * update changelog * update internal testnet genesis.json * update state & param specs updates to the sections describing functionality will be updated once that functionality actually exists... :) * update field decimal -> decimals field now matches erc20 spec * add validation decimals will cast to uint8 * add v2 store migration for evmutil * create & register evmutil migrations * adds migrator to evmutil's keeper * sets up Migrate1To2 migration * registers migration in module * updates GetParams to properly handle historic block queries * add unit test for GetParams with historic store 2023-05-19 23:01:46 +00:00			`\| Key \| Type \| Example \|`
			`\| ---------------------- \| ------------------------------------ \| ------------- \|`
			`\| EnabledConversionPairs \| array (ConversionPair) \| [{see below}] \|`
update new names, NativeCoin -> CosmosCoin (#1596) * rename contract NativeCoin -> CosmosCoin * rename all entities NativeCoin -> CosmosCoin * update changelog * update protonet genesis.json 2023-05-23 19:32:27 +00:00			`\| AllowedCosmosDenoms \| array (AllowedCosmosCoinERC20Tokens) \| [{see below}] \|`
update evmutil specs (#1356) 2022-11-03 15:16:16 +00:00
			Example parameters for `ConversionPair`:

			`\| Key \| Type \| Example \| Description \|`
			`\| ------------------ \| ------ \| -------------------------------------------- \| ---------------------------------- \|`
			`\| kava_erc20_Address \| string \| "0x43d8814fdfb9b8854422df13f1c66e34e4fa91fd" \| ERC20 contract address \|`
			`\| denom \| string \| "erc20/chain/usdc" \| sdk.Coin denom for the ERC20 token \|`

update new names, NativeCoin -> CosmosCoin (#1596) * rename contract NativeCoin -> CosmosCoin * rename all entities NativeCoin -> CosmosCoin * update changelog * update protonet genesis.json 2023-05-23 19:32:27 +00:00			Example parameters for `AllowedCosmosCoinERC20Token`:
feat(evmutil): add allow list for evm-convertible sdk denoms (#1590) * add proto for allowed sdk denoms -> evm conversion * add validation for AllowedNativeCoinERC20Token * add validation for AllowedNativeCoinERC20Tokens * add AllowedNativeDenoms into params & genesis * add evmutil Params.Validate() test * fix eip712 ante test * update changelog * update internal testnet genesis.json * update state & param specs updates to the sections describing functionality will be updated once that functionality actually exists... :) * update field decimal -> decimals field now matches erc20 spec * add validation decimals will cast to uint8 * add v2 store migration for evmutil * create & register evmutil migrations * adds migrator to evmutil's keeper * sets up Migrate1To2 migration * registers migration in module * updates GetParams to properly handle historic block queries * add unit test for GetParams with historic store 2023-05-19 23:01:46 +00:00
feat(evmutil)!: implement MsgConvertCosmosCoinToERC20 (#1603) * feat(evmutil): implement MsgConvertCosmosCoinToERC20 * docs(evmutil): update module spec * update changelog * rename conversion -> conversion_evm_native * refactor ConvertCosmosCoinToERC20 to keeper method * add CLI cmd for MsgConvertCosmosCoinToERC20 * updates from pr 2023-05-30 19:00:01 +00:00			`\| Key \| Type \| Example \| Description \|`
			`\| ------------ \| ------ \| ---------------------------------------------------------------------- \| --------------------------------------------------- \|`
			`\| cosmos_denom \| string \| "ibc/27394FB092D2ECCD56123C74F36E4C1F926001CEADA9CA97EA622B25F41E5EB2" \| denom of the sdk.Coin \|`
			`\| name \| string \| "Kava-wrapped Atom" \| name field of the erc20 token \|`
			`\| symbol \| string \| "kATOM" \| symbol field of the erc20 token \|`
			`\| decimals \| uint32 \| 6 \| decimals field of the erc20 token, for display only \|`
feat(evmutil): add allow list for evm-convertible sdk denoms (#1590) * add proto for allowed sdk denoms -> evm conversion * add validation for AllowedNativeCoinERC20Token * add validation for AllowedNativeCoinERC20Tokens * add AllowedNativeDenoms into params & genesis * add evmutil Params.Validate() test * fix eip712 ante test * update changelog * update internal testnet genesis.json * update state & param specs updates to the sections describing functionality will be updated once that functionality actually exists... :) * update field decimal -> decimals field now matches erc20 spec * add validation decimals will cast to uint8 * add v2 store migration for evmutil * create & register evmutil migrations * adds migrator to evmutil's keeper * sets up Migrate1To2 migration * registers migration in module * updates GetParams to properly handle historic block queries * add unit test for GetParams with historic store 2023-05-19 23:01:46 +00:00
update evmutil specs (#1356) 2022-11-03 15:16:16 +00:00			`## EnabledConversionPairs`

			`The enabled conversion pairs parameter is an array of ConversionPair entries mapping an erc20 address to a sdk.Coin denom. Only erc20 contract addresses that are in this list can be converted to sdk.Coin and vice versa.`
feat(evmutil): add allow list for evm-convertible sdk denoms (#1590) * add proto for allowed sdk denoms -> evm conversion * add validation for AllowedNativeCoinERC20Token * add validation for AllowedNativeCoinERC20Tokens * add AllowedNativeDenoms into params & genesis * add evmutil Params.Validate() test * fix eip712 ante test * update changelog * update internal testnet genesis.json * update state & param specs updates to the sections describing functionality will be updated once that functionality actually exists... :) * update field decimal -> decimals field now matches erc20 spec * add validation decimals will cast to uint8 * add v2 store migration for evmutil * create & register evmutil migrations * adds migrator to evmutil's keeper * sets up Migrate1To2 migration * registers migration in module * updates GetParams to properly handle historic block queries * add unit test for GetParams with historic store 2023-05-19 23:01:46 +00:00
update new names, NativeCoin -> CosmosCoin (#1596) * rename contract NativeCoin -> CosmosCoin * rename all entities NativeCoin -> CosmosCoin * update changelog * update protonet genesis.json 2023-05-23 19:32:27 +00:00			`## AllowedCosmosDenoms`
feat(evmutil): add allow list for evm-convertible sdk denoms (#1590) * add proto for allowed sdk denoms -> evm conversion * add validation for AllowedNativeCoinERC20Token * add validation for AllowedNativeCoinERC20Tokens * add AllowedNativeDenoms into params & genesis * add evmutil Params.Validate() test * fix eip712 ante test * update changelog * update internal testnet genesis.json * update state & param specs updates to the sections describing functionality will be updated once that functionality actually exists... :) * update field decimal -> decimals field now matches erc20 spec * add validation decimals will cast to uint8 * add v2 store migration for evmutil * create & register evmutil migrations * adds migrator to evmutil's keeper * sets up Migrate1To2 migration * registers migration in module * updates GetParams to properly handle historic block queries * add unit test for GetParams with historic store 2023-05-19 23:01:46 +00:00
update new names, NativeCoin -> CosmosCoin (#1596) * rename contract NativeCoin -> CosmosCoin * rename all entities NativeCoin -> CosmosCoin * update changelog * update protonet genesis.json 2023-05-23 19:32:27 +00:00			The allowed cosmos denoms parameter is an array of AllowedCosmosCoinERC20Token entries. They include the cosmos-sdk.Coin denom and metadata for the ERC20 representation of the asset in Kava's EVM. Coins may only be transferred to the EVM if they are included in this list. A token in this list will have an ERC20 token contract deployed on first conversion. The token will be deployed with the metadata included in the AllowedCosmosCoinERC20Token. Once deployed, changes to the metadata will not affect or change the deployed contract.