Inscrever-se

Autorizações

string

obrigatório

Sua chave de API Helius. Você pode obter uma gratuitamente no painel de controle.

Mensagem

A API gRPC suporta múltiplos tipos de inscrição que podem ser combinados em uma única solicitação:

object

Inscreva-se para atualizações de conta. Retorna dados quando contas específicas são modificadas.

Ocultar propriedades

array

Matriz de chaves públicas de conta a serem monitoradas.

array

Matriz de chaves públicas de proprietário a serem monitoradas (todas as contas de propriedade desses programas).

object

Filtros opcionais para aplicar.

Mostrar opções de filtro

object

Filtre por bytes específicos em um deslocamento nos dados da conta.

Mostrar propriedades

integer

Posição em bytes para começar a comparar os dados.

string

Os dados para comparar (formato bytes).

string

Os dados para comparar (formato base58).

string

Os dados para comparar (formato base64).

integer

Filtre por tamanho exato dos dados da conta em bytes.

boolean

Filtrar apenas contas de token.

object

Filtrar pelo saldo de SOL com comparações.

Mostrar operadores de comparação

integer

Igual ao valor especificado.

integer

Diferente do valor especificado.

integer

Menor que o valor especificado.

integer

Maior que o valor especificado.

boolean

Se true, incluir apenas atualizações causadas por uma transação. Se false, incluir apenas atualizações não causadas por uma transação. Se undefined, incluir todas as atualizações.

object

Inscreva-se para atualizações de slots.

Ocultar propriedades

boolean

Filtrar slots por nível de compromisso.

boolean

Incluir atualizações de status intermediário de slots (PROCESSED, CONFIRMED, FINALIZED, FIRST_SHRED_RECEIVED, COMPLETED, CREATED_BANK, DEAD).

object

Inscreva-se para atualizações de transações.

Ocultar propriedades

boolean

Incluir transações de voto.

boolean

Incluir transações que falharam.

string

Monitorar assinatura de transação específica.

array

Incluir apenas transações que afetam essas contas.

array

Excluir transações que afetam essas contas.

array

Transações devem afetar todas essas contas.

enum

Expansão opcional de conta associada ao token (ATA) (tag de campo 30, TokenAccountExpansionControlFlag). Quando definido, uma carteira account_include também corresponde a transações onde ela possui um saldo de token SPL — por exemplo, transferências de token recebidas que tocam na conta de token da carteira em vez de sua chave pública. Duas variantes:

ALL (0) — corresponder a qualquer transação que referencie um saldo de token que a carteira possui, mesmo que não tenha mudado. Maior volume.
BALANCE_CHANGED (1) — corresponder quando a carteira possui um saldo de token cujo valor foi alterado (ou cuja conta de token foi fechada) na transação.

Para desativar a expansão, deixe o campo ausente (None) — não há valor “desativado” no enum. Um inteiro fora do intervalo é rejeitado na configuração: Invalid token_accounts value, expected ALL (0) or BALANCE_CHANGED (1).

ALL é o valor zero. Um cliente que define o enum como 0 esperando “padrão/desativado” obtém ALL — o modo mais amplo e de maior volume. A única maneira de significar “sem expansão” é omitir completamente o campo.

object

Inscreva-se para atualizações de status de transações.

Ocultar propriedades

boolean

Incluir transações de voto.

boolean

Incluir transações que falharam.

string

Monitorar assinatura de transação específica.

array

Incluir apenas transações que afetam essas contas.

array

Excluir transações que afetam essas contas.

array

Transações devem afetar todas essas contas.

object

Inscreva-se para atualizações de blocos.

Ocultar propriedades

array

Incluir apenas blocos com transações que afetam essas contas.

boolean

Incluir detalhes completos da transação.

boolean

Incluir atualizações de contas.

boolean

Incluir entradas de blocos.

object

Inscreva-se para atualizações de metadados de bloco (mais leves que as atualizações de bloco completas).

Ocultar retornos

integer

Número do slot.

string

Blockhash.

array

Informações de recompensas.

integer

Hora do bloco.

integer

Altura do bloco.

integer

Slot pai.

string

Blockhash pai.

integer

Contagem de transações.

integer

Contagem de entradas.

object

Inscreva-se para atualizações de entrada.

Ocultar retornos

integer

Número do slot.

integer

Índice da entrada.

integer

Número de hashes.

string

Hash.

integer

Contagem de transações.

integer

Índice inicial da transação.

enum

O nível de compromisso para a inscrição:

Ocultar níveis

integer

(0): Processado pelo nó atual.

integer

(1): Confirmado por supermaioria do cluster.

integer

