Repolode
lightninglabs

lightninglabs/wavelength

一个用 Go 编写的自托管比特币钱包工具包,将 Ark、闪电网络兑换和链上支付整合到一个守护进程与命令行中。

Star
58
Fork
19
未关闭 Issue
163
最近提交
17小时前

这是什么?

wavelength 是一个用 Go 编写的自托管比特币钱包系统,将通常分散在不同工具中的 Ark 客户端、闪电网络兑换引擎和链上钱包整合到同一个长期运行的守护进程 waved 与配套命令行 wavecli 中。用户可以加入 Ark、持有和转移 VTXO、在闪电网络与 Ark 之间兑换、进行链上收发,并随时单方面退出到链上,始终由自己掌握资金。

守护进程重启后可以恢复状态,并通过持久化的 actor 邮箱与 Ark 运营方通信。它既可以使用内置 btcwallet 后端(配合 Esplora 或 Neutrino),也可以接入已有的 lnd 节点完成签名和链上访问。它提供类型化的 gRPC 与 REST 接口,并提供 sdk/ark、sdk/swaps、sdk/wavewalletdk 等 Go SDK,方便宿主应用在进程内嵌入使用。

通过可选的构建标签可以启用闪电兑换子系统以及精简的钱包 RPC,其中包括 create、send、recv、balance、exit 等命令。wavecli mcp serve 可将守护进程以类型化工具调用的形式提供给 AI 智能体。项目仍在积极开发中,主网使用需要显式开启对应参数。

核心功能

  • 01以单个守护进程运行,内置钱包并具备崩溃后可恢复的持久化状态。
  • 02支持 btcwallet 配合 Esplora 或 Neutrino,也可使用 lnd 作为链上与签名后端。
  • 03涵盖 Ark 入场、轮内与轮外转账、刷新以及单方面退出。
  • 04通过可选子系统提供闪电网络与 Ark 之间的原子兑换。
  • 05提供 gRPC 和 REST 接口以及 Go SDK,便于嵌入宿主应用。
  • 06内置 MCP 服务,AI 智能体可将守护进程作为工具调用。

适用场景

  • 为 Go 应用或服务增加自托管的比特币支付能力。
  • 构建需要通过类型化工具调用收发比特币的 AI 智能体。
  • 运行个人 Ark 钱包,并在闪电网络与 Ark 之间兑换资金。

快速上手

  1. 1

    克隆代码仓库

    git clone https://github.com/lightninglabs/wavelength.git
  2. 2

    进入项目目录

    cd wavelength
  3. 3

    构建并安装启用钱包 RPC 功能的 waved 和 wavecli

    make install-wavewalletrpc

使用前须知

  • 该项目仍在积极开发中,RPC 接口、磁盘数据结构和 CLI 命令在次要版本之间可能发生变化。
  • 主网运行需要显式添加 --allow-mainnet 标志。
  • 示例配置需要本地 regtest 的 Ark 运营方和 Esplora 后端。

收录于专题

标签

常见问题

wavelength 是什么?
一个用 Go 编写的自托管比特币钱包工具包,将 Ark、闪电网络兑换和链上支付整合到一个守护进程与命令行中。 wavelength 是一个用 Go 编写的自托管比特币钱包系统,将通常分散在不同工具中的 Ark 客户端、闪电网络兑换引擎和链上钱包整合到同一个长期运行的守护进程 waved 与配套命令行 wavecli 中。用户可以加入 Ark、持有和转移 VTXO、在闪电网络与 Ark 之间兑换、进行链上收发,并随时单方面退出到链上,始终由自己掌握资金。
wavelength 可以免费使用吗?用的什么许可证?
wavelength 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
wavelength 还在维护吗?
活跃维护中。wavelength 最近一次提交是在 2026年11月6日。
wavelength 适合用来做什么?
为 Go 应用或服务增加自托管的比特币支付能力。 构建需要通过类型化工具调用收发比特币的 AI 智能体。 运行个人 Ark 钱包,并在闪电网络与 Ark 之间兑换资金。
wavelength 怎么安装和运行?
克隆代码仓库: git clone https://github.com/lightninglabs/wavelength.git 进入项目目录: cd wavelength 构建并安装启用钱包 RPC 功能的 waved 和 wavecli: make install-wavewalletrpc
在哪里获取 wavelength?
源代码和安装说明在 GitHub 上:https://github.com/lightninglabs/wavelength

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目