端点
主网和 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 连接活跃。
授权
请求体
array
必填
隐藏 properties
隐藏 properties
string
必填
以 base-58 编码字符串表示的
program_id 的公钥。object
包含以下字段的配置对象:
string
订阅的承诺级别。可以是
finalized、confirmed 或 processed。array
要应用的过滤器对象数组。
string
账户数据的编码格式。可以是
base58、base64、base64+zstd 或 jsonParsed。base58较慢jsonParsed编码尝试使用特定于程序的状态解析器来返回更具可读性和明确性的账户状态数据- 如果请求了
jsonParsed但找不到解析器,字段会回退到二进制编码,当数据字段是字符串类型时可检测。
string
Helius 专用扩展。可以是
lock(默认)或 write。lock对每个匹配账户发送通知,即使事务从未写入该账户write仅在事务实际写入账户时发送通知,减少繁忙账户的重复无操作更新。写入相同数据仍计为写入并发送- 未识别的值回退到
lock
响应
integer
订阅ID(取消订阅时需要)
通知格式
通知格式是一个 单一 的程序账户对象,如getProgramAccounts RPC HTTP 方法中所见。
{
"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
}
}