Sign Message

sign_messageAPI-v2sign_message

The sign_message method allows you to prove ownership of a specific wallet address. A unique digital signature is provided for the message being signed. This signature, along with the original message and the wallet address, can then be verified, confirming that the message originated from the owner of the address and has not been altered.

Request Parameters

Parameter Type Required Description
coin string The coin to sign a message with.
message string The message you want to sign.
address string HD wallets only. A standard AddressPath object. The path to the address for signing the message. If not provided, the account_id, chain, and address_id will default to 0.

Response Parameters

Parameter Type Required Description
signature string The signature generated for the message.

📌 Examples

Basic Usage
POST Sign Message sign_message
{
  "userpass": "RPC_UserP@SSW0RD",
  "method": "sign_message",
  "mmrpc": "2.0",
  "id": 0,
  "params": {
    "coin": "DOC",
    "message": "Between subtle shading and the absence of light lies the nuance illusion"
  }
}
Show Sign Message Response

Response (success)

{
    "mmrpc": "2.0",
    "result": {
        "signature": "H43eTmJxBKEPiHkrCe/8NsRidkKCIkXDxLyp30Ez/RwoApGdg89Hlvj9mTMSPGp8om5297zvdL8EVx3IdIe2swY="
    },
    "id": 0
}
HD Wallet with Derivation Path
POST Sign Message (HD Wallet) sign_message
{
  "userpass": "RPC_UserP@SSW0RD",
  "mmrpc": "2.0",
  "method": "sign_message",
  "params": {
    "coin": "KMD",
    "message": "Very little worth knowing is taught by fear.",
    "address": {
      "derivation_path": "m/84'/2'/0'/0/1"
    }
  },
  "id": 2
}
Show Sign Message (HD Wallet) Response

Response (HD, success)

{
    "mmrpc": "2.0",
    "result": {
        "signature": "H8Jk+O21IJ0ob3pchrBkJdlXeObrMAKuABlCtW4JySOUUfxg7K8Vl/H3E4gdtwXqhbCu7vv+NYoIhq/bmjtBlkc="
    },
    "id": 2
}
HD Wallet with Account and Address ID
POST HD Wallet with Account and Address ID sign_message
{
  "userpass": "RPC_UserP@SSW0RD",
  "mmrpc": "2.0",
  "method": "sign_message",
  "params": {
    "coin": "KMD",
    "message": "Very little worth knowing is taught by fear.",
    "address": {
      "account_id": 0,
      "chain": "External",
      "address_id": 1
    }
  },
  "id": 2
}
Show Sign Message (HD Wallet, Account/Address ID) Response

Response (HD, success)

{
    "mmrpc": "2.0",
    "result": {
        "signature": "H8Jk+O21IJ0ob3pchrBkJdlXeObrMAKuABlCtW4JySOUUfxg7K8Vl/H3E4gdtwXqhbCu7vv+NYoIhq/bmjtBlkc="
    },
    "id": 2
}

Error Types

Parameter Type Required Description
PrefixNotFound string sign_message_prefix is not set in coin config file
CoinIsNotFound string Specified coin is not found
SigningError string Error attempting to sign message
InvalidRequest string Message signing is not supported by the given coin type
InternalError string An internal error occurred during the signing process
Show Error Responses

⚠️ Error Responses

PrefixNotFound
{
    "mmrpc": "2.0",
    "error": "sign_message_prefix is not set in coin config",
    "error_path": "eth",
    "error_trace": "eth:2332]",
    "error_type": "PrefixNotFound",
    "id": null
}
InternalError
{
    "mmrpc": "2.0",
    "error": "Internal error: No such coin: as",
    "error_path": "lp_coins",
    "error_trace": "lp_coins:5122] lp_coins:5034]",
    "error_type": "InternalError",
    "error_data": "No such coin: SHEKEL",
    "id": null
}