跳转到主要内容
在 Solana 上发送交易有两种主要方法:
  1. 使用 staked connections
  2. 使用专门的着陆服务,如 Sender
本文涵盖使用 staked connections 的交易优化最佳实践,这是所有 Helius 付费计划的默认方法。 Staked connections 最适合于延迟对您的业务不关键的用例(例如,支付、钱包、社交应用等)。 如果您是高级交易员(例如,高频交易、MEV 搜索者、套利者、代币狙击手等)并寻找专门的超低延迟交易着陆服务,请阅读我们的 Sender 教程

总结

Helius 的 staked connections 保证 100% 的交易交付,确认时间最短。为了优化使用 staked connections 的交易着陆率,我们建议以下最佳实践:
  • 使用承诺 “confirmed” 来获取 最新的 blockhash
  • 添加 优先费用 并动态计算它们
  • 优化计算单元 (CU) 的使用
  • maxRetries 设置为 0 并实施强大的重试逻辑
  • 发送时将 skipPreflight 设置为 true(可选)
想深入了解吗?我们在这篇 博客文章 中涵盖了所有基础知识。

为交易员推荐的优化

对于对延迟敏感的交易用例,我们建议 使用 Sender 但是,如果您使用 staked connections 并希望优化您的设置以获得尽可能低的延迟,我们建议以下优化(除了应用上述最佳实践):
  • 您的客户端服务器(用于发送交易的机器)应位于美国东部或西欧。
  • 如果您希望与 Helius 交易发送服务器共同定位,请选择 FRA 或 PIT。
  • 避免从远离验证器网络的地区发送(例如,拉丁美洲、南非)。
  • 预热 Helius 区域缓存以最小化尾部延迟。
  • 每个区域只需要一个预热线程 - 任何更多都没有好处。
  • 每秒使用您用于发送交易的相同端点和 API 密钥发送一个 getHealth RPC 调用。
这些好处只有经验丰富的交易者才能注意到。对于一般的应用程序开发者,我们建议遵循下面“发送智能交易”部分中的指南。

发送智能交易

Helius 的 Node.jsRust SDK 都可以发送智能交易。这种新方法在处理确认状态的同时构建并发送优化的交易。 用户可以配置交易的发送选项,例如交易是否应跳过预检检查。 在最基本的层面上,用户必须提供他们的密钥对和他们希望执行的指令,其余的由我们处理。 我们:
  • 获取最新的区块哈希
  • 构建初始交易
  • 模拟初始交易以获取消耗的计算单元(CUs)
  • 将 CU 限制设置为上一步中消耗的 CUs,并留有一定余量
  • 通过我们的 Priority Fee API 获取 Helius 推荐的优先费用
  • 将优先费用(每 CU 的微 lamports)设置为 Helius 推荐的费用
  • 添加一个小的缓冲费用,以防推荐费用在接下来的几秒钟内发生变化
  • 构建并发送优化的交易
  • 如果成功,返回交易签名
要求推荐值(或更高)用于我们的质押连接,确保 Helius 发送高质量的交易,并且不会被验证者限速。
这种方法是构建、发送和在 Solana 上完成交易的最简单方法。 通过使用 Helius 推荐的费用,使用我们 标准付费计划 的 Helius 用户发送的交易将通过我们的质押连接路由,几乎保证 100% 的交易交付和最小的延迟。

Node.js SDK

sendSmartTransaction 方法在我们的 Helius Node.js SDK 中可用,适用于 版本 >= 1.3.2。要更新到更高版本的 SDK,请运行 npm update helius-sdk 此示例将 SOL 转移到您选择的账户。它使用 sendSmartTransaction 发送一个不跳过预检检查的优化交易:
import { Helius } from "helius-sdk";
import {
  Keypair,
  SystemProgram,
  LAMPORTS_PER_SOL,
  TransactionInstruction,
} from "@solana/web3.js";

const helius = new Helius("YOUR_API_KEY");
const fromKeypair = /* Your keypair goes here */;
const fromPubkey = fromKeypair.publicKey;
const toPubkey = /* The person we're sending 0.5 SOL to */;

const instructions: TransactionInstruction[] = [
  SystemProgram.transfer({
    fromPubkey: fromPubkey,
    toPubkey: toPubkey,
    lamports: 0.5 * LAMPORTS_PER_SOL, 
  }),
];

const transactionSignature = await helius.rpc.sendSmartTransaction(instructions, [fromKeypair]);
console.log(`Successful transfer: ${transactionSignature}`);

