docs(forge script): improve Mac Mismatch error referring to failure to decrypt of keystore (#8572)

* docs(`forge script`): improve `Mac Mismatch` error referring to failure to decrypt of keystore

* chore: rename error

Author: leovct

Cargo.lock

@@ -45,6 +45,7 @@ rpassword = "7"
 serde.workspace = true
 thiserror.workspace = true
 tracing.workspace = true
+eth-keystore = "0.5.0"
 
 [dev-dependencies]
 tokio = { workspace = true, features = ["macros"] }

crates/wallets/Cargo.toml

@@ -22,6 +22,8 @@ pub enum PrivateKeyError {
 pub enum WalletSignerError {
     #[error(transparent)]
     Local(#[from] LocalSignerError),
+    #[error("Failed to decrypt keystore: incorrect password")]
+    IncorrectKeystorePassword,
     #[error(transparent)]
     Ledger(#[from] LedgerError),
     #[error(transparent)]

crates/wallets/src/error.rs

@@ -263,7 +263,17 @@ impl PendingSigner {
         match self {
             Self::Keystore(path) => {
                 let password = rpassword::prompt_password("Enter keystore password:")?;
-                Ok(WalletSigner::Local(PrivateKeySigner::decrypt_keystore(path, password)?))
+                match PrivateKeySigner::decrypt_keystore(path, password) {
+                    Ok(signer) => Ok(WalletSigner::Local(signer)),
+                    Err(e) => match e {
+                        // Catch the `MacMismatch` error, which indicates an incorrect password and
+                        // return a more user-friendly `IncorrectKeystorePassword`.
+                        alloy_signer_local::LocalSignerError::EthKeystoreError(
+                            eth_keystore::KeystoreError::MacMismatch,
+                        ) => Err(WalletSignerError::IncorrectKeystorePassword),
+                        _ => Err(WalletSignerError::Local(e)),
+                    },
+                }
             }
             Self::Interactive => {
                 let private_key = rpassword::prompt_password("Enter private key:")?;