Skip to Content
dApp 接入快速开始

dApp 集成

通过目标链的 provider 或钱包连接库,将 dApp 接入 OneKey 钱包。

选择集成方式

方式适用场景框架
RainbowKit现成钱包 UI,React 应用React
Web3Modal多框架钱包 UIReact / Vue / JS
Web3-Onboard高度定制化,多框架支持React / Vue / JS
Wagmi自定义 UI + React hooksReact
Provider API完全控制,无依赖任意

快速建议: React 应用使用 RainbowKit,Vue/原生 JS 使用 Web3Modal 或 Web3-Onboard。


快速开始

RainbowKit (React)

npm install @rainbow-me/rainbowkit@^2 wagmi@^2 viem@^2 @tanstack/react-query@^5
App.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 rdnsso.onekey.app.wallet
Providerwindow.$onekey.ethereum

支持的链

EVM: Ethereum 及支持的 EVM 网络,包括 Polygon、BSC、Arbitrum、Optimism 和 Base。

非 EVM: Bitcoin, Solana, Cosmos, Aptos, Sui, TON, TRON, Polkadot, Cardano, NEAR 等

查看所有 Provider API


资源

最后更新于