用途:把外部钱包中的 BSV、序数铭文(ordinals)和 BSV21 同质化代币导入 BRC-100 钱包,需通过 WIF 私钥控制来源输入。
主要能力:sweepBsv 扫入 BSV 聪;sweepOrdinals 扫入序数铭文,每个铭文经 ONESAT_PROTOCOL 派生唯一地址,保留 type、origin、name 标签并写入自定义指令,OpNS 铭文进入 opns 篮子,其余进入 ordinals,且拒绝 BSV-20 代币;sweepBsv21 扫入 BSV21 代币,所有输入必须同一 tokenId,需通过 overlay 校验为未花费有效输出,代币合并为单一输出并自动支付 overlay 处理费,交易提交 overlay 索引;prepareSweepInputs 把 IndexedOutput 转为扫入输入,会从 BEEF 获取 lockingScript。
使用方式:安装 bun add @1sat/actions @1sat/wallet @bsv/sdk;用 createContext(wallet, { services }) 创建上下文,向各 execute 传入 inputs 与 wif。sweepBsv 不传 amount 时扫入全部输入值(扣除手续费),传 amount 时扫入指定额度并将其余退回来源地址。输入 outpoint 格式为 txid_vout。迁移示例先从 api.1sat.app 拉取旧地址 UTXO,按类型区分后分别调用三个 sweep 动作,代币按 tokenId 分组处理。
适用场景:外部钱包资产迁移、WIF 导入、钱包整合。
限制:需依赖 services 完成 BEEF 获取与 overlay 校验;代币扫入要求同一 tokenId;序数扫入不支持 BSV-20;费用、价格与具体平台支持情况资料未提供。