📖 РуководстваNEW

Продвинутые iconПродвинутые

Обновлено: 2025-09-03

Продвинутые iconПродвинутые

Обновлено: 2025-09-03
Руководство для экспертов: Это исчерпывающее руководство охватывает продвинутое восстановление счетов токенов Solana с использованием JavaScript/TypeScript. Требуются технические знания и существует риск потери средств при неправильном выполнении.

Полное восстановление счетов токенов Solana

Продвинутые разработчики Solana могут восстанавливать SOL из пустых связанных счетов токенов (ATA) и закрывать неиспользуемые счета токенов SPL с использованием JavaScript/TypeScript и официальных библиотек Solana. Этот ручной процесс обеспечивает максимальный контроль над очисткой счетов токенов, восстановлением арендной платы и оптимизацией кошелька.

Предварительные требования для продвинутого восстановления:
  • Node.js 16+ и npm/yarn установлены
  • Понимание модели счетов Solana и механики арендной платы
  • Доступ к приватным ключам кошелька или seed-фразами
  • Знание инструкций программы токенов SPL
  • Знание JavaScript/TypeScript и асинхронного программирования
  • Базовое понимание построения транзакций Solana
Почему JavaScript/TypeScript?
  • Официальная документация Solana и примеры преимущественно на JS/TS
  • Зрелая экосистема с @solana/web3.js и @solana/spl-token
  • Активная поддержка сообщества и обширные учебные материалы
  • Web3.js 2.0 (выпущен в ноябре 2024 года) обеспечивает лучшую производительность
  • Более простая интеграция с веб-приложениями и кошельками
Потенциал восстановления
Стандартный ATA:
0.002 SOL на счет
Ограничение пакета:
20 счетов на транзакцию
Комиссии за транзакции:
~0.000005 SOL за подпись
Чистая ставка восстановления:
99%+ заблокированной арендной платы

Настройка проекта и зависимости

Требуемые зависимости

Команды установки:
# Web3.js 2.0 (Latest - Recommended)
npm install @solana/web3.js@2

# OR Web3.js 1.x (Stable)
npm install @solana/web3.js@1

# SPL Token Library
npm install @solana/spl-token

# Additional utilities
npm install bs58 bip39 ed25519-hd-key
Официальная документация:

Подключение кошелька и управление ключами

Метод 1: Приватный ключ (Base58)
import { Connection, Keypair } from '@solana/web3.js';
import bs58 from 'bs58';

const connection = new Connection(
  'https://api.mainnet-beta.solana.com'
);

const secretKey = 'YOUR_BASE58_PRIVATE_KEY';
const keypair = Keypair.fromSecretKey(
  bs58.decode(secretKey)
);
Экспортируйте приватные ключи из Phantom: Настройки → Экспорт приватного ключа
Метод 2: Восстановление с помощью seed-фразы
import { Keypair } from '@solana/web3.js';
import * as bip39 from 'bip39';
import { derivePath } from 'ed25519-hd-key';

const mnemonic = 'your twelve word seed phrase';
const seed = await bip39.mnemonicToSeed(mnemonic);
const derivedSeed = derivePath(
  "m/44'/501'/0'/0'", seed.toString('hex')
).key;

const keypair = Keypair.fromSeed(derivedSeed);
Стандартный путь деривации Solana: m/44'/501'/0'/0'
Критические меры безопасности:
  • Никогда не храните приватные ключи в виде обычного текста в производственном коде
  • Используйте переменные окружения для конфиденциальных данных
  • Тестируйте все операции сначала на devnet
  • Храните резервные копии пар ключей в безопасных местах
  • Рассмотрите использование аппаратных кошельков для больших сумм

Обнаружение и анализ счетов токенов

Найти все счета токенов

import {
  TOKEN_PROGRAM_ID,
  getAccount
} from '@solana/spl-token';

async function findAllTokenAccounts(walletAddress) {
  // Get all token accounts
  const tokenAccounts = await connection.getTokenAccountsByOwner(
    walletAddress,
    { programId: TOKEN_PROGRAM_ID }
  );

  // Categorize accounts
  const emptyAccounts = [];
  const accountsWithTokens = [];

  for (const account of tokenAccounts.value) {
    const accountInfo = await getAccount(connection, account.pubkey);
    if (accountInfo.amount === 0n) {
      emptyAccounts.push(account.pubkey);
    } else {
      accountsWithTokens.push({
        pubkey: account.pubkey,
        mint: accountInfo.mint,
        amount: accountInfo.amount
      });
    }
  }

  return { emptyAccounts, accountsWithTokens };
}
Поддержка Token-2022:
import { TOKEN_2022_PROGRAM_ID } from '@solana/spl-token';

// For Token Extensions (Token-2022)
{ programId: TOKEN_2022_PROGRAM_ID }
Reference: https://spl.solana.com/token-2022

Операции по сжиганию токенов

🚨 КРИТИЧЕСКИЙ РАБОЧИЙ ПРОЦЕСС - Следуйте этому порядку:
  1. Шаг 1: Определение - Найдите все счета токенов и классифицируйте их
  2. Шаг 2: Сначала сжечь - Если вы хотите уничтожить токены с балансом > 0, сначала сожгите их
  3. Шаг 3: Закрыть после - Закрывайте только счета, которые на 100% пусты

⚠️ НИКОГДА не закрывайте счета с балансом токенов > 0 - Вы навсегда потеряете ценные токены!

Индивидуальное сжигание токенов
import {
  createBurnInstruction,
  Transaction,
  sendAndConfirmTransaction
} from '@solana/spl-token';

