signatureSubscribe RPC-metodi

Tilaa ilmoitus, kun annetulla allekirjoituksella varustettu transaktio saavuttaa määritetyn sitoutumistason.

Tämä on tilaus yksittäiseen ilmoitukseen. Palvelin peruuttaa sen automaattisesti heti kun ilmoitus, signatureNotification, on lähetetty RPC:n toimesta.

params

stringrequired

transaktion allekirjoitus, base-58-koodattuna merkkijonona

Transaktion allekirjoituksen on oltava transaktion ensimmäinen allekirjoitus (katso lisätietoja transaktion tunniste).

objectoptional

Määrittelyobjekti, joka sisältää seuraavat kentät:

result

integer

tilauksen tunnus (tarvitaan tilauksen peruuttamiseen)

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

transaktion allekirjoitus, base-58-koodattuna merkkijonona

Transaktion allekirjoituksen on oltava transaktion ensimmäinen allekirjoitus (katso lisätietoja transaktion tunniste).

objectoptional

Määrittelyobjekti, joka sisältää seuraavat kentät:

result

Response

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

integer

tilauksen tunnus (tarvitaan tilauksen peruuttamiseen)

Ilmoitusmuoto:

Ilmoitus on RpcResponse JSON-objekti, jonka arvo sisältää objektin, jossa on:

slot: <u64> - Vastaava slot.
value: <object|string> - ilmoituksen arvo RpcSignatureResult, joka johtaa joko:
- kun enableReceivedNotification on true ja allekirjoitus vastaanotetaan: kirjaimellinen merkkijono "receivedSignature", tai
- kun allekirjoitus on käsitelty: err: <object|null>:
  - null jos transaktio onnistui käsittelyssä määritellyllä sitoutumistasolla, tai
  - TransactionError, jos transaktio epäonnistui

Esimerkkivastauksia:

Seuraava on esimerkki ilmoituksesta onnistuneesti käsitellystä transaktiosta:

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

Seuraava on esimerkki ilmoituksesta onnistuneesti vastaanotetusta transaktion allekirjoituksesta:

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