LIGHTNING-SIGNMESSAGE(7)

📦
version 26.06.9 · 2 versions
, in nixpkgs unstable

💖 LIGHTNING-SIGNMESSAGE 💖

okay so bestie, welcome to the LIGHTNING-SIGNMESSAGE(7) page — this is the command that lets your node flex its secret key and produce a signature, and honestly? iconic behavior.

✨ NAME ✨

signmessage — the command that makes a signature from this node, no cap 💅

🦋 SYNOPSIS 🦋

signmessage message

🌸 DESCRIPTION 🌸

so the signmessage RPC command creates a digital signature of message using this node's secret key, and like… that's the whole vibe. Anyone who knows your node's id and the message can be sure that the signature could only have been made by something with access to your node's secret key. it's giving proof of identity, it's giving trust, it's giving main character energy 🔥

  • message (string) — a message to be signed by the node. it's gotta be less than 65536 characters long, bestie. that's the limit, respect it 🫶

👑 RETURN VALUE 👑

on success you get an object back, and it contains:

  • signature (hex) (always 128 characters) — the signature itself ✨
  • recid (hex) (always 2 characters) — the recovery id, which is 0, 1, 2 or 3 💫
  • zbase (string) — the signature and recid encoded in a style that's compatible with lnd's SignMessageRequest. cute little format for the lnd girlies 🎀

🌈 AUTHOR 🌈

Rusty Russell rusty@rustcorp.com.au is mainly responsible — ty king 👑✨

🧚 SEE ALSO 🧚

🍓 RESOURCES 🍓

Main web site: https://github.com/ElementsProject/lightning

SignMessageRequest

💜 EXAMPLES 💜

Example 1:

Request:

$ lightning-cli signmessage -k "message"="this is a test!"

{
  "id": "example:signmessage#1",
  "method": "signmessage",
  "params": {
    "message": "this is a test!"
  }
}

Response:

{
  "signature": "9ea05929890e40489edbd5fe0552d22bcffe00bbd29da4fcf93ed5d8f1973e421509071a64935231a126637e3615225ddda86d2d0926ae537d9c3be149f9b21f",
  "recid": "00",
  "zbase": "d6xkysjjtr8ry1r65xk9hbk14eih99oyzxjj5j8h9r9pms8t1h9rrfejyhpgjr41ggo1ca56gak1rzq7ibs14njgi3jz58b5hfr9uco9"
}

Example 2:

Request:

$ lightning-cli signmessage -k "message"="message for you"

{
  "id": "example:signmessage#2",
  "method": "signmessage",
  "params": {
    "message": "message for you"
  }
}

Response:

{
  "signature": "8149401781108c1c2fda12d91969bfe2306afe06c387394d47a83a85a14702a16b6fcd0060693da436ff1c2b25cc470d7db68fe45d833733d8dca660a3f4d67d",
  "recid": "00",
  "zbase": "d6yw1oyzoreea8bx5ejp1gmjz9tdy4z6y5baqqkpe6wdibpbehbkn45x3wygy4j7wo5x68bmrzgrqdm7s486ezcdgh37tzfgcnt9jiu7"
}
ok that's the whole page bestie, go sign some messages and be your best cryptographic self 💅✨

Core Lightning v26.06.9 wrote this little love letter to you, dated LIGHTNING-SIGNMESSAGE(7) — mwah, go slay 🫶💖

📦 where this page comes from