Add contract alias show. (#1567)

FULL_HELP_DOCS.md

@@ -162,6 +162,7 @@ Utilities to manage contract aliases
 
 * `remove` — Remove contract alias
 * `add` — Add contract alias
+* `show` — Show the contract id associated with a given alias
 
 
 
@@ -207,6 +208,26 @@ Add contract alias
 
 
 
+## `stellar contract alias show`
+
+Show the contract id associated with a given alias
+
+**Usage:** `stellar contract alias show [OPTIONS] <ALIAS>`
+
+###### **Arguments:**
+
+* `<ALIAS>` — The contract alias that will be displayed
+
+###### **Options:**
+
+* `--global` — Use global config
+* `--config-dir <CONFIG_DIR>` — Location of config directory, default is "."
+* `--rpc-url <RPC_URL>` — RPC server endpoint
+* `--network-passphrase <NETWORK_PASSPHRASE>` — Network passphrase to sign the transaction sent to the rpc server
+* `--network <NETWORK>` — Name of network to use from config
+
+
+
 ## `stellar contract bindings`
 
 Generate code client bindings for a contract

cmd/soroban-cli/src/commands/contract/alias.rs

@@ -2,6 +2,7 @@ use crate::commands::global;
 
 pub mod add;
 pub mod remove;
+pub mod show;
 
 #[derive(Debug, clap::Subcommand)]
 pub enum Cmd {
@@ -10,6 +11,9 @@ pub enum Cmd {
 
     /// Add contract alias
     Add(add::Cmd),
+
+    /// Show the contract id associated with a given alias
+    Show(show::Cmd),
 }
 
 #[derive(thiserror::Error, Debug)]
@@ -19,13 +23,17 @@ pub enum Error {
 
     #[error(transparent)]
     Add(#[from] add::Error),
+
+    #[error(transparent)]
+    Show(#[from] show::Error),
 }
 
 impl Cmd {
     pub fn run(&self, global_args: &global::Args) -> Result<(), Error> {
         match &self {
             Cmd::Remove(remove) => remove.run(global_args)?,
             Cmd::Add(add) => add.run(global_args)?,
+            Cmd::Show(show) => show.run(global_args)?,
         }
         Ok(())
     }

cmd/soroban-cli/src/commands/contract/alias/remove.rs

@@ -27,8 +27,11 @@ pub enum Error {
     #[error(transparent)]
     Network(#[from] network::Error),
 
-    #[error("no contract found with alias `{alias}`")]
-    NoContract { alias: String },
+    #[error("no contract found with alias '{alias}' for network '{network_passphrase}'")]
+    NoContract {
+        alias: String,
+        network_passphrase: String,
+    },
 }
 
 impl Cmd {
@@ -44,6 +47,7 @@ impl Cmd {
         else {
             return Err(Error::NoContract {
                 alias: alias.into(),
+                network_passphrase: network_passphrase.into(),
             });
         };
 

cmd/soroban-cli/src/commands/contract/alias/show.rs

@@ -0,0 +1,62 @@
+use std::fmt::Debug;
+
+use clap::{command, Parser};
+
+use crate::commands::{config::network, global};
+use crate::config::locator;
+use crate::print::Print;
+
+#[derive(Parser, Debug, Clone)]
+#[group(skip)]
+pub struct Cmd {
+    #[command(flatten)]
+    pub config_locator: locator::Args,
+
+    #[command(flatten)]
+    network: network::Args,
+
+    /// The contract alias that will be displayed.
+    pub alias: String,
+}
+
+#[derive(thiserror::Error, Debug)]
+pub enum Error {
+    #[error(transparent)]
+    Locator(#[from] locator::Error),
+
+    #[error(transparent)]
+    Network(#[from] network::Error),
+
+    #[error("no contract found with alias '{alias}' for network '{network_passphrase}'")]
+    NoContract {
+        alias: String,
+        network_passphrase: String,
+    },
+}
+
+impl Cmd {
+    pub fn run(&self, global_args: &global::Args) -> Result<(), Error> {
+        let print = Print::new(global_args.quiet);
+        let alias = &self.alias;
+        let network = self.network.get(&self.config_locator)?;
+        let network_passphrase = &network.network_passphrase;
+
+        if let Some(contract) = self
+            .config_locator
+            .get_contract_id(&self.alias, network_passphrase)?
+        {
+            print.infoln(format!(
+                "Contract alias '{alias}' references {contract} on network '{network_passphrase}'"
+            ));
+
+            println!("{contract}");
+
+            Ok(())
+        } else {
+            Err(Error::NoContract {
+                alias: alias.into(),
+                network_passphrase: network_passphrase.into(),
+            })
+        }
+    }
+}