On this page

latest contributor to this doc

Last Edit:

@smk762

Sign Message

API-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.

ParameterTypeRequiredDefaultDescription
coinstring-The coin to sign a message with.
messagestring-The message you want to sign.
addressstring0HD 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.

ParameterTypeDescription
signaturestringThe signature generated for the message.

Sign Message

POST
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"
  }
}

Sign Message (HD Wallet)

POST
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
}

Sign Message (HD Wallet, Account/Address ID)

POST
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
}

For HD wallets, if the address parameter is not provided, the root derivation path will be used, for example, m/84'/2'/0'/0/0. The two examples above point to the same address. The derivation path follows the format m/44'/COIN_ID'/ACCOUNT_ID'/CHAIN/ADDRESS_ID (or m/84'/COIN_ID'/ACCOUNT_ID'/CHAIN/ADDRESS_ID for segwit coins). The account_id and address_id are the indices of the account and address in the wallet, starting from 0. The chain is either External or Internal, and is expressed as an integer with External being 0 and Internal being 1.

ParameterTypeDescription
PrefixNotFoundstringsign_message_prefix is not set in coin config file
CoinIsNotFoundstringSpecified coin is not found
SigningErrorstringError attempting to sign message
InvalidRequeststringMessage signing is not supported by the given coin type
InternalErrorstringAn internal error occurred during the signing process