preconfSubscribe

Inicie uma assinatura para Pré-confirmações — transações entregues na etapa de transação agendada, antes de serem coletadas em entradas e convertidas em fragmentos. Este é o sinal de transação com menor latência que a Helius oferece.

Endpoints

preconfSubscribe é servido a partir do endpoint Helius Gatekeeper:

wss://beta.helius-rpc.com/?api-key=<API_KEY>

O hostname beta refere-se à implantação do Gatekeeper, não à maturidade das Pré-confirmações — ele se tornará o endpoint padrão à medida que o tráfego migrar para o Gatekeeper.

O fluxo não é contínuo. A cobertura escala com a participação de rede encaminhando para a Helius, então espere slots sem mensagens — lide com essas lacunas de forma adequada. Consulte Cobertura.

Autorizações

string

obrigatório

Sua chave de API da Helius, passada como o parâmetro de consulta api-key. Requer um plano Profissional ou superior.

Corpo

array

Opcional. Omitir params para receber todas as transações agendadas. Para restringir o fluxo, passe um objeto de filtro como o primeiro elemento — a filtragem acontece no servidor, assim você só paga e recebe as transações de seu interesse.

Ocultar Filtro

Cada campo é opcional — um campo ausente significa “sem restrição” para esse predicado, então um filtro vazio corresponde a cada transação. Define campos combinados com E, avaliados na ordem regionInclude → accountExclude → accountRequired → accountInclude.

boolean

false descarta transações falhas (revertidas); transações de sucesso e com status desconhecido ainda passam. true — como omitir o campo — mantém todos os status.

string[]

Se não estiver vazio, a transação deve se originar de uma dessas regiões. Transações sem informações de região são descartadas quando isso é definido.

string[]

Se não estiver vazio, a transação deve referenciar pelo menos uma dessas contas (chaves públicas base58). Limitado a 500 entradas.

string[]

A transação é descartada se referenciar qualquer uma dessas contas. Tem precedência sobre accountInclude. Limitado a 500 entradas.

string[]

A transação deve referenciar todas essas contas. Limitado a 500 entradas.

Um valor de conta inválido ou código de região não reconhecido retorna erro JSON-RPC -32602 (parâmetros inválidos). Os filtros de conta correspondem a mais do que as chaves de conta estáticas da transação — a Helius resolve tabelas de pesquisa de endereço v0 tables de pesquisa de endereço no servidor, então accountInclude, accountExclude, e accountRequired também correspondem a contas que uma transação carrega por meio de um ALT.

Códigos de região

Código	Localização	Código	Localização
`slc`	Salt Lake City	`tyo`	Tóquio
`fra`	Frankfurt	`ams`	Amsterdã
`lon`	Londres	`dal`	Dallas
`pit`	Pittsburgh	`dub`	Dublin
`sgp`	Singapura	`mia`	Miami
`ewr`	Newark	`lax`	Los Angeles
`iad`	Ashburn	`sea`	Seattle

Resposta

integer

ID da assinatura (necessário para cancelar a inscrição)

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

const WebSocket = require('ws');

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

ws.on('open', () => {
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'preconfSubscribe'
    // Optional filter:
    // params: [{ failed: false, accountInclude: ['9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM'] }]
  }));

  setInterval(() => ws.ping(), 30_000);
});

ws.on('message', (data, isBinary) => {
  // The subscribe acknowledgement arrives as a JSON text frame
  if (!isBinary) {
    const msg = JSON.parse(data.toString());
    if (msg.id === 1) console.log('Subscribed, ID:', msg.result);
    return;
  }

  // Notifications arrive as binary frames:
  // version (u8) | slot (u64 LE) | tx_index (u64 LE) | status (u8) | bincode(VersionedTransaction)
  const buf = Buffer.from(data);
  const version = buf.readUInt8(0);
  if (version !== 1) return; // unknown schema version; update your decoder
  const slot = buf.readBigUInt64LE(1);
  const txIndex = buf.readBigUInt64LE(9);
  const status = buf.readUInt8(17); // 0 = failed, 1 = success, 2 = unknown
  const txBytes = buf.subarray(18); // bincode-serialized VersionedTransaction

  console.log('Scheduled transaction:', { slot, txIndex, status, bytes: txBytes.length });
});

{ "jsonrpc": "2.0", "id": 1, "result": 24040 }

