Komodo Docs
GitHub

Delete Wallet

delete_walletAPI-v2delete_wallet

Securely deletes a wallet. The wallet must not be the currently active wallet. This action is irreversible.

Request Parameters

Parameter Type Required Description
wallet_name string ✓ The name of the wallet to delete.
password string ✓ The password of the wallet.

Response Parameters

The response for a successful request is null.

📌 Examples

Request (Successful Deletion)

POST Delete Wallet delete_wallet 
{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "delete_wallet",
  "mmrpc": "2.0",
  "params": {
    "wallet_name": "wallet-to-delete",
    "password": "pass1"
  }
}
Show Response

Response (Success)

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

Error Types

Parameter Type Required Description
InvalidRequest string – The request is malformed or missing required parameters.
WalletNotFound string – The specified wallet_name was not found.
InvalidPassword string – The provided password is incorrect.
CannotDeleteActiveWallet string – An attempt was made to delete the currently active wallet.
WalletsStorageError string – A storage-related error occurred while accessing wallet data.
InternalError string – An internal server error occurred.
Show Error Responses

Error Response (Wallet Not Found)

{
    "mmrpc": "2.0",
    "error": "Wallet 'non-existent-wallet' not found.",
    "error_path": "mm2_main:lp_wallet:665",
    "error_trace": "mm2_main:lp_wallet:665",
    "error_type": "WalletNotFound",
    "error_data": "Wallet 'non-existent-wallet' not found.",
    "id": 0
}

Error Response (Invalid Password)

{
    "mmrpc": "2.0",
    "error": "Invalid password",
    "error_path": "mm2_main:lp_wallet:665",
    "error_trace": "mm2_main:lp_wallet:665",
    "error_type": "InvalidPassword",
    "error_data": "Invalid password",
    "id": 0
}

Error Response (Cannot Delete Active Wallet)

{
    "mmrpc": "2.0",
    "error": "Cannot delete wallet 'active-wallet' as it is currently active.",
    "error_path": "mm2_main:lp_wallet:658",
    "error_trace": "mm2_main:lp_wallet:658",
    "error_type": "CannotDeleteActiveWallet",
    "error_data": "Cannot delete wallet 'active-wallet' as it is currently active.",
    "id": 0
}