Transfer tokens and use IBC

transfer() sends a selected Cosmos denomination with a bank send or an IBC transfer.

Send on the same chain

When the recipient prefix matches the configured addressPrefix, the module broadcasts a Cosmos bank send:

import WalletManagerCosmos from '@base58-io/wdk-wallet-cosmos'

const seedPhrase = process.env.WDK_SEED_PHRASE
if (!seedPhrase) throw new Error('WDK_SEED_PHRASE is required')

const manager = new WalletManagerCosmos(seedPhrase, {
  chainName: 'cosmoshub',
})

try {
  const account = await manager.getAccount(0)
  const transfer = {
    token: 'uatom',
    recipient: 'cosmos1<recipient>',
    amount: 1_000n,
  }

  const applicationMaxFee = 5_000n
  const { fee } = await account.quoteTransfer(transfer)
  if (fee >= applicationMaxFee) {
    throw new Error('Quoted fee meets or exceeds the application limit')
  }

  const result = await account.transfer(transfer)
  console.log({
    hash: result.hash,
    fee: result.fee.toString(),
  })
} finally {
  manager.dispose()
}

Amounts are integer base units. Replace all address, denomination, and fee-limit examples with values validated for the configured chain.

A matching Bech32 prefix is only the module's routing heuristic; it does not prove that the recipient belongs to the same chain.

Configure an IBC transfer

When the recipient prefix differs, map that prefix to a source channel on the configured source chain:

const config = {
  chainName: 'cosmoshub',
  ibcChannels: {
    osmo: {
      sourceChannel: '<source-channel-on-cosmoshub>',
    },
  },
}

Then quote and transfer to the destination-prefix address:

const transfer = {
  token: 'uatom',
  recipient: 'osmo1<recipient>',
  amount: 1_000n,
}

const { fee } = await account.quoteTransfer(transfer)
if (fee >= applicationMaxFee) {
  throw new Error('Quoted fee meets or exceeds the application limit')
}

const result = await account.transfer(transfer)

Keep the manager inside a try/finally lifecycle and call manager.dispose() as shown in the same-chain example.

The released IBC flow:

• keys ibcChannels by destination Bech32 prefix;
• uses the configured mapping as the source channel;
• uses source port transfer;
• uses a fixed 600-second timestamp timeout;
• does not discover routes, validate channel topology, or track packet acknowledgement.

Understand quote limits

quoteTransfer() checks that a channel mapping exists when the prefixes differ. It then calculates a fee from configured gas metadata and the fixed gas limit of 200000.

The quote does not:

• call RPC or simulate gas;
• check the sender balance;
• validate that the channel is open;
• prove that the destination chain or relayer is available;
• validate the complete transfer against current chain state.

See Configuration for channel configuration and Handle errors for ambiguous-write guidance.