Getting Started

Connect to Aptos using OneKey's Petra-compatible provider

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

function App() {
  return (
    <AptosWalletAdapterProvider>
      <YourApp />
    </AptosWalletAdapterProvider>
  )
}

OneKey is automatically detected by the Aptos Wallet Adapter.