Bộ lọc

getFilterChanges

caver.klay.getFilterChanges(bộ lọcId [, callback])

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 kể từ lần truy vấn trước đó.

Tham số

Tên

type

Mô tả

bộ lọcId

Chuỗi

Id bộ lọc.

callback

Hàm

(tùy chọn) Hàm callback tùy chọn, trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về Array - 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 trước đó.

Cấu trúc của Object bản ghi trả về trong Array có dạng như sau:

Tên

Loại

Mô tả

address

DỮ LIỆU 20 byte

Địa chỉ mà bản ghi này được khởi tạo.

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.).

data

DATA

Chứa các đối số không được lập chỉ mục của bản ghi.

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ý.

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 khi giao dịch đang chờ xử lý, đây là trường hợp đặc biệt khi giao dịch đã được thực thi nhưng khối chứa giao dịch chưa được xác nhận.

transactionIndex

SỐ LƯỢNG

Giá trị nguyên. Chỉ mục của giao dịch nơi bản ghi này được tạo. 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ý.

logIndex

SỐ LƯỢNG

Giá trị nguyên chỉ vị trí chỉ mục bản ghi trong khối. Giá trị là Giá trị là null khi đó là bản ghi đang chờ xử lý.

Chuỗi

Mã số định danh bản ghi. Mã này được tạo bằng cách nối chuỗi "log_" với keccak256(blockHash + transactionHash + logIndex).substr(0, 8)

Ví dụ

> caver.klay.getFilterChanges('0xafb8e49bbcba9d61a3c616a3a312533e').then(console.log);
[ 
    { 
        address: '0x71e503935b7816757AA0314d4E7354dab9D39162',
        topics: [ '0xe8451a9161f9159bc887328b634789768bd596360ef07c5a5cbfb927c44051f9' ],
        data: '0x0000000000000000000000000000000000000000000000000000000000000001',
        blockNumber: 3525,
        transactionHash: '0x1b28e2c723e45a0d8978890598903f36a74397c9cea8531dc9762c39483e417f',
        transactionIndex: 0,
        blockHash: '0xb7f0bdaba93d3baaa01a5c24517da443207f774e0202f02c298e8e997a540b3d',
        logIndex: 0,
        id: 'log_c1ea867d'
    } 
]

getFilterLogs

