"More than one version of commitment transaction" must be fixed in node software side, not VLS side
维护者通常 2 天内回复
还没有人认领这个 Issue。
评估
- 难度
- 4/5
- 预计耗时
- 3-5 天
- 新手友好度
- 48/100
- Issue 类型
- 缺陷
- 描述清晰度
- 基本清楚
- 活跃度
- 冷清
- 技术栈
- c
调研方向
指定的主要入口点是 channeld/channeld.c 中的 sign_commit_part;跟踪其通知与 calc_commitsigs 的顺序,包括 status_debug 计数。检查 openingd/openingd.c 是否受到影响,因为该 issue 对此未作确定。完成的标准是:签名意图在签名前被持久化,并且重启/重试行为仍与 policy-commitment-retry-same 保持一致。
由索引模型根据 Issue 内容生成。
描述
Issue: Channel State Splitbrain, And VLS policy-commitment-retry-same
There is a race condition where the CLN node can ask VLS to sign a new
counterparty commitment (to which VLS then signs and responds), then
CLN crashes before it can write the new state to disk.
On restart, CLN will forget about the new state.
It will then channel_reestablish with its peer.
The issue is that the CLN node and the peer can now negotiate another
new state, with a set of HTLCs different from the new state from before
the crash.
However, VLS has already signed new state before the crash, and by its
policy policy-commitment-retry-same, it will reject the signing request
after restart, and there is no way to recover other than to close the
channel.
Fortunately, this state is not a funds-loss event; as far as VLS is
concerned, both the old state and new state are valid, and as far as
CLN (and presumably its counterparty) is concerned, there is only the old
state, and CLN is unable to sign the new state.
In VLS, policy-commitment-retry-same is the policy which requires
that every hsmd_sign_remote_commitment_tx is either the same as the
previous call, or is at the next higher state index.
In this issue, VLS thinks we are alreaady at the new state N, but CLN
and its peer believes the new state is N - 1 and attempt to
re-negotiate a different state index N.
A similar issue exists with rust-lightning.
In rust-lightning, depending on what exactly got saved on disk (it
seems to be dependent on whether the persister is asynchronous or
not), rust-lightning may re-call at state index N - 1, or have a
similar problem with CLN where it re-negotiates a different state
index N.
Incorrect Solution
CLN proposed a solution of "VLS should always just accept signing any
alternate new state N as long as state N - 1 is not invalidated."
This violates the VLS policy policy-commitment-retry-same.
The issue here is that VLS has the goal of "the node can be compromised,
but this will not lead to a funds loss event".
The problem is that VLS signing any alternate new state N (the
solution proposed by CLN) leads to a funds-loss vulnerability
that is exploitable if the counterparty has compromised the node.
The following user story shows the funds-loss vulnerability:
- Actors:
R, the counterparty.- secretly malicious.
A, the node (CLN or rust-lightning).- secretly compromised by
R.
- secretly compromised by
V, the Validating Lightning Signer.
- Start with
Rcommitment at state indexN - 1. Rsendsupdate_add_htlcwithH1with the tiniest amount.Adecides to sign the nextRstateN, and sends
hsmd_sign_remote_commitment_txtoV.Vsigns the new state and sends back the signature in response.
Let us call this state<R.N> H1.Areceives the signature for<R.N> H1and gives it toR.Ris now in possession of<R.N> H1.
APRETENDS TO CRASH.- On "restart",
APRETENDS to performchannel_reestablish
withRat stateN - 1. Rsendsupdate_add_htlcwithH2with the largest possible
amount, to be forwarded elsewhere (to another node owned byR).Arequests, toV, a signature for the nextRstateNwithH2
as the HTLC state.Vsigns the new state due to lack ofpolicy-commitment-retry-same.
Call this signature<R.N> H2.Rsends the revocation for stateR.N - 1.Vnow believes thatH2is "irrevocably committed" and authorizes
its forwarding onwards.Rcompletes the signature for<R.N> H1.- This can confirm, as it is now signed by both
VandR. Vcannot punish it it, because only stateR.N - 1is revoked.Rloses only the tiny amountH1(and it really only gets locked
until timeout) but gains the amount ofH2.RWINS.
- This can confirm, as it is now signed by both
Due to this proposed solution allowing funds loss (and the issue itself
not leading to funds loss, other than the "cost of doing
business" for fees for closing and re-opening channels), VLS rejects
this solution as worse than the problem.
Correct Solution
The correct solution is to write an intent to sign to disk,
before performing the signing.
This is valid as a solution: writing the intent to a log (called
the "write-ahead log" or "intent log") is how all modern
databases implement ACID transactions; Sqlite3 is faster if you
enable WAL mode while still as safe, and CLN often uses Sqlite3
anyway.
Thus, writing the "intent to sign this new state" to the log is
semantically equivalent to "I signed this new state".
Once it has been written and committed to the database, it is
equivalent to atomically having signed the new state.
The advantage is that this is effectively atomic from the point of
view of both VLS and CLN!
Thus, it makes atomic the two operations "make signature" and
"write new state to disk", even if the two operations are done on
different machines:
- Suppose CLN and VLS crash before it can write the intent-to-sign
on disk.
On restart, the view is:- CLN:
N - 1 - VLS:
N - 1 - Both are in synchrony.
- CLN:
- Suppose CLN writes intent-to-sign to disk, but crashes before it
can make the request to VLS.
On restart, the view is:- CLN:
N - VLS:
N - 1 - On restart, CLN sees the intent-to-sign and calls VLS to make
the request to signN.
This is accepted by VLS because it is a state advancement
fromN - 1toN.
- CLN:
- Suppose CLN writes intent-to-sign to disk and is able to make the
request to VLS, but VLS crashes before it can sign and updates its
own disk.
On VLS restart, the view is:- CLN:
N - VLS:
N - 1 - The CLN-VLS integration code will repeat the last request that
has not been responded to on reconnection.
This is the same request that signsN, which is accepted by
VLS as a state advancement.
- CLN:
- Suppose VLS signs and writes to disk, but crashes before it can
send the response to CLN.
On VLS restart, the view is:- CLN:
N - VLS:
N - As noted, the CLN-VLS integration code will repeat the last
request on reconnection of VLS.
As this request is the same as the request VLS received before
crashing, this passespolicy-commitment-retry-same.
- CLN:
- Suppose VLS is able to respond to CLN, but CLN crashes before it
can send the signature in acommitment_signed.
On restart, the view is:- CLN:
N - VLS:
N - On restart, CLN will see the intent-to-sign on disk, and re-do
the signing.
This is the same request as what VLS received before, which
passespolicy-commitment-retry-same.
Then CLN will use the signature for
connection_reestablish.
- CLN:
In CLN, the primary change is to move the call to calc_commitsigs,
in sign_commit_part of channeld/channeld.c, to after the code
that notifies the master.
The only dependency on the output of calc_commitsigs appears to be a
tal_count(htlc_sigs) in the status_debug message, which can be
replaced with tal_count(txs) - 1; otherwise, the outputs of
calc_commitsigs seems to only be used to generate the actual
commitment_signed message.
calc_commitsigs accepts txs as non-const, but does not appear
to actually modify it.
The commit_sig argument is an output, and is the only other
non-const pointer amongst its arguments.
I am uncertain if openingd/openingd.c also needs modifications.
Expanding View
There are four different things that a signer has to handle for the
channel state advancement:
- Our commitment:
- Validate signature from counterparty for
N. - Provide revocation to counterparty for
N - 1.
- Validate signature from counterparty for
- Counterparty commitment:
- Provide signature to counterparty for
N. - Validate revocaation from counterparty for
N - 1.
- Provide signature to counterparty for
Uniquely, this splitbrain phenomoenon only affects the "provide
signature to counterparty for N".
- Validate signature from counterparty for
N.- If the counterparty makes signatures for different
Nstates
instead of just a singleNstate, that means the counterparty is
opening itself to the vulnerability described here. - This means that this is not a funds loss for us at least.
- VLS can safely replace its own state with the latest signature and
latest state from the counterparty or node.
- If the counterparty makes signatures for different
- Provide revocation to counterparty for
N - 1.- The revocation key is independent of any HTLCs or other state.
- The only validation VLS makes here is to ensure that "validate
signature from counterparty" has been done.
- Validate revocation from counterparty for
N - 1.- The revocation key is independent of any HTLCs or other state.
- CLN can repeat this request to VLS any number of times and the
result will be the same each time (i.e. fully idempotent).
Thus, changes are unnnecessary in CLN for the other parts.
- 主要语言
- C
- 星标
- 3.1k
- 派生
- 1k
- 平均合并
- 3 天 10 小时
- 30 天内合并 PR
- 40
环境准备
- 提供 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 没有贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
ElementsProject/lightning 的其他 Issue
-
难度 1/5 1 小时以内 新手友好度 90/100
ElementsProject/lightning#9593 ·
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
ElementsProject/lightning#9322 ·
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
ElementsProject/lightning#9206 ·
维护者通常 2 天内回复
-
难度 2/5 1-3 小时 新手友好度 68/100
ElementsProject/lightning#9187 · 1 条评论 · 1 个 reaction ·
维护者通常 2 天内回复
-
QA
难度 1/5 1 小时以内 新手友好度 88/100
ElementsProject/lightning#9117 · 2 条评论 ·
维护者通常 2 天内回复
查看 ElementsProject/lightning 的全部 Issue
相似的 Issue
-
[P2] Workspace updates silently ignore forbidden assignments while staging the row可能已有人在做 关联的 PR 仍在进行中或已合并。 未关闭
难度 2/5 1-3 小时 新手友好度 78/100
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 70/100
维护者通常 4 天内回复
-
category:port-update
难度 2/5 1-3 小时 新手友好度 72/100
microsoft/vcpkg#54338 · 1 条评论 ·
维护者通常 2 天内回复
-
area:http-gateway good first issue priority:low type:docs
难度 2/5 1-3 小时 新手友好度 88/100
crazy-goat/php-fpm-ng#828 ·
维护者通常 1 天内回复
-
enhancement
难度 2/5 1-3 小时 新手友好度 63/100
SunDevilRocketry/Flight-Computer-Firmware#347 ·
维护者通常 3 天内回复