Phương thức truy vấn lần lượt đối với bộ lọc trả về một mảng các bản ghi phát sinh kể từ lần truy vấn lần lượt trước đó.
Tham số
Tên
type
Mô tả
SỐ LƯỢNG
chuỗi
Id bộ lọc (ví dụ: "0x16" // 22).
Giá trị trả về
Mảng - Mảng các đối tượng bản ghi, hoặc mảng trống nếu không có thay đổi kể từ lần truy vấn lần lượt trước đó.đó.
Đối với các bộ lọc được tạo bằng [klay_newBlockFilter](#klay_newblockbộ lọc), kết quả trả về là các hàm băm khối (DỮ LIỆU 32 byte), ví dụ:, ["0x3454645634534..."].
Đối với các bộ lọc được tạo bằng [klay_newPendingTransactionFilter](#klay_newpendingtransactionbộ lọc), giá trị trả về là các hàm băm giao dịch (DỮ LIỆU 32 byte), ví dụ: ["0x6345343454645..."].
Đối với các bộ lọc được tạo bằng [klay_newFilter](#klay_newbộ lọc), bản ghi là các đối tượng có tham số như sau:
Tên
Loại
Mô tả
đã xoá
THẺ
Kết quả là true nếu bản ghi đã bị xóa do tổ chức lại chuỗi. Kết quả là false nếu đó là bản ghi hợp lệ.
logIndex
SỐ LƯỢNG
Giá trị nguyên chỉ vị trí chỉ mục bản ghi trong khối. Giá trị là null khi đó là bản ghi đang chờ xử lý.
transactionIndex
SỐ LƯỢNG
Giá trị nguyên chỉ vị trí chỉ mục giao dịch mà bản ghi được tạo ra từ đó. Giá trị là null nếu giao dịch đang chờ xử lý.
transactionHash
DỮ LIỆU 32 byte
Hàm băm của giao dịch mà bản ghi này được tạo từ đó. Giá trị là null nếu giao dịch đang chờ xử lý.
blockHash
DỮ LIỆU 32 byte
Hàm băm của khối chứa bản ghi này. Giá trị là null nếu giao dịch đang chờ xử lý.
blockNumber
SỐ LƯỢNG
Số khối chứa bản ghi này. Giá trị là null nếu giao dịch đang chờ xử lý.
address
DỮ LIỆU 20 byte
Địa chỉ khởi tạo bản ghi này.
data
DATA
Chứa các đối số không được lập chỉ mục của bản ghi.
chủ đề
Mảng DỮ LIỆU
Mảng gồm 0 đến 4 DỮ LIỆU 32 byte của các đối số được lập chỉ mục trong bản ghi. (Trong Solidity: Chủ đề đầu tiên là hàm băm chữ ký của sự kiện (ví dụ: Deposit(address,bytes32,uint256)), trừ khi bạn khai báo sự kiện với giá trị chỉ định anonymous.).
Trả về một mảng gồm tất cả các bản ghi khớp với bộ lọc bằng id đã cho, có được bằng cách sử dụng [klay_newFilter](#klay_newbộ lọc). Lưu ý rằng các id bộ lọc được trả về bằng các hàm tạo bộ lọc khác, chẳng hạn như [klay_newBlockFilter](#klay_newblockbộ lọc) hoặc [klay_newPendingTransactionFilter](#klay_newpendingtransactionbộ lọc), không thể sử dụng được với hàm này.
Việc thực thi API này có thể bị giới hạn bởi hai cấu hình nút để quản lý tài nguyên của nút Klaytn một cách an toàn.
Số lượng kết quả trả về tối đa trong một truy vấn (Mặc định: 10.000).
Thời gian thực thi giới hạn của một truy vấn (Mặc định: 10 giây).
Tham số
Tên
type
Mô tả
SỐ LƯỢNG
chuỗi
Id bộ lọc
Giá trị trả về
Xem phần [klay_getFilterChanges](#klay_getbộ lọcchanges)
Trả về một mảng gồm tất cả bản ghi khớp với một đối tượng bộ lọc đã cho.
Việc thực thi API này có thể bị giới hạn bởi hai cấu hình nút để quản lý tài nguyên của nút Klaytn một cách an toàn.
Số lượng kết quả trả về tối đa trong một truy vấn (Mặc định: 10.000).
Thời gian thực thi giới hạn của một truy vấn (Mặc định: 10 giây).
Tham số
Object - Các tùy chọn bộ lọc:
Tên
Loại
Mô tả
fromBlock
SỐ LƯỢNG | THẺ
(tùy chọn, mặc định: "latest") Số khối là giá trị nguyên hoặc thập lục phân hay chuỗi "earliest", "latest" hoặc "pending" như trong tham số khối mặc định. hoặc "pending" như trong tham số khối mặc định.
toBlock
SỐ LƯỢNG | THẺ
(tùy chọn, mặc định: "latest") Số khối là giá trị nguyên hoặc thập lục phân hay chuỗi "earliest", "latest" hoặc "pending" như trong tham số khối mặc định. hoặc "pending" như trong tham số khối mặc định.
address
DỮ LIỆU 20 byte | Mảng
(tùy chọn) Địa chỉ hợp đồng hoặc danh sách các địa chỉ khởi tạo bản ghi.
chủ đề
Mảng DỮ LIỆU
(tùy chọn) Mảng các chủ đề DỮ LIỆU 32 byte. Các chủ đề phụ thuộc vào thứ tự. Mỗi chủ đề cũng có thể là một mảng DỮ LIỆU với các tùy chọn "hoặc".
blockHash
DỮ LIỆU 32 byte
(tùy chọn) Tùy chọn bộ lọc hạn chế số lượng bản ghi được trả về cho một khối với mã băm 32 byte blockHash. Việc sử dụng blockHash tương đương với fromBlock = toBlock = số khối với hàm băm blockHash. Nếu blockHash xuất hiện trong tiêu chí bộ lọc, thì cả fromBlock và toBlock đều không được phép.
LƯU Ý: Trong các phiên bản trước phiên bản Klaytn v1.7.0, chỉ có số khối số nguyên, chuỗi "earliest" và "latest" khả dụng.
Giá trị trả về
Xem phần [klay_getFilterChanges](#klay_getbộ lọcchanges)
Tạo một bộ lọc trong nút để thông báo khi có khối mới. Để kiểm tra xem trạng thái đã thay đổi hay chưa, hãy gọi ra [klay_getFilterChanges](#klay_getbộ lọcchanges).
Tạo đối tượng bộ lọc dựa trên các tùy chọn bộ lọc để thông báo khi trạng thái thay đổi (bản ghi).
Để kiểm tra xem trạng thái đã thay đổi hay chưa, hãy gọi ra [klay_getFilterChanges](#klay_getbộ lọcchanges).
Để có được tất cả các bản ghi khớp với bộ lọc được tạo bởi klay_newFilter, hãy gọi ra [klay_getFilterLogs](#klay_getbộ lọcnhật ký).
Lưu ý về việc xác định bộ lọc chủ đề: Các chủ đề phụ thuộc vào thứ tự. Một giao dịch với bản ghi có các chủ đề [A, B] sẽ được khớp bởi các bộ lọc chủ đề như sau:
[] "chủ đề bất kỳ"
[A] "A ở vị trí đầu tiên (và chủ đề bất kỳ sau đó)"
[null, B] "chủ đề bất kỳ ở vị trí đầu tiên VÀ B ở vị trí thứ hai (và chủ đề bất kỳ sau đó)"
[A, B] "A ở vị trí đầu tiên VÀ B ở vị trí thứ hai (và chủ đề bất kỳ sau đó)"
[[A, B], [A, B]] "(A HOẶC B) ở vị trí đầu tiên VÀ (A HOẶC B) ở vị trí thứ hai (và chủ đề bất kỳ sau đó)"
Tham số
Object - Các tùy chọn bộ lọc:
Tên
Loại
Mô tả
fromBlock
SỐ LƯỢNG | THẺ
(tùy chọn, mặc định: "latest") Số khối là giá trị nguyên hoặc thập lục phân hay chuỗi "earliest", "latest" hoặc "pending" như trong tham số khối mặc định. hoặc "pending" như trong tham số khối mặc định.
toBlock
SỐ LƯỢNG | THẺ
(tùy chọn, mặc định: "latest") Số khối là giá trị nguyên hoặc thập lục phân hay chuỗi "earliest", "latest" hoặc "pending" như trong tham số khối mặc định. hoặc "pending" như trong tham số khối mặc định.
address
DỮ LIỆU 20 byte | Mảng
(tùy chọn) Địa chỉ hợp đồng hoặc danh sách các địa chỉ khởi tạo bản ghi.
chủ đề
Mảng DỮ LIỆU
(tùy chọn) Mảng các chủ đề DỮ LIỆU 32 byte. Các chủ đề phụ thuộc vào thứ tự. Mỗi chủ đề cũng có thể là một mảng DỮ LIỆU với các tùy chọn "hoặc".
LƯU Ý: Trong các phiên bản trước phiên bản Klaytn v1.7.0, chỉ có số khối số nguyên, chuỗi "earliest" và "latest" khả dụng.
Tạo một bộ lọc trong nút để thông báo khi có giao dịch mới đang chờ xử lý. Để kiểm tra xem trạng thái đã thay đổi hay chưa, hãy gọi ra [klay_getFilterChanges](#klay_getbộ lọcchanges).
Tạo đăng ký mới cho các sự kiện cụ thể bằng cách sử dụng RPC Pub/Sub thông qua WebSocket hoặc bộ lọc thông qua HTTP. Tính năng này cho phép máy khách chờ các sự kiện thay vì phải truy vấn lần lượt.
Nút sẽ trả về id đăng ký cho mỗi lượt đăng ký được tạo. Đối với mỗi sự kiện khớp với gói đăng ký, thông báo chứa dữ liệu liên quan sẽ được gửi cùng với id đăng ký. Nếu một kết nối bị đóng lại, tất cả các đăng ký được tạo qua kết nối đó sẽ bị xóa.
Tham số
Object - Loại thông báo: "newHeads" hoặc "nhật ký".
"newHeads" thông báo cho bạn khi mỗi khối được thêm vào chuỗi khối. "nhật ký" thông báo cho bạn khi các bản ghi được đưa vào các khối mới. Loại thông báo này yêu cầu phải có tham số thứ hai chỉ định tùy chọn bộ lọc. Để biết thêm thông tin, vui lòng truy cập [klay_newFilter > tham số](https://docs.klaytn.com/dapp/json-rpc/api-references/klay/bộ lọc#klay_newbộ lọc).
Giá trị trả về
Loại
Mô tả
SỐ LƯỢNG
Id đăng ký khi tạo đăng ký. Đối với mỗi sự kiện khớp với gói đăng ký, thông báo chứa dữ liệu liên quan cũng sẽ được gửi.
Ví dụ
API này phù hợp cho việc sử dụng cùng với công cụ Websocket, wscat.
Gỡ cài đặt bộ lọc với id đã cho. Luôn phải được gọi ra khi không còn cần theo dõi. Ngoài ra, bộ lọc sẽ hết thời gian chờ nếu không được yêu cầu [klay_getFilterChanges](#klay_getbộ lọcchanges) trong một khoảng thời gian.
Tham số
Tên
type
Mô tả
bộ lọc
SỐ LƯỢNG
Id bộ lọc.
Giá trị trả về
Loại
Mô tả
Boolean
true nếu gỡ cài đặt bộ lọc thành công, nếu không sẽ là false.
Hủy đăng ký với id đăng ký cụ thể bằng cách sử dụng RPC Pub/Sub thông qua WebSocket hoặc bộ lọc thông qua HTTP. Chỉ có kết nối đã tạo gói đăng ký mới có thể hủy gói đăng ký.
Tham số
Loại
Mô tả
SỐ LƯỢNG
Id đăng ký.
Giá trị trả về
type
Mô tả
Boolean
true nếu hủy đăng ký thành công, ngược lại sẽ là false.
Ví dụ
API này phù hợp cho việc sử dụng cùng với công cụ Websocket, wscat.