(2): Finalizado pelo cluster.

array

Especifica dados parciais da conta a serem recebidos:

Ocultar propriedades

integer

Posição em bytes para começar a ler os dados.

integer

Número de bytes a serem lidos.

object

Habilitar mensagens de ping-pong para monitoramento da integridade da conexão.

Ocultar propriedades

integer

Identificador numérico para o ping.

integer

Slot inicial para receber atualizações. Atualizações para slots anteriores a este valor serão excluídas.

{
  "slots": {
      "slots": {}
  },
  "accounts": {
      "user-defined-label": {
          "account": [
              "DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu",
              "5U3bH5b6XtG99aVCE9ycvDgBKQx3fVT8WwTNbMToFuEr"
          ],
          "owner": [
              "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
          ],
          "filter": {
              "memcmp": {
                  "offset": 0,
                  "bytes": "0102030405"
              },
              "datasize": 165,
              "token_account_state": true,
              "lamports": {
                  "gt": 100000000
              }
          },
          "nonempty_txn_signature": true
      }
  },
  "transactions": {},
  "blocks": {},
  "blocks_meta": {},
  "accounts_data_slice": [],
  "commitment": 1
}

{
  "slots": {
    "incoming_slots": {}
  },
  "commitment": 1
}

{
  "transactions": {
    "vote": false,
    "failed": true,
    "signature": "4RPMxKBhCBubFmZ1r9BC52ztjG3qBTW9Gp1PXfufUSATQaLKTW3Dj6vQBYyVrhfjgJ4PjZLzwYs4Z92KDCPw8Qym",
    "account_include": ["DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu"],
    "account_exclude": ["TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"],
    "account_required": ["11111111111111111111111111111111"]
  },
  "commitment": 2
}

{
  "transactions": {
    "wallet": {
      "vote": false,
      "failed": false,
      "account_include": ["DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu"],
      "account_exclude": [],
      "account_required": [],
      "token_accounts": 1
    }
  },
  "commitment": 1
}

{
  "transactions_status": {
    "vote": false,
    "failed": true,
    "account_include": ["DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu"],
    "account_exclude": ["TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"],
    "account_required": ["11111111111111111111111111111111"]
  },
  "commitment": 2
}

{
  "blocks": {
    "account_include": ["DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu"],
    "include_transactions": 1,
    "include_accounts": 1,
    "include_entries": 0
  },
  "commitment": 2
}

{
  "blocks_meta": {},
  "commitment": 2,
  "from_slot": 139000000
}

{
  "entry": {},
  "commitment": 1
}

{
  "accounts": {
    "account": ["DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu"]
  },
  "accounts_data_slice": [
    {
      "offset": 0,
      "length": 64
    },
    {
      "offset": 128,
      "length": 32
    }
  ],
  "commitment": 2
}

{
  "ping": {
    "id": 1
  }
}

{
  "accounts": {
    "account": ["DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu"],
    "nonempty_txn_signature": true
  },
  "slots": {
    "filter_by_commitment": 1,
    "interslot_updates": 1
  },
  "commitment": 2,
  "from_slot": 139000000,
  "ping": {
    "id": 123
  }
}

Níveis de Compromisso

Todas as inscrições suportam os seguintes níveis de compromisso:

PROCESSED: Processado pelo nó atual (0)
CONFIRMED: Confirmado por supermaioria do cluster (1)
FINALIZED: Finalizado pelo cluster (2)

Estrutura de Resposta

As respostas de inscrição incluem:

filters: Os nomes dos filtros que corresponderam a esta atualização
Um dos seguintes tipos de atualização:
- account: Dados da conta, proprietário, lamports, status executável, etc.
- slot: Informações e atualizações de status de slots
- transaction: Detalhes completos da transação, assinatura e metadados
- transaction_status: Status de execução da transação (sucesso/erro)
- block: Dados completos do bloco com transações, contas, recompensas, etc.
- block_meta: Metadados leves de bloco sem detalhes completos da transação
- entry: Detalhes de entrada dentro de um bloco
- ping/pong: Mensagens de verificação de integridade da conexão
created_at: Timestamp quando a atualização foi criada

{
  "filters": ["accounts"],
  "account": {
    "account": {
      "pubkey": "BASE58_ENCODED_PUBKEY",
      "lamports": 12345678,
      "owner": "BASE58_ENCODED_OWNER",
      "executable": false,
      "rent_epoch": 361,
      "data": "BASE64_ENCODED_DATA",
      "write_version": 123,
      "txn_signature": "BASE58_ENCODED_SIGNATURE"
    },
    "slot": 189554321,
    "is_startup": false
  },
  "created_at": "2023-04-28T12:34:56.789Z"
}

