本页目录

快速开始

准备交易前，先连接 provider 并读取当前网络。这些示例适用于 Conflux Core Space。请替换省略的地址，并在调用 SDK 方法前初始化客户端。

了解如何检测、连接和与 Conflux 进行交互。

OneKey 的 Conflux provider 同时兼容 ConfluxPortal 和 Fluent 钱包接口。

Provider 检测


// Detect OneKey Conflux provider
const provider = window.$onekey?.conflux
 
if (!provider) {
  throw new Error('OneKey Conflux provider not detected')
}
 
// Check compatibility flags
console.log('isConfluxPortal:', provider.isConfluxPortal) // true
console.log('isFluent:', provider.isFluent) // true
console.log('isOneKey:', provider.isOneKey) // true

请求账户


const accounts = await provider.request({
  method: 'cfx_requestAccounts'
})
 
console.log('Connected:', accounts[0])

检查连接


if (provider.isConnected()) {
  const accounts = await provider.request({ method: 'cfx_accounts' })
  console.log('Accounts:', accounts)
}

获取链 ID


const chainId = await provider.request({ method: 'cfx_chainId' })
console.log('Chain ID:', chainId) // e.g., '0x405' for mainnet

获取网络版本


const networkId = await provider.request({ method: 'net_version' })
console.log('Network ID:', networkId) // e.g., '1029' for mainnet

获取余额


const balance = await provider.request({
  method: 'cfx_getBalance',
  params: [address, 'latest_state']
})
 
console.log('Balance:', balance) // In Drip (1 CFX = 10^18 Drip)

事件处理

监听账户变更


provider.on('accountsChanged', (accounts) => {
  if (accounts.length === 0) {
    console.log('Disconnected')
  } else {
    console.log('Account changed:', accounts[0])
  }
})

监听链变更


provider.on('chainChanged', (chainId) => {
  console.log('Chain changed:', chainId)
  // Recommend reloading the page
  window.location.reload()
})

监听连接


provider.on('connect', ({ chainId, networkId }) => {
  console.log('Connected to:', chainId, networkId)
})
 
provider.on('disconnect', () => {
  console.log('Disconnected')
})

地址格式

Conflux 使用 base32 地址 (CIP-37)：


// Mainnet: cfx:...
// Testnet: cfxtest:...
 
// Example mainnet address
const address = 'cfx:aak2rra2njvd77ezwjvx04kkds9fzagfe6ku8scz91'
 
// Convert between formats using js-conflux-sdk
import { format } from 'js-conflux-sdk'
 
const hexAddress = format.hexAddress(address)
const base32Address = format.address(hexAddress, 1029) // networkId

网络

网络	链 ID (十六进制)	网络 ID
主网	`0x405`	1029
测试网	`0x1`	1