跳转到主要内容

连接问题

现象: 连接失败或显示「已断开」(Disconnected)解决办法:
  1. 确认 节点 URL 填写正确
  2. 检查节点是否正在运行且可访问
  3. 使用本地节点时,确认它运行在预期端口上
  4. 使用远程节点时,检查网络/防火墙设置
  5. 使用 Biscuit/认证令牌时,确认令牌仍然有效
  6. 在设置 > RGB > RLN 节点(Settings > RGB > RLN node)中重新连接;LND/NWC 则在设置 > Lightning Node(Settings > Lightning Node)中重新连接
现象: 交换功能不可用,或显示连接错误解决办法:
  1. 检查相关账户是否已连接
  2. 使用 KaleidoSwap 做市方交易对时,确认 RLN 状态
  3. 使用 Flashnet 路由时,确认 Spark 是否可用
  4. 尝试刷新交换界面
现象: DApp 无法把 KaleidoSwap 扩展识别为钱包解决办法:
  1. 确认 KaleidoSwap 扩展已安装并已解锁
  2. 刷新网页
  3. 检查扩展是否对该站点已启用
  4. 确认 DApp 使用的是标准提供方——KaleidoSwap 扩展注入 window.webln(WebLN)、window.webbtc、window.nostr(NIP-07)、window.bitcoin 和 window.rgb
  5. 有些应用会等待就绪事件——扩展会派发 webln:ready、webbtc:ready、nostr:ready、bitcoin:ready 和 rgb:ready

支付问题

现象: 发送支付时报错解决办法:
  1. 检查余额是否充足
  2. 确认目标地址填写正确
  3. Lightning 支付需要确认到目标存在可用路由
  4. 检查发送账户是否在线且已同步
  5. 稍等一会儿再重试
现象: 一笔闪电支付显示为待处理,且发送功能对该目标被锁定解决办法:
  1. 钱包会在大约 3 分钟内持续检查支付状态;请等待它完成或失败
  2. 支付待处理期间,发送功能会对该目标保持锁定,以免重复支付
  3. 到记录(Activity)中查看最终状态,不要重复支付
现象: 无法生成接收发票解决办法:
  1. 检查节点连接
  2. 确认节点具备入向流动性(Lightning 场景)
  3. 尝试生成其他类型(用链上代替 Lightning)
  4. 重启扩展后重试

扩展问题

现象: 点击图标没有反应,或弹出窗口空白解决办法:
  1. 打开 chrome://extensions,检查 KaleidoSwap 扩展是否已启用
  2. 尝试先禁用再重新启用扩展
  3. 清理浏览器缓存
  4. 重启浏览器
  5. 手动安装的版本可以尝试重新加载扩展
现象: 无法解锁扩展解决办法:
  1. KaleidoSwap 扩展无法找回密码
  2. 在锁定界面选择忘记密码?重置钱包(Forgot password? Reset wallet),并输入 RESET 确认。这会从当前浏览器中清除钱包。
  3. 选择导入已有钱包(Import Existing Wallet)并输入助记词
  4. 设置新密码
  5. 恢复 RGB 状态(通过云端备份提示或备份文件),并重新连接闪电节点等可选服务
现象: 显示的余额是旧数据解决办法:
  1. 检查节点连接状态
  2. 点击余额卡片上的刷新余额(Refresh balances)
  3. 关闭扩展弹出窗口再重新打开
  4. 确认节点已同步

获取帮助

如果是疑问而不是报错,请查看常见问题;上游文档与相关链接见更多资源。 其他情况请从下面的渠道中选择一个反馈问题,并附上:
  1. 浏览器名称和版本
  2. KaleidoSwap 扩展版本(Settings > About)
  3. 闪电节点类型(RGB Lightning 节点、LND、NWC),如已连接
  4. 复现步骤
  5. 错误信息或截图
  6. 诊断信息:设置 > 发送反馈(Settings > Send Feedback)→ 在消息中附加诊断信息(Append diagnostics to message),或下载诊断信息(Download diagnostics)

Telegram 社群

向社群提问。

报告 Bug

提交 Bug 报告和测试版反馈。

申请测试版访问权限

申请加入 KaleidoSwap 扩展的封闭测试。