Método RPC signatureSubscribe

Suscríbete para recibir una notificación cuando la transacción con la firma dada alcance el nivel de compromiso especificado.

Esta es una suscripción a una sola notificación. Es cancelada automáticamente por el servidor una vez que la notificación, signatureNotification, es enviada por el RPC.

params

stringrequired

firma de transacción, como cadena codificada en base-58

La firma de la transacción debe ser la primera firma de la transacción (consulta id de transacción para más detalles).

objectoptional

Objeto de configuración que contiene los siguientes campos:

result

integer

id de suscripción (necesario para cancelar la suscripción)

{
  "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 de transacción, como cadena codificada en base-58

La firma de la transacción debe ser la primera firma de la transacción (consulta id de transacción para más detalles).

objectoptional

Objeto de configuración que contiene los siguientes campos:

result

Response

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

integer

id de suscripción (necesario para cancelar la suscripción)

Formato de notificación:

La notificación será un objeto JSON RpcResponse con un valor que contiene un objeto con:

slot: <u64> - El slot correspondiente.
value: <object|string> - un valor de notificación de RpcSignatureResult, resultando en:
- cuando enableReceivedNotification es true y la firma es recibida: la cadena literal "receivedSignature", o
- cuando la firma es procesada: err: <object|null>:
  - null si la transacción se procesó correctamente en el nivel de compromiso especificado, o
  - un TransactionError, si la transacción falló

Ejemplos de respuestas:

El siguiente es un ejemplo de respuesta de una notificación de una transacción procesada con éxito:

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

El siguiente es un ejemplo de respuesta de una notificación de una firma de transacción recibida con éxito:

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