Skip to Content
dAppsInicio rápido

Integración con dApps

Conecta tu dApp con la cartera OneKey mediante un proveedor específico de la cadena o una biblioteca de conexión de carteras.

Elige tu método

MétodoIdeal paraFramework
RainbowKitInterfaz de cartera lista para usar en aplicaciones ReactReact
Web3ModalInterfaz de cartera para varios frameworksReact / Vue / JS
Web3-OnboardAmplias opciones de personalización y varios frameworksReact / Vue / JS
WagmiInterfaz personalizada con hooks de ReactReact
API del proveedorControl total, sin dependenciasCualquiera

Recomendación rápida: Usa RainbowKit para aplicaciones React y Web3Modal o Web3-Onboard para Vue o JavaScript sin framework.


Inicio rápido

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> ) }

Guía completa

API del proveedor (sin dependencias)

// 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)

Guía completa


Detección de OneKey

PropiedadValor
EIP-6963 rdnsso.onekey.app.wallet
Proveedorwindow.$onekey.ethereum

Cadenas compatibles

EVM: Ethereum y redes EVM compatibles, como Polygon, BSC, Arbitrum, Optimism y Base

No EVM: Bitcoin, Solana, Cosmos, Aptos, Sui, TON, TRON, Polkadot, Cardano, NEAR, y más

Ver todas las API de proveedores


Recursos

Última actualización el