说明
概述
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
按业务目标选择对应接口:
事件流
- 关键事件:账户切换、网络变化。
- 更多信息:查看更多