Skip to Content
dAppsPolkadot

Polkadot

Integrieren Sie Polkadot und Substrate-basierte Chains mit dem Provider von OneKey. Zugriff über window.$onekey.polkadot oder die Polkadot.js Extension API.

OneKey implementiert die Polkadot.js-Erweiterungsschnittstelle für die hier dokumentierten Vorgänge.



Provider erkennen

// OneKey registers as a Polkadot.js extension const provider = window.$onekey?.polkadot // Or use the standard web3Enable API import { web3Enable, web3Accounts } from '@polkadot/extension-dapp'

Schnellstart

Erweiterung aktivieren

// Using OneKey provider directly const enabled = await provider.web3Enable('My dApp') if (enabled) { const accounts = await provider.web3Accounts() console.log('Accounts:', accounts) }
import { web3Enable, web3Accounts } from '@polkadot/extension-dapp' // Enable all extensions (including OneKey) const extensions = await web3Enable('My dApp') if (extensions.length === 0) { throw new Error('No extension found') } // Get all accounts const allAccounts = await web3Accounts() console.log('Accounts:', allAccounts)

Kontoverwaltung

Konten abrufen

const accounts = await provider.web3Accounts() accounts.forEach(account => { console.log({ address: account.address, // Substrate address name: account.name, // Account name type: account.type, // 'sr25519' | 'ed25519' | 'ecdsa' genesisHash: account.genesisHash, // Optional chain genesis }) })

Kontoänderungen abonnieren

const unsubscribe = provider.web3AccountsSubscribe((accounts) => { console.log('Accounts changed:', accounts) }) // Later: unsubscribe()

Signieren

Transaktionsnutzlast signieren

Extrinsic-Nutzlasten signieren:

import { web3FromAddress } from '@polkadot/extension-dapp' // Get injector for specific account const injector = await web3FromAddress(accountAddress) // Sign payload const payload = { address: accountAddress, blockHash: '0x...', blockNumber: '0x...', era: '0x...', genesisHash: '0x...', method: '0x...', nonce: '0x...', specVersion: '0x...', tip: '0x...', transactionVersion: '0x...', signedExtensions: [], // Populate from current chain metadata; do not sign this placeholder version: 4, } const result = await provider.web3SignPayload(payload) console.log({ id: result.id, signature: result.signature, // Hex signature })

Rohnachricht signieren

const payload = { address: accountAddress, data: '0x48656c6c6f', // Hex-encoded message type: 'bytes', } const result = await provider.web3SignRaw(payload) console.log({ id: result.id, signature: result.signature, })

Mit der Polkadot.js-API verwenden

Einrichtung

npm install @polkadot/api @polkadot/extension-dapp

Verbinden und Transaktion signieren

import { ApiPromise, WsProvider } from '@polkadot/api' import { web3Enable, web3FromAddress, web3Accounts } from '@polkadot/extension-dapp' // Enable extensions await web3Enable('My dApp') // Get accounts const accounts = await web3Accounts() const account = accounts[0] if (!account) throw new Error("No account was selected") // Connect to chain const wsProvider = new WsProvider('wss://rpc.polkadot.io') const api = await ApiPromise.create({ provider: wsProvider }) // Get injector const injector = await web3FromAddress(account.address) // Create and sign transaction const tx = api.tx.balances.transferKeepAlive( recipientAddress, '10000000000' // 1 DOT = 10^10 planck on Polkadot ) // Sign and send const hash = await tx.signAndSend( account.address, { signer: injector.signer } ) console.log('Transaction hash:', hash.toHex())

Auf Transaktionsereignisse reagieren

await tx.signAndSend( account.address, { signer: injector.signer }, ({ status, events }) => { if (status.isInBlock) { console.log('In block:', status.asInBlock.toHex()) } if (status.isFinalized) { console.log('Finalized:', status.asFinalized.toHex()) events.forEach(({ event }) => { if (api.events.system.ExtrinsicSuccess.is(event)) { console.log('Transaction succeeded') } if (api.events.system.ExtrinsicFailed.is(event)) { console.log('Transaction failed') } }) } } )

RPC-Methoden

RPC-Anfrage senden

const response = await provider.web3RpcSend({ method: 'chain_getHeader', params: [], }) console.log('Latest header:', response.result)

RPC-Ereignisse abonnieren

const subscriptionId = await provider.web3RpcSubscribe( { method: 'chain_subscribeNewHeads', params: [], }, (response) => { console.log('New block:', response.result) } ) // Unsubscribe later await provider.web3RpcUnSubscribe()

Verfügbare Provider auflisten

const providers = await provider.web3RpcListProviders() console.log('Available providers:', providers)

API-Referenz

Methoden

MethodeBeschreibung
web3Enable(dappName)Erweiterung für dApp aktivieren
web3Accounts(anyType?)Alle Konten abrufen
web3AccountsSubscribe(callback)Kontoänderungen abonnieren
web3SignPayload(payload)Transaktionsnutzlast signieren
web3SignRaw(payload)Rohnachricht signieren
web3RpcSend(request)RPC-Anfrage senden
web3RpcSubscribe(request, callback)RPC-Ereignisse abonnieren
web3RpcUnSubscribe()Alle Abonnements beenden
web3RpcListProviders()RPC-Provider auflisten
web3RpcStartProvider(key)Bestimmten Provider starten

Typen

interface InjectedAccount { address: string // Substrate address name?: string // Account name type?: 'sr25519' | 'ed25519' | 'ecdsa' genesisHash?: string // Optional chain restriction } interface SignerPayloadJSON { address: string blockHash: string blockNumber: string era: string genesisHash: string method: string nonce: string specVersion: string tip: string transactionVersion: string signedExtensions: string[] version: number } interface SignerPayloadRaw { address: string data: string // Hex-encoded data type: 'bytes' | 'payload' } interface SignerResult { id: number signature: string // Hex signature }

Unterstützte Chains

ChainBeschreibung
PolkadotHaupt-Relay-Chain
KusamaCanary-Netzwerk
AcalaDeFi-Zentrum
MoonbeamEVM-kompatibel
AstarSmart-Contract-Plattform
Weitere Substrate-ChainsWallet- und Laufzeitunterstützung vor der Verwendung prüfen

Fehlerbehandlung

try { const result = await provider.web3SignPayload(payload) } catch (error) { if (error.message === 'Cancelled') { console.log('User cancelled signing') } else { console.error('Signing failed:', error) } }

Mit React verwenden

import { useState, useEffect } from 'react' import { web3Enable, web3Accounts } from '@polkadot/extension-dapp' function usePolkadotWallet() { const [accounts, setAccounts] = useState([]) const [isConnected, setIsConnected] = useState(false) const connect = async () => { const extensions = await web3Enable('My dApp') if (extensions.length > 0) { const allAccounts = await web3Accounts() setAccounts(allAccounts) setIsConnected(true) } } return { accounts, isConnected, connect } }
Zuletzt aktualisiert am