Skip to Content
dAppsConflux

Conflux

Integra la cadena de bloques Conflux mediante el proveedor de OneKey compatible con Fluent. Accede a través de window.$onekey.conflux.

El proveedor de Conflux de OneKey es compatible con las interfaces de ConfluxPortal y Fluent.



Detección del proveedor

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

Inicio rápido

Solicitar cuentas

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

Comprobar la conexión

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

Cuenta y red

Obtener el ID de cadena

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

Obtener la versión de red

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

Obtener el saldo

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

Transacciones

Enviar una transacción

const txHash = await provider.request({ method: 'cfx_sendTransaction', params: [{ from: senderAddress, to: recipientAddress, value: '0xDE0B6B3A7640000', // 1 CFX in Drip (hex) gas: '0x5208', // 21000 }] }) console.log('Transaction hash:', txHash)

Enviar con estimación de gas

// Estimate gas first const gasEstimate = await provider.request({ method: 'cfx_estimateGasAndCollateral', params: [{ from: senderAddress, to: recipientAddress, value: '0xDE0B6B3A7640000', }] }) // Send with estimated values const txHash = await provider.request({ method: 'cfx_sendTransaction', params: [{ from: senderAddress, to: recipientAddress, value: '0xDE0B6B3A7640000', gas: gasEstimate.gasLimit, storageLimit: gasEstimate.storageCollateralized, }] })

Llamar a un contrato

const result = await provider.request({ method: 'cfx_call', params: [{ to: contractAddress, data: encodedFunctionCall, }, 'latest_state'] }) console.log('Result:', result)

Gestión de eventos

Escuchar cambios de cuenta

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

Escuchar cambios de cadena

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

Escuchar conexiones

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

Uso con js-conflux-sdk

Configuración

npm install js-conflux-sdk

Conectar el proveedor

import { Conflux } from 'js-conflux-sdk' const conflux = new Conflux({ url: 'https://main.confluxrpc.com', networkId: 1029, }) // Use OneKey provider for signing conflux.provider = provider

Enviar una transacción con el SDK

// Create and send transaction const tx = conflux.cfx.sendTransaction({ from: senderAddress, to: recipientAddress, value: Conflux.Drip.fromCFX(1), // 1 CFX }) console.log('Transaction:', tx) // Wait for confirmation const receipt = await tx.executed() console.log('Receipt:', receipt)

Interacción con contratos

const contract = conflux.Contract({ abi: contractABI, address: contractAddress, }) // Read const result = await contract.someViewFunction().call() // Write const tx = contract.someWriteFunction(param1, param2).sendTransaction({ from: senderAddress, }) const receipt = await tx.executed()

Referencia de la API

Métodos

MétodoDescripción
request({ method, params })Enviar una solicitud JSON-RPC
isConnected()Comprobar el estado de conexión
on(event, callback)Suscribirse a eventos
off(event, callback)Cancelar la suscripción a eventos

Métodos RPC

MétodoDescripción
cfx_requestAccountsSolicitar conexión
cfx_accountsObtener las cuentas conectadas
cfx_chainIdObtener el ID de cadena
cfx_sendTransactionEnviar una transacción
cfx_callLlamar a un contrato (solo lectura)
cfx_estimateGasAndCollateralEstimar el gas
cfx_getBalanceObtener el saldo de la cuenta
cfx_getTransactionByHashObtener una transacción
cfx_getTransactionReceiptObtener el recibo
net_versionObtener el ID de red

Eventos

EventoParámetrosDescripción
connect{ chainId, networkId }Conectado a la red
disconnect-Desconectado
chainChangedchainIdRed cambiada
accountsChangedaccounts[]Cuentas cambiadas

Redes

RedID de cadena (hexadecimal)ID de red
Red principal0x4051029
Red de pruebas0x11

Métodos obsoletos

Estos métodos siguen funcionando, pero están obsoletos:

// Deprecated: use request({ method: 'cfx_requestAccounts' }) await provider.enable() // Deprecated: use request() await provider.send({ method: 'cfx_accounts' }) await provider.sendAsync({ method: 'cfx_accounts' }, callback) // Deprecated: use request({ method: 'cfx_chainId' }) provider.chainId // Deprecated: use request({ method: 'net_version' }) provider.networkVersion // Deprecated: use request({ method: 'cfx_accounts' }) provider.selectedAddress

Gestión de errores

try { const accounts = await provider.request({ method: 'cfx_requestAccounts' }) } catch (error) { if (error.code === 4001) { console.log('User rejected the request') } else if (error.code === -32603) { console.log('Internal error') } else { console.error('Error:', error.message) } }

Códigos de error habituales

CódigoDescripción
4001El usuario rechazó la solicitud
-32700Error de análisis
-32600Solicitud no válida
-32601Método no encontrado
-32602Parámetros no válidos
-32603Error interno

Formato de dirección

Conflux usa direcciones 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
Última actualización el