用途:btc-connect 用于在比特币 Web3 应用中集成钱包连接功能,提供统一连接接口、事件监听和适配层,支持 React、Vue、Next.js、Nuxt 3 项目,适配 UniSat 和 OKX 钱包,并处理 SSR 环境兼容问题。
主要能力:安装并管理 @btc-connect/core、@btc-connect/react、@btc-connect/vue 依赖,最低版本要求 v0.4.0+;提供 React Hooks(useWallet、useNetwork、useAccount、useAutoConnect 等)与 Vue Composables;支持主网 livenet、测试网 testnet、回归测试网 regtest 的网络切换;UniSat 支持程序化网络切换,OKX 通常需用户手动切换;提供增强钱包检测(20 秒内每 300ms 轮询延迟注入)、缓存与错误处理等性能优化。
使用方式:React 项目安装 bun add @btc-connect/core @btc-connect/react,用 BTCWalletProvider 包装应用;Vue 项目安装 bun add @btc-connect/core @btc-connect/vue,使用 BTCWalletPlugin;Next.js 使用 'use client' 与动态导入;Nuxt 3 使用客户端插件与 ClientOnly。网络切换示例:const { network, switchNetwork } = useNetwork(),await switchNetwork('testnet')。
适用场景:React/Vue 项目集成比特币钱包、Next.js/Nuxt 3 SSR 配置、网络切换、UniSat/OKX 集成、连接失败或 SSR 兼容排查、升级到 v0.4.0+。
限制:Node.js 需 >= 18;OKX 网络切换能力有限,需引导用户手动操作;SSR 下需避免服务端访问 window;版本兼容与依赖冲突需自行检查。其他收费、价格、平台等信息暂未提供。