From aj at erisian.com.au  Wed Mar  9 06:48:50 2016
From: aj at erisian.com.au (Anthony Towns)
Date: Wed, 9 Mar 2016 16:48:50 +1000
Subject: [Lightning-dev] terminology
Message-ID: <20160309064850.GA26586@sapphire.erisian.com.au>

>From IRC:

<rusty> Hmm, what term should I use in documentation for the
        failure mode where a node uses too tight a timeout and ends up
        paying out an outgoing HTLC but unable to redeem the incoming
        HTLC?
<rusty> "one-sided redemption" is what I came up with, but it's not very
        punchy for "you screwed up and lost money"

That's too loose a timeout, isn't it? You choose the timeout for your
outgoing payment, so if the incoming timeout runs out, your outgoing
timeout was too long.

I'd just call it "avoiding timeout on incoming HTLC when forwarding"
or similar?

On Wed, Mar 09, 2016 at 11:13:36AM +1030, Rusty Russell wrote:
> Confusingly, we also use "revocation preimage" as the term method to
> invalidate old transactions, a private matter between pairs of nodes,
> but try to avoid abbreviating it to R.

Yeah, the lack of an obvious abbreviation for the revocation preimage
has bugged me a couple of times. What about saying we "void" the old
commitment, and use "V" as the symbol for the hash/signature/whatever?

(R for the HTLC "receipt" seems to work okay so probably good to keep
that)

Cheers,
aj