Metodo RPC signatureSubscribe

Sottoscrivi per ricevere una notifica quando la transazione con la firma specificata raggiunge il livello di conferma indicato.

Questa è una sottoscrizione a una singola notifica. Viene automaticamente annullata dal server una volta che la notifica, signatureNotification, viene inviata dal RPC.

params

stringrequired

firma della transazione, come stringa codificata in base-58

La firma della transazione deve essere la prima firma della transazione (vedi id transazione per maggiori dettagli).

objectoptional

Oggetto di configurazione contenente i seguenti campi:

result

integer

id di sottoscrizione (necessario per annullare la sottoscrizione)

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

firma della transazione, come stringa codificata in base-58

La firma della transazione deve essere la prima firma della transazione (vedi id transazione per maggiori dettagli).

objectoptional

Oggetto di configurazione contenente i seguenti campi:

result

Response

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

integer

id di sottoscrizione (necessario per annullare la sottoscrizione)

Formato della notifica:

La notifica sarà un oggetto JSON RpcResponse con un valore contenente un oggetto con:

slot: <u64> - Lo slot corrispondente.
value: <object|string> - un valore di notifica di RpcSignatureResult, che risulta in:
- quando enableReceivedNotification è true e la firma viene ricevuta: la stringa letterale "receivedSignature", oppure
- quando la firma viene elaborata: err: <object|null>:
  - null se la transazione è stata elaborata con successo al livello di commitment specificato, oppure
  - un TransactionError, se la transazione è fallita

Esempi di risposte:

Di seguito è riportato un esempio di risposta di una notifica da una transazione elaborata con successo:

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

Di seguito è riportato un esempio di risposta di una notifica da una firma di transazione ricevuta con successo:

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