Как перевести определенное количество токенов 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, необходимо использовать описанный выше подход/