@keymaster/connect / FeepoolPrepareParams

Interface: FeepoolPrepareParams

feepool.prepare 请求参数。

设计缘由（施工单 002 硬切换 + 收尾反馈 + 施工单 2026-06-28 002 硬切换）：

• site 不传 action / lockHeight 等策略字段；action（create / spend / close_and_recreate）和 lockHeight 由 Keymaster 单边决定。
• site 只提交：
  • counterpartyPublicKeyHex：对端公钥。
  • amountSatoshis：本次想转给对端的金额（satoshis）。
  • connectSessionId：本次 transfer 所属 connect sessionId；service 通过 session 找到绑定 owner。必填。
• amountSatoshis 在所有 action 下语义一致：本次 transfer 的金额。 池大小由 ProtocolOriginSettingsRecord.feePoolDefaultFundSatoshis 决定（per-origin 配置）。
• 三种 action 都围绕"持续协商的 B-Tx 草稿"展开（不在 prepare 阶段 广播任何 draftTx）：
  • create：建池 A-Tx + 生成初始 B-Tx 草稿， 草稿 serverAmount = amountSatoshis。
  • spend：在旧 B-Tx 草稿上把 serverAmount += amountSatoshis 并 client 重签，得到更新后的 B-Tx 草稿。
  • close_and_recreate：把旧 B-Tx 草稿切到 FINAL_LOCKTIME 得到 close 草稿（待双方后续广播；V1 简化下暂不广播），再建新池 A-Tx + 生成新池初始 B-Tx 草稿。

Properties overview

Property	Type	Required	Description
counterpartyPublicKeyHex	string	Yes	33-byte compressed secp256k1 公钥 hex（66 个 hex 字符）。
amountSatoshis	number	Yes	正整数 satoshis；本次想转给对端的金额（三种 action 语义一致）。
connectSessionId	string	Yes	由 connect.login 返回的 sessionId。

Properties

counterpartyPublicKeyHex

counterpartyPublicKeyHex: string

33-byte compressed secp256k1 公钥 hex（66 个 hex 字符）。

---

amountSatoshis

amountSatoshis: number

正整数 satoshis；本次想转给对端的金额（三种 action 语义一致）。

---

connectSessionId

connectSessionId: string

由 connect.login 返回的 sessionId。必填。 feepool 是按 (origin + ownerPublicKeyHex + counterpartyPublicKeyHex) 三个维度归档的；不同 owner 不会串池。