本页目录
dApp 集成
通过目标链的 provider 或钱包连接库,将 dApp 接入 OneKey 钱包。
选择集成方式
| 方式 | 适用场景 | 框架 |
|---|---|---|
| RainbowKit | 现成钱包 UI,React 应用 | React |
| Web3Modal | 多框架钱包 UI | React / Vue / JS |
| Web3-Onboard | 高度定制化,多框架支持 | React / Vue / JS |
| Wagmi | 自定义 UI + React hooks | React |
| Provider API | 完全控制,无依赖 | 任意 |
快速建议: React 应用使用 RainbowKit,Vue/原生 JS 使用 Web3Modal 或 Web3-Onboard。
快速开始
RainbowKit (React)
npm install @rainbow-me/rainbowkit@^2 wagmi@^2 viem@^2 @tanstack/react-query@^5App.tsx
import '@rainbow-me/rainbowkit/styles.css'
import { getDefaultConfig, RainbowKitProvider, ConnectButton } from '@rainbow-me/rainbowkit'
import { oneKeyWallet, injectedWallet, walletConnectWallet } from '@rainbow-me/rainbowkit/wallets'
import { WagmiProvider } from 'wagmi'
import { mainnet } from 'wagmi/chains'
import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
const config = getDefaultConfig({
appName: 'My dApp',
wallets: [{ groupName: 'Wallets', wallets: [oneKeyWallet, injectedWallet, walletConnectWallet] }],
projectId: 'YOUR_WALLETCONNECT_PROJECT_ID', // Get from cloud.reown.com
chains: [mainnet],
})
const queryClient = new QueryClient()
export default function App() {
return (
<WagmiProvider config={config}>
<QueryClientProvider client={queryClient}>
<RainbowKitProvider>
<ConnectButton />
</RainbowKitProvider>
</QueryClientProvider>
</WagmiProvider>
)
}Provider API(无依赖)
// Detect OneKey using EIP-6963
let onekeyProvider = null
const onAnnounce = (event) => {
if (event.detail.info.rdns === 'so.onekey.app.wallet') {
onekeyProvider = event.detail.provider
}
}
window.addEventListener('eip6963:announceProvider', onAnnounce)
window.dispatchEvent(new Event('eip6963:requestProvider'))
// Call from your Connect button after the user selects OneKey.
async function connectOneKey() {
if (!onekeyProvider) throw new Error('OneKey has not announced a provider yet')
return onekeyProvider.request({ method: 'eth_requestAccounts' })
}
// On component cleanup:
// window.removeEventListener('eip6963:announceProvider', onAnnounce)OneKey 检测
| 属性 | 值 |
|---|---|
EIP-6963 rdns | so.onekey.app.wallet |
| Provider | window.$onekey.ethereum |
支持的链
EVM: Ethereum 及支持的 EVM 网络,包括 Polygon、BSC、Arbitrum、Optimism 和 Base。
非 EVM: Bitcoin, Solana, Cosmos, Aptos, Sui, TON, TRON, Polkadot, Cardano, NEAR 等
资源
- 更新日志: cross-inpage-provider releases
- 源代码: cross-inpage-provider
- 问题反馈: GitHub Issues
- 在线演示: Provider 示例
最后更新于