Instructions

​

addInstruction(options)

{
  // data requests
  where?: {
    programId?: string[]

    d1?: string[]
    d2?: string[]
    d3?: string[]
    d4?: string[]
    d8?: string[]
    discriminator?: string[]

    a0?: string[]
    a1?: string[]
    a2?: string[]
    a3?: string[]
    a4?: string[]
    a5?: string[]
    a6?: string[]
    a7?: string[]
    a8?: string[]
    a9?: string[]

    isCommitted?: boolean
  }

  // related data retrieval
  include?: {
    transaction?: boolean
    transactionBalances?: boolean
    transactionTokenBalances?: boolean
    transactionInstructions?: boolean
    logs?: boolean
    innerInstructions?: boolean
  }

  range?: {
    from: number
    to?: number
  }
}

• programId: the set of program addresses to track. Leave undefined to subscribe to instructions data of all programs from the whole network.
• d1 through d8: sets of 1, 2, 3, 4 and 8-byte instruction discriminators, correspondingly. Discriminators are 0x-prefixed hexadecimal prefixes of instruction data; each dN filter requires exactly that many bytes.
• discriminator: a set of instruction data prefixes of any length, 0x-prefixed hexadecimal.
• a0 through a9: sets of base58-encoded account inputs to the instruction, at positions 0-9 correspondingly.
• isCommitted: true to request only instructions that did not revert.

• transaction = true: retrieve the transaction that gave rise to instruction
• transactionBalances = true: retrieve all SOL balance records of the parent transaction
• transactionTokenBalances = true: retrieve all token balance records of the parent transaction
• transactionInstructions = true: retrieve all instructions executed by the parent transaction
• logs = true: retrieve all logs emitted due to the instruction
• innerInstructions = true: retrieve the data for all instruction calls due to the matching instruction