signatureSubscribe RPC-Methode

Abonnieren Sie, um eine Benachrichtigung zu erhalten, wenn die Transaktion mit der angegebenen Signatur die festgelegte Commitment-Stufe erreicht.

Dies ist ein Abonnement für eine einzelne Benachrichtigung. Es wird automatisch vom Server gekündigt, sobald die Benachrichtigung, signatureNotification, vom RPC gesendet wird.

params

stringrequired

Transaktionssignatur als Base-58-kodierte Zeichenfolge

Die Transaktionssignatur muss die erste Signatur der Transaktion sein (siehe Transaktions-ID für weitere Details).

objectoptional

Konfigurationsobjekt mit den folgenden Feldern:

result

integer

Abonnement-ID (wird zum Abbestellen benötigt)

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

Transaktionssignatur als Base-58-kodierte Zeichenfolge

Die Transaktionssignatur muss die erste Signatur der Transaktion sein (siehe Transaktions-ID für weitere Details).

objectoptional

Konfigurationsobjekt mit den folgenden Feldern:

result

Response

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

integer

Abonnement-ID (wird zum Abbestellen benötigt)

Benachrichtigungsformat:

Die Benachrichtigung wird ein RpcResponse JSON-Objekt sein, dessen Wert ein Objekt mit folgenden Elementen enthält:

slot: <u64> - Der entsprechende slot.
value: <object|string> - ein Benachrichtigungswert von RpcSignatureResult, was zu einem der folgenden Ergebnisse führt:
- wenn enableReceivedNotification auf true gesetzt ist und die Signatur empfangen wird: der wörtliche String "receivedSignature", oder
- wenn die Signatur verarbeitet wird: err: <object|null>:
  - null wenn die Transaktion erfolgreich auf der angegebenen Commitment-Ebene verarbeitet wurde, oder
  - ein TransactionError, wenn die Transaktion fehlgeschlagen ist

Beispielantworten:

Das Folgende ist ein Beispiel für eine Benachrichtigung von einer erfolgreich verarbeiteten Transaktion:

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

Das Folgende ist ein Beispiel für eine Benachrichtigung von einer erfolgreich empfangenen Transaktionssignatur:

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