Skip to content

Commit 4173549

Browse files
committed
Adds missing comments and fixes ToC
1 parent dcd1f4a commit 4173549

File tree

1 file changed

+10
-4
lines changed

1 file changed

+10
-4
lines changed

13-watchtowers.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ For the rest of this document we will use server/tower and client/Lightning node
3131
* [User authentication](#user-authentication)
3232
* [The `register_top_up` message](#the-register_top_up-message)
3333
* [The `subscription_deltais` message](#the-subscription_details-message)
34-
* [Sending appointments to the tower](#sending-and-receiving-appointments)
34+
* [Sending appointments to the tower](#sending-appointments-to-the-tower)
3535
* [The `add_update_appointment` message](#the-add_update_appointment-message)
3636
* [The `appointment_accepted` message](#the-appointment_accepted-message)
3737
* [The `appointment_rejected` message](#the-appointment_rejected-message)
@@ -43,8 +43,8 @@ For the rest of this document we will use server/tower and client/Lightning node
4343
* [Encryption Algorithms and Parameters](#encryption-algorithms-and-parameters)
4444
* [Payment Modes](#payment-modes)
4545
* [Data serialisation and signing](#data-serialisation-and-signing)
46-
* [Attacks on towers](#attacks-on-towers)
4746
* [No compression of penalty transaction](#no-compression-of-penalty-transaction)
47+
* [Attacks on towers](#attacks-on-towers)
4848

4949
## Watchtower discovery
5050

@@ -140,6 +140,8 @@ Once the user is registered, the tower will be able to identify him by doing EC
140140

141141
If a user fills all his appointment slots, or need to keep the data in the tower for longer than the `subscription_period`, he may need to top up his subscription.
142142

143+
For now only `subscription_invoice` tlv has been defined as payment method. Other payment methods can be defined as tlv in the future.
144+
143145
## Sending appointments to the tower
144146

145147
Once the client is registered with the tower, he can start backing up state updates by sending appointments to the tower:
@@ -228,6 +230,8 @@ and at most as big as:
228230
`minimum_viable_transaction_size` and `maximum_viable_transaction_size` refer to the minimum/maximum size required to create a valid transaction.
229231

230232
`encrypted_blob`s outside those boundaries cannot contain valid transactions, so they should be rejected.
233+
234+
A tower should broadcast a penalty transaction right after a breach is seen, but should be also able to bump the fee is necessary. A too small `to_self_delay` can make the tower fail to do so.
231235

232236
### The `appointment_accepted` message
233237

@@ -468,13 +472,15 @@ The storage requirements for a Watchtower can be reduced (linearly) by implement
468472

469473
- Define a proper tower discovery.
470474
- None of the message types have been defined (they have been left with ?).
471-
- Define errors (transient vs permanently)
475+
- Define errors (transient vs permanently).
476+
- Add attacks on towers
472477

473478
## DISCUSS
474479

475-
- The tower may also need to reply with `appointment_slots` during the registration phase so a minimum amount of appointments are paid for. Check [attacks on towers](#attacks-on-towers). Therefore hiring the tower for a single appointment may be problematic.
480+
- The tower may also need to reply with `appointment_slots` during the registration phase so a minimum amount of appointments are paid for. Check [Trustless WatchTowers?](https://lists.linuxfoundation.org/pipermail/lightning-dev/2018-April/001203.html). Therefore hiring the tower for a single appointment may be problematic.
476481
- Signature on the deletion acceptance by the server may not be necessary.
477482
- Appointment deletion can be performed in bulk, by allowing sending more than one appointment at a time. That could result in a privacy leak though, since the tower will be able to link what appointments belonged to the same channel.
483+
- Separate register and top up so proofs can be used for top ups, in a similar way to [Dead Men's Button](https://github.com/joostjager/deadmensbutton)
478484

479485

480486
## Acknowledgments

0 commit comments

Comments
 (0)