Skip to content

@keymaster/connect / P2pkhTransferParams

Interface: P2pkhTransferParams

p2pkh.transfer 请求参数。

设计缘由(施工单 002 硬切换 + 施工单 2026-06-28 002 硬切换):

  • 本次只支持 bsv 主网 P2PKH 转账。不引入 assetId / network / 多币种 / 多网络协商。
  • site 不允许传 text / confirmMessage:确认文案由 Keymaster 自己 按方法语义生成;不允许 site 伪装转账为登录确认。
  • aud 不接受:connect popup 已天然拿到 event.origin 真值,origin 等价检查由 service 自动执行。
  • feeRateSatoshisPerKb 可选;缺省时由 service 走一个保守默认值。
  • amountSatoshis 是整数 satoshis,不接受小数;feeSatoshis 在 result 里 回。
  • connectSessionId强制输入字段(施工单 2026-06-28 002 硬切换): 资金 owner 取自 session 绑定 owner,读取全局 active key。 旧 session 失效时直接 fail-fast,不再静默 fallback 到 active key。

Properties overview

PropertyTypeRequiredDescription
recipientAddressstringYes主网 P2PKH 地址(base58check,version 0x00);testnet 直接 invalid_request。
amountSatoshisnumberYes正整数 satoshis。
feeRateSatoshisPerKb?numberNo可选 fee rate(sat/kB)。
connectSessionIdstringYesconnect.login 返回的 sessionId。

Properties

recipientAddress

recipientAddress: string

主网 P2PKH 地址(base58check,version 0x00);testnet 直接 invalid_request。


amountSatoshis

amountSatoshis: number

正整数 satoshis。


feeRateSatoshisPerKb?

optional feeRateSatoshisPerKb?: number

可选 fee rate(sat/kB)。>= 1。


connectSessionId

connectSessionId: string

connect.login 返回的 sessionId。必填。 service 通过此 id 找到绑定 key,不允许 fallback 到 active key。

Capability access without key custody.