Rust SDK

send_smart_transaction 方法在我们的 Rust SDK 中可用,适用于 版本 >= 0.1.5。要更新到更高版本的 SDK,请运行 cargo update helius 以下示例将 0.01 SOL 转移到您选择的账户。 它利用 send_smart_transaction 发送一个跳过预检检查并在必要时重试两次的优化交易:
use helius::types::*;
use helius::Helius;
use solana_sdk::{
    pubkey::Pubkey,
    signature::Keypair,
    system_instruction
};

#[tokio::main]
async fn main() {
    let api_key: &str = "YOUR_API_KEY";
    let cluster: Cluster = Cluster::MainnetBeta;
    let helius: Helius = Helius::new(api_key, cluster).unwrap();
    
    let from_keypair: Keypair = /* Your keypair goes here */;
    let from_pubkey: Pubkey = from_keypair.pubkey();
    let to_pubkey: Pubkey = /* The person we're sending 0.01 SOL to */;

    // Create a simple instruction (transfer 0.01 SOL from from_pubkey to to_pubkey)
    let transfer_amount = 100_000; // 0.01 SOL in lamports
    let instruction = system_instruction::transfer(&from_pubkey, &to_pubkey, transfer_amount);

    // Create the SmartTransactionConfig
    let config = SmartTransactionConfig {
        instructions,
        signers: vec![&from_keypair],
        send_options: RpcSendTransactionConfig {
            skip_preflight: true,
            preflight_commitment: None,
            encoding: None,
            max_retries: Some(2),
            min_context_slot: None,
        },
        lookup_tables: None,
    };

    // Send the optimized transaction
    match helius.send_smart_transaction(config).await {
        Ok(signature) => {
            println!("Transaction sent successfully: {}", signature);
        }
        Err(e) => {
            eprintln!("Failed to send transaction: {:?}", e);
        }
    }
}

不使用 SDK 发送交易

我们建议使用我们的 SDK 之一发送智能交易,但不使用 SDK 也可以实现相同的功能。 Node.js SDK 和 Rust SDK 都是开源的,因此可以随时查看发送智能交易功能的底层代码。

准备和构建初始交易

首先,准备和构建初始交易。这包括创建一个包含一组指令的新交易,添加最近的区块哈希,并指定费用支付者。 对于版本化交易,创建一个 TransactionMessage 并在存在查找表时进行编译。 然后,创建一个新的版本化交易并对其进行签名——这是模拟交易时所必需的,因为交易必须签名。 例如,如果我们想准备一个版本化交易:
// Prepare your instructions and set them to an instructions variable
// The payerKey is the public key that will be paying for this transaction
// Prepare your lookup tables and set them to a lookupTables variable
let recentBlockhash = (await this.connection.getLatestBlockhash()).blockhash;
const v0Message = new TransactionMessage({
    instructions: instructions,
    payerKey: pubKey,
    recentBlockhash: recentBlockhash,
}).compileToV0Message(lookupTables);
versionedTransaction = new VersionedTransaction(v0Message);
versionedTransaction.sign([fromKeypair]);

优化交易的计算单元 (CU) 使用

优化交易的计算单元(CU)使用,我们可以使用simulateTransaction RPC方法来模拟交易。 模拟交易将返回使用的CU数量,因此我们可以使用此值来相应地设置我们的计算限制。 建议首先使用带有所需指令的测试交易,加上一条将计算限制设置为1.4百万CU的指令。 这样做是为了确保交易模拟成功。 例如:
const testInstructions = [
    ComputeBudgetProgram.setComputeUnitLimit({ units: 1_400_000 }),
    ...instructions,
];

const testTransaction = new VersionedTransaction(
    new TransactionMessage({
        instructions: testInstructions,
        payerKey: payer,
        recentBlockhash: (await this.connection.getLatestBlockhash()).blockhash,
    }).compileToV0Message(lookupTables)
);

const rpcResponse = await this.connection.simulateTransaction(testTransaction, {
    replaceRecentBlockhash: true,
    sigVerify: false,
});

const unitsConsumed = rpcResponse.value.unitsConsumed;
还建议增加一些余量以确保交易顺利执行。我们可以通过设置以下内容来实现:
let customersCU = Math.ceil(unitsConsumed * 1.1);
然后,创建一个指令,将计算单元限制设置为此值,并将其添加到您的指令数组中:
const computeUnitIx = ComputeBudgetProgram.setComputeUnitLimit({
    units: customersCU
});
instructions.push(computeUnitIx);

