Staking Solana theo chương trình với Helius SDK

Trình xác thực không thu hoa hồng: Stake với trình xác thực Helius và giữ lại 100% phần thưởng staking nhờ mức hoa hồng 0% của chúng tôi.

Tổng quan nhanh

Helius SDK cung cấp các phương thức đơn giản để xử lý toàn bộ vòng đời staking SOL theo chương trình. Hoàn hảo để xây dựng giao diện staking, giao thức DeFi hoặc chiến lược staking tự động.

Create & Delegate

Thiết lập tài khoản stake mới và ủy quyền cho trình xác thực trong một giao dịch

Monitor & Manage

Theo dõi phần thưởng, kiểm tra trạng thái và quản lý các tài khoản stake hiện có

Withdraw & Redeem

Hủy kích hoạt stake và rút SOL sau thời gian chờ

Cài đặt và thiết lập

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 */);

Kiến thức cơ bản về staking

How Solana Staking Works

Tài khoản stake: Một tài khoản đặc biệt khóa SOL và ủy quyền SOL cho một trình xác thực. Mỗi tài khoản stake trỏ đến đúng một trình xác thực.Phần thưởng: Các trình xác thực nhận phần thưởng khi bảo mật mạng. Những phần thưởng này được phân phối cho tất cả tài khoản stake đã ủy quyền cho trình xác thực đó.Vòng đời: Tạo → Ủy quyền → Nhận phần thưởng → Hủy kích hoạt → Rút

Why Choose Helius Validator

Phí hoa hồng 0%: Giữ lại 100% phần thưởng staking của bạn
Hiệu suất cao: Sản xuất khối ổn định và thời gian ngừng hoạt động tối thiểu
Tích hợp dễ dàng: Được tối ưu hóa cho Helius SDK với các hàm trợ giúp tích hợp sẵn

Timing & Epochs

Kích hoạt: Stake được kích hoạt vào đầu epoch tiếp theo (~1 ngày)
Hủy kích hoạt: Có hiệu lực vào cuối epoch hiện tại
Thời gian chờ: Có thể rút stake đã hủy kích hoạt ngay sau khi epoch kết thúc

Bắt đầu

Quick Start
Complete Example

Stake SOL chỉ với 3 dòng mã:

// 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 tự động xử lý việc tính phí thuê và tạo tài khoản stake. Tham số 1.5 là số lượng SOL bạn muốn stake.

Triển khai staking đầy đủ với cơ chế xử lý lỗi:

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`);

Tham chiếu các phương thức SDK

createStakeTransaction(owner, amount)

Tạo một giao dịch staking hoàn chỉnh có thể được ký và gửi.Tham số:

owner (PublicKey): Ví sẽ sở hữu tài khoản stake
amount (number): Số lượng SOL cần stake

Trả về:

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

Ví dụ:

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

getStakeInstructions(owner, amount)

Chỉ trả về các lệnh staking (hữu ích khi tự tạo giao dịch tùy chỉnh).Trả về:

{
  instructions: TransactionInstruction[],
  stakeAccount: Keypair
}

Ví dụ:

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

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

getHeliusStakeAccounts(wallet)

Truy xuất tất cả tài khoản stake của một ví đã ủy quyền cho trình xác thực Helius.Ví dụ:

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)

Tạo giao dịch để hủy kích hoạt (bắt đầu unstake) một tài khoản stake.Ví dụ:

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?)

Kiểm tra số lượng SOL có thể rút từ một tài khoản stake đã hủy kích hoạt.Tham số:

includeRent (boolean): Có bao gồm số tiền được miễn phí thuê hay không

Ví dụ:

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)

Tạo giao dịch để rút SOL từ một tài khoản stake đã hủy kích hoạt.Ví dụ:

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

Quy trình staking hoàn chỉnh

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`);
}

Mẫu nâng cao

Browser Integration
Batch Operations
Smart Transactions

Dành cho các ứng dụng trình duyệt sử dụng bộ điều hợp ví:

// 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()}`);

Stake hiệu quả cho nhiều ví:

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`);
}

Sử dụng Smart Transactions để cải thiện độ tin cậy và khả năng tối ưu hóa:

// 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}`);

Lưu ý quan trọng

Thời điểm epoch: Mỗi epoch Solana kéo dài ~1 ngày. Stake được kích hoạt khi epoch tiếp theo bắt đầu, còn việc hủy kích hoạt có hiệu lực khi epoch hiện tại kết thúc.

Lưu ý về phí thuê: Tài khoản stake cần khoản dự trữ được miễn phí thuê (~0.00228 SOL). Rút toàn bộ số dư sẽ đóng tài khoản.

Ví phần cứng: Người dùng sẽ thấy hai lời nhắc ký — một cho tài khoản stake (được ký trước) và một cho bên trả phí. Hãy thiết kế UX cho phù hợp.

Tham chiếu nhanh

Cần xem lại nhanh? Dưới đây là các phương thức thiết yếu:

// 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);

Bước tiếp theo

Helius SDK Documentation

Tài liệu tham chiếu SDK đầy đủ với tất cả phương thức hiện có

Smart Transactions

Tối ưu hóa giao dịch bằng phí ưu tiên và logic thử lại

Join Discord

Nhận trợ giúp từ cộng đồng nhà phát triển của chúng tôi

Validator Dashboard

Theo dõi hiệu suất và phần thưởng của trình xác thực Helius

Bắt đầu tại đây

Dữ liệu thời gian thực

Giao dịch độ trễ thấp

Dữ liệu lịch sử & ví

Hướng dẫn phương thức RPC

Mức độ sẵn sàng cho môi trường production

Sử dụng Orb

Các hướng dẫn khác

Staking Solana theo chương trình với Helius SDK

Tổng quan nhanh

Create & Delegate

Monitor & Manage

Withdraw & Redeem

Cài đặt và thiết lập

Kiến thức cơ bản về staking

Bắt đầu

Tham chiếu các phương thức SDK

Quy trình staking hoàn chỉnh

Mẫu nâng cao

Lưu ý quan trọng

Tham chiếu nhanh

Bước tiếp theo

Helius SDK Documentation

Smart Transactions

Join Discord

Validator Dashboard

​Tổng quan nhanh

Create & Delegate

Monitor & Manage

Withdraw & Redeem

​Cài đặt và thiết lập

​Kiến thức cơ bản về staking

​Bắt đầu

​Tham chiếu các phương thức SDK

​Quy trình staking hoàn chỉnh

​Mẫu nâng cao

​Lưu ý quan trọng

​Tham chiếu nhanh

​Bước tiếp theo

Helius SDK Documentation

Smart Transactions

Join Discord

Validator Dashboard

Tổng quan nhanh

Cài đặt và thiết lập

Kiến thức cơ bản về staking

Bắt đầu

Tham chiếu các phương thức SDK

Quy trình staking hoàn chỉnh

Mẫu nâng cao

Lưu ý quan trọng

Tham chiếu nhanh

Bước tiếp theo