SuperAPI AI 工具集

sweep

通用与其它

查看项目

更新于 10-15 17:23

技能介绍

用途:Sweep 用于从外部钱包导入或“清扫”资产到 BRC-100 钱包。适用于按 WIF 私钥导入、钱包迁移、把外部 UTXO 中的 BSV、序数铭文和 BSV21 代币归集到目标钱包,以及认领本钱包已收到的普通 BSV 存款。

主要能力:提供 sweepBsv、sweepOrdinals、sweepBsv21、sweepDeposit 和 prepareSweepInputs。sweepBsv 清扫外部 BSV 聪;sweepOrdinals 清扫序数铭文;sweepBsv21 清扫 BSV21 同质化代币;sweepDeposit 认领钱包自身存款篮中的 UTXO,无需外部私钥;prepareSweepInputs 从 1sat-stack API 的 IndexedOutput 对象构建清扫输入,并从 BEEF 获取锁定脚本。

使用方式:安装依赖 bun add @1sat/actions @1sat/wallet @bsv/sdk。外部清扫方法接收 keys: PrivateKey[],需先用 PrivateKey.fromWif('...') 转换 WIF,且 keys 与 inputs 一一对应。sweepBsv 可传 amount 做部分清扫,余额退回源地址;不传则全额清扫。序数清扫每个铭文通过 P1SAT 协议派生唯一地址,依据 ORDFS 元数据设置标签,OpNS 进入 opns 篮、其余进入 ordinals 篮,并拒绝 BSV-20 代币。BSV21 清扫要求所有输入 tokenId 相同,经 overlay 校验后合并为单一输出,并自动支付 overlay 处理费。sweepDeposit 接收可选 limit(默认 50),返回 txid 与 swept 数量,失败无副作用,可重试。

适用场景:钱包迁移、外部地址资产归集、按类型分批导入 BSV/铭文/代币。

限制:外部清扫必须提供与输入一一对应的 PrivateKey 对象,不能直接传 WIF 字符串;sweepDeposit 不涉及外部私钥;清扫模块需要 services 以完成 BEEF 获取与 overlay 校验;序数输入仅包含 outpoint、satoshis、lockingScript,元数据由系统内部解析。其余平台或收费信息资料未提供。