Cosmos - Initia Docs

Overview

The ICosmos interface defines a set of functions for interacting with the Cosmos blockchain from an Ethereum Virtual Machine (EVM) environment. It includes functions for address conversion, querying, and executing Cosmos messages.

Constants

`COSMOS_ADDRESS`

The address of the Cosmos precompile contract.

address constant COSMOS_ADDRESS = 0x00000000000000000000000000000000000000f1;

`COSMOS_CONTRACT`

The instance of the ICosmos contract.

ICosmos constant COSMOS_CONTRACT = ICosmos(COSMOS_ADDRESS);

Functions

`is_blocked_address`

Checks if an address is blocked by the Cosmos SDK bank module.

function is_blocked_address(address account) external view returns (bool blocked);

Parameters

Name	Type	Description
`account`	`address`	The address to check

Returns

Type	Description
`bool`	`true` if the address is blocked, `false` otherwise

`is_module_address`

Checks if an address is a Cosmos SDK module account.

function is_module_address(address account) external view returns (bool module);

Parameters

Name	Type	Description
`account`	`address`	The address to check

Returns

Type	Description
`bool`	`true` if the address is a module account, `false` otherwise

`to_cosmos_address`

Converts an EVM hex format address to a Cosmos bech32 format address.

function to_cosmos_address(address evm_address) external returns (string memory cosmos_address);

Parameters

Name	Type	Description
`evm_address`	`address`	The EVM address to convert

Returns

Type	Description
`string memory`	The corresponding Cosmos address

`to_evm_address`

Convert a Cosmos bech32 format address to an EVM hex format address.

function to_evm_address(string memory cosmos_address) external returns (address evm_address);

Parameters

Name	Type	Description
`cosmos_address`	`string memory`	The Cosmos address to convert

Returns

Type	Description
`address`	The corresponding EVM address

`to_denom`

Converts an ERC20 address to a Cosmos coin denom.

function to_denom(address erc20_address) external returns (string memory denom);

Parameters

Name	Type	Description
`erc20_address`	`address`	The ERC20 address to convert

Returns

Type	Description
`string memory`	The corresponding Cosmos denom

`to_erc20`

Converts a Cosmos coin denom to an ERC20 address.

function to_erc20(string memory denom) external returns (address erc20_address);

Parameters

Name	Type	Description
`denom`	`string memory`	The Cosmos denom to convert

Returns

Type	Description
`address`	The corresponding ERC20 address

`execute_cosmos`

Records a Cosmos message to be executed after the current message execution. The message should be in JSON string format.

function execute_cosmos(string memory msg) external returns (bool dummy);

Parameters

Name	Type	Description
`msg`	`string memory`	The Cosmos message in JSON format

Returns

Type	Description
`bool`	Dummy return value

`query_cosmos`

Queries a whitelisted Cosmos SDK query.

function query_cosmos(string memory path, string memory req) external returns (string memory result);

Parameters

Name	Type	Description
`path`	`string memory`	The query path
`req`	`string memory`	The query request in JSON format

Returns

Type	Description
`string memory`	The query result in JSON format

​Overview

​Constants

​COSMOS_ADDRESS

​COSMOS_CONTRACT

​Functions

​is_blocked_address

​Parameters

​Returns

​is_module_address

​Parameters

​Returns

​to_cosmos_address

​Parameters

​Returns

​to_evm_address

​Parameters

​Returns

​to_denom

​Parameters

​Returns

​to_erc20

​Parameters

​Returns

​execute_cosmos

​Parameters

​Returns

​query_cosmos

​Parameters

​Returns

Overview

Constants

`COSMOS_ADDRESS`

`COSMOS_CONTRACT`

Functions

`is_blocked_address`

Parameters

Returns

`is_module_address`

Parameters

Returns

`to_cosmos_address`

Parameters

Returns

`to_evm_address`

Parameters

Returns

`to_denom`

Parameters

Returns

`to_erc20`

Parameters

Returns

`execute_cosmos`

Parameters

Returns

`query_cosmos`

Parameters

Returns