signatureSubscribe

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "signatureSubscribe",
  "params": [
    "Q7Q8rMSn9PAdJfwRPwEBrijt7bNqrD1cRqkBd8fjYnXidJUoKz5wSRY2y1emZhw3KwM44A5QSM2k6GsaXCYugez",
    {
      "commitment": "finalized"
    }
  ]
}

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

{
  "jsonrpc": "2.0",
  "method": "signatureNotification",
  "params": {
    "result": {
      "context": {
        "slot": 439749496
      },
      "value": {
        "err": {
          "InstructionError": [
            2,
            {
              "Custom": 103
            }
          ]
        }
      }
    },
    "subscription": 3081
  }
}

Subscribe to receive a notification when the transaction with the given signature reaches the specified commitment level.

On ThorNode

Send over the complete wss:// URL copied from the dashboard. Each active subscription counts toward the per-token cap; over the cap the request is answered with -32005 subscription limit exceeded and not forwarded. Frames pass through unchanged. The subscription closes itself after the notification, so a later signatureUnsubscribe for the same id returns -32602 Invalid subscription id.

Parameters

array

required

Hide properties

string

required

Transaction signature, as base-58 encoded string.The transaction signature must be the first signature from the transaction (see transaction id for more details).

object

Configuration object containing the following fields:

string

The commitment level for the subscription. Can be finalized, confirmed, or processed.

boolean

Whether to send a notification when the transaction signature is received.

Notification format

The notification will be an RpcResponse JSON object with value containing an object with:

slot: <u64> - The corresponding slot.
value: <object|string> - a notification value of RpcSignatureResult, resulting in either:
- when enableReceivedNotification is true and the signature is received: the literal string "receivedSignature", or
- when the signature is processed: err: <object|null>:
  - null if the transaction succeeded in being processed at the specified commitment level, or
  - a TransactionError, if the transaction failed

Response

integer

Subscription id (needed to unsubscribe)

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "signatureSubscribe",
  "params": [
    "Q7Q8rMSn9PAdJfwRPwEBrijt7bNqrD1cRqkBd8fjYnXidJUoKz5wSRY2y1emZhw3KwM44A5QSM2k6GsaXCYugez",
    {
      "commitment": "finalized"
    }
  ]
}

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

{
  "jsonrpc": "2.0",
  "method": "signatureNotification",
  "params": {
    "result": {
      "context": {
        "slot": 439749496
      },
      "value": {
        "err": {
          "InstructionError": [
            2,
            {
              "Custom": 103
            }
          ]
        }
      }
    },
    "subscription": 3081
  }
}

API reference

ThorEdge RPC

FastGate RPC

Yellowstone gRPC

Bifrost

Hofund

On ThorNode

Parameters

Notification format

Response

​On ThorNode

​Parameters

​Notification format

​Response

On ThorNode

Parameters

Notification format

Response