RPC-метод signatureSubscribe

Підпишіться, щоб отримувати сповіщення, коли транзакція з вказаним підписом досягне визначеного рівня підтвердження.

Це підписка на одне сповіщення. Вона автоматично скасовується сервером після того, як сповіщення, signatureNotification, надсилається RPC.

params

stringrequired

підпис транзакції, як рядок у кодуванні base-58

Підпис транзакції повинен бути першим підписом з транзакції (див. ідентифікатор транзакції для отримання додаткової інформації).

objectoptional

Об'єкт конфігурації, що містить такі поля:

result

integer

ідентифікатор підписки (потрібен для скасування підписки)

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "signatureSubscribe",
  "params": [
    "2EBVM6cB8vAAD93Ktr6Vd8p67XPbQzCJX47MpReuiCXJAtcjaxpvWpcg9Ege1Nr5Tk3a2GFrByT7WPBjdsTycY9b",
    {
      "commitment": "finalized",
      "enableReceivedNotification": false
    }
  ]
}

Response

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

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "signatureSubscribe",
  "params": [
    "2EBVM6cB8vAAD93Ktr6Vd8p67XPbQzCJX47MpReuiCXJAtcjaxpvWpcg9Ege1Nr5Tk3a2GFrByT7WPBjdsTycY9b",
    {
      "commitment": "finalized",
      "enableReceivedNotification": false
    }
  ]
}

params

stringrequired

підпис транзакції, як рядок у кодуванні base-58

objectoptional

Об'єкт конфігурації, що містить такі поля:

result

Response

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

integer

ідентифікатор підписки (потрібен для скасування підписки)

Формат сповіщення:

Сповіщення буде об'єктом RpcResponse JSON, значення якого містить об'єкт з:

slot: <u64> - Відповідний slot.
value: <object|string> - значення сповіщення RpcSignatureResult, що призводить до одного з варіантів:
- коли enableReceivedNotification є true і підпис отримано: буквальний рядок "receivedSignature", або
- коли підпис оброблено: err: <object|null>:
  - null якщо транзакція успішно оброблена на вказаному рівні підтвердження, або
  - TransactionError, якщо транзакція не вдалася

Приклади відповідей:

Нижче наведено приклад відповіді сповіщення від успішно обробленої транзакції:

{
  "jsonrpc": "2.0",
  "method": "signatureNotification",
  "params": {
    "result": {
      "context": {
        "slot": 5207624
      },
      "value": {
        "err": null
      }
    },
    "subscription": 24006
  }
}

Нижче наведено приклад відповіді сповіщення від успішно отриманого підпису транзакції:

{
  "jsonrpc": "2.0",
  "method": "signatureNotification",
  "params": {
    "result": {
      "context": {
        "slot": 5207624
      },
      "value": "receivedSignature"
    },
    "subscription": 24006
  }
}