programSubscribe Solana WebSocket Method

Endpoints

Websockets estão disponíveis no 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 possuem um temporizador de inatividade de 10 minutos; a implementação de verificações de integridade e envio de pings a cada minuto é altamente recomendada para manter a conexão websocket ativa.

Autorizações

string

obrigatório

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

Corpo

array

obrigatório

Ocultar properties

string

obrigatório

Pubkey do program_id, como string codificada em base-58.

object

Objeto de configuração contendo os seguintes campos:

string

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

array

Array de objetos de filtro a serem aplicados.

string

Formato de codificação para dados de conta. Pode ser base58, base64, base64+zstd ou jsonParsed.

base58 é lento
jsonParsed tenta usar analisadores de estado específicos do programa para retornar dados de estado de conta mais legíveis e explícitos
Se jsonParsed for solicitado mas um analisador não puder ser encontrado, o campo retorna para a codificação binária, detectável quando o campo de dados é do tipo string.

Resposta

integer

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

Formato de Notificação

O formato de notificação é um objeto de conta de programa único como visto no método RPC HTTP getProgramAccounts.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "programSubscribe",
  "params": [
    "11111111111111111111111111111111",
    {
      "encoding": "base64",
      "filters": [{ "dataSize": 80 }]
    }
  ]
}

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

{
  "jsonrpc": "2.0",
  "method": "programNotification",
  "params": {
    "result": {
      "context": {
        "slot": 5208469
      },
      "value": {
        "pubkey": "H4vnBqifaSACnKa7acsxstsY1iV1bvJNxsCY7enrd1hq",
        "account": {
          "data": [
            "11116bv5nS2h3y12kD1yUKeMZvGcKLSjQgX6BeV7u1FrjeJcKfsHPXHRDEHrBesJhZyqnnq9qJeUuF7WHxiuLuL5twc38w2TXNLxnDbjmuR",
            "base58"
          ],
          "executable": false,
          "lamports": 33594,
          "owner": "11111111111111111111111111111111",
          "rentEpoch": 636,
          "space": 80
        }
      }
    },
    "subscription": 24040
  }
}

{
  "jsonrpc": "2.0",
  "method": "programNotification",
  "params": {
    "result": {
      "context": {
        "slot": 5208469
      },
      "value": {
        "pubkey": "H4vnBqifaSACnKa7acsxstsY1iV1bvJNxsCY7enrd1hq",
        "account": {
          "data": {
            "program": "nonce",
            "parsed": {
              "type": "initialized",
              "info": {
                "authority": "Bbqg1M4YVVfbhEzwA9SpC9FhsaG83YMTYoR4a8oTDLX",
                "blockhash": "LUaQTmM7WbMRiATdMMHaRGakPtCkc2GHtH57STKXs6k",
                "feeCalculator": {
                  "lamportsPerSignature": 5000
                }
              }
            }
          },
          "executable": false,
          "lamports": 33594,
          "owner": "11111111111111111111111111111111",
          "rentEpoch": 636,
          "space": 80
        }
      }
    },
    "subscription": 24040
  }
}

logsUnsubscribe

programUnsubscribe

⌘I

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "programSubscribe",
  "params": [
    "11111111111111111111111111111111",
    {
      "encoding": "base64",
      "filters": [{ "dataSize": 80 }]
    }
  ]
}

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

{
  "jsonrpc": "2.0",
  "method": "programNotification",
  "params": {
    "result": {
      "context": {
        "slot": 5208469
      },
      "value": {
        "pubkey": "H4vnBqifaSACnKa7acsxstsY1iV1bvJNxsCY7enrd1hq",
        "account": {
          "data": [
            "11116bv5nS2h3y12kD1yUKeMZvGcKLSjQgX6BeV7u1FrjeJcKfsHPXHRDEHrBesJhZyqnnq9qJeUuF7WHxiuLuL5twc38w2TXNLxnDbjmuR",
            "base58"
          ],
          "executable": false,
          "lamports": 33594,
          "owner": "11111111111111111111111111111111",
          "rentEpoch": 636,
          "space": 80
        }
      }
    },
    "subscription": 24040
  }
}

{
  "jsonrpc": "2.0",
  "method": "programNotification",
  "params": {
    "result": {
      "context": {
        "slot": 5208469
      },
      "value": {
        "pubkey": "H4vnBqifaSACnKa7acsxstsY1iV1bvJNxsCY7enrd1hq",
        "account": {
          "data": {
            "program": "nonce",
            "parsed": {
              "type": "initialized",
              "info": {
                "authority": "Bbqg1M4YVVfbhEzwA9SpC9FhsaG83YMTYoR4a8oTDLX",
                "blockhash": "LUaQTmM7WbMRiATdMMHaRGakPtCkc2GHtH57STKXs6k",
                "feeCalculator": {
                  "lamportsPerSignature": 5000
                }
              }
            }
          },
          "executable": false,
          "lamports": 33594,
          "owner": "11111111111111111111111111111111",
          "rentEpoch": 636,
          "space": 80
        }
      }
    },
    "subscription": 24040
  }
}

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

programSubscribe

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