MultisigPool

README

MultisigPool v4

MultisigPool v4 是 Buyer / Seller / Arbiter 角色明确的 BSV 多签池实现，提供 TypeScript、Go 和 Rust 完整仲裁池能力。

角色和链上顺序固定如下：

• 2-of-2：[Buyer, Seller]
• 2-of-3：[Buyer, Seller, Arbiter]
• 仲裁池状态交易：output[0] = Buyer，output[1] = Seller，output[2] = Arbiter，付款证明位于可选的 output[3]
• Buyer 提供建池 UTXO，并承担状态交易手续费；Arbiter 初始金额为 0，但固定占用 output[2]。

协议标识是 bitfs.pool.v4，协议版本是 4。v4 是破坏性切换，不读取、迁移或兼容旧 v2/v3 池。

版本与发布

版本事实源只有 release/versions.json。协议版本与包发布版本含义不同：协议为 bitfs.pool.v4 / 4，npm、Go 与 Rust 发布版本统一为 4.0.0。

修改版本清单后执行 node scripts/release-versions.mjs sync，审查生成的 Go、TypeScript、Rust 版本文件及包锁文件。只读检查命令是 node scripts/release-versions.mjs check。

三语言发布只有 scripts/release-all.sh 入口；它不接受临时版本，不自动提交代码或修改版本清单。发布中断时只能使用同一入口显式恢复：--resume-from rust、--resume-from tags 或 --resume-from verify。

TypeScript

import { PrivateKey } from '@bsv/sdk/primitives'
import { buildArbitratedPoolLock, type ArbitratedPoolRoles } from 'keymaster-multisig-pool'

const roles: ArbitratedPoolRoles = {
  buyer: PrivateKey.fromHex('01'.padStart(64, '0')).toPublicKey(),
  seller: PrivateKey.fromHex('02'.padStart(64, '0')).toPublicKey(),
  arbiter: PrivateKey.fromHex('03'.padStart(64, '0')).toPublicKey(),
}
const lockingScript = buildArbitratedPoolLock(roles)

公共签名合并函数显式覆盖 Buyer+Seller、Buyer+Arbiter、Seller+Arbiter 三种合法组合。

Go

Go module 路径是 github.com/bsv8/MultisigPool/v4。公共聚合包位于 github.com/bsv8/MultisigPool/v4/pkg，角色值对象位于 pkg/two_party_pool 和 pkg/arbitrated_pool，不保留旧函数别名。

roles := arbitrated_pool.ArbitratedPoolRoles{
    Buyer: buyer.PubKey(), Seller: seller.PubKey(), Arbiter: arbiter.PubKey(),
}
lock, err := arbitrated_pool.BuildArbitratedPoolLock(roles)

验证

npm run build
npm test -- --runInBand
go test ./...

Rust 目录提供通用 m-of-n 能力和完整 v4 仲裁池交易 API；涉及池角色的交叉验证使用同一套 v4 角色顺序。