En esta página

Firma

Habilita la cadena de destino antes de consultar su clave o solicitar una firma. Usa el número de cuenta, la secuencia, las comisiones y el endpoint RPC de esa cadena; sustituye los valores de ejemplo antes de usar los ejemplos de firma.

Aprende a firmar transacciones y mensajes con el proveedor de Cosmos de OneKey.

Firmar con Amino (heredado)

Para transacciones heredadas codificadas con Amino:


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

Firmar con Direct (Protobuf)

Para transacciones modernas codificadas con Protobuf:


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

Firmar datos arbitrarios

Para firmar mensajes arbitrarios (útil para autenticación):


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)

Difundir una transacción


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)

Firmar datos de Ethereum

Para cadenas compatibles con la firma de Ethereum (como Evmos):


const result = await provider.signEthereum(
  chainId,
  signer,
  data,       // Message to sign
  'message'   // EthSignType: 'message', 'transaction', or 'eip-712'
)
 
console.log('Signature:', result)

Gestión de errores


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