跳到主要内容

说明

概述

Web 应用接入 UKey Wallet BTC Provider 后,可以请求用户授权 BTC 账户,并继续调用账户读取、转账、消息签名等能力。

部署

1. 安装 UKey Wallet

安装 UKey Wallet 浏览器扩展,并确认钱包已完成初始化。

2. API 注入说明

  • UKey Wallet 浏览器扩展会向页面注入 BTC Provider。
  • 可用入口包括 window.$ukey.btc 和兼容入口 window.unisat
  • 新项目建议优先使用 window.$ukey.btc

两个入口能力一致,差异主要在命名和兼容目的。

检测 Provider API 支持

调用账户或签名方法前,先检查当前浏览器环境是否存在 Provider:

const provider = (window.$ukey && window.$ukey.btc) || window.unisat;

if (!provider) {
alert("UKey Wallet 未安装。");
}

连接到 UKey Wallet

使用其他 BTC API 前,请先调用 provider.requestAccounts 请求用户授权账户访问。

provider.requestAccounts()

用户确认后,应用才能继续读取账户或发起签名、付款请求。

API

按业务目标选择对应接口:

事件流

  • 关键事件:账户切换、网络变化。
  • 更多信息查看更多