Metoda RPC signatureSubscribe

Subskrybuj, aby otrzymać powiadomienie, gdy transakcja o podanym podpisie osiągnie określony poziom zaangażowania.

Jest to subskrypcja pojedynczego powiadomienia. Jest ona automatycznie anulowana przez serwer po wysłaniu powiadomienia, signatureNotification, przez RPC.

params

stringrequired

podpis transakcji jako ciąg zakodowany w base-58

Podpis transakcji musi być pierwszym podpisem z transakcji (zobacz id transakcji po więcej szczegółów).

objectoptional

Obiekt konfiguracji zawierający następujące pola:

result

integer

id subskrypcji (potrzebne do anulowania subskrypcji)

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

podpis transakcji jako ciąg zakodowany w base-58

Podpis transakcji musi być pierwszym podpisem z transakcji (zobacz id transakcji po więcej szczegółów).

objectoptional

Obiekt konfiguracji zawierający następujące pola:

result

Response

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

integer

id subskrypcji (potrzebne do anulowania subskrypcji)

Format powiadomienia:

Powiadomienie będzie obiektem JSON typu RpcResponse, którego wartość zawiera obiekt z:

slot: <u64> - odpowiadającym slotem.
value: <object|string> - wartością powiadomienia RpcSignatureResult, co skutkuje jednym z dwóch przypadków:
- gdy enableReceivedNotification jest true i podpis został odebrany: dosłownym ciągiem znaków "receivedSignature", lub
- gdy podpis został przetworzony: err: <object|null>:
  - null jeśli transakcja została pomyślnie przetworzona na określonym poziomie zaangażowania, lub
  - TransactionError, jeśli transakcja zakończyła się niepowodzeniem.

Przykładowe odpowiedzi:

Poniżej znajduje się przykładowa odpowiedź powiadomienia dla pomyślnie przetworzonych transakcji:

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

Poniżej znajduje się przykładowa odpowiedź powiadomienia dla pomyślnie odebranego podpisu transakcji:

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