En esta página

Transacciones

Los siguientes ejemplos de firma usan connectSuiAccount() de Primeros pasos. Devuelve una cuenta de Wallet Standard y su cadena activa. Los ejemplos usan @mysten/[email protected]. Incluso los métodos antiguos *TransactionBlock ahora declaran entradas Transaction en @mysten/[email protected].

Solicita permiso antes de firmar, selecciona una cuenta conectada y consulta la cadena activa. Estos ejemplos usan @mysten/[email protected], que coincide con @mysten/[email protected] aceptado por el proveedor actual.

Aprende a firmar y ejecutar transacciones en Sui.

Inicializa el contexto de cuenta antes de los siguientes ejemplos:


const { account, chain } = await connectSuiAccount()

Firmar y ejecutar un bloque de transacción

El proveedor inyectado actual no reenvía options en signAndExecuteTransactionBlock. Consulta el digest devuelto con un cliente Sui en la misma cadena para solicitar efectos, eventos o cambios de objetos.


import { Transaction } from '@mysten/sui/transactions'
 
// Create transaction block
const txb = new Transaction()
 
// Add a transfer
txb.transferObjects(
  [txb.object('0xobject_id')],
  txb.pure.address('RECIPIENT_SUI_ADDRESS')
)
 
// Or send SUI
const [coin] = txb.splitCoins(txb.gas, [txb.pure.u64(1000000000)]) // 1 SUI
txb.transferObjects([coin], txb.pure.address('RECIPIENT_SUI_ADDRESS'))
 
// Sign and execute
const result = await provider.signAndExecuteTransactionBlock({
  account,
  chain,
  transactionBlock: txb,
})
 
console.log({
  digest: result.digest,
})

Firmar un bloque de transacción (sin ejecutarlo)


const txb = new Transaction()
// ... build transaction
 
const signedTxb = await provider.signTransactionBlock({
  account,
  chain,
  transactionBlock: txb,
})
 
console.log({
  transactionBlockBytes: signedTxb.transactionBlockBytes,
  signature: signedTxb.signature,
})
 
// Execute later using Sui SDK
// const result = await suiClient.executeTransactionBlock({
//   transactionBlock: signedTxb.transactionBlockBytes,
//   signature: signedTxb.signature,
// })

Firmar y ejecutar una transacción (API nueva)


// Using the newer signAndExecuteTransaction method
import { Transaction } from '@mysten/sui/transactions'
 
const transaction = new Transaction()
const [coin] = transaction.splitCoins(transaction.gas, [transaction.pure.u64(100000000)])
transaction.transferObjects([coin], transaction.pure.address('RECIPIENT_SUI_ADDRESS'))
const result = await provider.signAndExecuteTransaction({
  account,
  chain,
  transaction,
})

Firmar una transacción (API nueva)


const signedTxn = await provider.signTransaction({
  account,
  chain,
  transaction,
})

Interacción con contratos inteligentes

Llamada Move


const txb = new Transaction()
 
// Call a Move function
txb.moveCall({
  target: '0xpackage::module::function',
  arguments: [
    txb.pure.string('arg1'),
    txb.object('0xobject_id'),
  ],
  typeArguments: ['0x2::sui::SUI'],
})
 
const result = await provider.signAndExecuteTransactionBlock({
  account,
  chain,
  transactionBlock: txb,
})

Publicar un paquete


const txb = new Transaction()
 
const [upgradeCap] = txb.publish({
  modules: compiledModules,
  dependencies: [
    '0x1', // Move stdlib
    '0x2', // Sui framework
  ],
})
 
txb.transferObjects([upgradeCap], txb.pure.address(account.address))
 
const result = await provider.signAndExecuteTransactionBlock({
  account,
  chain,
  transactionBlock: txb,
})

Uso con Sui SDK


import { SuiClient } from '@mysten/sui/client'
 
const client = new SuiClient({ url: 'https://fullnode.mainnet.sui.io' })
 
// Get balance
const balance = await client.getBalance({
  owner: accountAddress,
})
 
// Get objects
const objects = await client.getOwnedObjects({
  owner: accountAddress,
})
 
// Get transaction
const txn = await client.getTransactionBlock({
  digest: txDigest,
  options: { showEffects: true },
})