Программный стейкинг Solana с помощью Helius SDK

Валидатор с нулевой комиссией: размещайте SOL в стейкинге у валидатора Helius и сохраняйте 100% вознаграждений благодаря комиссии 0%.

Краткий обзор

Helius SDK предоставляет простые методы для программного управления полным жизненным циклом стейкинга SOL. Он идеально подходит для создания интерфейсов стейкинга, протоколов DeFi и автоматизированных стратегий стейкинга.

Create & Delegate

Создавайте новые стейкинговые аккаунты и делегируйте средства валидаторам в одной транзакции

Monitor & Manage

Отслеживайте вознаграждения, проверяйте состояние и управляйте существующими стейкинговыми аккаунтами

Withdraw & Redeem

Деактивируйте стейки и выводите SOL после периода ожидания

Установка и настройка

npm install helius-sdk @solana/web3.js bs58

yarn add helius-sdk @solana/web3.js bs58

pnpm add helius-sdk @solana/web3.js bs58

import { Helius } from 'helius-sdk';
import { Keypair, Transaction } from '@solana/web3.js';
import bs58 from 'bs58';

// Initialize Helius client
const helius = new Helius('YOUR_API_KEY');

// Your wallet keypair (load from your secure storage)
const payer = Keypair.fromSecretKey(/* your secret key */);

Основы стейкинга

How Solana Staking Works

Стейкинговый аккаунт: специальный аккаунт, который блокирует SOL и делегирует их валидатору. Каждый стейкинговый аккаунт связан только с одним валидатором.Вознаграждения: валидаторы получают вознаграждения за обеспечение безопасности сети. Эти вознаграждения распределяются между всеми стейкинговыми аккаунтами, делегированными соответствующему валидатору.Жизненный цикл: создание → делегирование → получение вознаграждений → деактивация → вывод средств

Why Choose Helius Validator

Комиссия 0%: сохраняйте 100% вознаграждений за стейкинг
Высокая производительность: надежное создание блоков и минимальное время простоя
Простая интеграция: оптимизация для Helius SDK и встроенные вспомогательные функции

Timing & Epochs

Активация: стейки становятся активными в начале следующей эпохи (~2 дня)
Деактивация: вступает в силу в конце текущей эпохи
Период ожидания: деактивированные стейки можно вывести сразу после завершения эпохи

Начало работы

Quick Start
Complete Example

Разместите SOL в стейкинге всего тремя строками кода:

// 1. Create the staking transaction
const { serializedTx, stakeAccountPubkey } = 
  await helius.rpc.createStakeTransaction(payer.publicKey, 1.5);

// 2. Sign and send
const tx = Transaction.from(bs58.decode(serializedTx));
tx.partialSign(payer);
const signature = await helius.connection.sendRawTransaction(tx.serialize());

console.log(`Staked! Transaction: ${signature}`);
console.log(`Stake Account: ${stakeAccountPubkey}`);

SDK автоматически рассчитывает аренду и создает стейкинговый аккаунт. Параметр 1.5 — это сумма в SOL, которую вы хотите разместить в стейкинге.

Полная реализация стейкинга с обработкой ошибок:

async function stakeSOL(amountInSol: number) {
  try {
    // Create staking transaction
    const { serializedTx, stakeAccountPubkey } = 
      await helius.rpc.createStakeTransaction(payer.publicKey, amountInSol);
    
    // Deserialize and sign transaction
    const transaction = Transaction.from(bs58.decode(serializedTx));
    transaction.partialSign(payer);
    
    // Send transaction
    const signature = await helius.connection.sendRawTransaction(
      transaction.serialize(),
      { 
        skipPreflight: false,
        preflightCommitment: 'confirmed'
      }
    );
    
    // Wait for confirmation
    await helius.connection.confirmTransaction(signature, 'confirmed');
    
    return {
      signature,
      stakeAccount: stakeAccountPubkey,
      amount: amountInSol
    };
    
  } catch (error) {
    console.error('Staking failed:', error);
    throw error;
  }
}

// Usage
const result = await stakeSOL(2.5);
console.log(`Successfully staked ${result.amount} SOL`);

Справочник по методам SDK

createStakeTransaction(owner, amount)

Создает полную транзакцию стейкинга, которую можно подписать и отправить.Параметры:

owner (PublicKey): кошелек, которому будет принадлежать стейкинговый аккаунт
amount (number): сумма SOL для стейкинга

Возвращает:

{
  serializedTx: string,        // Base58 encoded transaction
  stakeAccountPubkey: string   // New stake account address
}

Пример:

const result = await helius.rpc.createStakeTransaction(
  payer.publicKey, 
  1.5  // 1.5 SOL
);

