programSubscribe

Subscribe to notifications for accounts owned by a given program.

Source

program_subscribe

params

stringrequired

Pubkey of the program_id, as base-58 encoded string

objectoptional

Optional configuration object.

result

integer

Subscription id. Pass this to programUnsubscribe.

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

Response

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

{
  "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

Optional configuration object.

result

Response

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

integer

Subscription id. Pass this to programUnsubscribe.

Notification format

Notifications are delivered as programNotification.

{
  "jsonrpc": "2.0",
  "method": "programNotification",
  "params": {
    "result": {
      "context": {
        "slot": 583
      },
      "value": {
        "pubkey": "BpdYYo2Vw1NVbzE2DqJxCX2xEfr42xvMYFU2dKd1CW57",
        "account": {
          "lamports": 499997095000,
          "data": ["", "base64"],
          "owner": "11111111111111111111111111111111",
          "executable": false,
          "rentEpoch": 18446744073709551615,
          "space": 0
        }
      }
    },
    "subscription": 11
  }
}

jsonrpc

string

Always "2.0".

method

string

Always "programNotification".

params

object

Notification wrapper with a single matching account and the subscription id.