programSubscribe

订阅一个程序，以便在由给定程序拥有的账户的 lamports 或数据发生变化时接收通知。

​

端点

主网和 devnet 上可用的 Websockets URL 如下：

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

Websockets 有一个 10 分钟的不活动计时器；强烈建议实施健康检查并每分钟发送 ping 以保持 websocket 连接活跃。

​

授权

api-key · string · 必填

您的 Helius API 密钥。您可以在仪表板中免费获取一个。

​

请求体

params · array · 必填

隐藏 properties

programId · string · 必填

以 base-58 编码字符串表示的 program_id 的公钥。

config · object

包含以下字段的配置对象：

commitment · string

订阅的承诺级别。可以是 finalized，confirmed，或 processed。

filters · array

要应用的过滤器对象数组。

encoding · string

帐户数据的编码格式。可以是 base58，base64，base64+zstd，或 jsonParsed。

• base58 较慢
• jsonParsed 编码尝试使用程序特定的状态解析器返回更具可读性和更明确的帐户状态数据
• 如果请求 jsonParsed 但找不到解析器，则字段将回退到二进制编码，可以通过数据字段为字符串类型检测到。

​

响应

result · integer

订阅 ID（需要取消订阅）

​

通知格式

通知格式是一个 单一 的程序帐户对象，如 getProgramAccounts RPC HTTP 方法所示。

Request

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

Response

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