programSubscribe

Subscribe to program-owned account changes on the Solana route (Beta).

Available under Solana WebSocket API (Beta). Use the chain-family pages for handle discovery and this page for exact subscription semantics.

Stage: Beta

Access

Surfaces: raw_rpc_ws
Metering: raw_rpc_ws_target_minute
Scope: Solana program subscription

Handles

Surface	Label	Value
`raw_rpc_ws`	Endpoint	`wss://gw-aql.tomo.services/rpc/solana/wss`
`raw_rpc_ws`	Auth header	`Bearer <api_key>`
`raw_rpc_ws`	Subscribe method	`programSubscribe`
`raw_rpc_ws`	Notification method	`programNotification`

Use `programSubscribe` when the runtime needs updates for accounts owned by one program with the current reviewed filter shape.

This beta example uses `/rpc/solana/wss` and the reviewed `programSubscribe` request shape.

Examples

Connect with wscat


wscat -c "wss://gw-aql.tomo.services/rpc/solana/wss" \  -H "Authorization: Bearer <api_key>"> {>   "jsonrpc": "2.0",>   "id": 1,>   "method": "programSubscribe",>   "params": [>     "11111111111111111111111111111111",>     {>       "encoding": "base64">     }>   ]> }

Request fields

Subscription request

Field	Type	Required	Notes
`jsonrpc`	`string`	Required	JSON-RPC version. Use `2.0`.
`id`	`string \| number`	Required	Caller request id.
`method`	`string`	Required	Allowlisted subscription method.
`params`	`array`	Required	Subscription topic or filter arguments.

Response fields

Subscribe result

Field	Type	Notes
`jsonrpc`	`string`	JSON-RPC version.
`id`	`string \| number`	Echoed caller request id.
`result`	`string \| number`	Subscription id returned by the hosted route.

Notification shape

Field	Type	Notes
`method`	`string`	Notification method such as `eth_subscription` or `slotNotification`.
`params.subscription`	`string \| number`	Subscription id tied to the current stream.
`params.result`	`object`	Upstream chain payload for the current notification.