Skip to Content
dAppsConflux

Conflux

Integrieren Sie die Conflux-Blockchain mit dem Fluent-kompatiblen Provider von OneKey. Zugriff über window.$onekey.conflux.

Der Conflux-Provider von OneKey ist sowohl mit den Schnittstellen von ConfluxPortal als auch von Fluent kompatibel.



Provider erkennen

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

Schnellstart

Konten anfordern

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

Verbindung prüfen

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

Konto und Netzwerk

Chain-ID abrufen

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

Netzwerkversion abrufen

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

Guthaben abrufen

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

Transaktionen

Transaktion senden

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)

Mit Gasschätzung senden

// 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, }] })

Vertrag aufrufen

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

Ereignisbehandlung

Auf Kontoänderungen reagieren

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

Auf Chain-Änderungen reagieren

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

Auf Verbindungen reagieren

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

Mit js-conflux-sdk verwenden

Einrichtung

npm install js-conflux-sdk

Provider verbinden

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

Transaktion mit dem SDK senden

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

Vertragsinteraktion

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

API-Referenz

Methoden

MethodeBeschreibung
request({ method, params })JSON-RPC-Anfrage senden
isConnected()Verbindungsstatus prüfen
on(event, callback)Ereignisse abonnieren
off(event, callback)Ereignisabonnement beenden

RPC-Methoden

MethodeBeschreibung
cfx_requestAccountsVerbindung anfordern
cfx_accountsVerbundene Konten abrufen
cfx_chainIdChain-ID abrufen
cfx_sendTransactionTransaktion senden
cfx_callVertrag aufrufen (rein lesend)
cfx_estimateGasAndCollateralGas schätzen
cfx_getBalanceKontoguthaben abrufen
cfx_getTransactionByHashTransaktion abrufen
cfx_getTransactionReceiptBeleg abrufen
net_versionNetzwerk-ID abrufen

Ereignisse

EreignisParameterBeschreibung
connect{ chainId, networkId }Mit Netzwerk verbunden
disconnect-Getrennt
chainChangedchainIdNetzwerk geändert
accountsChangedaccounts[]Konten geändert

Netzwerke

NetzwerkChain-ID (hex)Netzwerk-ID
Mainnet0x4051029
Testnet0x11

Veraltete Methoden

Diese Methoden funktionieren weiterhin, sind aber veraltet:

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

Fehlerbehandlung

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

Häufige Fehlercodes

CodeBeschreibung
4001Nutzer hat die Anfrage abgelehnt
-32700Parsing-Fehler
-32600Ungültige Anfrage
-32601Methode nicht gefunden
-32602Ungültige Parameter
-32603Interner Fehler

Adressformat

Conflux verwendet Base32-Adressen (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
Zuletzt aktualisiert am