@keymaster/connect / FeepoolCommitParams

Interface: FeepoolCommitParams

feepool.commit 请求参数。

V4 收口：移除 baseCounterpartySignatures。base tx 仅由 client 用 自己 P2PKH UTXO funding 并签名；server 不参与 base tx 的签名（multisig output 是被创建的，不是被花费的）。所有 server sig 都在 B-Tx 上。

设计缘由（施工单 2026-06-28 002 硬切换）：

• connectSessionId 是强制输入字段；feepool.commit 必须按 connectSessionId + origin + ownerPublicKeyHex 校验 pending op， 不允许跨 session / 跨 owner 复用 operationId。

Properties overview

Property	Type	Required	Description
operationId	string	Yes	由 feepool.prepare 返回的 operationId；只在本 popup 会话内有效。
counterpartyPublicKeyHex	string	Yes	33-byte compressed secp256k1 公钥 hex。
connectSessionId	string	Yes	由 connect.login 返回的 sessionId。
counterpartySignatures	BinaryField[]	Yes	主 B-Tx 草稿的 server sig。
closeCounterpartySignatures?	BinaryField[]	No	close_and_recreate 的 close 部分 B-Tx 草稿的 server sig（update sig）。

Properties

operationId

operationId: string

由 feepool.prepare 返回的 operationId；只在本 popup 会话内有效。

---

counterpartyPublicKeyHex

counterpartyPublicKeyHex: string

33-byte compressed secp256k1 公钥 hex。

---

connectSessionId

connectSessionId: string

由 connect.login 返回的 sessionId。必填。 feepool.commit 校验 operation 与当前 session/owner/origin 一致。

---

counterpartySignatures

counterpartySignatures: BinaryField[]

主 B-Tx 草稿的 server sig。

• create：initial spend sig（由 SDK clientVerifyServerSpendSig 验）。
• spend：update sig（由 SDK clientVerifyServerUpdateSig 验）。
• close_and_recreate 的新池部分：initial spend sig（同 create）。

---

closeCounterpartySignatures?

optional closeCounterpartySignatures?: BinaryField[]

close_and_recreate 的 close 部分 B-Tx 草稿的 server sig（update sig）。 仅 close_and_recreate 路径下传入；其它 action 不传。