Ckb-on-ramp:用闪电网络钱包入金 CKB 生态

最近我做了一个小 demo,叫 ckb-on-ramp,线上测试版在 https://onramp.retric.uk (全部跑在 testnet)。它要回答的问题是:一个手里只有 BTC 闪电钱包、没有 CKB 的新用户,能不能不装任何软件,打开网页就把 BTC 换成 Fiber 通道里的资产?

我觉得这个想法有意思,是想到如果有这样一个产品,不仅能解决入金问题,也能通过通道网络,让新用户从第一天开始就感受到CKB上二层网络的魅力。onboarding 不一定要 onboard 到 CKB 网络的一层里,二层也许是个更实用的选择。比如入金之后,用户可以直接就去做小额快速的支付,或是直接玩fiber上的游戏。这或许能打开不一样的应用场景。

我自己尝试了下用了zeus 钱包来扫描 demo 里的二维码,换了一点 CKB testnet 上的 cWBTC 的token,体验还是挺有意思的。

这篇帖子简单写下这个 demo 是怎么实现的、我想验证什么、有哪些限制,以及我觉得 Fiber 可以在协议层补上的几项能力。

一、这个 demo 有趣在哪

我觉得有意思的地方有三点。

  1. 用户的 Fiber 节点跑在浏览器里。前端用 fiber-js(Fiber 的 WASM 版本),节点密钥由 passkey 保护,状态存在 IndexedDB。用户不需要装 FNN,也不需要懂节点运维。
  2. 用户不需要先有 CKB。开 UDT 通道要占用链上 Cell,用户这一侧大约要 184 CKB。对想要入金的新用户来说,这是一个死循环。在这个 demo 里,用了一个比较级简单粗暴的做法:这部分 CKB 由运营方出,可以视为是一种获取用户的补贴。
  3. 付款端可以是任何普通的 BTC 闪电钱包。用户拿到的是一张标准 BOLT11 发票,用 Phoenix、Zeus、Blink 之类的钱包扫码付款即可。CCH(cross-chain hub)用同一个 payment hash 把闪电和 Fiber 两边的支付原子地绑定,运营方不托管用户资金。

在 testnet 的端到端测试里,一笔 10,130 sats 的闪电付款,大约 3 秒后测试 Fiber 节点收到了 10,000 raw cWBTC(一个测试网上的udt)。报价规则是 0.3% + 100 sats,差额就是这部分费用。

二、技术原理

整体由三部分组成:

  • 浏览器:fiber-js WASM 节点 + React 前端;
  • 运营方:一个 FNN(v0.9.0),开启 CCH,CCH 连接一个 Bitcoin testnet 的 LND;
  • API:一个 Node 服务,负责报价、开渠协调、替运营方签 funding 交易、调用 CCH 下单。

流程如下:

sequenceDiagram
    participant U as 浏览器 Fiber 节点 (WASM)
    participant A as On-ramp API
    participant F as 运营方 FNN + CCH
    participant L as 运营方 LND
    participant W as 用户闪电钱包

    U->>F: connect_peer(wss)
    U->>U: open_channel_with_external_funding<br/>(UDT=cWBTC,用户出 0,CKB 来自运营方锁)
    F->>F: accept_channel,出 1 cWBTC 作为入向流动性
    U->>A: POST /api/sign-funding(未签名 funding tx)
    A->>A: 校验输入/输出/预算后用运营方钥签名
    A-->>U: 已签名 tx
    U->>F: submit_signed_funding_tx → 通道 Ready
    U->>A: 请求报价,用户生成 cWBTC Fiber 发票
    A->>F: CCH receive_btc(Fiber 发票)
    F->>L: 生成同 payment hash 的 hold invoice
    A-->>U: 返回 BOLT11 发票
    W->>L: 支付闪电发票(HTLC 被 hold)
    F->>U: 通过 Fiber 通道支付 cWBTC
    U-->>F: 揭示 preimage
    F->>L: 用 preimage 结算 hold invoice

下面分几点说实现细节。