caver.klay.getFilterLogs(bộ lọcId [, callback])

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 trước. Nên lấy đối tượng bộ lọc bằng cách sử dụng hàm [newFilter](#newbộ lọc). Lưu ý rằng không thể sử dụng các id bộ lọc trả về bằng các hàm tạo bộ lọc khác, chẳng hạn như [newBlockFilter](#newblockbộ lọc) hoặc [newPendingTransactionFilter](#newpendingtransactionbộ lọc), với hàm này.

Tham số

Tên

type

Mô tả

bộ lọcId

Chuỗi

Id bộ lọc.

callback

Hàm

(tùy chọn) Hàm callback tùy chọn, trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Tham khảo [getFilterChanges](#getbộ lọcchanges)

Ví dụ

> caver.klay.getFilterLogs('0xcac08a7fc32fc625a519644187e9f690').then(console.log);
[
    {
        address: '0x55384B52a9E5091B6012717197887dd3B5779Df3',
        topics: [ '0xe8451a9161f9159bc887328b634789768bd596360ef07c5a5cbfb927c44051f9' ],
        data: '0x0000000000000000000000000000000000000000000000000000000000000001',
        blockNumber: 7217,
        transactionHash: '0xa7436c54e47dafbce696de65f6e890c96ac22c236f50ca1be28b9b568034c3b3',
        transactionIndex: 0,
        blockHash: '0xe4f27c524dacfaaccb36735deccee69b3d6c315e969779784c36bb8e14b89e01',
        logIndex: 0,
        id: 'log_2dd695a8' 
    }
]

getPastLogs

caver.klay.getPastLogs(options [, callback])

Lấy bản ghi trong quá khứ, phù hợp với các tùy chọn đã cho.

Tham số

Tên

Loại

Mô tả

tùy chọn

Đối tượng

Các tùy chọn bộ lọc.

options.fromBlock

Số | Chuỗi

(tùy chọn) Số hiệu của khối lấy bản ghi sớm nhất. ("mới nhất" nghĩa là khối gần đây nhất.) Giá trị mặc định là "latest".

options.toBlock

Số | Chuỗi

(tùy chọn) Số hiệu của khối lấy bản ghi cuối cùng. ("mới nhất" nghĩa là khối gần đây nhất.). Giá trị mặc định là "latest".

options.address

Chuỗi | Mảng

(tùy chọn) Địa chỉ hoặc danh sách các địa chỉ. Hàm sẽ chỉ trả về các bản ghi liên quan đến (các) tài khoản cụ thể.

options.topics

Mảng

(tùy chọn) Mảng các giá trị phải xuất hiện trong bản ghi. Quan trọng là thứ tự. Nếu bạn muốn bỏ qua một số chủ đề, hãy sử dụng null, ví dụ, [null, '0x12...']. Bạn cũng có thể truyền một mảng của mỗi chủ đề với các tùy chọn cho chủ đề đó ví dụ: [null, ['option1', 'option2']].

callback

Hàm

(tùy chọn) Hàm callback tùy chọn, trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về Array - Mảng các đối tượng bản ghi.

Cấu trúc của Object sự kiện trả về trong Array có dạng như sau:

Tên

Loại

Mô tả

address

Chuỗi

Địa chỉ khởi tạo sự kiện.

data

Chuỗi

Dữ liệu chứa tham số bản ghi không được lập chỉ mục.

chủ đề

Mảng

Một mảng có tối đa 4 chủ đề 32 byte, chủ đề 1-3 chứa các tham số được lập chỉ mục của bản ghi.

logIndex

Số

Giá trị nguyên chỉ vị trí chỉ mục sự kiện trong khối.

transactionIndex

Số

Giá trị nguyên chỉ vị trí chỉ mục giao dịch nơi sự kiện được tạo.

transactionHash

Chuỗi 32 byte

Hàm băm của giao dịch mà sự kiện này được tạo.

blockHash

Chuỗi 32 byte

Hàm băm của khối nơi sự kiện này được tạo. Giá trị là null khi sự kiện vẫn đang chờ xử lý.

blockNumber

Số

Số khối nơi bản ghi này được tạo. Giá trị là null khi bản ghi vẫn đang chờ xử lý.

Chuỗi

Mã số định danh bản ghi. Mã này được tạo thông qua việc nối chuỗi "log_" với keccak256(blockHash + transactionHash + logIndex).substr(0, 8)

Ví dụ

> caver.klay.getPastLogs({
    address: "0x11f4d0A3c12e86B4b5F39B213F7E19D048276DAe",
    topics: ["0x033456732123ffff2342342dd12342434324234234fd234fd23fd4f23d4234"]
})
.then(console.log);

[{
    data: '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385',
    topics: ['0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7', '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385']
    logIndex: 0,
    transactionIndex: 0,
    transactionHash: '0x7f9fade1c0d57a7af66ab4ead79fade1c0d57a7af66ab4ead7c2c2eb7b11a91385',
    blockHash: '0xfd43ade1c09fade1c0d57a7af66ab4ead7c2c2eb7b11a91ffdd57a7af66ab4ead7',
    blockNumber: 1234,
    address: '0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe',
    id: 'log_124d61bc',
},{...}]

newBlockFilter

caver.klay.newBlockFilter([callback])

Tạo bộ lọc trong nút để nhận thông tin về sự xuất hiện của khối mới. Để kiểm tra xem trạng thái có thay đổi hay không, hãy gọi ra [getFilterChanges](#getbộ lọcchanges).

Tham số

Tên

type

Mô tả

callback

Hàm

(tùy chọn) Hàm callback tùy chọn. Hàm callback được gọi với đối tượng lỗi làm tham số thứ nhất của hàm và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về String - Id bộ lọc.

Ví dụ

> caver.klay.newBlockFilter().then(console.log);
0x9ca049dc8b0788ee05724e45fc4137f1

newFilter

caver.klay.newFilter(options [, callback])

Tạo đối tượng bộ lọc sử dụng các tùy chọn bộ lọc nhất định để nhận thông tin thay đổi trạng thái cụ thể (bản ghi).

Để kiểm tra xem trạng thái có thay đổi hay không, hãy gọi ra [getFilterChanges](#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 newFilter, hãy gọi ra [getFilterLogs](#getbộ lọcnhật ký).

Để biết thông tin chi tiết về các bộ lọc theo chủ đề, hãy tham khảo [API Nền tảng Klaytn - klay_newFilter](../../../../../json-rpc/api-references/klay/bộ lọc.md#klay_newbộ lọc).

Tham số

Tên

Loại

Mô tả

tùy chọn

Đối tượng

Các tùy chọn bộ lọc.

options.fromBlock

Số | Chuỗi

(tùy chọn) Số hiệu của chiều cao khối truy vấn sự kiện sớm nhất. (Có các thẻ đặc biệt, "latest" nghĩa là khối gần đây nhất). Giá trị mặc định là "latest".

options.toBlock

Số | Chuỗi

(tùy chọn) Số hiệu của chiều cao khối truy vấn sự kiện cuối cùng (Có các thẻ đặc biệt, "latest" nghĩa là khối được xác nhận gần đây nhất). Giá trị mặc định là "latest".

options.address

Chuỗi | Mảng

(tùy chọn) Địa chỉ hoặc danh sách các địa chỉ để lấy bản ghi được tạo ra bên trong (các) hợp đồng đã cho.

options.topics

Mảng

(tùy chọn) Mảng các giá trị để tìm kiếm trong mục nhập bản ghi. Quan trọng là thứ tự. Nếu bạn muốn khớp với tất cả mọi thứ trong vị trí cho trước, hãy sử dụng null, ví dụ, [null, '0x12...']. Bạn cũng có thể truyền một mảng để khớp một trong số các giá trị đó. Ví dụ, [null, ['option1', 'option2']].

callback

Hàm

(tùy chọn) Hàm callback tùy chọn, trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về String - Id bộ lọc.

Ví dụ

> caver.klay.newFilter({}).then(console.log);
0x40d40cb9758c6f0d99d9c2ce9c0f823

> caver.klay.newFilter({address: "0x55384B52a9E5091B6012717197887dd3B5779Df3"}).then(console.log);
0xd165cbf31b9d60346aada33dbefe01b

newPendingTransactionFilter

caver.klay.newPendingTransactionFilter([callback])

Tạo bộ lọc trong nút để nhận thông tin về sự xuất hiện của khối đang chờ xử lý mới. Để kiểm tra xem trạng thái có thay đổi hay không, hãy gọi ra [getFilterChanges](#getbộ lọcchanges).

Tham số

Tên

Loại

Mô tả

callback

Hàm

(tùy chọn) Hàm callback tùy chọn, trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về String - Id bộ lọc.

Ví dụ

> caver.klay.newPendingTransactionFilter().then(console.log);
0x1426438ffdae5abf43edf4159c5b013b

uninstallFilter

caver.klay.uninstallFilter(bộ lọcId [, callback])

Gỡ bỏ bộ lọc với id cho trước. Bạn nên xóa ngay bộ lọc nếu việc giám sát không còn cần thiết nữa. Bộ lọc sẽ bị xóa nếu không được gọi ra thông qua [getFilterChanges](#getbộ lọcchanges) trong thời gian lớn hơn giá trị thời gian chờ được thiết lập trong nút. Cấu hình mặc định là 5 phút.

Tham số

Tên

Loại

Mô tả

bộ lọcId

Chuỗi

Id bộ lọc.

callback

Hàm

(tùy chọn) Hàm callback tùy chọn, trả về một đối tượng lỗi làm tham số thứ nhất và kết quả làm tham số thứ hai.

Giá trị trả về

Promise trả về Boolean - Giá trị là true nếu bộ lọc đã được gỡ cài đặt thành công, ngược lại, giá trị sẽ là false.

Ví dụ

> caver.klay.uninstallFilter('0x1426438ffdae5abf43edf4159c5b013b').then(console.log);
true

PreviousCấu hình NextKhác

Last updated 1 year ago