getStakeInstructions(owner, amount)

Возвращает только инструкции для стейкинга. Это удобно при создании пользовательских транзакций.Возвращает:

{
  instructions: TransactionInstruction[],
  stakeAccount: Keypair
}

Пример:

const { instructions } = await helius.rpc.getStakeInstructions(
  payer.publicKey, 
  1.5
);

// Use with Smart Transactions
const signature = await helius.rpc.sendSmartTransaction(
  instructions, 
  [payer]
);

getHeliusStakeAccounts(wallet)

Получает все стейкинговые аккаунты кошелька, делегированные валидатору Helius.Пример:

const accounts = await helius.rpc.getHeliusStakeAccounts(
  payer.publicKey.toBase58()
);

accounts.forEach(account => {
  const delegation = account.account.data.parsed.info.stake.delegation;
  console.log(`Account: ${account.pubkey}`);
  console.log(`Stake: ${delegation.stake / LAMPORTS_PER_SOL} SOL`);
});

createUnstakeTransaction(owner, stakeAccount)

Создает транзакцию для деактивации стейкингового аккаунта, то есть запуска вывода из стейкинга.Пример:

const tx = await helius.rpc.createUnstakeTransaction(
  payer.publicKey,
  stakeAccountPubkey
);

const transaction = Transaction.from(bs58.decode(tx));
transaction.partialSign(payer);
await helius.connection.sendRawTransaction(transaction.serialize());

getWithdrawableAmount(stakeAccount, includeRent?)

Проверяет, сколько SOL можно вывести из деактивированного стейкингового аккаунта.Параметры:

includeRent (boolean): следует ли включать сумму, освобожденную от арендной платы

Пример:

const available = await helius.rpc.getWithdrawableAmount(stakeAccountPubkey);
const total = await helius.rpc.getWithdrawableAmount(stakeAccountPubkey, true);

console.log(`Available now: ${available / LAMPORTS_PER_SOL} SOL`);
console.log(`Total balance: ${total / LAMPORTS_PER_SOL} SOL`);

createWithdrawTransaction(owner, stakeAccount, destination, amount)

Создает транзакцию для вывода SOL из деактивированного стейкингового аккаунта.Пример:

const tx = await helius.rpc.createWithdrawTransaction(
  payer.publicKey,
  stakeAccountPubkey,
  destinationPubkey,
  withdrawAmount  // in lamports
);

Полный процесс стейкинга

Create and Delegate

// Stake 2 SOL to Helius validator
const { serializedTx, stakeAccountPubkey } = 
  await helius.rpc.createStakeTransaction(payer.publicKey, 2.0);

const tx = Transaction.from(bs58.decode(serializedTx));
tx.partialSign(payer);

const signature = await helius.connection.sendRawTransaction(tx.serialize());
console.log(`Stake created: ${stakeAccountPubkey}`);

Monitor Your Stakes

// Get all your Helius stake accounts
const accounts = await helius.rpc.getHeliusStakeAccounts(
  payer.publicKey.toBase58()
);

console.log(`You have ${accounts.length} active stake accounts`);

accounts.forEach((account, index) => {
  const info = account.account.data.parsed.info;
  const delegation = info.stake.delegation;
  
  console.log(`Stake ${index + 1}:`);
  console.log(`  Amount: ${delegation.stake / LAMPORTS_PER_SOL} SOL`);
  console.log(`  Activated: Epoch ${delegation.activationEpoch}`);
  console.log(`  Status: ${info.meta.lockup.unixTimestamp === 0 ? 'Active' : 'Locked'}`);
});

Deactivate (Start Unstaking)

// Begin the unstaking process
const unstakeTx = await helius.rpc.createUnstakeTransaction(
  payer.publicKey,
  stakeAccountPubkey
);

const tx = Transaction.from(bs58.decode(unstakeTx));
tx.partialSign(payer);

await helius.connection.sendRawTransaction(tx.serialize());
console.log('Deactivation started. Will be withdrawable next epoch.');

Withdraw SOL

// Check withdrawable amount
const withdrawable = await helius.rpc.getWithdrawableAmount(
  stakeAccountPubkey, 
  true  // include rent
);

if (withdrawable > 0) {
  // Create withdrawal instruction
  const withdrawInstruction = helius.rpc.getWithdrawInstruction(
    payer.publicKey,
    stakeAccountPubkey,
    payer.publicKey,  // withdraw to same wallet
    withdrawable
  );
  
  // Send using Smart Transactions for better reliability
  const signature = await helius.rpc.sendSmartTransaction(
    [withdrawInstruction], 
    [payer]
  );
  
  console.log(`Withdrawn ${withdrawable / LAMPORTS_PER_SOL} SOL`);
}

