En esta página

Transacciones

Conecta el proveedor antes de firmar. Los ejemplos de transacciones usan los campos de algosdk 2 from/to; usa la versión principal correspondiente del SDK. algodClient, las direcciones y las transacciones agrupadas deben prepararse antes de ejecutar los fragmentos. Los ejemplos para navegador que usan Buffer necesitan una importación explícita de buffer o un codificador base64 equivalente.

Aprende a firmar y enviar transacciones en Algorand.

Firmar transacciones (ARC-0001)

Firma una o varias transacciones:


import algosdk from 'algosdk'
 
// Create transaction
const suggestedParams = await algodClient.getTransactionParams().do()
 
const txn = algosdk.makePaymentTxnWithSuggestedParamsFromObject({
  from: senderAddress,
  to: recipientAddress,
  amount: 1000000, // 1 ALGO (microAlgos)
  suggestedParams,
})
 
// Prepare for signing
const walletTxns = [{
  txn: Buffer.from(algosdk.encodeUnsignedTransaction(txn)).toString('base64'),
}]
 
// Sign
const signedTxns = await provider.signTxns(walletTxns)
 
console.log('Signed transactions:', signedTxns)

Firmar varias transacciones


// Group transactions
const txns = [txn1, txn2, txn3]
algosdk.assignGroupID(txns)
 
// Prepare for signing
const walletTxns = txns.map(txn => ({
  txn: Buffer.from(algosdk.encodeUnsignedTransaction(txn)).toString('base64'),
}))
 
// Sign all
const signedTxns = await provider.signTxns(walletTxns)

Firma parcial (multifirma)


// Only sign specific transactions in a group
const walletTxns = [
  { txn: encodedTxn1 },
  { txn: encodedTxn2, signers: [] }, // Skip this one
  { txn: encodedTxn3 },
]
 
const signedTxns = await provider.signTxns(walletTxns)
// signedTxns[1] will be null

Enviar transacciones

Difunde las transacciones firmadas:


const completeTxns = signedTxns.filter((txn) => txn !== null)
if (completeTxns.length !== signedTxns.length) {
  throw new Error('Complete all required signatures before broadcasting the group')
}
const result = await provider.postTxns(completeTxns)
console.log('Transaction IDs:', result.txnIDs)

Firmar y enviar

Firma y difunde en un solo paso:


const result = await provider.signAndPostTxns(walletTxns)
console.log('Transaction IDs:', result.txnIDs)

API de transacciones heredada

Firmar una transacción (heredado)


// Create transaction as Uint8Array
const txnBytes = algosdk.encodeUnsignedTransaction(txn)
 
// Sign
const signedTxnBytes = await provider.signTransaction([txnBytes])
 
// Send
const { txId } = await algodClient.sendRawTransaction(signedTxnBytes[0]).do()

Firmar y enviar (heredado)


const result = await provider.signAndSendTransaction([txnBytes])
console.log('Transaction ID:', result.txId)

Ejemplo completo


import algosdk from 'algosdk'
 
async function sendAlgo() {
  // Connect
  const provider = window.$onekey?.algo
  if (!provider) throw new Error("OneKey Algorand provider is unavailable")
  const { address } = await provider.connect()
 
  // Setup client
  const algodClient = new algosdk.Algodv2(
    '',
    'https://mainnet-api.algonode.cloud',
    ''
  )
 
  // Get params
  const suggestedParams = await algodClient.getTransactionParams().do()
 
  // Create transaction
  const txn = algosdk.makePaymentTxnWithSuggestedParamsFromObject({
    from: address,
    to: 'RECIPIENT_ADDRESS',
    amount: 1000000, // 1 ALGO
    suggestedParams,
  })
 
  // Sign
  const walletTxns = [{
    txn: Buffer.from(algosdk.encodeUnsignedTransaction(txn)).toString('base64'),
  }]
 
  const signedTxns = await provider.signTxns(walletTxns)
 
  if (!signedTxns[0]) throw new Error("The transaction was not signed")
 
  // Send
  const { txId } = await algodClient.sendRawTransaction(
    Buffer.from(signedTxns[0], 'base64')
  ).do()
 
  console.log('Transaction ID:', txId)
 
  // Wait for confirmation
  await algosdk.waitForConfirmation(algodClient, txId, 4)
  console.log('Confirmed!')
}