signatureSubscribe Método Solana WebSocket

Esta é uma assinatura para uma única notificação. Ela é cancelada automaticamente pelo servidor assim que a notificação, signatureNotification, é enviada pelo RPC.

Endpoints

Websockets estão disponíveis na mainnet e devnet com as seguintes URLs:

Mainnet wss://mainnet.helius-rpc.com/?api-key=<api-key>
Devnet wss://devnet.helius-rpc.com/?api-key=<api-key>

Os websockets têm um temporizador de inatividade de 10 minutos; implementar verificações de integridade e enviar pings a cada minuto é altamente recomendado para manter a conexão websocket ativa.

Autorizações

string

obrigatório

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

Corpo

array

obrigatório

Ocultar properties

string

obrigatório

Assinatura da transação, como string codificada em base-58.A assinatura da transação deve ser a primeira assinatura da transação (veja o ID da transação para mais detalhes).

object

Objeto de configuração contendo os seguintes campos:

string

O nível de comprometimento para a assinatura. Pode ser finalized, confirmed, ou processed.

boolean

Se deve enviar uma notificação quando a assinatura da transação for recebida.

Resposta

integer

ID de assinatura (necessário para cancelar a assinatura)

Formato de Notificação

A notificação será um objeto JSON RpcResponse com valor contendo um objeto com:

slot: <u64> - O slot correspondente.
value: <object|string> - um valor de notificação de RpcSignatureResult, resultando em:
- quando enableReceivedNotification é true e a assinatura é recebida: a string literal "receivedSignature", ou
- quando a assinatura é processada: err: <object|null>:
  - null se a transação foi processada com sucesso no nível de comprometimento especificado, ou
  - um TransactionError, se a transação falhou

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "signatureSubscribe",
  "params": [
    "2EBVM6cB8vAAD93Ktr6Vd8p67XPbQzCJX47MpReuiCXJAtcjaxpvWpcg9Ege1Nr5Tk3a2GFrByT7WPBjdsTycY9b",
    {
      "commitment": "finalized",
      "enableReceivedNotification": false
    }
  ]
}

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

{
  "jsonrpc": "2.0",
  "method": "signatureNotification",
  "params": {
    "result": {
      "context": {
        "slot": 5207624
      },
      "value": {
        "err": null
      }
    },
    "subscription": 24006
  }
}

{
  "jsonrpc": "2.0",
  "method": "signatureNotification",
  "params": {
    "result": {
      "context": {
        "slot": 5207624
      },
      "value": "receivedSignature"
    },
    "subscription": 24006
  }
}

rootUnsubscribe

signatureUnsubscribe

⌘I

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "signatureSubscribe",
  "params": [
    "2EBVM6cB8vAAD93Ktr6Vd8p67XPbQzCJX47MpReuiCXJAtcjaxpvWpcg9Ege1Nr5Tk3a2GFrByT7WPBjdsTycY9b",
    {
      "commitment": "finalized",
      "enableReceivedNotification": false
    }
  ]
}

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

{
  "jsonrpc": "2.0",
  "method": "signatureNotification",
  "params": {
    "result": {
      "context": {
        "slot": 5207624
      },
      "value": {
        "err": null
      }
    },
    "subscription": 24006
  }
}

{
  "jsonrpc": "2.0",
  "method": "signatureNotification",
  "params": {
    "result": {
      "context": {
        "slot": 5207624
      },
      "value": "receivedSignature"
    },
    "subscription": 24006
  }
}

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

signatureSubscribe

Endpoints

Autorizações

Corpo

Resposta

Formato de Notificação

​Endpoints

​Autorizações

​Corpo

​Resposta

​Formato de Notificação

Endpoints

Autorizações

Corpo

Resposta

Formato de Notificação