A chain-agnostic CLI tool for interacting with Cosmos SDK blockchains.
You can install the CLI tool globally using npm, yarn, or pnpm:
# Using npm
npm install -g cosmcli
# Using yarn
yarn global add cosmcli
# Using pnpm
pnpm add -g cosmcliAlternatively, you can use it directly without installation using npx:
npx cosmcli <command>- IBC transfers between Cosmos chains
- Chain-agnostic design (works with any Cosmos SDK chain)
- Simple and intuitive command-line interface
Transfer tokens from one chain to another using IBC.
cosmcli ibc-transfer [options]--rpc <rpc>: RPC URL of the source chain--seed <seed>: Seed phrase/mnemonic for the sender's wallet--prefix <prefix>: Bech32 address prefix of the source chain (e.g.,"cosmos","stride","osmo")--gas-price <gasPrice>: Gas price per unit (e.g.,"0.025uatom")--receiver <receiver>: Destination address to receive tokens--amount <amount>: Amount to transfer (e.g.,"10uatom")--src-channel <srcChannel>: Source channel ID for the IBC transfer
--gas-adjustment <gasAdjustment>: Gas multiplier for transaction simulation (default:"1.4")-v, --verbose: Enable verbose logging (default:false)--src-port <srcPort>: Source port for IBC (default:"transfer")--timeout <timeout>: Timeout in seconds (default:"180")--memo <memo>: Transaction memo (default:"")
cosmcli ibc-transfer \
--rpc https://rpc.cosmos.network \
--seed "your mnemonic words here" \
--prefix cosmos \
--gas-price 0.025uatom \
--receiver osmo1yourosmoaddress \
--amount 10uatom \
--src-channel channel-141On successful IBC transfer, the tool outputs a JSON object containing:
tx: Transaction hash on the source chainibcAck: IBC acknowledgement transaction hash
Example output:
{ "tx": "ABC123DEF456GHI789JKL", "ibcAck": "MNO123PQR456STU789VWX" }If an error occurs, the program will:
- Print an error message to stderr
- Exit with a non-zero status code (1)
With the --verbose flag, additional error details and stack traces are provided.