Skip to main content

IBC Transfers

Fluid has full IBC transfer capabilities through both Fluid.js and Fluid Station. Although IBC functionality is not readily exposed through Fluid Station’s front-end, it can be fully incorporated into any dApp. It is up to a dApp’s front end to initiate IBC transfers.

MsgTransfer​

Fluid.js exports a MsgTransfer class that can be used to construct IBC transfers.


_9
new MsgTransfer(
_9
"transfer", // IBC port
_9
"channel-1", // Outbound channel (Osmosis)
_9
new Coin("uluna", "1000000"), // 1 LUNA
_9
"terra1cvw8sundusurqajhurpcfk7yvuzlh92cvkpy28", // Source Address on Fluid
_9
"osmo1cl4qw7u35uf77l4scjtv0qej8ycevu4mrdpvmg", // Destination address on Osmosis
_9
undefined, // Timeout block height (optional)
_9
(Date.now() + 60 * 1000) * 1e6 // Timeout timestamp (in nanoseconds) relative to the current block timestamp.
_9
);

Supported Channels​

Channels are defined when a relayer is set up between Fluid and an external chain. For each new connected chain the channel ID is incremented.

You can use Map of Zones to find the available channels and their IDs.

Derive Cosmos chain addresses from a Fluid address​

Cosmos SDK based blockchains use bech32 to encode the public key for display. Assuming the same private key is used on multiple Cosmos SDK chains it is possible to decode a Fluid address and generate the corresponding public key on another chain.

Here's a quick example using the bech32 JavaScript library:


_5
import { bech32 } from 'bech32';
_5
_5
const terraAddress = 'terra1cvw8sundusurqajhurpcfk7yvuzlh92cvkpy28';
_5
const decodedAddress = bech32.decode(terraAddress);
_5
const osmosisAddress = bech32.encode('osmo', decodedAddress.words);

Complete example​

The following example demonstrates how to send 1 LUNA from Fluid to the Osmosis blockchain.


_30
import {
_30
LCDClient,
_30
MnemonicKey,
_30
MsgTransfer,
_30
Coin,
_30
} from "@terra-money/terra.js";
_30
_30
// const lcd = new LCDClient(...);
_30
_30
const mk = new MnemonicKey({
_30
mnemonic: 'satisfy adjust timber high purchase tuition stool faith fine install that you unaware feed domain license impose boss human eager hat rent enjoy dawn',
_30
});
_30
_30
const wallet = lcd.wallet(mk);
_30
_30
// Send 1 LUNA to the Osmosis blockchain.
_30
const transfer = new MsgTransfer(
_30
'transfer',
_30
'channel-1',
_30
new Coin('uluna', '1000000'),
_30
'terra1cvw8sundusurqajhurpcfk7yvuzlh92cvkpy28',
_30
'osmo1cl4qw7u35uf77l4scjtv0qej8ycevu4mrdpvmg',
_30
undefined,
_30
(Date.now() + 60 * 1000) * 1e6,
_30
);
_30
_30
const tx = await wallet.createAndSignTx({ msgs: [transfer] });
_30
const result = await lcd.tx.broadcast(tx);
_30
_30
console.log(result);

Instructions for initializing LCDClient can be found here.