Giao dịch bằng Preconfirmations

Preconfirmations truyền phát các giao dịch trước khi chúng được chia thành shred — Helius gửi thông tin xác nhận trước ngay khi leader thực thi giao dịch, cùng với trạng thái thực thi. Hướng dẫn này xây dựng một trình lắng nghe để theo dõi tài khoản mục tiêu, giải mã từng giao dịch và phản ứng bằng Sender Max.

Preconfirmations yêu cầu gói Professional trở lên và có chi phí 10 credit cho mỗi thông báo.

Giới hạn phạm vi luồng trước khi kết nối

Một preconfSubscribe không được lọc sẽ cung cấp mọi giao dịch với chi phí 10 credit cho mỗi giao dịch, vì vậy hãy lọc ở phía máy chủ và chỉ trả phí cho những giao dịch bạn thực sự xử lý.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "preconfSubscribe",
  "params": [
    {
      "failed": false,
      "regionInclude": ["ewr"],
      "accountInclude": ["TARGET_WALLET_OR_PROGRAM"]
    }
  ]
}

Ba bộ lọc đáp ứng hầu hết các trình lắng nghe giao dịch:

failed: false loại bỏ các giao dịch đã được xác định là bị hoàn tác, vì bạn không cần chạy đua với chúng.
regionInclude ghim luồng vào khu vực gần hạ tầng của bạn nhất, để bước nhảy liên vùng không làm mất lợi thế ban đầu.
accountInclude khớp với mọi giao dịch tham chiếu đến mục tiêu của bạn: ví, pool AMM, chương trình, v.v. Helius phân giải các bảng tra cứu địa chỉ ở phía máy chủ, vì vậy bộ lọc vẫn khớp ngay cả khi tài khoản được tải qua ALT.

Kết nối, đăng ký và giải mã

preconfSubscribe được cung cấp từ endpoint Gatekeeper (wss://beta.helius-rpc.com), còn thông báo được gửi dưới dạng khung nhị phân chứ không phải JSON. Mỗi khung gồm một tiền tố cố định dài 18 byte, theo sau là giao dịch được tuần tự hóa bằng bincode:

listener.js

const WebSocket = require('ws');
const { VersionedTransaction } = require('@solana/web3.js');

const ws = new WebSocket('wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY');

ws.on('open', () => {
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'preconfSubscribe',
    params: [{
      failed: false,
      regionInclude: ['ewr'],
      accountInclude: ['TARGET_WALLET_OR_PROGRAM']
    }]
  }));
  setInterval(() => ws.ping(), 30_000); // keep the connection alive
});

ws.on('message', (data, isBinary) => {
  if (!isBinary) {
    const msg = JSON.parse(data.toString());
    if (msg.id === 1) console.log('Subscribed, ID:', msg.result);
    return;
  }

  // version (u8) | slot (u64 LE) | tx_index (u64 LE) | status (u8) | bincode(VersionedTransaction)
  const buf = Buffer.from(data);
  if (buf.readUInt8(0) !== 1) return; // unknown schema version; update your decoder
  const slot = buf.readBigUInt64LE(1);
  const status = buf.readUInt8(17); // 0 = failed, 1 = success, 2 = unknown
  const tx = VersionedTransaction.deserialize(buf.subarray(18));

  onScheduledTransaction({ slot, status, tx });
});

ws.on('error', console.error);
ws.on('close', () => process.exit(1)); // let your supervisor restart and resubscribe

Trước tiên, hãy kiểm tra byte phiên bản. Nếu Helius cập nhật định dạng payload, số phiên bản sẽ tăng; việc phân nhánh theo số này giúp bộ giải mã tiếp tục hoạt động. Giao dịch sau khi giải tuần tự cung cấp cho bạn các lệnh, tài khoản và chữ ký.

Hành động bằng Sender Max

Xác nhận trước chỉ mang lại lợi ích nếu phản ứng của bạn được ghi nhận đầu tiên. Gửi phản ứng qua Sender Max: khoản tip 0,001 SOL đi vào bộ đệm tip ưu tiên và được định tuyến qua mọi đường truyền tốc độ cao:

async function onScheduledTransaction({ slot, status, tx }) {
  if (!strategy.shouldReact(tx)) return;

  // strategy is your own code: it decides whether to react and returns a
  // signed, base64-encoded transaction that includes the tip and priority fee
  const reaction = await strategy.buildTransaction(tx);
  await fetch('http://ewr-sender.helius-rpc.com/fast', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: Date.now().toString(),
      method: 'sendTransaction',
      params: [reaction, { encoding: 'base64', skipPreflight: true, maxRetries: 0 }]
    })
  });
}

Hãy giữ trình xử lý này ngắn gọn. Ra quyết định rồi gửi, đồng thời chuyển việc ghi log, hạch toán và đối soát ra khỏi luồng tiếp nhận. Xem Đưa giao dịch lên chuỗi bằng Sender để tìm hiểu toàn bộ vòng lặp gửi, bao gồm làm nóng kết nối và ước tính phí.

Xác nhận giao dịch được ghi nhận và dự kiến có khoảng trống

Xác nhận trước chỉ cung cấp thông tin sớm. Giao dịch chưa được ghi nhận và vẫn có thể thất bại hoặc bị loại bỏ, vì vậy cần tuân theo hai quy tắc:

Xác nhận bằng các bước kiểm tra commitment tiêu chuẩn (getSignatureStatuses hoặc luồng có commitment processed) trước khi coi giao dịch quan sát được hoặc phản ứng của bạn là cuối cùng.
Hãy dự kiến có khoảng trống. Phạm vi bao phủ tỷ lệ thuận với lượng stake chuyển tiếp đến Helius, vì vậy một số slot không tạo ra thông báo. Đây là hành vi dự kiến, không phải kết nối bị ngắt; ping keepalive giúp phân biệt hai trường hợp này. Hãy đăng ký lại khi kết nối đóng.

Hướng dẫn liên quan

preconfSubscribe API reference

Ngữ nghĩa đầy đủ của bộ lọc, mã khu vực và bố cục payload nhị phân

Trade on Preprocessed Transactions

Phạm vi bao phủ trước khi thực thi với chi phí 0,1 credit cho mỗi thông báo, áp dụng cho mọi gói trả phí

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

Hướng dẫn khác

Giao dịch bằng Preconfirmations

Giới hạn phạm vi luồng trước khi kết nối

Kết nối, đăng ký và giải mã

Hành động bằng Sender Max

Xác nhận giao dịch được ghi nhận và dự kiến có khoảng trống

Hướng dẫn liên quan

preconfSubscribe API reference

Trade on Preprocessed Transactions

​Giới hạn phạm vi luồng trước khi kết nối

​Kết nối, đăng ký và giải mã

​Hành động bằng Sender Max

​Xác nhận giao dịch được ghi nhận và dự kiến có khoảng trống

​Hướng dẫn liên quan

preconfSubscribe API reference

Trade on Preprocessed Transactions

Giới hạn phạm vi luồng trước khi kết nối

Kết nối, đăng ký và giải mã

Hành động bằng Sender Max

Xác nhận giao dịch được ghi nhận và dự kiến có khoảng trống

Hướng dẫn liên quan