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.petraUsing with Aptos Wallet Adapter
For React applications, use the official Aptos Wallet Adapter:
npm install @aptos-labs/wallet-adapter-reactimport { 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