Metode RPC signatureSubscribe

Berlangganan untuk menerima notifikasi ketika transaksi dengan tanda tangan yang diberikan mencapai tingkat komitmen yang ditentukan.

Ini adalah langganan untuk satu notifikasi. Langganan ini secara otomatis dibatalkan oleh server setelah notifikasi, signatureNotification, dikirim oleh RPC.

params

stringrequired

tanda tangan transaksi, sebagai string yang dikodekan base-58

Tanda tangan transaksi harus merupakan tanda tangan pertama dari transaksi (lihat id transaksi untuk detail lebih lanjut).

objectoptional

Objek konfigurasi yang berisi bidang-bidang berikut:

result

integer

id langganan (diperlukan untuk berhenti berlangganan)

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

tanda tangan transaksi, sebagai string yang dikodekan base-58

Tanda tangan transaksi harus merupakan tanda tangan pertama dari transaksi (lihat id transaksi untuk detail lebih lanjut).

objectoptional

Objek konfigurasi yang berisi bidang-bidang berikut:

result

Response

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

integer

id langganan (diperlukan untuk berhenti berlangganan)

Format Notifikasi:

Notifikasi akan berupa objek JSON RpcResponse dengan nilai yang berisi objek dengan:

slot: <u64> - Slot yang sesuai.
value: <object|string> - nilai notifikasi dari RpcSignatureResult, yang menghasilkan salah satu dari:
- ketika enableReceivedNotification adalah true dan tanda tangan diterima: string literal "receivedSignature", atau
- ketika tanda tangan diproses: err: <object|null>:
  - null jika transaksi berhasil diproses pada tingkat komitmen yang ditentukan, atau
  - sebuah TransactionError, jika transaksi gagal

Contoh respons:

Berikut adalah contoh respons notifikasi dari transaksi yang berhasil diproses:

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

Berikut adalah contoh respons notifikasi dari tanda tangan transaksi yang berhasil diterima:

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