programSubscribe RPC Method
Subscribe to a program to receive notifications when the lamports or data for an account owned by the given program changes
params
stringrequired
Pubkey of the program_id
, as base-58 encoded string
objectoptional
Configuration object containing the following fields:
result
integer
Subscription id (needed to unsubscribe)
Request
{"jsonrpc": "2.0","id": 1,"method": "programSubscribe","params": ["11111111111111111111111111111111",{"encoding": "base64","filters": [{ "dataSize": 80 }]}]}
Response
{"jsonrpc": "2.0","result": 24040,"id": 1}
Request
{"jsonrpc": "2.0","id": 1,"method": "programSubscribe","params": ["11111111111111111111111111111111",{"encoding": "base64","filters": [{ "dataSize": 80 }]}]}
params
stringrequired
Pubkey of the program_id
, as base-58 encoded string
objectoptional
Configuration object containing the following fields:
result
Response
{"jsonrpc": "2.0","result": 24040,"id": 1}
integer
Subscription id (needed to unsubscribe)
Notification format
The notification format is a single program account object as seen in the getProgramAccounts RPC HTTP method.
Base58 encoding:
{"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}}
Parsed-JSON encoding:
{"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}}
Is this page helpful?