外部出资开渠。 最早的版本是运营方先往用户地址转 200 CKB,再由运营方开渠。问题是这些 CKB 成了用户可以随意花的 UTXO,用户领到后可以直接转走。后来我改成用 Fiber 的 open_channel_with_external_funding:用户节点作为 opener 发起,funding_lock_script 指向运营方的锁,funding tx 的 CKB 输入来自运营方的 Cell,找零回运营方;运营方 FNN 作为 acceptor 出 1 cWBTC,作为用户的入向容量。整个过程中用户没有拿到可以直接花的 CKB。

/api/sign-funding 假设客户端可能作恶。 交易由用户的 WASM 节点组装,API 只签满足以下条件的交易:所有输入都属于运营方受信任的锁,输出只有 funding cell 和找零,UDT 守恒,CKB 容量和矿工费都在预算内。

原子性来自 hold invoice。 CCH 的 receive_btc 接收用户的 Fiber 发票,返回一张同 hash 的闪电 hold invoice。用户付款后,LND 端的 HTLC 先被 hold 住,CCH 在 Fiber 这边付给用户;用户收款时揭示 preimage,CCH 再用 preimage 结算闪电那一侧。任一边失败,另一边就不会结算。

收款之后的用途。 前端做了两个出口:用通道里的 cWBTC 支付 Fiber 发票(Spend on Fiber),以及协作关渠,通过 close_script 把 cWBTC 和那部分 CKB 关到用户指定的 CCC 钱包地址(L1 xUDT)。

浏览器节点与运营方的连接。 浏览器里的节点只能通过 WebSocket 连 peer,所以运营方需要对外提供一个 wss 地址。这个 demo 能跑通,前提是运营方节点可以被浏览器直接访问。

三、我想验证的事情

做这个 demo,我主要想验证三件事。

  1. 不装软件、不持有 CKB 的首次入金能不能在 Fiber 上跑通。结果是可以,而且整条链路用的都是 Fiber 现有的 RPC(外部出资开渠、CCH、hold invoice),不需要改协议。
  2. 浏览器 WASM 节点能不能当作真实的用户节点使用。开渠、收款、付款、协作关渠都在 testnet 上跑过。
  3. 这种运营方模式还缺什么。跑下来我的感受是,基本链路已经通了,但让没有 CKB 的用户收款、收回赞助成本、获取流动性这几件事,现在都要应用层自己拼凑。如果 Fiber 在协议层提供对应的能力,做 on-ramp 这类服务会简单很多。下一节主要讲这部分。

四、限制,以及我希望 Fiber 网络往哪改进

先说这个 demo 本身的限制:

  • 每个用户的入向容量固定为 1 cWBTC。不管用户想换多少,运营方都按这个额度开一条渠,每条渠都要锁一份 cWBTC 和约 184 CKB。
  • 赞助的 CKB 可能收不回来。通道 Ready 之后,用户强制关渠就能拿走通道里那部分 CKB。外部出资只是让用户无法在开渠前直接转走 CKB,并没有消除这部分成本。
  • 容量瓶颈主要在闪电那一侧。运营方能收多少 BTC,取决于它的 LND 有多少入向流动性,而 testnet 上这部分很难拿到。
  • 报价不感知流动性。报价接口只检查 Fiber 侧的出资上限,不检查闪电侧还能收多少。额度不够时报价照样能出,但付款会失败。

这些限制大多不是这个 demo 能单独解决的。下面是我觉得 Fiber 可以在协议或标准层面提供的几项能力,都是提案,不是现状。

提案 1:零 CKB 收款,即 Fiber 版的 JIT 通道。

  • 解决什么:现在用户必须先准备好通道才能收款,收款前的准备步骤(连接、开渠、签名、等确认)是用户最容易卡住的地方。
  • 闪电里的做法:在 LSP 模式下,没有通道的用户也能生成发票,发票里的路由提示指向 LSP。付款到达 LSP 时,LSP 先 hold 住 HTLC,现场给用户开一条通道(常用 zero-conf),把这笔钱转过去,同时从金额里扣一笔开渠费。Phoenix 这类钱包就是用这种方式让用户安装后直接收款,LSPS2 等规范也在把这套流程标准化。
  • 对应到 Fiber:用户的 WASM 节点生成一张指向某个 Fiber LSP 的 UDT 发票;第一笔付款到达时,LSP 开一条 UDT 通道,约 184 CKB 的 Cell 容量由 LSP 先垫付,再以 UDT 计价的开渠费从这笔入金里扣回。Fiber 需要提供的是:发票里携带按需开渠的 LSP 提示、一套标准的开渠费协商协议,以及 zero-conf 或等确认后再放行 HTLC 的明确语义。这样 on-ramp 就可以简化为生成发票、付款、到账三步。