async function burnTokens(
  tokenAccount, mint, owner, amount
) {
  const instruction = createBurnInstruction(
    tokenAccount, // Token account
    mint, // Mint account
    owner, // Owner
    amount // Amount to burn
  );

  const transaction = new Transaction().add(instruction);
  return await sendAndConfirmTransaction(
    connection, transaction, [ownerKeypair]
  );
}

Сжигает токены навсегда, уменьшая общее предложение и подготавливая счета к закрытию.

Пакетное сжигание токенов
async function burnAllTokensInAccounts(accountsWithTokens) {
  for (const account of accountsWithTokens) {
    console.log(
      `Burning {account.amount} tokens from {account.pubkey}`
    );

    await burnTokens(
      account.pubkey,
      account.mint,
      ownerKeypair.publicKey,
      account.amount
    );

    // Rate limiting
    await new Promise(r => setTimeout(r, 2000));
  }
}
⚠️ ПРЕДУПРЕЖДЕНИЕ: Это навсегда уничтожает токены! Сжигайте только бесполезные/нежелательные токены.

Закрытие связанных счетов токенов

Закрытие индивидуального счета
import {
  createCloseAccountInstruction
} from '@solana/spl-token';

async function closeEmptyTokenAccount(
  tokenAccount, owner, recipient
) {
  // CRITICAL: Verify account is empty first
  const accountInfo = await getAccount(
    connection, tokenAccount
  );
  if (accountInfo.amount !== 0n) {
    throw new Error('Account must be empty!');
  }

  const instruction = createCloseAccountInstruction(
    tokenAccount, // Empty token account
    recipient, // SOL recipient
    owner // Account owner
  );

  const transaction = new Transaction().add(instruction);
  return await sendAndConfirmTransaction(
    connection, transaction, [ownerKeypair]
  );
}

Закрывает индивидуальные ПУСТЫЕ счета токенов и восстанавливает 0.002 SOL арендной платы за счет.

Массовое закрытие пустых счетов
async function closeAllEmptyAccounts(emptyAccounts) {
  const batchSize = 20; // Max per transaction
  const results = [];

  for (let i = 0; i < emptyAccounts.length; i += batchSize) {
    const batch = emptyAccounts.slice(i, i + batchSize);
    const transaction = new Transaction();

    // Double-verify all accounts are empty
    for (const account of batch) {
      const info = await getAccount(connection, account);
      if (info.amount !== 0n) {
        throw new Error(`Account not empty: {account}`);
      }
      transaction.add(
        createCloseAccountInstruction(
          account, recipient, owner
        )
      );
    }

    const signature = await sendAndConfirmTransaction(
      connection, transaction, [ownerKeypair]
    );
    results.push(signature);

    // Rate limiting
    await new Promise(r => setTimeout(r, 1000));
  }

  return results;
}
✅ Безопасная массовая обработка с двойной проверкой того, что счета пусты.

Приоритетные комиссии для более быстрого подтверждения

Добавьте инструкции по бюджету вычислений

import { ComputeBudgetProgram } from '@solana/web3.js';

// Add priority fee for faster confirmation
transaction.add(
  ComputeBudgetProgram.setComputeUnitPrice({
    microLamports: 1000 // 0.000001 SOL
  })
);

// Optional: Set compute unit limit
transaction.add(
  ComputeBudgetProgram.setComputeUnitLimit({
    units: 200000
  })
);
Приоритетные комиссии помогают обеспечить более быстрое подтверждение транзакций во время перегрузки сети. Настройте microLamports в зависимости от текущих условий сети.

Устранение неполадок и распространенные проблемы

Сбои транзакций
  • Счет не пуст: Убедитесь, что баланс токенов равен точно 0
  • Несоответствие полномочий: Убедитесь, что кошелек является владельцем счета
  • Недостаточно SOL: Нужен SOL для комиссий за транзакции
  • Перегрузка сети: Добавьте приоритетные комиссии или попробуйте снова позже
Проблемы с RPC и сетью
  • Ограничение скорости: Добавьте задержки между запросами (1-2 секунды)
  • Ошибки таймаута: Используйте надежного провайдера RPC (Helius, QuickNode)
  • Blockhash истек: Получите новый недавний blockhash
  • Ошибки 429: Внедрите экспоненциальное отступление
Советы по оптимизации
  • Пакетные операции: Группируйте до 20 счетов на транзакцию
  • Обработка ошибок: Используйте блоки try/catch с логикой повторных попыток
  • Фильтры счетов: Предварительно фильтруйте пустые счета на стороне клиента
  • Тестирование: Всегда тестируйте сначала на devnet
Предупреждение о безопасности - декабрь 2024:

Версии 1.95.6 и 1.95.7 @solana/web3.js были скомпрометированы. Всегда используйте последнюю версию:

npm install @solana/web3.js@latest

Лучшие практики безопасности и ресурсы

Критические меры безопасности:
  • Тестируйте все операции сначала на devnet
  • Используйте переменные окружения для приватных ключей
  • Проверяйте адреса кошельков перед выполнением
  • Держите @solana/web3.js обновленным до последней версии
  • Отслеживайте транзакции в обозревателях Solana
  • Используйте аппаратные кошельки для больших сумм
  • Никогда не закрывайте счета с балансом токенов > 0
  • Всегда дважды проверяйте состояние счетов перед операциями
Официальные ресурсы:

Для пользователей, не уверенных в кодировании, автоматические инструменты предоставляют более безопасные альтернативы:

  • SweepSOL: Автоматизированное восстановление на основе графического интерфейса
  • Профессиональная проверка и контроль безопасности
  • Техническая поддержка и руководство
Используйте инструмент SweepSOL
UnisolUnibot Recovery
Все Руководства