Change Mnemonic Password

API-v2change_mnemonic_password

change_mnemonic_password

The change_mnemonic_password method allows a user to update the password used to encrypt a mnemonic phrase in their local database.

While this will change the password used to encrypt the mnemonic phrase in the local database, it will not update the wallet_password value in the MM2.json config file. This will need to be updated manually, otherise you will see a log error Error initializing wallet: Error generating or decrypting mnemonic: Error decrypting mnemonic: HMAC error: MAC tag mismatch on next launch.

Request Parameters

Parameter* = required	Type	Description
current_password*	`string`	the active mnemonic password for your wallet
new_password*	`string`	the new password to use for encrypting your active mnemonic password

Response Parameters

Parameter* = required	Type	Description
result*	`null`	Returns null on successful password change.

📌 Examples

Command

Change Mnemonic Password

POST

change_mnemonic_password

{
  "mmrpc": "2.0",
  "method": "change_mnemonic_password",
  "userpass": "RPC_UserP@SSW0RD",
  "params": {
    "current_password": "old_password123",
    "new_password": "new_password456"
  }
}

Response (success)

{
  "mmrpc": "2.0",
  "result": null,
  "id": null
}

Error Types

Parameter* = required	Type	Description
WalletsStorageError	`string`	Optional. Error decrypting or accessing wallet storage.

⚠️ Error Responses

WalletsStorageError (Wrong Password)

{
    "mmrpc": "2.0",
    "error": "Wallets storage error: Error decrypting passphrase: Error decrypting mnemonic: HMAC error: MAC tag mismatch",
    "error_path": "lp_wallet.mnemonic.decrypt",
    "error_trace": "lp_wallet:551] lp_wallet:141] mnemonic:109] decrypt:56]",
    "error_type": "WalletsStorageError",
    "error_data": "Error decrypting passphrase: Error decrypting mnemonic: HMAC error: MAC tag mismatch",
    "id": null
}

To view your mnemonic phrase in plain text, use get_mnemonic.

On this page

Change Mnemonic Password

Change Mnemonic Password