Skip to Content
dAppsConflux

Conflux

Intégrez la blockchain Conflux à l’aide du fournisseur OneKey compatible Fluent. Accès via window.$onekey.conflux.

Le fournisseur Conflux OneKey est compatible avec les interfaces des portefeuilles ConfluxPortal et Fluent.



Détection du fournisseur

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

Démarrage rapide

Demander les comptes

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

Vérifier la connexion

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

Compte et réseau

Obtenir l’ID de chaîne

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

Obtenir la version du réseau

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

Obtenir le solde

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

Transactions

Envoyer une transaction

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)

Envoyer avec estimation du 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, }] })

Appeler un contrat

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

Gestion des événements

Écouter les changements de compte

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

Écouter les changements de chaîne

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

Écouter la connexion

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

Utilisation avec js-conflux-sdk

Configuration

npm install js-conflux-sdk

Connecter le fournisseur

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

Envoyer une transaction avec le 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)

Interaction avec un contrat

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()

Référence de l’API

Méthodes

MéthodeDescription
request({ method, params })Envoyer une requête JSON-RPC
isConnected()Vérifier l’état de connexion
on(event, callback)S’abonner aux événements
off(event, callback)Se désabonner des événements

Méthodes RPC

MéthodeDescription
cfx_requestAccountsDemander une connexion
cfx_accountsObtenir les comptes connectés
cfx_chainIdObtenir l’ID de chaîne
cfx_sendTransactionEnvoyer une transaction
cfx_callAppeler un contrat (lecture seule)
cfx_estimateGasAndCollateralEstimer le gas
cfx_getBalanceObtenir le solde du compte
cfx_getTransactionByHashObtenir une transaction
cfx_getTransactionReceiptObtenir un reçu
net_versionObtenir l’ID du réseau

Événements

ÉvénementParamètresDescription
connect{ chainId, networkId }Connecté au réseau
disconnect-Déconnecté
chainChangedchainIdRéseau modifié
accountsChangedaccounts[]Comptes modifiés

Réseaux

RéseauID de chaîne (hex)ID du réseau
Mainnet0x4051029
Testnet0x11

Méthodes obsolètes

Ces méthodes fonctionnent encore mais sont obsolètes :

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

Gestion des erreurs

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) } }

Codes d’erreur courants

CodeDescription
4001Demande rejetée par l’utilisateur
-32700Erreur d’analyse
-32600Requête non valide
-32601Méthode introuvable
-32602Paramètres non valides
-32603Erreur interne

Format d’adresse

Conflux utilise des adresses 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
Dernière mise à jour le