Skip to main content

babylond tx

Comprehensive transaction system for interacting with the Babylon blockchain.

Overview

The babylond tx command provides access to all transaction functionality on the Babylon blockchain. Transactions are used to modify blockchain state, including transferring tokens, staking, governance participation, Bitcoin staking operations, and smart contract interactions.

Transaction Workflow

All transactions follow a common pattern:

  1. Generate → Create an unsigned transaction
  2. Sign → Add cryptographic signatures
  3. Broadcast → Submit to the network
# Generate unsigned transaction
babylond tx bank send [from] [to] [amount] --generate-only > tx.json

# Sign the transaction
babylond tx sign tx.json --from [key-name] > signed-tx.json

# Broadcast to network
babylond tx broadcast signed-tx.json

Usage

babylond tx [module] [command] [flags]

Command Categories

Core Transaction Operations

Essential commands for transaction management:

CommandDescription
broadcastBroadcast signed transactions to the network
encodeEncode transactions to protobuf format
decodeDecode binary transaction strings
signSign unsigned transactions
multi-signCreate multisig signatures
simulateTest transaction execution and gas usage
validate-signaturesVerify transaction signatures

Financial Operations

Basic token and financial operations:

ModuleCommandsDescription
banksend, multi-sendTransfer tokens between accounts
distributionwithdraw-rewards, fund-community-poolStaking rewards and community funding
feegrantgrant, revokeFee allowances for other accounts
vestingcreate-vesting-accountTime-locked token accounts

Governance & Authorization

Network governance and delegation:

ModuleCommandsDescription
govsubmit-proposal, vote, depositNetwork governance participation
authzgrant, revoke, execAuthorization delegation

Staking & Validation

Babylon's epoched staking system:

ModuleCommandsDescription
epochingdelegate, unbond, redelegateEpoch-based staking operations
checkpointingcreate-validatorValidator registration
slashingunjailValidator penalty management

Examples

Create validator
cd $HOME
# Create validator.json file
echo "{\"pubkey\":{\"@type\":\"/cosmos.crypto.ed25519.PubKey\",\"key\":\"$(babylond comet show-validator | grep -Po '\"key\":\s*\"\K[^"]*')\"},
\"amount\": \"1000000ubbn\",
\"moniker\": \"test\",
\"identity\": \"\",
\"website\": \"\",
\"security\": \"\",
\"details\": \"I love blockchain ❤️\",
\"commission-rate\": \"0.1\",
\"commission-max-rate\": \"0.2\",
\"commission-max-change-rate\": \"0.01\",
\"min-self-delegation\": \"1\"
}" > validator.json
# Create a validator using the JSON configuration
babylond tx staking create-validator validator.json \
--from $WALLET \
--chain-id bbn-1 \
--gas auto --gas-adjustment 1.5

Bitcoin Integration (Babylon-Specific)

Bitcoin staking and integration features:

ModuleCommandsDescription
btcstakingcreate-btc-delegation, create-finality-providerBitcoin staking operations
btccheckpointinsert-proofsBitcoin checkpoint submissions
btclightclientinsert-headersBitcoin block header management
btcstkconsumerregister-consumerConsumer chain registration

Finality & Incentives

Babylon's finality and reward systems:

ModuleCommandsDescription
finalityadd-finality-sig, commit-pubrand-listFinality provider operations
incentivewithdraw-reward, set-withdraw-addrReward distribution
monitorVarious monitoring operationsNetwork monitoring transactions
zoneconciergeCross-zone operationsInter-zone communication

Cross-Chain (IBC)

Inter-Blockchain Communication:

ModuleCommandsDescription
ibcchannel, clientCore IBC operations
ibc-transfertransferToken transfers via IBC
ibc-feepay-packet-feeIBC relayer incentivization
ibc-wasmstore-code, migrate-contractIBC WASM contracts

Smart Contracts

WASM smart contract operations:

ModuleCommandsDescription
wasmstore, instantiate, execute, migrateSmart contract lifecycle

Network Management

System-level operations:

ModuleCommandsDescription
circuitauthorize, disable, resetCircuit breaker management
crisisinvariant-brokenEmergency system checks
upgradesoftware-upgradeNetwork upgrades
consensusConsensus parameter changesConsensus modifications

Common Flag Reference

Transaction Flags

FlagTypeDescriptionDefault
--chain-idstringNetwork chain ID
--fromstringSigning account name or address
--feesstringTransaction fees (e.g., 10ubbn)
--gasstringGas limit (auto for estimation)200000
--gas-pricesstringGas prices (e.g., 0.1ubbn)
--notestringTransaction memo/note

Signing Flags

FlagTypeDescriptionDefault
--keyring-backendstringKeyring backend (os|file|test)"os"
--sign-modestringSignature mode (direct|amino-json)
--offlinebooleanOffline signing modefalse
--generate-onlybooleanGenerate unsigned transactionfalse

Broadcasting Flags

FlagTypeDescriptionDefault
--broadcast-modestringBroadcasting mode (sync|async)"sync"
--nodestringRPC endpoint"tcp://localhost:26657"
--yesbooleanSkip confirmation promptsfalse