Move get commands under sncast get (#4215)

<!-- Reference any GitHub issues resolved by this PR -->

Towards #4144 

## Stack
- #4215 
- #4210


## Introduced changes

<!-- A brief description of the changes -->

- moved `sncast balance`->`sncast get balance`
- moved `sncast tx-status`->`sncast get tx-status`
- add warnings to old commands

## Checklist

<!-- Make sure all of these are complete -->

- [x] Linked relevant issue
- [x] Updated relevant documentation
- [x] Added relevant tests
- [x] Performed self-review of the code
- [x] Added changes to `CHANGELOG.md`

---------

Co-authored-by: ddoktorski <45050160+ddoktorski@users.noreply.github.com>

Author: DelevoXDG

CHANGELOG.md

@@ -17,6 +17,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Bug with invalid function name mappings for functions with `#[test]` attribute
 - `--exit-first` flag now correctly stops execution for all packages when tests are run in a workspace
 
+### Cast
+
+#### Changed
+
+- `sncast balance` and `sncast tx-status` commands have been moved under `sncast get` subcommand (`sncast get balance`, `sncast get tx-status`). The old commands still work, but will be removed in the future.
+
 ## [0.57.0] - 2026-02-24
 
 ### Forge

crates/sncast/src/main.rs

@@ -1,24 +1,26 @@
 use std::str::FromStr;
 
-use crate::starknet_commands::balance::Balance;
 use crate::starknet_commands::declare::declare;
 use crate::starknet_commands::declare_from::{ContractSource, DeclareFrom};
 use crate::starknet_commands::deploy::{DeployArguments, DeployCommonArgs};
+use crate::starknet_commands::get::Get;
+use crate::starknet_commands::get::balance::Balance;
 use crate::starknet_commands::invoke::InvokeCommonArgs;
-use crate::starknet_commands::multicall;
 use crate::starknet_commands::script::run_script_command;
 use crate::starknet_commands::utils::{self, Utils};
 use crate::starknet_commands::{
     account, account::Account as AccountCommand, call::Call, declare::Declare, deploy::Deploy,
-    invoke::Invoke, multicall::Multicall, script::Script, show_config::ShowConfig,
-    tx_status::TxStatus,
+    get::tx_status::TxStatus, invoke::Invoke, multicall::Multicall, script::Script,
+    show_config::ShowConfig,
 };
+use crate::starknet_commands::{get, multicall};
 use anyhow::{Context, Result, bail};
 use camino::Utf8PathBuf;
 use clap::{CommandFactory, Parser, Subcommand};
 use configuration::load_config;
 use conversions::IntoConv;
 use data_transformer::transform;
+use foundry_ui::components::warning::WarningMessage;
 use shared::auto_completions::{Completions, generate_completions};
 use sncast::helpers::command::process_command_result;
 use sncast::helpers::config::{combine_cast_configs, get_global_config_path};
@@ -42,7 +44,6 @@ use sncast::{
     get_contract_class,
 };
 use starknet_commands::verify::Verify;
-use starknet_rust::accounts::Account;
 use starknet_rust::core::types::ContractClass;
 use starknet_rust::core::types::contract::{AbiEntry, SierraClass};
 use starknet_rust::core::utils::get_selector_from_name;
@@ -126,6 +127,7 @@ struct Cli {
 impl Cli {
     fn command_name(&self) -> String {
         match self.command {
+            Commands::Get(_) => "get",
             Commands::Declare(_) => "declare",
             Commands::DeclareFrom(_) => "declare-from",
             Commands::Deploy(_) => "deploy",
@@ -147,6 +149,9 @@ impl Cli {
 
 #[derive(Subcommand)]
 enum Commands {
+    /// Get various data from the network
+    Get(Get),
+
     /// Declare a contract
     Declare(Declare),
 
@@ -643,6 +648,8 @@ async fn run_async_command(cli: Cli, config: CastConfig, ui: &UI) -> Result<()>
             Ok(())
         }
 
+        Commands::Get(get) => get::get(get, config, ui).await,
+
         Commands::Utils(utils) => {
             utils::utils(
                 utils,
@@ -676,16 +683,10 @@ async fn run_async_command(cli: Cli, config: CastConfig, ui: &UI) -> Result<()>
             Ok(())
         }
 
+        // TODO(#4214): Remove moved sncast commands
         Commands::TxStatus(tx_status) => {
-            let provider = tx_status.rpc.get_provider(&config, ui).await?;
-
-            let result =
-                starknet_commands::tx_status::tx_status(&provider, tx_status.transaction_hash)
-                    .await
-                    .context("Failed to get transaction status");
-
-            process_command_result("tx-status", result, ui, None);
-            Ok(())
+            print_cmd_move_warning("tx-status", "get tx-status", ui);
+            get::tx_status::tx_status(tx_status, config, ui).await
         }
 
         Commands::Verify(verify) => {
@@ -721,23 +722,10 @@ async fn run_async_command(cli: Cli, config: CastConfig, ui: &UI) -> Result<()>
             Ok(())
         }
 
+        // TODO(#4214): Remove moved sncast commands
         Commands::Balance(balance) => {
-            let provider = balance.rpc.get_provider(&config, ui).await?;
-            let account = get_account(
-                &config,
-                &provider,
-                &balance.rpc,
-                config.keystore.as_ref(),
-                ui,
-            )
-            .await?;
-
-            let result =
-                starknet_commands::balance::balance(account.address(), &provider, &balance).await?;
-
-            process_command_result("balance", Ok(result), ui, None);
-
-            Ok(())
+            print_cmd_move_warning("balance", "get balance", ui);
+            get::balance::balance(balance, config, ui).await
         }
 
         Commands::Script(_) => unreachable!(),
@@ -790,3 +778,10 @@ fn get_cast_config(cli: &Cli, ui: &UI) -> Result<CastConfig> {
     config_with_cli(&mut combined_config, cli);
     Ok(combined_config)
 }
+
+fn print_cmd_move_warning(command_name: &str, new_command_name: &str, ui: &UI) {
+    ui.print_warning(WarningMessage::new(format!(
+        "`sncast {command_name}` has moved to `sncast {new_command_name}`. `sncast {command_name}` will be removed in the next version."
+    )));
+    ui.print_blank_line();
+}

…/sncast/src/starknet_commands/balance.rs …ast/src/starknet_commands/get/balance.rscrates/sncast/src/starknet_commands/balance.rs renamed to crates/sncast/src/starknet_commands/get/balance.rs crates/sncast/src/starknet_commands/balance.rs renamed to crates/sncast/src/starknet_commands/get/balance.rs

@@ -1,17 +1,22 @@
 use anyhow::{Error, Result};
 use clap::Args;
 use primitive_types::U256;
-use sncast::get_block_id;
+use sncast::helpers::command::process_command_result;
+use sncast::helpers::configuration::CastConfig;
 use sncast::helpers::rpc::RpcArgs;
 use sncast::helpers::token::Token;
 use sncast::response::balance::BalanceResponse;
 use sncast::response::errors::SNCastProviderError;
 use sncast::response::errors::StarknetCommandError;
+use sncast::response::ui::UI;
+use sncast::{get_account, get_block_id};
+use starknet_rust::accounts::Account;
 use starknet_rust::{
     core::{types::FunctionCall, utils::get_selector_from_name},
     providers::{JsonRpcClient, Provider, jsonrpc::HttpTransport},
 };
 use starknet_types_core::felt::Felt;
+
 #[derive(Args, Debug, Clone)]
 #[group(multiple = false)]
 pub struct TokenIdentifier {
@@ -67,7 +72,25 @@ pub struct Balance {
     pub rpc: RpcArgs,
 }
 
-pub async fn balance(
+pub async fn balance(balance: Balance, config: CastConfig, ui: &UI) -> anyhow::Result<()> {
+    let provider = balance.rpc.get_provider(&config, ui).await?;
+    let account = get_account(
+        &config,
+        &provider,
+        &balance.rpc,
+        config.keystore.as_ref(),
+        ui,
+    )
+    .await?;
+
+    let result = get_balance(account.address(), &provider, &balance).await?;
+
+    process_command_result("get balance", Ok(result), ui, None);
+
+    Ok(())
+}
+
+pub async fn get_balance(
     account_address: Felt,
     provider: &JsonRpcClient<HttpTransport>,
     balance: &Balance,

crates/sncast/src/starknet_commands/get/mod.rs

@@ -0,0 +1,32 @@
+use clap::{Args, Subcommand};
+use sncast::helpers::configuration::CastConfig;
+use sncast::response::ui::UI;
+
+pub mod balance;
+pub mod tx_status;
+
+#[derive(Args)]
+#[command(about = "Commands for querying Starknet state")]
+pub struct Get {
+    #[command(subcommand)]
+    pub command: GetCommands,
+}
+
+#[derive(Debug, Subcommand)]
+pub enum GetCommands {
+    /// Get the status of a transaction
+    TxStatus(tx_status::TxStatus),
+
+    /// Fetch balance of the account for specified token
+    Balance(balance::Balance),
+}
+
+pub async fn get(get: Get, config: CastConfig, ui: &UI) -> anyhow::Result<()> {
+    match get.command {
+        GetCommands::TxStatus(status) => tx_status::tx_status(status, config, ui).await?,
+
+        GetCommands::Balance(balance) => balance::balance(balance, config, ui).await?,
+    }
+
+    Ok(())
+}

…ncast/src/starknet_commands/tx_status.rs …t/src/starknet_commands/get/tx_status.rscrates/sncast/src/starknet_commands/tx_status.rs renamed to crates/sncast/src/starknet_commands/get/tx_status.rs crates/sncast/src/starknet_commands/tx_status.rs renamed to crates/sncast/src/starknet_commands/get/tx_status.rs

@@ -1,13 +1,17 @@
+use anyhow::Context;
 use clap::Args;
+use sncast::helpers::command::process_command_result;
+use sncast::helpers::configuration::CastConfig;
 use sncast::helpers::rpc::RpcArgs;
 use sncast::response::errors::StarknetCommandError;
 use sncast::response::tx_status::{ExecutionStatus, FinalityStatus, TransactionStatusResponse};
+use sncast::response::ui::UI;
 use starknet_rust::core::types::{TransactionExecutionStatus, TransactionStatus};
 use starknet_rust::providers::jsonrpc::HttpTransport;
 use starknet_rust::providers::{JsonRpcClient, Provider};
 use starknet_types_core::felt::Felt;
 
-#[derive(Args)]
+#[derive(Debug, Args)]
 #[command(about = "Get the status of a transaction")]
 pub struct TxStatus {
     /// Hash of the transaction
@@ -17,7 +21,18 @@ pub struct TxStatus {
     pub rpc: RpcArgs,
 }
 
-pub async fn tx_status(
+pub async fn tx_status(tx_status: TxStatus, config: CastConfig, ui: &UI) -> anyhow::Result<()> {
+    let provider = tx_status.rpc.get_provider(&config, ui).await?;
+
+    let result = get_tx_status(&provider, tx_status.transaction_hash)
+        .await
+        .context("Failed to get transaction status");
+
+    process_command_result("get tx-status", result, ui, None);
+    Ok(())
+}
+
+pub async fn get_tx_status(
     provider: &JsonRpcClient<HttpTransport>,
     transaction_hash: Felt,
 ) -> Result<TransactionStatusResponse, StarknetCommandError> {

crates/sncast/src/starknet_commands/mod.rs

@@ -1,13 +1,12 @@
 pub mod account;
-pub mod balance;
 pub mod call;
 pub mod declare;
 pub mod declare_from;
 pub mod deploy;
+pub mod get;
 pub mod invoke;
 pub mod multicall;
 pub mod script;
 pub mod show_config;
-pub mod tx_status;
 pub mod utils;
 pub mod verify;

crates/sncast/src/starknet_commands/script/run.rs

@@ -1,4 +1,4 @@
-use crate::starknet_commands::{call, declare, deploy, invoke, tx_status};
+use crate::starknet_commands::{call, declare, deploy, get::tx_status, invoke};
 use crate::{WaitForTx, get_account};
 use anyhow::{Context, Result, anyhow};
 use blockifier::execution::contract_class::TrackedResource;
@@ -254,7 +254,7 @@ impl<'a> ExtensionLogic for CastScriptExtension<'a> {
 
                 let tx_status_result = self
                     .tokio_runtime
-                    .block_on(tx_status::tx_status(self.provider, transaction_hash));
+                    .block_on(tx_status::get_tx_status(self.provider, transaction_hash));
 
                 Ok(CheatcodeHandlingResult::from_serializable(tx_status_result))
             }

crates/sncast/tests/e2e/balance.rs

@@ -17,6 +17,7 @@ pub async fn happy_case() {
         accounts_json_path.as_str(),
         "--account",
         "balance-test",
+        "get",
         "balance",
         "--url",
         URL,
@@ -29,6 +30,30 @@ pub async fn happy_case() {
     "});
 }
 
+#[tokio::test]
+pub async fn happy_case_old_command() {
+    let tempdir = tempdir().unwrap();
+    let accounts_json_path = get_accounts_path("tests/data/accounts/accounts.json");
+
+    let args = vec![
+        "--accounts-file",
+        accounts_json_path.as_str(),
+        "--account",
+        "balance-test",
+        "balance",
+        "--url",
+        URL,
+    ];
+
+    let snapbox = runner(&args).current_dir(tempdir.path());
+
+    snapbox.assert().stdout_eq(indoc! {r"
+        [WARNING] `sncast balance` has moved to `sncast get balance`. `sncast balance` will be removed in the next version.
+
+        Balance: 109394843313476728397 fri
+    "});
+}
+
 #[tokio::test]
 pub async fn happy_case_json() {
     let tempdir = tempdir().unwrap();
@@ -40,6 +65,7 @@ pub async fn happy_case_json() {
         accounts_json_path.as_str(),
         "--account",
         "user1",
+        "get",
         "balance",
         "--url",
         URL,
@@ -48,7 +74,7 @@ pub async fn happy_case_json() {
     let snapbox = runner(&args).current_dir(tempdir.path());
 
     snapbox.assert().stdout_eq(indoc! {r#"
-        {"balance":"[..]","command":"balance","token_unit":"fri","type":"response"}
+        {"balance":"[..]","command":"get balance","token_unit":"fri","type":"response"}
     "#});
 }
 
@@ -66,6 +92,7 @@ pub async fn happy_case_with_token(token: &Token) {
         accounts_json_path.as_str(),
         "--account",
         "user1",
+        "get",
         "balance",
         "--token",
         &token,
@@ -90,6 +117,7 @@ pub async fn happy_case_with_block_id() {
         accounts_json_path.as_str(),
         "--account",
         "user1",
+        "get",
         "balance",
         "--block-id",
         "latest",
@@ -114,6 +142,7 @@ pub async fn invalid_token() {
         accounts_json_path.as_str(),
         "--account",
         "user1",
+        "get",
         "balance",
         "--token",
         "xyz",
@@ -142,6 +171,7 @@ pub async fn happy_case_with_token_address() {
         accounts_json_path.as_str(),
         "--account",
         "user1",
+        "get",
         "balance",
         "--token-address",
         strk_address,
@@ -167,6 +197,7 @@ pub async fn happy_case_json_with_token_address() {
         accounts_json_path.as_str(),
         "--account",
         "user1",
+        "get",
         "balance",
         "--url",
         URL,
@@ -193,6 +224,7 @@ pub async fn nonexistent_token_address() {
         accounts_json_path.as_str(),
         "--account",
         "user1",
+        "get",
         "balance",
         "--token-address",
         "0x123",