version   u8              payload schema version, currently 1
slot      u64 (LE)        slot the transaction is scheduled in
tx_index  u64 (LE)        index of the transaction within the slot
status    u8              0 = failed, 1 = success, 2 = unknown
tx        bincode bytes   bincode(VersionedTransaction)

Notificações

Após o reconhecimento em JSON, as notificações são entregues como frames WebSocket binários (não JSON). Cada frame é um layout de bytes empacotados que transporta uma única transação agendada:

Bytes	Campo	Tipo	Descrição
0	`version`	`u8`	Versão do esquema de payload. Atualmente `1`.
1–8	`slot`	`u64` (little-endian)	O slot em que a transação está agendada.
9–16	`tx_index`	`u64` (little-endian)	Índice da transação dentro do slot.
17	`status`	`u8`	Status da transação: `0` = falha, `1` = sucesso, `2` = desconhecido. O status de execução é relatado pelos validadores com base no melhor esforço — `2` quando não está disponível.
18+	`transaction`	`bincode(VersionedTransaction)`	A transação agendada, serializada em formato bincode.

Leia os campos em ordem e, em seguida, bincode-desserialize os bytes restantes em um VersionedTransaction para ler instruções, contas e a assinatura.

Sempre leia e verifique o byte version primeiro. Atualmente é 1. Se a Helius precisar atualizar o formato do payload, a versão será incrementada — ramifique para que seu decodificador continue funcionando em mudanças de esquema.

Uma pré-confirmação é um sinal inicial, não uma garantia. A transação ainda não foi registrada onchain e ainda pode falhar ou ser descartada. Confirme o registro por meio de verificações de compromisso padrão antes de tratá-la como final.

Preços

As pré-confirmações exigem um plano Profissional ou superior e custam 10 créditos por mensagem — uma mensagem por transação transmitida. Veja Créditos para detalhes.

Relacionados

Visão Geral das Pré-confirmações

O que são Pré-confirmações e onde elas se situam no pipeline do validador.

preconfUnsubscribe

Cancele uma assinatura pelo seu ID.

getValidityProof

preconfUnsubscribe

⌘I

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

const WebSocket = require('ws');

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

ws.on('open', () => {
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'preconfSubscribe'
    // Optional filter:
    // params: [{ failed: false, accountInclude: ['9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM'] }]
  }));

  setInterval(() => ws.ping(), 30_000);
});

ws.on('message', (data, isBinary) => {
  // The subscribe acknowledgement arrives as a JSON text frame
  if (!isBinary) {
    const msg = JSON.parse(data.toString());
    if (msg.id === 1) console.log('Subscribed, ID:', msg.result);
    return;
  }

  // Notifications arrive as binary frames:
  // version (u8) | slot (u64 LE) | tx_index (u64 LE) | status (u8) | bincode(VersionedTransaction)
  const buf = Buffer.from(data);
  const version = buf.readUInt8(0);
  if (version !== 1) return; // unknown schema version; update your decoder
  const slot = buf.readBigUInt64LE(1);
  const txIndex = buf.readBigUInt64LE(9);
  const status = buf.readUInt8(17); // 0 = failed, 1 = success, 2 = unknown
  const txBytes = buf.subarray(18); // bincode-serialized VersionedTransaction

  console.log('Scheduled transaction:', { slot, txIndex, status, bytes: txBytes.length });
});

{ "jsonrpc": "2.0", "id": 1, "result": 24040 }

version   u8              payload schema version, currently 1
slot      u64 (LE)        slot the transaction is scheduled in
tx_index  u64 (LE)        index of the transaction within the slot
status    u8              0 = failed, 1 = success, 2 = unknown
tx        bincode bytes   bincode(VersionedTransaction)

Introdução

Transmissão de Dados & Escuta de Eventos

APIs de Dados & RPCs

Negociação

Envio de Transações

Gestão de Contas

Endpoints

Autorizações

Corpo

Códigos de região

Resposta

Notificações

Preços

Relacionados

Visão Geral das Pré-confirmações

preconfUnsubscribe

​Endpoints

​Autorizações

​Corpo

​Códigos de região

​Resposta

​Notificações

​Preços

​Relacionados

Visão Geral das Pré-confirmações

preconfUnsubscribe

Endpoints

Autorizações

Corpo

Códigos de região

Resposta

Notificações

Preços

Relacionados