Skip to content

Commit

Permalink
Moved msg type description from BOLT#2 to BOLT#1 (#35)
Browse files Browse the repository at this point in the history
* moved msg type description from BOLT#2 to BOLT#1
* added a ToC
  • Loading branch information
pm47 authored Dec 6, 2016
1 parent 9fff656 commit 9bb732f
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 8 deletions.
9 changes: 8 additions & 1 deletion 01-messaging.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Overview
This protocol assumes an underlying authenticated and ordered transport mechanism that takes care of framing individual messages.
[BOLT 08](08-transport.md) specifies the canonical transport layer used in Lightning, though it can be replaced by any transport that fulfills the above guarantees.
[BOLT #8](08-transport.md) specifies the canonical transport layer used in Lightning, though it can be replaced by any transport that fulfills the above guarantees.

The default TCP port is 9735. This corresponds to hexadecimal `0x2607`, the unicode code point for LIGHTNING.<sup>[2](#reference-2)</sup>

Expand Down Expand Up @@ -32,6 +32,13 @@ A node MUST NOT send an evenly-typed message not listed here without prior negot
A node MUST ignore a received message of unknown type, if that type is odd.
A node MUST fail the channels if it receives a message of unknown type, if that type is even.

The messages are grouped logically into 4 groups by their most significant set bit:

- Setup & signalling (types `0`-`31`): messages related to supported features and error reporting. These are described below.
- Channel (types `32`-`127`): comprises messages used to setup, update and tear down micropayment channels. These are described in [BOLT #2](02-peer-protocol.md).
- HTLC (types `128`-`255`: comprises messages related to adding, revoking and settling HTLCs on a micropayment channel. These are described in [BOLT #2](02-peer-protocol.md).
- Routing (types `256`-`511`): node and channel announcements, as well as any active route exploration. These are described in [BOLT #7](07-routing-gossip.md).

The size of the message is required to fit into a 2 byte unsigned int by the transport layer, therefore the maximum possible size is 65535 bytes.
A node MUST ignore any additional data within a message, beyond the length it expects for that type.
A node MUST fail the channels if it receives a known message with insufficient length for the contents.
Expand Down
7 changes: 0 additions & 7 deletions 02-peer-protocol.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,13 +3,6 @@
The peer channel protocol has three phases: establishment, normal
operation, and closing.

The messages described in this document are grouped logically into 4 groups by their most significant set bit:

- Setup & signalling (types `0`-`31`): comprises setup of the cryptographic transport, communication of supported features and error reporting. These are described in BOLT #1.
- Channel (types `32`-`127`): comprises messages used to setup, update and tear down micropayment channels
- HTLC (types `128`-`255`: comprises messages related to adding, revoking and settling HTLCs on a micropayment channel
- Routing (types `256`-`511`): node and channel announcements, as well as any active route exploration.

# Table of Contents
* [Channel](#channel)
* [Channel Establishment](#channel-establishment)
Expand Down

0 comments on commit 9bb732f

Please sign in to comment.