Расширенные сценарии

Browser Integration
Batch Operations
Smart Transactions

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

// Get instructions instead of full transaction
const { instructions, stakeAccount } = await helius.rpc.getStakeInstructions(
  wallet.publicKey,
  stakeAmount
);

// Let the wallet handle transaction building and signing
const transaction = new Transaction().add(...instructions);

// Sign with wallet adapter
const signature = await wallet.sendTransaction(transaction, connection);

console.log(`Stake account: ${stakeAccount.publicKey.toBase58()}`);

Эффективно размещайте средства в стейкинге для нескольких кошельков:

async function batchStake(wallets: Keypair[], amount: number) {
  const promises = wallets.map(async (wallet) => {
    try {
      const { serializedTx, stakeAccountPubkey } = 
        await helius.rpc.createStakeTransaction(wallet.publicKey, amount);
      
      const tx = Transaction.from(bs58.decode(serializedTx));
      tx.partialSign(wallet);
      
      return helius.connection.sendRawTransaction(tx.serialize());
    } catch (error) {
      console.error(`Failed to stake for ${wallet.publicKey.toBase58()}:`, error);
      return null;
    }
  });
  
  const results = await Promise.allSettled(promises);
  const successful = results.filter(r => r.status === 'fulfilled').length;
  
  console.log(`Successfully staked for ${successful}/${wallets.length} wallets`);
}

Используйте Smart Transactions для повышения надежности и оптимизации:

// Get individual instructions
const { instructions } = await helius.rpc.getStakeInstructions(
  payer.publicKey,
  2.5
);

// Send with Smart Transaction features:
// - Automatic priority fee optimization
// - Retry logic with backoff
// - Better error handling
const signature = await helius.rpc.sendSmartTransaction(
  instructions,
  [payer],
  {
    skipPreflight: false,
    maxRetries: 3
  }
);

console.log(`Smart transaction sent: ${signature}`);

Важные примечания

Время эпохи: эпохи Solana длятся около двух дней. Стейки активируются в начале следующей эпохи, а деактивация вступает в силу в конце текущей эпохи.

Учет аренды: стейкинговым аккаунтам необходим резерв для освобождения от арендной платы (~0,00228 SOL). Вывод всего баланса закрывает аккаунт.

Аппаратные кошельки: пользователи увидят два запроса на подпись — один для стейкингового аккаунта (с предварительной подписью), а второй для плательщика комиссии. Учитывайте это при проектировании UX.

Краткий справочник

Нужно быстро освежить информацию? Вот основные методы:

// Stake SOL
await helius.rpc.createStakeTransaction(owner, amountInSol);

// Check your stakes  
await helius.rpc.getHeliusStakeAccounts(ownerAddress);

// Start unstaking
await helius.rpc.createUnstakeTransaction(owner, stakeAccount);

// Check withdrawable amount
await helius.rpc.getWithdrawableAmount(stakeAccount, includeRent);

// Withdraw SOL
helius.rpc.getWithdrawInstruction(owner, stakeAccount, destination, amount);

Следующие шаги

Helius SDK Documentation

Полный справочник по SDK со всеми доступными методами

Smart Transactions

Оптимизируйте транзакции с помощью приоритетных комиссий и логики повторных попыток

Join Discord

Получите помощь от нашего сообщества разработчиков

Validator Dashboard

Отслеживайте производительность валидатора Helius и вознаграждения

Начните здесь

Данные в реальном времени

Торговля с низкой задержкой

Исторические данные и данные кошельков

Руководства по методам RPC

Готовность к эксплуатации

Использование Orb

Другие инструкции

Программный стейкинг Solana с помощью Helius SDK

Краткий обзор

Create & Delegate

Monitor & Manage

Withdraw & Redeem

Установка и настройка

Основы стейкинга

Начало работы

Справочник по методам SDK

Полный процесс стейкинга

Расширенные сценарии

Важные примечания

Краткий справочник

Следующие шаги

Helius SDK Documentation

Smart Transactions

Join Discord

Validator Dashboard

​Краткий обзор

Create & Delegate

Monitor & Manage

Withdraw & Redeem

​Установка и настройка

​Основы стейкинга

​Начало работы

​Справочник по методам SDK

​Полный процесс стейкинга

​Расширенные сценарии

​Важные примечания

​Краткий справочник

​Следующие шаги

Helius SDK Documentation

Smart Transactions

Join Discord

Validator Dashboard

Краткий обзор

Установка и настройка

Основы стейкинга

Начало работы

Справочник по методам SDK

Полный процесс стейкинга

Расширенные сценарии

Важные примечания

Краткий справочник

Следующие шаги