连接问题
无法连接到节点
无法连接到节点
现象: 连接失败或显示「已断开」(Disconnected)解决办法:
- 确认 节点 URL 填写正确
- 检查节点是否正在运行且可访问
- 使用本地节点时,确认它运行在预期端口上
- 使用远程节点时,检查网络/防火墙设置
- 使用 Biscuit/认证令牌时,确认令牌仍然有效
- 在设置 > RGB > RLN 节点(Settings > RGB > RLN node)中重新连接;LND/NWC 则在设置 > Lightning Node(Settings > Lightning Node)中重新连接
交易场所连不上
交易场所连不上
现象: 交换功能不可用,或显示连接错误解决办法:
- 检查相关账户是否已连接
- 使用 KaleidoSwap 做市方交易对时,确认 RLN 状态
- 使用 Flashnet 路由时,确认 Spark 是否可用
- 尝试刷新交换界面
DApp 检测不到提供方
DApp 检测不到提供方
现象: DApp 无法把 KaleidoSwap 扩展识别为钱包解决办法:
- 确认 KaleidoSwap 扩展已安装并已解锁
- 刷新网页
- 检查扩展是否对该站点已启用
- 确认 DApp 使用的是标准提供方——KaleidoSwap 扩展注入
window.webln(WebLN)、window.webbtc、window.nostr(NIP-07)、window.bitcoin和window.rgb - 有些应用会等待就绪事件——扩展会派发
webln:ready、webbtc:ready、nostr:ready、bitcoin:ready和rgb:ready
支付问题
支付失败
支付失败
现象: 发送支付时报错解决办法:
- 检查余额是否充足
- 确认目标地址填写正确
- Lightning 支付需要确认到目标存在可用路由
- 检查发送账户是否在线且已同步
- 稍等一会儿再重试
闪电支付一直处于待处理状态
闪电支付一直处于待处理状态
现象: 一笔闪电支付显示为待处理,且发送功能对该目标被锁定解决办法:
- 钱包会在大约 3 分钟内持续检查支付状态;请等待它完成或失败
- 支付待处理期间,发送功能会对该目标保持锁定,以免重复支付
- 到记录(Activity)中查看最终状态,不要重复支付
发票生成失败
发票生成失败
现象: 无法生成接收发票解决办法:
- 检查节点连接
- 确认节点具备入向流动性(Lightning 场景)
- 尝试生成其他类型(用链上代替 Lightning)
- 重启扩展后重试
扩展问题
扩展无法加载
扩展无法加载
现象: 点击图标没有反应,或弹出窗口空白解决办法:
- 打开
chrome://extensions,检查 KaleidoSwap 扩展是否已启用 - 尝试先禁用再重新启用扩展
- 清理浏览器缓存
- 重启浏览器
- 手动安装的版本可以尝试重新加载扩展
被锁在外/忘记密码
被锁在外/忘记密码
现象: 无法解锁扩展解决办法:
- KaleidoSwap 扩展无法找回密码
- 在锁定界面选择忘记密码?重置钱包(Forgot password? Reset wallet),并输入
RESET确认。这会从当前浏览器中清除钱包。 - 选择导入已有钱包(Import Existing Wallet)并输入助记词
- 设置新密码
- 恢复 RGB 状态(通过云端备份提示或备份文件),并重新连接闪电节点等可选服务
余额不更新
余额不更新
现象: 显示的余额是旧数据解决办法:
- 检查节点连接状态
- 点击余额卡片上的刷新余额(Refresh balances)
- 关闭扩展弹出窗口再重新打开
- 确认节点已同步
获取帮助
如果是疑问而不是报错,请查看常见问题;上游文档与相关链接见更多资源。 其他情况请从下面的渠道中选择一个反馈问题,并附上:- 浏览器名称和版本
- KaleidoSwap 扩展版本(Settings > About)
- 闪电节点类型(RGB Lightning 节点、LND、NWC),如已连接
- 复现步骤
- 错误信息或截图
- 诊断信息:设置 > 发送反馈(Settings > Send Feedback)→ 在消息中附加诊断信息(Append diagnostics to message),或下载诊断信息(Download diagnostics)
Telegram 社群
向社群提问。
报告 Bug
提交 Bug 报告和测试版反馈。
申请测试版访问权限
申请加入 KaleidoSwap 扩展的封闭测试。