Phương thức RPC signatureSubscribe

Đăng ký để nhận thông báo khi giao dịch với chữ ký đã cho đạt đến mức cam kết được chỉ định.

Đây là đăng ký cho một thông báo duy nhất. Nó tự động bị hủy bởi máy chủ sau khi thông báo, signatureNotification, được gửi bởi RPC.

params

stringrequired

chữ ký giao dịch, dưới dạng chuỗi mã hóa base-58

Chữ ký giao dịch phải là chữ ký đầu tiên từ giao dịch (xem id giao dịch để biết thêm chi tiết).

objectoptional

Đối tượng cấu hình chứa các trường sau:

result

integer

id đăng ký (cần thiết để hủy đăng ký)

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

chữ ký giao dịch, dưới dạng chuỗi mã hóa base-58

Chữ ký giao dịch phải là chữ ký đầu tiên từ giao dịch (xem id giao dịch để biết thêm chi tiết).

objectoptional

Đối tượng cấu hình chứa các trường sau:

result

Response

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

integer

id đăng ký (cần thiết để hủy đăng ký)

Định dạng thông báo:

Thông báo sẽ là một đối tượng JSON RpcResponse với giá trị chứa một đối tượng với:

slot: <u64> - slot tương ứng.
value: <object|string> - giá trị thông báo của RpcSignatureResult, dẫn đến một trong hai kết quả:
- khi enableReceivedNotification là true và chữ ký được nhận: chuỗi ký tự "receivedSignature", hoặc
- khi chữ ký được xử lý: err: <object|null>:
  - null nếu giao dịch được xử lý thành công ở mức cam kết đã chỉ định, hoặc
  - một TransactionError, nếu giao dịch thất bại

Ví dụ về phản hồi:

Dưới đây là ví dụ về phản hồi thông báo từ một giao dịch đã được xử lý thành công:

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

Dưới đây là ví dụ về phản hồi thông báo từ một chữ ký giao dịch đã nhận thành công:

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