Send Transactions

Sending a transaction on a Cosmos SDK chain is a multi-step process: you build one or more messages, estimate gas, sign the transaction, broadcast it to a node, and then wait for block inclusion. This guide walks through each step using SigningStargateClient.

Prerequisites

Node.js v22 or later
@cosmjs/stargate and @cosmjs/proto-signing installed
An RPC endpoint for the target chain

npm install @cosmjs/stargate @cosmjs/proto-signing cosmjs-types

yarn add @cosmjs/stargate @cosmjs/proto-signing cosmjs-types

pnpm add @cosmjs/stargate @cosmjs/proto-signing cosmjs-types

Set Up a Signing Client

Create a wallet and connect a signing client. This example uses a mnemonic-based wallet for simplicity — see Local Wallets and Injected Wallets for production options.

import { SigningStargateClient, GasPrice } from "@cosmjs/stargate";
import { DirectSecp256k1HdWallet } from "@cosmjs/proto-signing";

const wallet = await DirectSecp256k1HdWallet.fromMnemonic(
  "your mnemonic words here ...",
  { prefix: "cosmos" },
);
const [{ address: senderAddress }] = await wallet.getAccounts();

const client = await SigningStargateClient.connectWithSigner(
  "https://rpc.my-chain.network",
  wallet,
  { gasPrice: GasPrice.fromString("0.025uatom") },
);

Never hard-code mnemonics in source files. Use environment variables or a secrets manager.

Setting gasPrice in the client options enables "auto" fee estimation for all transactions. Without it, you must pass an explicit StdFee to every transaction method.

Transaction Lifecycle

Every transaction follows these steps:

Build messages — describe what the transaction should do
Estimate gas — simulate execution to determine fees
Sign — produce a cryptographic signature over the transaction bytes
Broadcast — send the signed transaction to a node
Confirm — wait for the transaction to be included in a block

The simplest path combines all steps in a single call:

const result = await client.sendTokens(
  senderAddress,
  "cosmos1recipientaddress...",
  [{ denom: "uatom", amount: "1000000" }],
  "auto",
);

console.info("Tx hash:", result.transactionHash);

The following pages break down each step in detail.

Convenience Methods

SigningStargateClient provides high-level methods for the most common transactions. They construct the message internally and call signAndBroadcast:

const result = await client.sendTokens(
  senderAddress,
  "cosmos1recipientaddress...",
  [{ denom: "uatom", amount: "1000000" }],
  "auto",
  "thanks for lunch",
);

Method	Description
`sendTokens(sender, recipient, amount, fee, memo?)`	Transfer tokens (`MsgSend`)
`delegateTokens(delegator, validator, amount, fee, memo?)`	Delegate to a validator (`MsgDelegate`)
`undelegateTokens(delegator, validator, amount, fee, memo?)`	Undelegate from a validator (`MsgUndelegate`)
`withdrawRewards(delegator, validator, fee, memo?)`	Withdraw staking rewards (`MsgWithdrawDelegatorReward`)

These convenience methods accept the same three fee forms — "auto", a number multiplier, or an explicit StdFee.

Next Steps

Building Messages

Construct message objects for token transfers, staking, and multi-message transactions.

Simulating Gas

Estimate gas with auto fees, manual simulation, or explicit fee objects.

Signing & Broadcasting

Sign and broadcast transactions, or separate the two steps for advanced workflows.

Waiting for Confirmation

Configure polling timeouts and handle transactions that take too long.

Error Handling

Handle CheckTx rejections, execution failures, and timeouts.

Events & Lookups

Read transaction events and look up past transactions by hash or query.

CosmJS

Concepts

Guides

API Reference

Prerequisites

Set Up a Signing Client

Transaction Lifecycle

Convenience Methods

Next Steps

Building Messages

Simulating Gas

Signing & Broadcasting

Waiting for Confirmation

Error Handling

Events & Lookups

​Prerequisites

​Set Up a Signing Client

​Transaction Lifecycle

​Convenience Methods

​Next Steps

Building Messages

Simulating Gas

Signing & Broadcasting

Waiting for Confirmation

Error Handling

Events & Lookups

Prerequisites

Set Up a Signing Client

Transaction Lifecycle

Convenience Methods

Next Steps