package althea.erc20.v1

Get desktop application:
View/edit binary Protocol Buffers messages

Msg defines the erc20 Msg service.

• rpc ConvertCoin (MsgConvertCoin, MsgConvertCoinResponse)

  tx.proto:14

  ConvertCoin mints a ERC20 representation of the native Cosmos coin denom that is registered on the token mapping.

  message MsgConvertCoin

  tx.proto:47

  MsgConvertCoin defines a Msg to convert a native Cosmos coin to a ERC20 token

  • optional cosmos.base.v1beta1.Coin coin = 1

    Cosmos coin which denomination is registered in a token pair. The coin amount defines the amount of coins to convert.

  • string receiver = 2

    recipient hex address to receive ERC20 token

  • string sender = 3

    cosmos bech32 address from the owner of the given Cosmos coins

  message MsgConvertCoinResponse

  tx.proto:58

  MsgConvertCoinResponse returns no fields

  (message has no fields)

• rpc ConvertERC20 (MsgConvertERC20, MsgConvertERC20Response)

  tx.proto:19

  ConvertERC20 mints a native Cosmos coin representation of the ERC20 token contract that is registered on the token mapping.

  message MsgConvertERC20

  tx.proto:62

  MsgConvertERC20 defines a Msg to convert a ERC20 token to a native Cosmos coin.

  • string contract_address = 1

    ERC20 token contract address registered in a token pair

  • string amount = 2

    amount of ERC20 tokens to convert

  • string receiver = 3

    bech32 address to receive native Cosmos coins

  • string sender = 4

    sender hex address from the owner of the given ERC20 tokens

  message MsgConvertERC20Response

  tx.proto:77

  MsgConvertERC20Response returns no fields

  (message has no fields)

• rpc SendCoinToEVM (MsgSendCoinToEVM, MsgSendCoinToEVMResponse)

  tx.proto:27

  SendCoinToEVM is a simplified version of ConvertCoin, meant for use by machine accounts and the gasfree module. It sends Cosmos coins to the EVM layer where they become ERC20s. It only works for certain whitelisted tokens and will claim a fee separately from the standard tx fee deduction, much like the MsgMicrotx from the microtx module.

  message MsgSendCoinToEVM

  tx.proto:84

  MsgSendCoinToEVM will send a whitelisted Cosmos coin to the EVM layer, where it becomes an ERC20. This message is meant for use with machine accounts, and so ordinary fees will not be collected for this tx, instead charging a fee in the Msg handler. You most likely want to use MsgConvertCoin instead. The receiving address on the EVM side will be converted from the sender address.

  • optional cosmos.base.v1beta1.Coin coin = 1

    The amount and denomination of the Cosmos layer coins to send to the EVM. The denom must be whitelisted and registered in a token pair for this to work.

  • string sender = 2

    Cosmos bech32 address of the sender, who must own the coins being sent and sign the message.

  message MsgSendCoinToEVMResponse

  tx.proto:92

  (message has no fields)

• rpc SendERC20ToCosmos (MsgSendERC20ToCosmos, MsgSendERC20ToCosmosResponse)

  tx.proto:35

  SendERC20ToCosmos is a simplified version of ConvertERC20, meant for use by machine accounts and the gasfree module. It sends ERC20 tokens to the Cosmos layer where they become Coins. It only works for certain whitelisted tokens and will claim a fee separately from the standard tx fee deduction, much like the MsgMicrotx from the microtx module.

  message MsgSendERC20ToCosmos

  tx.proto:99

  MsgSendERC20ToCosmos will send a whitelisted ERC20 to the Cosmos layer, where it becomes a Cosmos coin. This message is meant for use with machine accounts, and so ordinary fees will not be collected for this tx, instead charging a fee in the Msg handler. You most likely want to use MsgConvertERC20 instead. The receiving address on the Cosmos side will be converted from the sender address.

  • string erc20 = 1

    The contract address of the ERC20 token to convert to Cosmos coins. This contract must be whitelisted and registered in a token pair for this to work.

  • string amount = 2

    The amount of the ERC20 token to convert to Cosmos coins.

  • string sender = 3

    The hex address of the sender, who must own the ERC20 tokens being converted and sign the message.

  message MsgSendERC20ToCosmosResponse

  tx.proto:112

  (message has no fields)

