Skip to content

Latest commit

 

History

History
150 lines (96 loc) · 6.65 KB

README.md

File metadata and controls

150 lines (96 loc) · 6.65 KB
Raw

Rust

This Repo contains the smart contracts for ICON-IBC in rust.

Standard Libraries

Crate Usage Download
cosmwasm-schema Contract Development cosmwasm-schema on crates.io
cosmwasm-std Contract Development cosmwasm-std on crates.io
cosmwasm-storage Contract Development cosmwasm-storage on crates.io
Specification Crates.io Coverage
cw-ibc-core ibc on crates.io codecov
cw-icon-light-client ibc on crates.io codecov
cw-xcall ibc on crates.io codecov

Prerequiste

  • To install Rust in Linux/Mac,

First, install rustup. Once installed, make sure you have the wasm32 target:

rustup default stable
cargo version
# If this is lower than 1.55.0+, update
rustup update stable

rustup target list --installed
rustup target add wasm32-unknown-unknown

For windows, Download and run, rustup-init.exe

Build Contracts

  • Execute the following command to compile the contract

    cargo wasm

  • Optimise using cargo, by giving the following command

    RUSTFLAGS='-C link-arg=-s' cargo wasm

  • Deploy the contract on testnet

    // add the wasm binary file path in <path>

RES=$(archwayd tx wasm store <path> --from wallet --chain-id constantine-2 --node https://rpc.constantine-2.archway.tech:443/ --fees 3397uconst --gas auto -y --output json -b block)

  • Getting CodeId from RES

    CODE_ID=$(echo $RES | jq -r '.logs[0].events[-1].attributes[1].value')

  • To instantiate the contract

    archwayd tx wasm instantiate $CODE_ID "{}" --from wallet --gas auto --label "ics20" --no-admin --chain-id constantine-2 --node https://rpc.constantine-2.archway.tech:443/ --fees 300uconst -y

  • Getting the contract address

    CONTRACT=$(archwayd query wasm list-contract-by-code 4 --output json | jq -r '.contracts[-1]')

  • To Query the contract

    archwayd query wasm contract-state smart $CONTRACT '{"method_name":{}}' --output json

  • To execute methods in contract

    archwayd tx wasm execute $CONTRACT '{"method_name":{}}' --from wallet --chain-id constantine-2 --output json

Checking contract validity

When the contract is built, the last step is to ensure it is valid CosmWasm contract is to call check_contract on it.

$ cargo wasm
...
$ check_contract ./target/wasm32-unknown-unknown/release/contract.wasm
Supported features: {"iterator", "staking", "stargate"}
contract checks passed.

Contracts

cw-xCall :

The xCall contract in Inter-Blockchain Communication (IBC) protocol facilitate cross-chain communication and token transfers between different blockchain networks. This is designed to act as a gateway between two blockchains, allowing them to securely communicates with each other and transfer assets.

cw-ibc-core :

IBC-Core is the reference implementation of the Inter-Blockchain Communication (IBC) protocol, which is a standardized protocol for enabling communication and interoperability between independent blockchain networks.

  • ics02_client :

    ICS02-Client is a module in the IBC-Core that provides a standard interface and protocol for verifying the state of a remote chain in the Inter-Blockchain Communication (IBC) protocol.

  • ics03_connection :

    ICS03-Connection is a module in the IBC-Core that provides a standard interface and protocol for establishing a connection between two independent blockchain networks in the Inter-Blockchain Communication (IBC) protocol. It is designed to ensure secure and reliable communication between connected chains, enabling cross-chain asset transfers and other types of communication.

  • ics04_channel :

    The ICS04-Channel module works by creating a unidirectional or bidirectional communication channel between two chains, depending on the requirements of the use case. It negotiates the parameters of the channel, such as the channel ID, packet ordering, and reliability guarantees, and establishes a set of state machine rules that govern the behavior of the channel.

  • ics05_port :

    This concrete implementation defines types and methods with which modules can bind to uniquely named ports allocated by the IBC handler.

  • ics24_host :

    ICS24 is a module in the InterBlockchain Communication (IBC) protocol stack that facilitates the transfer of tokens and other data between independent blockchain networks.

  • ics26_routing :

    ICS26 is a module in the Inter-Blockchain Communication (IBC) protocol stack that defines the routing of packets between independent blockchain networks. It provides a mechanism for packets to be routed through a sequence of intermediate relayers until they reach their destination on the target blockchain network.

cw-icon-light-client :

The icon-light-client in IBC enables blockchain networks to communicate with each other without having to trust each other. This is achieved by using the cryptographic proofs to verify that transactions are valid and have been executed correctly.

Unit Testing

cd <contract>
cargo test

References