Balance of Satoshis潜水艇换币全攻略swap-in与swap-out实现链上闪电资金互转【免费下载链接】balanceofsatoshisTool for working with the balance of your satoshis on LND项目地址: https://gitcode.com/gh_mirrors/ba/balanceofsatoshisBalance of Satoshis简称 bos是一款面向 LND 节点的命令行工具其中swap-in与swap-out两条命令通过「潜水艇换币」submarine swap机制帮你把资金在比特币主链与闪电网络之间快速互转无需等待开通道确认。本攻略带你零基础看懂并跑通这两个换币命令。一、什么是潜水艇换币闪电节点的流动性是「双向」的发钱靠通道内的出站余额收钱靠入站余额。当你的链上资金需要变成闪电余额、或闪电余额需要变成链上 UTXO 时传统做法是关通道回链慢且贵。潜水艇换币用第三方换币服务swap service做桥命令方向适用场景swap-in链上 → 闪电入站流动性收到链上转账后想快速变成可收款的闪电余额swap-out即increase-inbound-liquidity闪电 → 链上通道出站快用完想把资金搬到链上腾出额度 核心逻辑你在链上付款服务方通过闪电网络付给你一张发票或反向两边各走一半路资金「潜入」另一侧因此得名 submarine swap。二、快速安装与验证先安装 Node v20然后一条命令全局安装npm install -g balanceofsatoshis bos --version # 确认已安装 bos help swap-in # 查看换币入站命令帮助 bos help increase-inbound-liquidity # 查看换币出站命令帮助工具默认从 LND 默认目录读取tls.cert与admin.macaroonLinux 下为~/.lnd/也可以用--node 保存的节点名操作其他节点。三、swap-in链上资金秒变闪电余额对应命令定义在 bos 第 2046 行起核心实现在 swaps/swap_in.js。一键启动换币bos swap-in 500000 --max-fee 4000执行后终端会依次打印链上收款地址含二维码扫一下即可付款必须发送「精确金额」refund_recovery_secret退款恢复密钥请妥善保存预计完成时间与退款开放时间当服务方检测到你的链上付款并通过闪电支付你的发票后终端会输出swap_successful资金即进入你的通道成为入站流动性。常用参数速查参数默认值说明[amount]1000000要换入的 sats 数量必须与链上付款金额完全一致--max-fee4000可接受的服务费上限sats超出即中止--in peer-指定经由某个 peer 的通道接收闪电付款--api-key-预付费换币服务 API 密钥--service-socket-指定自定义换币服务的 host:port--refund-address自动新地址指定退款时资金回到的链上地址--recovery secret-用之前的恢复密钥接续未完成的换币四、swap-out闪电余额搬上链腾出出站额度对应命令increase-inbound-liquidity定义在 bos 第 1050 行起核心实现在 swaps/swap_out.js。先试算再执行# 干跑模式只估算成本不真正执行 bos increase-inbound-liquidity --amount 500000 --dryrun # 正式执行 bos increase-inbound-liquidity --amount 500000流程上工具会自动探测到换币服务的付款路由 → 向服务支付链上定金 → 服务方通过闪电网络付给你的节点 → 你的通道入站余额增加。日志会实时输出路由探测、server_update: On-chain transaction published等进度。常用参数速查参数默认值说明--amount500*k换出的 sats 数支持公式如5*m--max-fee30000服务费上限sats--max-deposit50000需先行垫付的链上定金上限sats--fast关闭跳过服务方 30 分钟批次延迟立即执行--max-paths1付款路径数1 时启用多路径探测--with peer-指定与哪个 peer 提升流动性--address out自动新地址链上资金最终扫到的地址--avoid pubkey-路由时避开的节点可多次指定--recovery secret-接续之前中断的换币五、关键参数与恢复机制换币涉及链上确认与超时窗口几个要点值得记住默认值见 swaps/constants.json超时高度最长达 2016 个区块约两周的退款窗口超期前服务方未履约你可用恢复密钥自行退款费用保护--max-fee之外内置 6% 的最高费率硬上限防止异常报价恢复密钥两条命令都会打印恢复密钥swap-in 为refund_recovery_secretswap-out 为restart_recovery_secret中断后用--recovery传入即可继续资金不会卡死服务方可替换通过--service-socket接入自建或指定的换币服务--api-key可使用预付密钥免逐笔协商。六、常见问题排查错误信息原因与解决InsufficientInboundLiquidityToReceiveSwapOffchainswap-in 前找不到足够入站流动性接收探测付款试试--in指定有余额的 peerMaxFeeExceededForSwap报价超过你的--max-fee适当调高上限或换其他服务FailedToFindAPathToPaySwapExecutionFee找不到支付服务费的路径检查出站通道状态或用--with/--max-paths调整InsufficientOutboundLiquidityToConvertToInbound指定--with的 peer 通道余额不足换个 peerInsufficientTimeAvailableToCompleteSwap距离超时高度太近剩余区块不够完成确认稍后再试七、小结用Balance of Satoshis管理 LND 流动性只需两条命令bos swap-in—— 链上资金换入闪电快速补充收款能力bos increase-inbound-liquidityswap-out—— 闪电资金换出到链上释放出站额度。配合--dryrun试算、--max-fee控费、恢复密钥兜底潜水艇换币对新手来说既安全又省心。更多命令可运行bos help探索完整说明见项目 README.md。【免费下载链接】balanceofsatoshisTool for working with the balance of your satoshis on LND项目地址: https://gitcode.com/gh_mirrors/ba/balanceofsatoshis创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考