序列化和编码交易

这相对简单。 首先,为了序列化交易,Transaction和VersionedTransaction类型都有一个.serialize()方法。然后使用bs58包来编码交易。 您的代码应类似于bs58.encode(txt.serialize());

设置正确的优先费用

首先,使用优先费用API获取优先费用估算。我们希望传入我们的交易并通过推荐参数获取Helius推荐的费用:
const response = await fetch(HeliusURL, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
        jsonrpc: "2.0",
        id: "1",
        method: "getPriorityFeeEstimate",
        params: [
            {
                transaction: bs58.encode(versionedTransaction), // Pass the serialized transaction in
                options: { recommended: true },
            },
        ],   
    }),
});

const data = await response.json();
const priorityFeeRecommendation = data.result.priorityFeeEstimate;
然后,创建一个指令,将计算单元价格设置为此值,并将该指令添加到您之前的指令中:
const computeBudgetIx = ComputeBudgetProgram.setComputeUnitPrice({
    microLamports: priorityFeeRecommendation,
});

instructions.push(computeBudgetIx);

构建并发送优化后的交易

这一步几乎是第一步的重复。然而,初始指令数组已被更改,以添加两个指令来优化设置计算单元限制和价格。 现在,发送交易。 无论是否进行预检或更改其他发送选项,交易都会通过我们为所有付费计划提供的质押连接进行路由。

轮询交易状态和重新广播

虽然质押连接会将交易直接转发给领导者,但交易仍有可能在银行阶段被丢弃。建议用户使用自己的重新广播逻辑,而不是依赖RPC为他们重试交易。
sendTransaction RPC方法有一个maxRetries参数,可以设置以覆盖RPC的默认重试逻辑,给予开发者更多的重试过程控制。 一个常见的模式是通过getLatestBlockhash获取当前的区块哈希,存储lastValidBlockHeight,并在区块哈希过期前重试交易。 关键是只有在区块哈希不再有效时才重新签署交易,否则网络可能会接受两个交易。 一旦交易发送,重要的是轮询其确认状态,以查看网络是否已处理并确认交易,然后再重试。使用getSignatureStatuses RPC方法检查交易列表的确认状态。 @solana/web3.js SDK在其Connection类上也有一个getSignatureStatuses方法,用于获取多个签名的当前状态。

sendSmartTransaction如何处理轮询和重新广播

sendSmartTransaction方法有一个60秒的超时时间。由于一个区块哈希在150个槽内有效,并假设完美的400毫秒槽,我们可以合理地假设交易的区块哈希将在一分钟后失效。 该方法发送交易并使用此超时时间轮询其签名:
try {
   // Create a smart transaction
   const transaction = await this.createSmartTransaction(instructions, signers, lookupTables, sendOptions);
  
   const timeout = 60000;
   const startTime = Date.now();
   let txtSig;
  
   while (Date.now() - startTime < timeout) {
     try {
       txtSig = await this.connection.sendRawTransaction(transaction.serialize(), {
         skipPreflight: sendOptions.skipPreflight,
         ...sendOptions,
       });
  
       return await this.pollTransactionConfirmation(txtSig);
     } catch (error) {
       continue;
     }
   }
} catch (error) {
   throw new Error(`Error sending smart transaction: ${error}`);
}
txtSig 被设置为刚刚发送的交易的签名。 然后,该方法使用 pollTransactionConfirmation() 方法轮询交易的确认状态。此方法每五秒检查一次交易状态,最多三次。 如果在此期间交易未被确认,则返回错误:
async pollTransactionConfirmation(txtSig: TransactionSignature): Promise<TransactionSignature> {
    // 15 second timeout
    const timeout = 15000;
    // 5 second retry interval
    const interval = 5000;
    let elapsed = 0;

    return new Promise<TransactionSignature>((resolve, reject) => {
      const intervalId = setInterval(async () => {
        elapsed += interval;

        if (elapsed >= timeout) {
          clearInterval(intervalId);
          reject(new Error(`Transaction ${txtSig}'s confirmation timed out`));
        }

        const status = await this.connection.getSignatureStatuses([txtSig]);

        if (status?.value[0]?.confirmationStatus === "confirmed") {
          clearInterval(intervalId);
          resolve(txtSig);
        }
      }, interval);
   });
}