Skip to content

Usage

With Cshell fully configured (provider and wallet), you’re ready to manage transactions and explore blockchain data.

Quick Start

Execute a Transaction

The quickest way to submit a transaction is using tx3 files:

Terminal window
cshell tx invoke --tx3-file ./my-transaction.tx3

This will resolve, sign, and submit your transaction in one step.

Search Blockchain Data

Query blocks and transactions:

Terminal window
# Search for a specific block
cshell search block <block-hash>
# Search for a transaction
cshell search transaction <tx-hash>

Explore with GUI

Launch the terminal-based explorer:

Terminal window
cshell explorer

Available Commands

Cshell provides several command groups for different operations:

Common Workflows

Send ADA

Terminal window
# 1. Create a tx3 file describing the transfer
# 2. Execute the transaction
cshell tx invoke --tx3-file ./transfer.tx3

Mint Tokens

Terminal window
# 1. Create a tx3 file with minting instructions
# 2. Execute the transaction
cshell tx invoke --tx3-file ./mint-token.tx3

Verify a Transaction

Terminal window
# After submission, verify it was confirmed
cshell search transaction <tx-hash>

Check Wallet Balance

Terminal window
cshell wallet balance

Output Formats

Many commands support multiple output formats:

Terminal window
# Human-readable table (default)
cshell search block <hash>
# Machine-readable JSON
cshell search block <hash> --output-format json

Next Steps