> ## Documentation Index > Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Программный стейкинг Solana с помощью Helius SDK > Создавайте удобные решения для стейкинга Solana с помощью Helius SDK. Полное руководство: от настройки до вывода средств с интеграцией валидатора с комиссией 0%. **Валидатор с нулевой комиссией**: размещайте SOL в стейкинге у валидатора Helius и сохраняйте 100% вознаграждений благодаря комиссии 0%. ## Краткий обзор Helius SDK предоставляет простые методы для программного управления полным жизненным циклом стейкинга SOL. Он идеально подходит для создания интерфейсов стейкинга, протоколов DeFi и автоматизированных стратегий стейкинга. Создавайте новые стейкинговые аккаунты и делегируйте средства валидаторам в одной транзакции Отслеживайте вознаграждения, проверяйте состояние и управляйте существующими стейкинговыми аккаунтами Деактивируйте стейки и выводите SOL после периода ожидания ## Установка и настройка ```bash npm theme={"system"} npm install helius-sdk @solana/web3.js bs58 ``` ```bash yarn theme={"system"} yarn add helius-sdk @solana/web3.js bs58 ``` ```bash pnpm theme={"system"} pnpm add helius-sdk @solana/web3.js bs58 ``` ```typescript Setup theme={"system"} 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 */); ``` ## Основы стейкинга **Стейкинговый аккаунт**: специальный аккаунт, который блокирует SOL и делегирует их валидатору. Каждый стейкинговый аккаунт связан только с одним валидатором. **Вознаграждения**: валидаторы получают вознаграждения за обеспечение безопасности сети. Эти вознаграждения распределяются между всеми стейкинговыми аккаунтами, делегированными соответствующему валидатору. **Жизненный цикл**: создание → делегирование → получение вознаграждений → деактивация → вывод средств * **Комиссия 0%**: сохраняйте 100% вознаграждений за стейкинг * **Высокая производительность**: надежное создание блоков и минимальное время простоя * **Простая интеграция**: оптимизация для Helius SDK и встроенные вспомогательные функции * **Активация**: стейки становятся активными в начале следующей эпохи (\~2 дня) * **Деактивация**: вступает в силу в конце текущей эпохи * **Период ожидания**: деактивированные стейки можно вывести сразу после завершения эпохи ## Начало работы Разместите SOL в стейкинге всего тремя строками кода: ```typescript theme={"system"} // 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, которую вы хотите разместить в стейкинге. Полная реализация стейкинга с обработкой ошибок: ```typescript theme={"system"} 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 Создает полную транзакцию стейкинга, которую можно подписать и отправить. **Параметры:** * `owner` (PublicKey): кошелек, которому будет принадлежать стейкинговый аккаунт * `amount` (number): сумма SOL для стейкинга **Возвращает:** ```typescript theme={"system"} { serializedTx: string, // Base58 encoded transaction stakeAccountPubkey: string // New stake account address } ``` **Пример:** ```typescript theme={"system"} const result = await helius.rpc.createStakeTransaction( payer.publicKey, 1.5 // 1.5 SOL ); ``` Возвращает только инструкции для стейкинга. Это удобно при создании пользовательских транзакций. **Возвращает:** ```typescript theme={"system"} { instructions: TransactionInstruction[], stakeAccount: Keypair } ``` **Пример:** ```typescript theme={"system"} const { instructions } = await helius.rpc.getStakeInstructions( payer.publicKey, 1.5 ); // Use with Smart Transactions const signature = await helius.rpc.sendSmartTransaction( instructions, [payer] ); ``` Получает все стейкинговые аккаунты кошелька, делегированные валидатору Helius. **Пример:** ```typescript theme={"system"} 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`); }); ``` Создает транзакцию для деактивации стейкингового аккаунта, то есть запуска вывода из стейкинга. **Пример:** ```typescript theme={"system"} 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()); ``` Проверяет, сколько SOL можно вывести из деактивированного стейкингового аккаунта. **Параметры:** * `includeRent` (boolean): следует ли включать сумму, освобожденную от арендной платы **Пример:** ```typescript theme={"system"} 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`); ``` Создает транзакцию для вывода SOL из деактивированного стейкингового аккаунта. **Пример:** ```typescript theme={"system"} const tx = await helius.rpc.createWithdrawTransaction( payer.publicKey, stakeAccountPubkey, destinationPubkey, withdrawAmount // in lamports ); ``` ## Полный процесс стейкинга ```typescript theme={"system"} // 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}`); ``` ```typescript theme={"system"} // 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'}`); }); ``` ```typescript theme={"system"} // 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.'); ``` ```typescript theme={"system"} // 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`); } ``` ## Расширенные сценарии Для браузерных приложений, использующих адаптеры кошельков: ```typescript theme={"system"} // 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()}`); ``` Эффективно размещайте средства в стейкинге для нескольких кошельков: ```typescript theme={"system"} 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 для повышения надежности и оптимизации: ```typescript theme={"system"} // 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. ## Краткий справочник Нужно быстро освежить информацию? Вот основные методы: ```typescript theme={"system"} // 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); ``` ## Следующие шаги Полный справочник по SDK со всеми доступными методами Оптимизируйте транзакции с помощью приоритетных комиссий и логики повторных попыток Получите помощь от нашего сообщества разработчиков Отслеживайте производительность валидатора Helius и вознаграждения This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.