Cosmos

GitHub: ICosmos

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

Converts 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 must 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

Executes 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