Método RPC signatureSubscribe

Inscreva-se para receber uma notificação quando a transação com a assinatura fornecida atingir o nível de confirmação especificado.

Esta é uma inscrição para uma única notificação. É automaticamente cancelada pelo servidor assim que a notificação, signatureNotification, é enviada pelo RPC.

params

stringrequired

assinatura da transação, como string codificada em base-58

A assinatura da transação deve ser a primeira assinatura da transação (veja id da transação para mais detalhes).

objectoptional

Objeto de configuração contendo os seguintes campos:

result

integer

id de inscrição (necessário para cancelar a inscrição)

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

assinatura da transação, como string codificada em base-58

A assinatura da transação deve ser a primeira assinatura da transação (veja id da transação para mais detalhes).

objectoptional

Objeto de configuração contendo os seguintes campos:

result

Response

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

integer

id de inscrição (necessário para cancelar a inscrição)

Formato de notificação:

A notificação será um objeto JSON RpcResponse com valor contendo um objeto com:

slot: <u64> - O slot correspondente.
value: <object|string> - um valor de notificação de RpcSignatureResult, resultando em:
- quando enableReceivedNotification é true e a assinatura é recebida: a string literal "receivedSignature", ou
- quando a assinatura é processada: err: <object|null>:
  - null se a transação foi processada com sucesso no nível de confirmação especificado, ou
  - um TransactionError, se a transação falhou

Exemplos de respostas:

A seguir está um exemplo de resposta de uma notificação de uma transação processada com sucesso:

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

A seguir está um exemplo de resposta de uma notificação de uma assinatura de transação recebida com sucesso:

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