Commerce sur les Préconfirmations

Préconfirmations diffuse les transactions avant qu’elles ne soient fragmentées — Helius préconfirme à l’instant où le leader les exécute, avec leur statut d’exécution. Ce guide construit un écouteur qui surveille un compte cible, décode chaque transaction et réagit en utilisant Sender Max.

Les préconfirmations nécessitent un plan Professionnel ou supérieur et coûtent 10 crédits par message.

Définir la portée du flux avant de vous connecter

Un preconfSubscribe non filtré livre chaque transaction à 10 crédits chacune, alors filtrez côté serveur et payez uniquement pour ce sur quoi vous commercez.

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

Trois filtres couvrent la plupart des écouteurs de trading :

failed: false élimine les transactions déjà connues pour avoir été annulées, que vous n’avez aucune raison de précipiter.
regionInclude ancre le flux à la région la plus proche de votre infrastructure, afin qu’un saut interrégional ne consomme pas l’avance.
accountInclude correspond à toute tx référencée par votre cible : un portefeuille, un pool AMM, un programme, etc. Helius résout les tables de consultation d’adresses côté serveur, donc le filtre correspond même lorsque le compte est chargé via un ALT.

Connectez-vous, abonnez-vous et décodez

preconfSubscribe est servi depuis le point de terminaison Gatekeeper (wss://beta.helius-rpc.com), et les notifications arrivent sous forme de trames binaires, pas JSON. Chaque trame est un préfixe immuable de 18 octets suivi de la transaction sérialisée en 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

Vérifiez d’abord l’octet de version. Si Helius met à jour le format de charge utile, la version s’incrémente, et s’y brancher maintient votre décodeur fonctionnel. La transaction désérialisée vous donne les instructions, les comptes et la signature.

Agir avec Sender Max

Une préconfirmation ne rapporte que si votre réponse arrive en premier. Envoyez votre réaction via Sender Max : le pourboire de 0,001 SOL entre dans le tampon de pourboire prioritaire et est acheminé via chaque voie à haute vitesse :

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

Gardez cet gestionnaire court. Décidez et envoyez, et déplacez la journalisation, la comptabilité et la réconciliation hors du chemin de réception. Voir Land Trades with Sender pour la boucle d’envoi complète, y compris le réchauffement de la connexion et l’estimation des frais.

Confirmez l’atterrissage et attendez-vous à des écarts

Une préconfirmation est un aperçu précoce. La transaction n’a pas encore atterri et peut encore échouer ou être abandonnée, donc deux règles s’appliquent :

Confirmez via des vérifications d’engagement standard (getSignatureStatuses, ou un flux processed-engagement) avant de considérer la transaction observée ou votre réaction comme définitive.
Attendez-vous à des écarts. La couverture évolue avec la part du jalonnement transférée à Helius, donc certains créneaux ne produisent aucun message. C’est un comportement attendu plutôt qu’une connexion interrompue, et le ping keepalive différencie les deux. Réabonnez-vous à la fermeture.

Guides associés

Référence API preconfSubscribe

Semantiques complètes des filtres, codes régionaux et disposition de la charge utile binaire

Commerce sur les Transactions Prétraitées

Couverture pré-exécution à 0,1 crédit par message, sur tous les plans payants

Commencez ici

Données en temps réel

Trading à faible latence

Données historiques et de portefeuille

Guides des méthodes RPC

Préparation à la production

Utilisation d'Orb

Autres modes d'emploi

Commerce sur les Préconfirmations

Définir la portée du flux avant de vous connecter

Connectez-vous, abonnez-vous et décodez

Agir avec Sender Max

Confirmez l’atterrissage et attendez-vous à des écarts

Guides associés

Référence API preconfSubscribe

Commerce sur les Transactions Prétraitées

​Définir la portée du flux avant de vous connecter

​Connectez-vous, abonnez-vous et décodez

​Agir avec Sender Max

​Confirmez l’atterrissage et attendez-vous à des écarts

​Guides associés

Référence API preconfSubscribe

Commerce sur les Transactions Prétraitées

Définir la portée du flux avant de vous connecter

Connectez-vous, abonnez-vous et décodez

Agir avec Sender Max

Confirmez l’atterrissage et attendez-vous à des écarts

Guides associés