signatureSubscribe RPC-methode

Abonneer je om een melding te ontvangen wanneer de transactie met de gegeven handtekening het gespecificeerde commitment-niveau bereikt.

Dit is een abonnement op een enkele melding. Het wordt automatisch geannuleerd door de server zodra de melding, signatureNotification, door de RPC wordt verzonden.

params

stringrequired

transactiehandtekening, als base-58 gecodeerde string

De transactiehandtekening moet de eerste handtekening van de transactie zijn (zie transactie-id voor meer details).

objectoptional

Configuratieobject met de volgende velden:

result

integer

abonnement-id (nodig om je af te melden)

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

transactiehandtekening, als base-58 gecodeerde string

De transactiehandtekening moet de eerste handtekening van de transactie zijn (zie transactie-id voor meer details).

objectoptional

Configuratieobject met de volgende velden:

result

Response

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

integer

abonnement-id (nodig om je af te melden)

Notificatieformaat:

De notificatie zal een RpcResponse JSON-object zijn met een waarde die een object bevat met:

slot: <u64> - De bijbehorende slot.
value: <object|string> - een notificatiewaarde van RpcSignatureResult, wat resulteert in ofwel:
- wanneer enableReceivedNotification is true en de handtekening is ontvangen: de letterlijke string "receivedSignature", of
- wanneer de handtekening is verwerkt: err: <object|null>:
  - null als de transactie succesvol is verwerkt op het gespecificeerde commitment-niveau, of
  - een TransactionError, als de transactie is mislukt

Voorbeeldreacties:

Het volgende is een voorbeeldreactie van een notificatie van een succesvol verwerkte transactie:

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

Het volgende is een voorbeeldreactie van een notificatie van een succesvol ontvangen transactiehandtekening:

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