{
  "filters": ["slots"],
  "slot": {
    "slot": 189554321,
    "parent": 189554320,
    "status": 2,
    "dead_error": null
  },
  "created_at": "2023-04-28T12:34:56.789Z"
}

{
  "filters": ["transactions"],
  "transaction": {
    "transaction": {
      "signature": "BASE58_ENCODED_SIGNATURE",
      "is_vote": false,
      "transaction": {
        "signatures": ["BASE58_ENCODED_SIGNATURE"],
        "message": {
          "header": {
            "num_required_signatures": 1,
            "num_readonly_signed_accounts": 0,
            "num_readonly_unsigned_accounts": 1
          },
          "account_keys": ["BASE58_ENCODED_PUBKEY1", "BASE58_ENCODED_PUBKEY2"],
          "recent_blockhash": "BASE58_ENCODED_BLOCKHASH",
          "instructions": [
            {
              "program_id_index": 1,
              "accounts": [0],
              "data": "BASE64_ENCODED_INSTRUCTION_DATA"
            }
          ]
        }
      },
      "meta": {
        "err": null,
        "fee": 5000,
        "pre_balances": [10000000, 1],
        "post_balances": [9995000, 1],
        "pre_token_balances": [],
        "post_token_balances": [],
        "log_messages": ["Program log: Instruction executed"],
        "rewards": []
      },
      "index": 2
    },
    "slot": 189554321
  },
  "created_at": "2023-04-28T12:34:56.789Z"
}

{
  "filters": ["blocks_meta"],
  "block_meta": {
    "slot": 189554321,
    "blockhash": "BASE58_ENCODED_BLOCKHASH",
    "rewards": [
      {
        "pubkey": "BASE58_ENCODED_PUBKEY",
        "lamports": 1785000,
        "post_balance": 48589432109,
        "reward_type": 0,
        "commission": 10
      }
    ],
    "block_time": 1682684096,
    "block_height": 185432109,
    "parent_slot": 189554320,
    "parent_blockhash": "BASE58_ENCODED_PARENT_BLOCKHASH",
    "executed_transaction_count": 2576,
    "entries_count": 16
  },
  "created_at": "2023-04-28T12:34:56.789Z"
}

{
  "filters": ["entry"],
  "entry": {
    "slot": 189554321,
    "index": 5,
    "num_hashes": 8765432,
    "hash": "BASE58_ENCODED_HASH",
    "executed_transaction_count": 128,
    "starting_transaction_index": 1024
  },
  "created_at": "2023-04-28T12:34:56.789Z"
}

{
  "filters": [],
  "pong": {
    "id": 1
  },
  "created_at": "2023-04-28T12:34:56.789Z"
}

API gRPC LaserStream

GetBlockHeight

⌘I

{
  "slots": {
      "slots": {}
  },
  "accounts": {
      "user-defined-label": {
          "account": [
              "DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu",
              "5U3bH5b6XtG99aVCE9ycvDgBKQx3fVT8WwTNbMToFuEr"
          ],
          "owner": [
              "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"
          ],
          "filter": {
              "memcmp": {
                  "offset": 0,
                  "bytes": "0102030405"
              },
              "datasize": 165,
              "token_account_state": true,
              "lamports": {
                  "gt": 100000000
              }
          },
          "nonempty_txn_signature": true
      }
  },
  "transactions": {},
  "blocks": {},
  "blocks_meta": {},
  "accounts_data_slice": [],
  "commitment": 1
}

{
  "slots": {
    "incoming_slots": {}
  },
  "commitment": 1
}

{
  "transactions": {
    "vote": false,
    "failed": true,
    "signature": "4RPMxKBhCBubFmZ1r9BC52ztjG3qBTW9Gp1PXfufUSATQaLKTW3Dj6vQBYyVrhfjgJ4PjZLzwYs4Z92KDCPw8Qym",
    "account_include": ["DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu"],
    "account_exclude": ["TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"],
    "account_required": ["11111111111111111111111111111111"]
  },
  "commitment": 2
}

{
  "transactions": {
    "wallet": {
      "vote": false,
      "failed": false,
      "account_include": ["DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu"],
      "account_exclude": [],
      "account_required": [],
      "token_accounts": 1
    }
  },
  "commitment": 1
}

{
  "transactions_status": {
    "vote": false,
    "failed": true,
    "account_include": ["DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu"],
    "account_exclude": ["TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"],
    "account_required": ["11111111111111111111111111111111"]
  },
  "commitment": 2
}

