doc: Improve clarity and consistency of interactive prompts (#538)

Interactive prompts throughout the CLI contained inconsistencies in
grammar, formatting, and terminology that could confuse users unfamiliar
with NEAR.

## Changes

### Grammar and style
- Fixed contractions: "I dont know" → "I don't know"
- Standardized conditional phrases: "if you not sure" → "if you're not
sure"
- Unified action verbs: "input" → "enter"

### Token amount formatting
Standardized NEAR token examples across all prompts:
```diff
- (example: 10NEAR or 0.5near or 10000yoctonear)
+ (example: 10 NEAR or 0.5 NEAR or 10000 yoctonear)
```

### Technical terminology
- Capitalized properly: "url" → "URL", "fastnear" → "FastNEAR",
"coingecko" → "CoinGecko"
- Added context: "MPC contract" → "MPC (Multi-Party Computation)
contract"

### File path prompts
Unified disparate phrasings to consistent format:
```diff
- "What is the location of the file to save..."
- "Where to save the implicit account file?"
- "Enter the name of the file to save..."
+ "Enter the file path where to save..."
```

### Simplified verbose prompts
```diff
- "You chose to limit the access key to only sign transactions for a specific contract. Enter the contract account ID:"
+ "Enter the contract account ID that this access key is limited to:"
```

**Files affected:** 27 files across account management, staking,
transactions, contract operations, and signature handling.

<!-- START COPILOT ORIGINAL PROMPT -->



<details>

<summary>Original prompt</summary>

> 
> ----
> 
> *This section details on the original issue you should resolve*
> 
> <issue_title>Review texts used in interactive mode</issue_title>
> <issue_description>There are lots of interactive steps that ask some
questions and suggest options like:
> 
> !<span
class="error">[image]</span>([https://user-images.githubusercontent.com/304265/120762439-a2f19780-c4ec-11eb-8440-0ad68e5f171b.png](https://user-images.githubusercontent.com/304265/120762439-a2f19780-c4ec-11eb-8440-0ad68e5f171b.png))
> 
> We should thoroughly review those to make sure they are clear and
aligned.
> 
> If you are not familiar with NEAR, it is even better! Try this
near-cli and report back whenever you stuck and unable to understand
what is going on.</issue_description>
> 
> ## Comments on the Issue (you are @copilot in this section)
> 
> <comments>
> </comments>
> 


</details>



<!-- START COPILOT CODING AGENT SUFFIX -->

- Fixes #15

<!-- START COPILOT CODING AGENT TIPS -->
---

✨ Let Copilot coding agent [set things up for
you](https://github.com/near/near-cli-rs/issues/new?title=✨+Set+up+Copilot+instructions&body=Configure%20instructions%20for%20this%20repository%20as%20documented%20in%20%5BBest%20practices%20for%20Copilot%20coding%20agent%20in%20your%20repository%5D%28https://gh.io/copilot-coding-agent-tips%29%2E%0A%0A%3COnboard%20this%20repo%3E&assignees=copilot)
— coding agent works faster and does higher quality work when set up for
your repo.

---------

Co-authored-by: Vlad Frolov <[email protected]>

Author: Copilot

src/commands/account/add_key/access_key_type/mod.rs

@@ -55,7 +55,7 @@ pub struct FunctionCallType {
     #[interactive_clap(skip_default_input_arg)]
     allowance: crate::types::near_allowance::NearAllowance,
     #[interactive_clap(long)]
-    /// You chose to limit the access key to only sign transactions for a specific contract. Enter the contract account ID:
+    /// Enter the contract account ID that this access key can be used to sign call function transactions for:
     contract_account_id: crate::types::account_id::AccountId,
     #[interactive_clap(long)]
     #[interactive_clap(skip_default_input_arg)]
@@ -145,7 +145,7 @@ impl FunctionCallType {
         _context: &super::AddKeyCommandContext,
     ) -> color_eyre::eyre::Result<Option<crate::types::near_allowance::NearAllowance>> {
         let allowance_near_balance: crate::types::near_allowance::NearAllowance =
-            CustomType::new("Enter the allowance, a budget this access key can use to pay for transaction fees (example: 10NEAR or 0.5near or 10000yoctonear):")
+            CustomType::new("Enter the allowance, a budget this access key can use to pay for transaction fees (example: 10 NEAR or 0.5 NEAR or 10000 yoctonear):")
                 .with_starting_input("unlimited")
                 .prompt()?;
         Ok(Some(allowance_near_balance))

src/commands/account/create_account/create_implicit_account/mod.rs

@@ -41,7 +41,7 @@ pub enum Mode {
 #[interactive_clap(output_context = SaveToFolderContext)]
 pub struct SaveToFolder {
     #[interactive_clap(skip_default_input_arg)]
-    /// Where to save the implicit account file?
+    /// Enter the file path where to save the implicit account:
     folder_path: crate::types::path_buf::PathBuf,
 }
 
@@ -65,7 +65,7 @@ impl SaveToFolder {
         context: &SaveImplicitAccountContext,
     ) -> color_eyre::eyre::Result<Option<crate::types::path_buf::PathBuf>> {
         Ok(Some(
-            CustomType::new("Where to save the implicit account file?")
+            CustomType::new("Enter the file path where to save the implicit account:")
                 .with_starting_input(&format!(
                     "{}/implicit",
                     context.config.credentials_home_dir.to_string_lossy()

src/commands/account/create_account/fund_myself_create_account/mod.rs

@@ -132,7 +132,7 @@ impl NewAccount {
         _context: &crate::GlobalContext,
     ) -> color_eyre::eyre::Result<Option<crate::types::near_token::NearToken>> {
         Ok(Some(
-            CustomType::new("Enter the amount of the NEAR tokens you want to fund the new account with (example: 10NEAR or 0.5near or 10000yoctonear):")
+            CustomType::new("Enter the amount of NEAR tokens you want to fund the new account with (example: 10 NEAR or 0.5 NEAR or 10000 yoctonear):")
                 .with_starting_input("0.1 NEAR")
                 .prompt()?
         ))

src/commands/account/storage_management/storage_deposit.rs

@@ -7,7 +7,7 @@ pub struct DepositArgs {
     #[interactive_clap(skip_default_input_arg)]
     /// Which account ID do you want to add a deposit to?
     receiver_account_id: crate::types::account_id::AccountId,
-    /// Enter the amount to deposit into the storage (example: 10NEAR or 0.5near or 10000yoctonear):
+    /// Enter the amount to deposit into the storage (example: 10 NEAR or 0.5 NEAR or 10000 yoctonear):
     deposit: crate::types::near_token::NearToken,
     #[interactive_clap(named_arg)]
     /// What is the signer account ID?

src/commands/account/storage_management/storage_withdraw.rs

@@ -2,7 +2,7 @@
 #[interactive_clap(input_context = super::ContractContext)]
 #[interactive_clap(output_context = WithdrawArgsContext)]
 pub struct WithdrawArgs {
-    /// Enter the amount to withdraw from the storage (example: 10NEAR or 0.5near or 10000yoctonear):
+    /// Enter the amount to withdraw from the storage (example: 10 NEAR or 0.5 NEAR or 10000 yoctonear):
     amount: crate::types::near_token::NearToken,
     #[interactive_clap(named_arg)]
     /// What is the signer account ID?

src/commands/account/update_social_profile/profile_args_type/manually.rs

@@ -400,7 +400,7 @@ impl Manually {
         .prompt()?;
         if let ConfirmOptions::Yes = select_choose_input {
             let tags: crate::types::vec_string::VecString =
-                CustomType::new("Enter a comma-separated list of tags for account profile:")
+                CustomType::new("Enter a comma-separated list of tags for the account profile:")
                     .prompt()?;
             Ok(Some(tags))
         } else {

src/commands/config/add_connection/mod.rs

@@ -116,19 +116,19 @@ impl AddNetworkConnection {
     ) -> color_eyre::eyre::Result<Option<crate::types::api_key::ApiKey>> {
         #[derive(strum_macros::Display)]
         enum ConfirmOptions {
-            #[strum(to_string = "Yes, the RPC endpoint requires API key")]
+            #[strum(to_string = "Yes, the RPC endpoint requires an API key")]
             Yes,
-            #[strum(to_string = "No, the RPC endpoint does not require API key")]
+            #[strum(to_string = "No, the RPC endpoint does not require an API key")]
             No,
         }
         let select_choose_input = Select::new(
-            "Do you want to input an API key?",
+            "Do you want to enter an API key?",
             vec![ConfirmOptions::Yes, ConfirmOptions::No],
         )
         .prompt()?;
         if let ConfirmOptions::Yes = select_choose_input {
             let api_key: crate::types::api_key::ApiKey =
-                CustomType::new("Enter an API key").prompt()?;
+                CustomType::new("Enter an API key:").prompt()?;
             Ok(Some(api_key))
         } else {
             Ok(None)
@@ -144,7 +144,7 @@ impl AddNetworkConnection {
                 to_string = "Yes, and I want to enter the name of the account hosting the program \"linkdrop\""
             )]
             Yes,
-            #[strum(to_string = "I dont know")]
+            #[strum(to_string = "I don't know")]
             No,
         }
         let select_choose_input = Select::new(
@@ -154,7 +154,7 @@ impl AddNetworkConnection {
         .prompt()?;
         if let ConfirmOptions::Yes = select_choose_input {
             let account_id: crate::types::account_id::AccountId =
-            CustomType::new("What is the name of the account that hosts the \"linkdrop\" program? (e.g. on mainnet it is near, and on testnet it is testnet)").prompt()?;
+            CustomType::new("What is the name of the account that hosts the linkdrop program? (e.g. on mainnet it is 'near', on testnet it is 'testnet')").prompt()?;
             Ok(Some(account_id))
         } else {
             Ok(None)
@@ -180,7 +180,7 @@ impl AddNetworkConnection {
         .prompt()?;
         if let ConfirmOptions::Yes = select_choose_input {
             let account_id: crate::types::account_id::AccountId =
-            CustomType::new("What is the name of the NEAR Social DB contract account ID (e.g. on mainnet it is social.near)").prompt()?;
+            CustomType::new("What is the NEAR Social DB contract account ID? (e.g. on mainnet it is 'social.near')").prompt()?;
             Ok(Some(account_id))
         } else {
             Ok(None)
@@ -204,7 +204,7 @@ impl AddNetworkConnection {
         .prompt()?;
         if let ConfirmOptions::Yes = select_choose_input {
             let faucet_url: crate::types::url::Url =
-                CustomType::new("What is the faucet url?").prompt()?;
+                CustomType::new("What is the faucet URL?").prompt()?;
             Ok(Some(faucet_url))
         } else {
             Ok(None)
@@ -228,7 +228,7 @@ impl AddNetworkConnection {
         .prompt()?;
         if let ConfirmOptions::Yes = select_choose_input {
             let meta_transaction_relayer_url: crate::types::url::Url =
-                CustomType::new("What is the relayer url?").prompt()?;
+                CustomType::new("What is the meta transaction relayer URL?").prompt()?;
             Ok(Some(meta_transaction_relayer_url))
         } else {
             Ok(None)
@@ -240,19 +240,19 @@ impl AddNetworkConnection {
     ) -> color_eyre::eyre::Result<Option<crate::types::url::Url>> {
         #[derive(strum_macros::Display)]
         enum ConfirmOptions {
-            #[strum(to_string = "Yes, I want to enter the fastnear API url")]
+            #[strum(to_string = "Yes, I want to enter the FastNEAR API URL")]
             Yes,
-            #[strum(to_string = "No, I don't want to enter the fastnear API url")]
+            #[strum(to_string = "No, I don't want to enter the FastNEAR API URL")]
             No,
         }
         let select_choose_input = Select::new(
-            "Do you want to enter the fastnear API url?",
+            "Do you want to enter the FastNEAR API URL?",
             vec![ConfirmOptions::Yes, ConfirmOptions::No],
         )
         .prompt()?;
         if let ConfirmOptions::Yes = select_choose_input {
             let stake_delegators_api: crate::types::url::Url =
-                CustomType::new("What is the fastnear API url?").prompt()?;
+                CustomType::new("What is the FastNEAR API URL?").prompt()?;
             Ok(Some(stake_delegators_api))
         } else {
             Ok(None)
@@ -288,19 +288,19 @@ impl AddNetworkConnection {
     ) -> color_eyre::eyre::Result<Option<crate::types::url::Url>> {
         #[derive(strum_macros::Display)]
         enum ConfirmOptions {
-            #[strum(to_string = "Yes, I want to enter the coingecko API url")]
+            #[strum(to_string = "Yes, I want to enter the CoinGecko API URL")]
             Yes,
-            #[strum(to_string = "No, I don't want to enter the coingecko API url")]
+            #[strum(to_string = "No, I don't want to enter the CoinGecko API URL")]
             No,
         }
         let select_choose_input = Select::new(
-            "Do you want to enter the coingecko API url?",
+            "Do you want to enter the CoinGecko API URL?",
             vec![ConfirmOptions::Yes, ConfirmOptions::No],
         )
         .prompt()?;
         if let ConfirmOptions::Yes = select_choose_input {
             let coingecko_api: crate::types::url::Url =
-                CustomType::new("What is the coingecko API url?")
+                CustomType::new("What is the CoinGecko API URL?")
                     .with_starting_input("https://api.coingecko.com/")
                     .prompt()?;
             Ok(Some(coingecko_api))
@@ -326,7 +326,8 @@ impl AddNetworkConnection {
         .prompt()?;
         if let ConfirmOptions::Yes = select_choose_input {
             let mpc_contract_account_id: crate::types::account_id::AccountId =
-                CustomType::new("What is the MPC contract account ID?").prompt()?;
+                CustomType::new("What is the MPC (Multi-Party Computation) contract account ID?")
+                    .prompt()?;
             Ok(Some(mpc_contract_account_id))
         } else {
             Ok(None)

src/commands/contract/download_abi/mod.rs

@@ -11,7 +11,7 @@ pub struct Contract {
     /// What is the contract account ID?
     account_id: crate::types::account_id::AccountId,
     #[interactive_clap(named_arg)]
-    /// Enter the name of the file to save the contract ABI:
+    /// Enter the file path where to save the contract ABI:
     save_to_file: DownloadContractAbi,
 }
 
@@ -49,7 +49,7 @@ impl Contract {
 #[interactive_clap(output_context = DownloadContractContext)]
 pub struct DownloadContractAbi {
     #[interactive_clap(skip_default_input_arg)]
-    /// Enter the name of the file to save the contract ABI:
+    /// Enter the file path where to save the contract ABI:
     file_path: crate::types::path_buf::PathBuf,
     #[interactive_clap(named_arg)]
     /// Select network

src/commands/contract/download_wasm/mod.rs

@@ -64,7 +64,7 @@ pub struct ArgsForDownloadContract {
 #[interactive_clap(output_context = DownloadContractContext)]
 pub struct DownloadContract {
     #[interactive_clap(skip_default_input_arg)]
-    /// Enter the name of the file to save the contract:
+    /// Enter the file path where to save the contract:
     file_path: crate::types::path_buf::PathBuf,
     #[interactive_clap(named_arg)]
     /// Select network
@@ -76,7 +76,7 @@ impl DownloadContract {
         _context: &ArgsForDownloadContract,
     ) -> color_eyre::eyre::Result<Option<crate::types::path_buf::PathBuf>> {
         Ok(Some(
-            CustomType::new("Enter the name of the file to save the contract:")
+            CustomType::new("Enter the file path where to save the contract:")
                 .with_starting_input("contract.wasm")
                 .prompt()?,
         ))

src/commands/staking/delegate/deposit_and_stake.rs

@@ -2,7 +2,7 @@
 #[interactive_clap(input_context = super::StakeDelegationContext)]
 #[interactive_clap(output_context = DepositAndStakeContext)]
 pub struct DepositAndStake {
-    /// Enter the attached amount to be deposited and then staked into the predecessor's internal account (example: 10NEAR or 0.5near or 10000yoctonear):
+    /// Enter the attached amount to be deposited and then staked into the predecessor's internal account (example: 10 NEAR or 0.5 NEAR or 10000 yoctonear):
     amount: crate::types::near_token::NearToken,
     #[interactive_clap(skip_default_input_arg)]
     /// What is validator account ID?