Skip to Content
dAppsCosmos

Cosmos

Integrieren Sie Chains des Cosmos-Ökosystems mit dem Keplr-kompatiblen Provider von OneKey. Zugriff über window.$onekey.cosmos.

OneKey stellt Keplr-kompatible Methoden bereit. Prüfen Sie die von Ihrer Anwendung benötigten Methoden und Chains anhand der Ziel-Wallet-Version.



Provider erkennen

// Detect OneKey Cosmos provider const provider = window.$onekey?.cosmos if (!provider) { throw new Error('OneKey Cosmos provider not detected') } // Check if it's OneKey console.log('Provider:', provider.isOneKey ? 'OneKey' : 'Unknown')

Schnellstart

Mit Chain verbinden

const chainId = 'cosmoshub-4' // Request access to the chain. Read key information separately with getKey(). await provider.enable(chainId) // Or enable multiple chains at once await provider.enable(['cosmoshub-4', 'osmosis-1', 'juno-1'])

Kontoinformationen abrufen

const chainId = 'cosmoshub-4' const key = await provider.getKey(chainId) console.log({ name: key.name, // Account name algo: key.algo, // Signing algorithm (secp256k1) pubKey: key.pubKey, // Public key (Uint8Array) address: key.address, // Raw address bytes bech32Address: key.bech32Address, // Bech32 formatted address isNanoLedger: key.isNanoLedger, // Ledger compatibility flag })

Chain-Verwaltung

Benutzerdefinierte Chain hinzufügen

Verwenden Sie experimentalSuggestChain, um nicht nativ unterstützte Chains hinzuzufügen:

await provider.experimentalSuggestChain({ chainId: 'my-chain-1', chainName: 'My Custom Chain', rpc: 'https://rpc.mychain.io', rest: 'https://lcd.mychain.io', bip44: { coinType: 118 }, bech32Config: { bech32PrefixAccAddr: 'mychain', bech32PrefixAccPub: 'mychainpub', bech32PrefixValAddr: 'mychainvaloper', bech32PrefixValPub: 'mychainvaloperpub', bech32PrefixConsAddr: 'mychainvalcons', bech32PrefixConsPub: 'mychainvalconspub', }, currencies: [{ coinDenom: 'TOKEN', coinMinimalDenom: 'utoken', coinDecimals: 6, }], feeCurrencies: [{ coinDenom: 'TOKEN', coinMinimalDenom: 'utoken', coinDecimals: 6, gasPriceStep: { low: 0.01, average: 0.025, high: 0.04 }, }], stakeCurrency: { coinDenom: 'TOKEN', coinMinimalDenom: 'utoken', coinDecimals: 6, }, })

Trennen

await provider.disconnect()

Nachrichten signieren

Amino signieren (Legacy)

Für ältere Amino-kodierte Transaktionen:

const chainId = 'cosmoshub-4' const signer = 'cosmos1...' const signDoc = { chain_id: chainId, account_number: '0', sequence: '0', fee: { amount: [{ denom: 'uatom', amount: '5000' }], gas: '200000', }, msgs: [{ type: 'cosmos-sdk/MsgSend', value: { from_address: signer, to_address: 'cosmos1...', amount: [{ denom: 'uatom', amount: '1000000' }], }, }], memo: '', } const result = await provider.signAmino(chainId, signer, signDoc) console.log({ signed: result.signed, // Signed document signature: result.signature, // { pub_key, signature } })

Direct signieren (Protobuf)

Für moderne Protobuf-kodierte Transaktionen:

import { makeSignDoc } from '@cosmjs/proto-signing' const chainId = 'cosmoshub-4' const signer = 'cosmos1...' const signDoc = makeSignDoc( bodyBytes, // Transaction body authInfoBytes, // Auth info with fee chainId, accountNumber ) const result = await provider.signDirect(chainId, signer, signDoc) console.log({ signed: result.signed, signature: result.signature, })

Beliebige Daten signieren

Zum Signieren beliebiger Nachrichten (nützlich zur Authentifizierung):

const chainId = 'cosmoshub-4' const signer = 'cosmos1...' const data = 'Login to MyApp at 2024-01-01T00:00:00Z' const signature = await provider.signArbitrary(chainId, signer, data) // Verify the signature const isValid = await provider.verifyArbitrary(chainId, signer, data, signature) console.log('Signature valid:', isValid)

Transaktionen senden

Transaktion übertragen

const chainId = 'cosmoshub-4' // `txBytes` is the complete signed transaction as a Uint8Array. // Broadcast modes: 'block', 'sync', 'async' const result = await provider.sendTx(chainId, txBytes, 'sync') console.log('TX Hash:', result)

Offline-Signierer

Offline-Signierer zur Verwendung mit CosmJS abrufen:

import { SigningStargateClient } from '@cosmjs/stargate' const chainId = 'cosmoshub-4' // Auto-detect best signer type const offlineSigner = await provider.getOfflineSignerAuto(chainId) // Or use specific signer types const aminoSigner = provider.getOfflineSignerOnlyAmino(chainId) const directSigner = provider.getOfflineSigner(chainId) // Use with CosmJS const client = await SigningStargateClient.connectWithSigner( 'https://rpc.cosmos.network', offlineSigner ) // Send tokens const result = await client.sendTokens( senderAddress, recipientAddress, [{ denom: 'uatom', amount: '1000000' }], { amount: [{ denom: 'uatom', amount: '5000' }], gas: '200000' } )

API-Referenz

Methoden

MethodeBeschreibung
enable(chainIds)Zugriff auf eine oder mehrere Chains anfordern; wird ohne Rückgabewert aufgelöst
disable(chainIds)Eine oder mehrere Chains deaktivieren
disconnect()Von allen Chains trennen
getKey(chainId)Kontoschlüssel für die Chain abrufen
signAmino(chainId, signer, signDoc)Amino-kodierte Transaktion signieren
signDirect(chainId, signer, signDoc)Protobuf-kodierte Transaktion signieren
sendTx(chainId, tx, mode)Signierte Transaktion übertragen
signArbitrary(chainId, signer, data)Beliebige Nachricht signieren
verifyArbitrary(chainId, signer, data, signature)Signatur prüfen
experimentalSuggestChain(chainInfo)Benutzerdefinierte Chain hinzufügen
getOfflineSigner(chainId)Direct-Offline-Signierer abrufen
getOfflineSignerOnlyAmino(chainId)Reinen Amino-Offline-Signierer abrufen
getOfflineSignerAuto(chainId)Besten Signierertyp automatisch erkennen

Key-Schnittstelle

interface Key { name: string // Human-readable name algo: string // Signing algorithm pubKey: Uint8Array // Public key bytes address: Uint8Array // Address bytes bech32Address: string // Bech32 formatted address isNanoLedger: boolean // Ledger compatibility flag isKeystone: boolean // True if Keystone hardware }

Unterstützte Chains

ChainChain-IDWallet-Verfügbarkeit
Cosmos Hubcosmoshub-4In der Ziel-Wallet prüfen
Osmosisosmosis-1In der Ziel-Wallet prüfen
Junojuno-1In der Ziel-Wallet prüfen
Stargazestargaze-1In der Ziel-Wallet prüfen
Akashakashnet-2In der Ziel-Wallet prüfen
Secret Networksecret-4In der Ziel-Wallet prüfen
BenutzerdefiniertChainspezifischAnfordern mit experimentalSuggestChain; Annahme ist nicht garantiert

Fehlerbehandlung

try { await provider.enable('cosmoshub-4') } catch (error) { if (error.code === 4001) { console.log('User rejected the request') } else if (error.message.includes('not supported')) { console.log('Chain not supported, try experimentalSuggestChain') } else { console.error('Connection failed:', error) } }

Migration von Keplr

Der Cosmos-Provider von OneKey ist Keplr-kompatibel. Ändern Sie einfach Ihre Provider-Erkennung:

// Before (Keplr only) const provider = window.keplr // After (OneKey with Keplr fallback) const provider = window.$onekey?.cosmos || window.keplr
Zuletzt aktualisiert am