{
  "blocks": {
    "account_include": ["DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu"],
    "include_transactions": 1,
    "include_accounts": 1,
    "include_entries": 0
  },
  "commitment": 2
}

{
  "blocks_meta": {},
  "commitment": 2,
  "from_slot": 139000000
}

{
  "entry": {},
  "commitment": 1
}

{
  "accounts": {
    "account": ["DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu"]
  },
  "accounts_data_slice": [
    {
      "offset": 0,
      "length": 64
    },
    {
      "offset": 128,
      "length": 32
    }
  ],
  "commitment": 2
}

{
  "ping": {
    "id": 1
  }
}

{
  "accounts": {
    "account": ["DjUF9ASpyMbVpGJmTvzfSbCgUWj6JowwLh8dGAJzSPmu"],
    "nonempty_txn_signature": true
  },
  "slots": {
    "filter_by_commitment": 1,
    "interslot_updates": 1
  },
  "commitment": 2,
  "from_slot": 139000000,
  "ping": {
    "id": 123
  }
}

{
  "filters": ["accounts"],
  "account": {
    "account": {
      "pubkey": "BASE58_ENCODED_PUBKEY",
      "lamports": 12345678,
      "owner": "BASE58_ENCODED_OWNER",
      "executable": false,
      "rent_epoch": 361,
      "data": "BASE64_ENCODED_DATA",
      "write_version": 123,
      "txn_signature": "BASE58_ENCODED_SIGNATURE"
    },
    "slot": 189554321,
    "is_startup": false
  },
  "created_at": "2023-04-28T12:34:56.789Z"
}

{
  "filters": ["slots"],
  "slot": {
    "slot": 189554321,
    "parent": 189554320,
    "status": 2,
    "dead_error": null
  },
  "created_at": "2023-04-28T12:34:56.789Z"
}

{
  "filters": ["transactions"],
  "transaction": {
    "transaction": {
      "signature": "BASE58_ENCODED_SIGNATURE",
      "is_vote": false,
      "transaction": {
        "signatures": ["BASE58_ENCODED_SIGNATURE"],
        "message": {
          "header": {
            "num_required_signatures": 1,
            "num_readonly_signed_accounts": 0,
            "num_readonly_unsigned_accounts": 1
          },
          "account_keys": ["BASE58_ENCODED_PUBKEY1", "BASE58_ENCODED_PUBKEY2"],
          "recent_blockhash": "BASE58_ENCODED_BLOCKHASH",
          "instructions": [
            {
              "program_id_index": 1,
              "accounts": [0],
              "data": "BASE64_ENCODED_INSTRUCTION_DATA"
            }
          ]
        }
      },
      "meta": {
        "err": null,
        "fee": 5000,
        "pre_balances": [10000000, 1],
        "post_balances": [9995000, 1],
        "pre_token_balances": [],
        "post_token_balances": [],
        "log_messages": ["Program log: Instruction executed"],
        "rewards": []
      },
      "index": 2
    },
    "slot": 189554321
  },
  "created_at": "2023-04-28T12:34:56.789Z"
}

{
  "filters": ["blocks_meta"],
  "block_meta": {
    "slot": 189554321,
    "blockhash": "BASE58_ENCODED_BLOCKHASH",
    "rewards": [
      {
        "pubkey": "BASE58_ENCODED_PUBKEY",
        "lamports": 1785000,
        "post_balance": 48589432109,
        "reward_type": 0,
        "commission": 10
      }
    ],
    "block_time": 1682684096,
    "block_height": 185432109,
    "parent_slot": 189554320,
    "parent_blockhash": "BASE58_ENCODED_PARENT_BLOCKHASH",
    "executed_transaction_count": 2576,
    "entries_count": 16
  },
  "created_at": "2023-04-28T12:34:56.789Z"
}

{
  "filters": ["entry"],
  "entry": {
    "slot": 189554321,
    "index": 5,
    "num_hashes": 8765432,
    "hash": "BASE58_ENCODED_HASH",
    "executed_transaction_count": 128,
    "starting_transaction_index": 1024
  },
  "created_at": "2023-04-28T12:34:56.789Z"
}

{
  "filters": [],
  "pong": {
    "id": 1
  },
  "created_at": "2023-04-28T12:34:56.789Z"
}

Referência de API

Solana RPC APIs

Solana APIs

APIs de Transmissão de Dados

APIs de Escuta de Eventos

APIs de Gerenciamento de Contas

Autorizações

Mensagem

Níveis de Compromisso

Estrutura de Resposta

​Autorizações

​Mensagem

​Níveis de Compromisso

​Estrutura de Resposta

Autorizações

Mensagem

Níveis de Compromisso

Estrutura de Resposta