Wireshark plug-in for Lightning Network(BOLT) protocol [combined summary]



Individual post summaries: Click here to read the original discussion on the lightning-dev mailing list

Published on: 2018-11-28T05:10:22+00:00


Summary:

The Nayuta team has developed a Wireshark plug-in for the Lightning Network (BOLT) protocol. This software can decode some BOLT messages and currently works for Nayuta's implementation (ptarmigan) and Éclair. To simplify interoperability testing, the team proposes adding a compile option to every implementation that enables an output key information file. This file would allow communication logs of BOLT messages to be viewed in the same format (.pcap). The team believes that this project will be useful for the Lightning Network ecosystem.In response to the proposal, Olaoluwa Osuntokun suggests creating canned protocol transcripts for other implementations to assert their responses, and considers the proposal a great first step towards that goal. Furthermore, Tock203 notes that ~/.lightning/keys.log will only contain the last sk, and lightning-dissector cannot decrypt .pcap files that contain both messages before key rotation and messages after key rotation. Tock203 recommends following the suggested key log format to support decrypting such .pcap files.Christian Decker wonders if it would be possible to query a command line program or a JSON-RPC call to obtain the secret and add it to the `listpeers` output. Tock203 responds that they have implemented the latter scheme and that lightning-dissector already supports key rotation. In the current design, when key rotation occurs (nonce==0), the lightning node software writes 16-byte MAC & key of the "first BOLT packet". However, when reading a .pcap file that starts with a message whose nonce is not 0, the messages cannot be decrypted until the next key rotation occurs.Overall, the Nayuta team's Wireshark plug-in for the Lightning Network (BOLT) protocol aims to simplify interoperability testing by enabling the viewing of communication logs in the same format. Various suggestions and discussions have taken place on the Lightning-dev mailing list to further enhance the project's functionality and usefulness within the Lightning Network ecosystem.


Updated on: 2023-07-31T20:34:45.892590+00:00