Berdagang dengan Preconfirmations

Preconfirmations mengalirkan transaksi sebelum transaksi tersebut dipecah menjadi shred — Helius mengirimkan preconfirmation segera setelah leader mengeksekusinya, beserta status eksekusinya. Panduan ini membuat listener yang memantau akun target, mendekode setiap transaksi, dan bereaksi menggunakan Sender Max.

Preconfirmations memerlukan paket Professional atau yang lebih tinggi dan dikenai biaya 10 kredit per pesan.

Batasi cakupan aliran sebelum Anda terhubung

preconfSubscribe tanpa filter mengirimkan setiap transaksi dengan biaya masing-masing 10 kredit. Karena itu, gunakan filter di sisi server dan bayar hanya untuk transaksi yang akan Anda tindak lanjuti.

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

Tiga filter mencakup sebagian besar listener perdagangan:

failed: false menghapus transaksi yang sudah diketahui telah dibatalkan, sehingga Anda tidak perlu berlomba memprosesnya.
regionInclude menetapkan aliran ke wilayah yang paling dekat dengan infrastruktur Anda agar perpindahan lintas wilayah tidak menghabiskan keunggulan waktu Anda.
accountInclude mencocokkan transaksi apa pun yang mereferensikan target Anda: dompet, pool AMM, program, dan sebagainya. Helius me-resolve address lookup table di sisi server, sehingga filter tetap cocok meskipun akun dimuat melalui ALT.

Hubungkan, berlangganan, dan dekode

preconfSubscribe disediakan melalui endpoint Gatekeeper (wss://beta.helius-rpc.com), dan notifikasi diterima sebagai frame biner, bukan JSON. Setiap frame terdiri dari prefiks tetap sepanjang 18 byte yang diikuti transaksi yang diserialisasi dengan 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

Periksa byte versi terlebih dahulu. Jika Helius memperbarui format payload, nomor versi akan bertambah. Membuat percabangan berdasarkan versi tersebut akan menjaga dekoder Anda tetap berfungsi. Transaksi yang telah dideserialisasi menyediakan instruksi, akun, dan tanda tangan.

Bertindak dengan Sender Max

Preconfirmation hanya bermanfaat jika respons Anda masuk lebih dahulu. Kirim reaksi Anda melalui Sender Max: tip sebesar 0,001 SOL masuk ke buffer tip prioritas dan dirutekan melalui setiap jalur berkecepatan tinggi:

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

Jaga agar handler ini tetap ringkas. Ambil keputusan dan kirim, lalu pindahkan pencatatan log, akuntansi, dan rekonsiliasi dari jalur penerimaan. Lihat Pastikan Perdagangan Masuk dengan Sender untuk loop pengiriman lengkap, termasuk pemanasan koneksi dan estimasi biaya.

Konfirmasikan transaksi telah masuk dan antisipasi celah

Preconfirmation adalah informasi awal. Transaksi belum masuk dan masih dapat gagal atau dibatalkan, sehingga ada dua aturan yang berlaku:

Konfirmasikan melalui pemeriksaan commitment standar (getSignatureStatuses, atau aliran dengan commitment processed) sebelum menganggap transaksi yang diamati atau reaksi Anda sebagai final.
Antisipasi celah. Cakupan meningkat sesuai proporsi stake yang diteruskan ke Helius, sehingga beberapa slot tidak menghasilkan pesan. Ini adalah perilaku yang diperkirakan, bukan koneksi yang terputus. Ping keepalive membantu membedakan keduanya. Berlangganan kembali saat koneksi ditutup.

Panduan terkait

preconfSubscribe API reference

Semantik filter lengkap, kode wilayah, dan tata letak payload biner

Trade on Preprocessed Transactions

Cakupan praeksekusi dengan biaya 0,1 kredit per pesan, tersedia di semua paket berbayar

Mulai di Sini

Data Waktu Nyata

Perdagangan Latensi Rendah

Data Historis & Dompet

Panduan Metode RPC

Kesiapan Produksi

Menggunakan Orb

Panduan Praktis Lainnya

Berdagang dengan Preconfirmations

Batasi cakupan aliran sebelum Anda terhubung

Hubungkan, berlangganan, dan dekode

Bertindak dengan Sender Max

Konfirmasikan transaksi telah masuk dan antisipasi celah

Panduan terkait

preconfSubscribe API reference

Trade on Preprocessed Transactions

​Batasi cakupan aliran sebelum Anda terhubung

​Hubungkan, berlangganan, dan dekode

​Bertindak dengan Sender Max

​Konfirmasikan transaksi telah masuk dan antisipasi celah

​Panduan terkait

preconfSubscribe API reference

Trade on Preprocessed Transactions

Batasi cakupan aliran sebelum Anda terhubung

Hubungkan, berlangganan, dan dekode

Bertindak dengan Sender Max

Konfirmasikan transaksi telah masuk dan antisipasi celah

Panduan terkait