提案 2:外部出资通道的容量退回规则。

  • 解决什么:运营方垫付的 CKB 是获客成本。现在通道一旦 Ready,用户强制关渠就能把它带走,运营方只能靠限额控制损失。
  • 可以提供什么:开渠时在协议里记录每一方投入的 CKB 容量和对应的退回锁(refund lock)。无论协作关渠还是强制关渠,结算时出资方投入的 CKB 都必须回到它指定的锁,用户只拿走自己的 UDT 余额和自己投入的部分。
  • 大致机制:funding 阶段把容量归属写进双方签署的 commitment / settlement 交易模板,结算输出按 funder lock 和 user lock 拆分容量,强制关渠路径同样受这个模板约束。还有一个细节需要在规则里写清楚:用户那份 UDT 输出本身也要占用一定的 CKB 容量,这部分由谁出(出资方让渡、从 UDT 余额里扣费,或者要求用户自带最低容量)。

提案 3:自定义 swap 报价,以及让 CCH 具备流动性感知

  • 现状:CCH 按 1 sat ≈ 1 raw UDT 结算,只扣固定手续费,没有兑换价参数;报价也看不到闪电侧入向和 Fiber 侧出向还剩多少,应用要么自己镜像费率,要么等下单失败才知道超限。
  • 解决什么:运营方无法按市场设定“多少 BTC 换多少 UDT”,只能做接近 1:1 的 wrapped BTC 入金;同时 on-ramp 的上限主要在闪电侧入向流动性,每个 CCH 运营方都得自己找人开通道,报价阶段却感知不到这个上限。
  • 可以提供什么:让运营方在报价或下单时指定兑换比例,例如多少 sats 换多少 UDT;同时让 CCH 暴露当前可服务的额度(闪电侧入向、Fiber 侧出向),应用在报价阶段就能拒绝超额订单。

最后

从这个 demo 看,在 Fiber 上用浏览器节点加一个闪电钱包完成 BTC 到 CKB 生态资产的首次入金,现有能力已经够用。如果要让这类服务规模化,还需要上面几项协议层面的支持。另一个感受是,闪电网络生态上的钱包,类似 ZEUS 这样的,对普通用户仍然有很大的使用门槛。稳定性和易用性都还有很大的空间。Fiber 如果以后有类似的产品,可以想象也会面临更多的挑战。

有任何想法欢迎一起讨论!

10 Likes

这个方向挺有意思的。如果这条路径能够跑通,Fiber 就有机会成为用户进入 CKB 生态的第一站,而不必再以 L1 作为必经入口。尤其是通过 fiber-js WASM 在浏览器中运行用户节点,并利用 Passkey 保护密钥,这对网页游戏、即时支付、小额打赏等场景都很有价值。

从长远来看,还可以探索一套可持续的 LSP 商业模式,运营商为新用户开通通道、提供资金和流动性,再通过手续费覆盖成本并获得收益,而不是让冷启动长期依赖无条件补贴。

另外,这对我正在做的 UTXOPlay Store 也有潜在的入口价值。比如未来可以在首页提供一个 Play with Bitcoin 入口:玩家只需要已有的闪电钱包,扫码支付少量 BTC,系统便自动完成 Fiber 通道的建立和游戏资产的获取,随后就能直接开始玩游戏了了

nice work!

6 Likes

This project has a demo that is quite similar to ours: https://ckbolt.texlabs.org/. We are currently developing the ckbolt project as well, and a demo should be available either today or tomorrow. Your demo is excellent!

4 Likes