chore: improve error message for 'dfx deploy'.

CHANGELOG.md

@@ -37,6 +37,17 @@ This affects the following commands:
 - `dfx canister update-settings`
 - `dfx ledger fabricate-cycles`
 
+### chore: improve `dfx deploy` messages.
+
+If users run `dfx deploy` without enough cycles, show additional messages to indicate what to do next.
+```
+Error explanation:
+Insufficient cycles balance to create the canister.
+How to resolve the error:
+Please top up your cycles balance by converting ICP to cycles like below:
+'dfx cycles convert --amount=0.123 --ic'.
+```
+
 # 0.24.3
 
 ### feat: Bitcoin support in PocketIC

src/dfx/src/lib/diagnosis.rs

@@ -1,3 +1,4 @@
+use crate::lib::cycles_ledger_types::create_canister::CreateCanisterError;
 use crate::lib::error_code;
 use anyhow::Error as AnyhowError;
 use dfx_core::error::root_key::FetchRootKeyError;
@@ -72,6 +73,12 @@ pub fn diagnose(err: &AnyhowError) -> Diagnosis {
         }
     }
 
+    if let Some(create_canister_err) = err.downcast_ref::<CreateCanisterError>() {
+        if insufficient_cycles(create_canister_err) {
+            return diagnose_insufficient_cycles();
+        }
+    }
+
     NULL_DIAGNOSIS
 }
 
@@ -262,3 +269,14 @@ fn diagnose_ledger_not_found() -> Diagnosis {
 
     (Some(explanation.to_string()), Some(suggestion.to_string()))
 }
+
+fn insufficient_cycles(err: &CreateCanisterError) -> bool {
+    matches!(err, CreateCanisterError::InsufficientFunds { balance: _ })
+}
+
+fn diagnose_insufficient_cycles() -> Diagnosis {
+    let explanation = "Insufficient cycles balance to create the canister.";
+    let suggestion = "Please top up your cycles balance by converting ICP to cycles like below:
+'dfx cycles convert --amount=0.123 --ic'.";
+    (Some(explanation.to_string()), Some(suggestion.to_string()))
+}