• rpc SendERC20ToCosmosAndIBCTransfer (MsgSendERC20ToCosmosAndIBCTransfer, MsgSendERC20ToCosmosAndIBCTransferResponse)

  tx.proto:41

  SendERC20ToCosmosAndIBCTransfer is just like UnwrapERC20, but also queues an IBC MsgTransfer to send to another chain. This is also intended for use with the gasfree module and claims fees like MsgMicrotx.

  message MsgSendERC20ToCosmosAndIBCTransfer

  tx.proto:121

  MsgSendERC20ToCosmosAndIBCTransfer will send a whitelisted ERC20 to the Cosmos layer and also queue an IBC transfer to the specified destination. This message is meant for use with machine accounts, and so ordinary fees will not be collected for this tx, instead charging a fee in the Msg handler. You most likely want to use MsgConvertERC20 + MsgTransfer instead. The receiving address on the Cosmos side will be converted from the sender address. WARNING: This message MAY cause a loss of tokens if the IBC transfer is to a chain which does not support Ethermint-style private keys. Use with caution.

  • string erc20 = 1

    The contract address of the ERC20 token to convert to Cosmos coins. This contract must be whitelisted and registered in a token pair for this to work.

  • string amount = 2

    The amount of the ERC20 token to convert to Cosmos coins.

  • string sender = 3

    The hex address of the sender, who must own the ERC20 tokens being converted and sign the message.

  • string destination_port = 4

    The IBC destination port

  • string destination_channel = 5

    The IBC destination channel

  • string destination_receiver = 6

    The IBC destination receiver bech32 address, with the destination chain's bech32 prefix

  message MsgSendERC20ToCosmosAndIBCTransferResponse

  tx.proto:140

  (message has no fields)

Query defines the gRPC querier service.

• rpc Params (QueryParamsRequest, QueryParamsResponse)

  query.proto:25

  Params retrieves the erc20 module params

  message QueryParamsRequest

  query.proto:59

  QueryParamsRequest is the request type for the Query/Params RPC method.

  (message has no fields)

  message QueryParamsResponse

  query.proto:63

  QueryParamsResponse is the response type for the Query/Params RPC method.

  • optional Params params = 1

• rpc TokenPair (QueryTokenPairRequest, QueryTokenPairResponse)

  query.proto:20

  TokenPair retrieves a registered token pair

  message QueryTokenPairRequest

  query.proto:46

  QueryTokenPairRequest is the request type for the Query/TokenPair RPC method.

  • string token = 1

    token identifier can be either the hex contract address of the ERC20 or the Cosmos base denomination

  message QueryTokenPairResponse

  query.proto:54

  QueryTokenPairResponse is the response type for the Query/TokenPair RPC method.

  • optional TokenPair token_pair = 1

• rpc TokenPairs (QueryTokenPairsRequest, QueryTokenPairsResponse)

  query.proto:15

  TokenPairs retrieves registered token pairs

  message QueryTokenPairsRequest

  query.proto:32

  QueryTokenPairsRequest is the request type for the Query/TokenPairs RPC method.

  • optional cosmos.base.query.v1beta1.PageRequest pagination = 1

    pagination defines an optional pagination for the request.

  message QueryTokenPairsResponse

  query.proto:39

  QueryTokenPairsResponse is the response type for the Query/TokenPairs RPC method.

  • repeated TokenPair token_pairs = 1

  • optional cosmos.base.query.v1beta1.PageResponse pagination = 2

    pagination defines the pagination in the response.

GenesisState defines the module's genesis state.

• optional Params params = 1

  module parameters

• repeated TokenPair token_pairs = 2

  registered token pairs

Owner enumerates the ownership of a ERC20 contract.

Used in: TokenPair

• OWNER_UNSPECIFIED = 0

  OWNER_UNSPECIFIED defines an invalid/undefined owner.

• OWNER_MODULE = 1

  OWNER_MODULE erc20 is owned by the erc20 module account.

• OWNER_EXTERNAL = 2

  EXTERNAL erc20 is owned by an external account.

Params defines the erc20 module params

Used in: GenesisState, QueryParamsResponse

• bool enable_erc20 = 1

  parameter to enable the conversion of Cosmos coins <--> ERC20 tokens.

• bool enable_evm_hook = 2

  parameter to enable the EVM hook that converts an ERC20 token to a Cosmos Coin by transferring the Tokens through a MsgEthereumTx to the ModuleAddress Ethereum address.

RegisterCoinProposal is a gov Content type to register a token pair for a native Cosmos coin.

• string title = 1

  title of the proposal

• string description = 2

  proposal description

• optional cosmos.bank.v1beta1.Metadata metadata = 3

  metadata of the native Cosmos coin

RegisterERC20Proposal is a gov Content type to register a token pair for an ERC20 token

• string title = 1

  title of the proposa string title = 1;

• string description = 2

  proposal description

• string erc20address = 3

  contract address of ERC20 token

ToggleTokenConversionProposal is a gov Content type to toggle the conversion of a token pair.

• string title = 1

  title of the proposal

• string description = 2

  proposal description

• string token = 3

  token identifier can be either the hex contract address of the ERC20 or the Cosmos base denomination

TokenPair defines an instance that records a pairing consisting of a native Cosmos Coin and an ERC20 token address.

Used in: GenesisState, QueryTokenPairResponse, QueryTokenPairsResponse

• string erc20_address = 1

  address of ERC20 contract token

• string denom = 2

  cosmos base denomination to be mapped to

• bool enabled = 3

  shows token mapping enable status

• Owner contract_owner = 4

  ERC20 owner address ENUM (0 invalid, 1 ModuleAccount, 2 external address)