Skip to Content
Connect to Software

Getting Started

Learn how to detect, connect, and interact with Aptos using OneKey’s provider.

OneKey’s Aptos provider is fully compatible with the Petra wallet interface and Aptos Wallet Standard.


Provider Detection

// Detect OneKey Aptos provider const provider = window.$onekey?.aptos if (!provider) { throw new Error('OneKey Aptos provider not detected') } // Check provider info console.log('Provider:', provider.isOneKey ? 'OneKey' : 'Unknown')

Connect Wallet

// Connect and get account info const response = await provider.connect() console.log({ address: response.address, // Account address publicKey: response.publicKey, // Public key })

Check Connection Status

const isConnected = await provider.isConnected() console.log('Connected:', isConnected)

Get Current Account

const account = await provider.account() console.log({ address: account.address, publicKey: account.publicKey, })

Get Network Info

const network = await provider.network() console.log('Network:', network) // 'mainnet', 'testnet', 'devnet' // For full network info const networkInfo = await provider.getNetwork() console.log({ name: networkInfo.name, chainId: networkInfo.chainId, url: networkInfo.url, })

Disconnect

await provider.disconnect()

Event Listeners

Listen for Account Changes

provider.onAccountChange((newAccount) => { if (newAccount) { console.log('Account changed:', newAccount.address) } else { console.log('Wallet disconnected') } })

Listen for Network Changes

provider.onNetworkChange((network) => { console.log('Network changed:', network) })

Migration from Petra

OneKey’s Aptos provider is Petra-compatible. Update your provider detection:

// Before (Petra only) const provider = window.petra // After (OneKey with Petra fallback) const provider = window.$onekey?.aptos || window.petra

Using with Aptos Wallet Adapter

For React applications, use the official Aptos Wallet Adapter:

npm install @aptos-labs/wallet-adapter-react
import { AptosWalletAdapterProvider } from '@aptos-labs/wallet-adapter-react' function App() { return ( <AptosWalletAdapterProvider> <YourApp /> </AptosWalletAdapterProvider> ) }

OneKey is automatically detected by the Aptos Wallet Adapter.

Last updated on