Skip to Content
dAppsPolkadot

Polkadot

Integra Polkadot y las cadenas basadas en Substrate mediante el proveedor de OneKey. Accede a través de window.$onekey.polkadot o de la API de la extensión Polkadot.js.

OneKey implementa la interfaz de la extensión Polkadot.js para las operaciones documentadas aquí.



Detección del proveedor

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

Inicio rápido

Habilitar la extensión

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

Administración de cuentas

Obtener cuentas

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

Suscribirse a cambios de cuenta

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

Firma

Firmar los datos de una transacción

Firma los datos de extrínsecos:

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

Firmar un mensaje en bruto

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

Uso con la API de Polkadot.js

Configuración

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

Conectar y firmar una transacción

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

Escuchar eventos de transacciones

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

Métodos RPC

Enviar una solicitud RPC

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

Suscribirse a eventos RPC

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

Enumerar los proveedores disponibles

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

Referencia de la API

Métodos

MétodoDescripción
web3Enable(dappName)Habilitar la extensión para la dApp
web3Accounts(anyType?)Obtener todas las cuentas
web3AccountsSubscribe(callback)Suscribirse a cambios de cuenta
web3SignPayload(payload)Firmar los datos de la transacción
web3SignRaw(payload)Firmar un mensaje en bruto
web3RpcSend(request)Enviar una solicitud RPC
web3RpcSubscribe(request, callback)Suscribirse a eventos RPC
web3RpcUnSubscribe()Cancelar todas las suscripciones
web3RpcListProviders()Enumerar los proveedores RPC
web3RpcStartProvider(key)Iniciar un proveedor específico

Tipos

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 }

Cadenas compatibles

CadenaDescripción
PolkadotCadena de retransmisión principal
KusamaRed canaria
AcalaCentro DeFi
MoonbeamCompatible con EVM
AstarPlataforma de contratos inteligentes
Otras cadenas de SubstrateVerifica la compatibilidad de la cartera y del entorno de ejecución antes de usar

Gestión de errores

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

Uso con React

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 } }
Última actualización el