Auf dieser Seite
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.
Direktlinks
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)
}Polkadot.js Extension API verwenden (empfohlen)
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-dappVerbinden 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
| Methode | Beschreibung |
|---|---|
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
| Chain | Beschreibung |
|---|---|
| Polkadot | Haupt-Relay-Chain |
| Kusama | Canary-Netzwerk |
| Acala | DeFi-Zentrum |
| Moonbeam | EVM-kompatibel |
| Astar | Smart-Contract-Plattform |
| Weitere Substrate-Chains | Wallet- 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