Як перевести певну кількість токенів SUI: обробка об'єктів монет

Виклик

На відміну від традиційних блокчейнів, де залишки токенів є простими числами, SUI зберігає токени як окремі об'єкти монети**. Це означає, що якщо у вас є 3 токени SUI, вони існують як три окремі об'єкти (наприклад, 1 SUI + 1 SUI + 1 SUI = 3 загалом), а не як єдиний баланс «3 SUI».

Якщо ви хочете перевести певну суму (наприклад, 2.5 SUI), вам потрібно: 1.Об'єднатикілька об'єктів монет, якщо потрібно 2.Розділітьмонети, щоб отримати точну суму 3.Передайотриманий об'єкт монети

Приклад коду: Передача 2.5 SUI

Ось повний приклад TypeScript, який показує, як впоратися з цим:

import { SuiClient, getFullnodeUrl } from '@mysten/sui.js/client';
import { TransactionBlock } from '@mysten/sui.js/transactions';
import { Ed25519Keypair } from '@mysten/sui.js/keypairs/ed25519';

// Initialize client and keypair
const client = new SuiClient({ url: getFullnodeUrl('testnet') });
const keypair = Ed25519Keypair.fromSecretKey(YOUR_SECRET_KEY);
const senderAddress = keypair.getPublicKey().toSuiAddress();

async function transferSUI(recipientAddress: string, amountInSUI: number) {
  try {
    // Convert SUI to MIST (1 SUI = 1,000,000,000 MIST)
    const amountInMist = Math.floor(amountInSUI * 1_000_000_000);
    
    // Step 1: Get all SUI coin objects owned by sender
    const coinObjects = await client.getCoins({
      owner: senderAddress,
      coinType: '0x2::sui::SUI'
    });
    
    if (coinObjects.data.length === 0) {
      throw new Error('No SUI coins found');
    }
    
    console.log(`Found ${coinObjects.data.length} SUI coin objects`);
    coinObjects.data.forEach((coin, index) => {
      console.log(`Coin ${index + 1}: ${coin.balance} MIST`);
    });
    
    // Step 2: Create transaction block
    const txb = new TransactionBlock();
    
    // Step 3: Handle coin merging and splitting
    let primaryCoin;
    
    if (coinObjects.data.length === 1) {
      // Single coin - just split it
      primaryCoin = coinObjects.data[0].coinObjectId;
    } else {
      // Multiple coins - merge them first
      primaryCoin = coinObjects.data[0].coinObjectId;
      const coinsToMerge = coinObjects.data.slice(1).map(coin => coin.coinObjectId);
      
      if (coinsToMerge.length > 0) {
        txb.mergeCoins(primaryCoin, coinsToMerge);
        console.log(`Merging ${coinsToMerge.length} coins into primary coin`);
      }
    }
    
    // Step 4: Split the exact amount needed
    const [transferCoin] = txb.splitCoins(primaryCoin, [amountInMist]);
    
    // Step 5: Transfer the split coin
    txb.transferObjects([transferCoin], recipientAddress);
    
    // Step 6: Set gas budget and execute
    txb.setGasBudget(10000000); // 0.01 SUI in MIST
    
    const result = await client.signAndExecuteTransactionBlock({
      signer: keypair,
      transactionBlock: txb,
      options: {
        showEffects: true,
        showObjectChanges: true,
      },
    });
    
    console.log('Transaction successful!');
    console.log('Digest:', result.digest);
    console.log('Gas used:', result.effects?.gasUsed);
    
    return result;
    
  } catch (error) {
    console.error('Transfer failed:', error);
    throw error;
  }
}

// Usage example
async function main() {
  const recipientAddress = '0x742d35cc6db7e3b6c7e4c46e7f8c7e6f1234567890abcdef';
  const amountToTransfer = 2.5; // SUI
  
  await transferSUI(recipientAddress, amountToTransfer);
}

// Run the transfer
main().catch(console.error);

Покрокова розбивка

1.Отримати об'єкти монети

const coinObjects = await client.getCoins({
  owner: senderAddress,
  coinType: '0x2::sui::SUI'
});

Це отримує всі об'єкти монет SUI, що належать вашій адресі.

2.** Об'єднати кілька монет (якщо потрібно)**

if (coinObjects.data.length > 1) {
  const primaryCoin = coinObjects.data[0].coinObjectId;
  const coinsToMerge = coinObjects.data.slice(1).map(coin => coin.coinObjectId);
  txb.mergeCoins(primaryCoin, coinsToMerge);
}

Якщо у вас є кілька предметів монет, об'єднайте їх в одну більшу монету.

3.Розділіть точну суму

const [transferCoin] = txb.splitCoins(primaryCoin, [amountInMist]);

Розділіть точну суму, яку ви хочете перевести з об'єднаної монети.

4.Передайте розділену монету

txb.transferObjects([transferCoin], recipientAddress);

Передайте щойно створений об'єкт монети одержувачу.

Ключові моменти, які слід пам'ятати

-MIST проти SUI: Завжди конвертуйте SUI на MIST (помножте на 1 000 000 000) під час роботи з транзакціями -Газовий бюджет: Встановіть відповідний бюджет газу (зазвичай достатньо 0,01 SUI) -Ідентифікатори об'єктів: Кожна монета має унікальний ідентифікатор об'єкта, на який ви посилаєтесь у транзакціях -Атомні операції: Усі операції злиття, поділу та передачі відбуваються в одній транзакції

Поради щодо обробки помилок

// Check if you have enough balance
const totalBalance = coinObjects.data.reduce((sum, coin) => 
  sum + parseInt(coin.balance), 0
);

if (totalBalance < amountInMist) {
  throw new Error(`Insufficient balance. Have: ${totalBalance/1e9} SUI, Need: ${amountInSUI} SUI`);
}

Альтернатива: Використання вбудованого методу SUI SDK

Для більш простих випадків використання ви можете скористатися зручним методом SDK:

const txb = new TransactionBlock();
const [coin] = txb.splitCoins(txb.gas, [amountInMist]);
txb.transferObjects([coin], recipientAddress);

При цьому використовується газова монета для переказу, яка добре працює для менших сум. Однак, якщо газова монета не має необхідної кількості SUI, необхідний вищезазначений підход/