caver.rpc.klay
caver.rpc.klay
cung cấp lệnh gọi JSON-RPC với không gian tên klay
.
caver.rpc.klay.tài khoảnCreated
Trả về true
nếu tài khoản được liên kết với địa chỉ được tạo trong nền tảng chuỗi khối Klaytn. Nếu không sẽ trả về false
.
Tham số
address
chuỗi
Địa chỉ của tài khoản mà bạn muốn truy vấn nếu tài khoản đã được tạo trong mạng.
blockNumber
số \
chuỗi
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
boolean
Có địa chỉ đầu vào trong Klaytn.
Ví dụ
caver.rpc.klay.getAccount
Trả về thông tin tài khoản của một địa chỉ nhất định trong Klaytn. Để biết thêm chi tiết về các loại tài khoản trong Klaytn, vui lòng tham khảo [Các loại tài khoản Klaytn](../../../../../klaytn/design/tài khoảns.md#klaytn-tài khoản-types).
LƯU Ý caver.rpc.klay.getAccount
trả về tài khoản tồn tại trên mạng, nếu tài khoản khớp với địa chỉ không tồn tại trên mạng chuỗi khối thực tế, hàm sẽ trả về null
.
Tham số
address
chuỗi
Địa chỉ của tài khoản mà bạn muốn có thông tin tài khoản.
blockNumber
số \
chuỗi
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ề đối tượng
đối tượng
Một đối tượng chứa thông tin tài khoản. Mỗi loại tài khoản sẽ có các thuộc tính khác nhau.
Ví dụ
caver.rpc.klay.getAccountKey
Trả về AccountKey của một địa chỉ đã cho. Nếu tài khoản có [AccountKeyLegacy](../../../../../klaytn/design/tài khoảns.md#tài khoảnkeylegacy) hoặc tài khoản của địa chỉ đã cho là [Tài khoản hợp đồng thông minh](../../../../../klaytn/design/tài khoảns.md#smart-contract-tài khoảns-scas), tài khoản đó sẽ trả về một giá trị khóa trống. Vui lòng tham khảo [Khóa tài khoản](../../../../../klaytn/design/tài khoảns.md#tài khoản-key) để biết thêm thông tin chi tiết.
LƯU Ý caver.rpc.klay.getAccountKey
trả về một đối tượng khác nhau theo từng loại AccountKey. Nếu tài khoản Klaytn khớp với địa chỉ đã cho không tồn tại trong mạng thì sẽ trả về null
.
Tham số
address
chuỗi
Địa chỉ của tài khoản Klaytn mà bạn muốn lấy một đối tượng của thông tin AccountKey.
blockNumber
số \
chuỗi
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ề đối tượng
đối tượng
Một đối tượng chứa thông tin AccountKey. Mỗi loại AccountKey sẽ có các thuộc tính khác nhau.
Ví dụ
caver.rpc.klay.encodeAccountKey
Mã hóa một đối tượng chứa thông tin AccountKey bằng sơ đồ mã hóa Tiền tố độ dài đệ quy (RLP). Ngoài ra, bạn có thể sử dụng [tài khoản.getRLPEncodingAccountKey](../caver.tài khoản.md#tài khoản-getrlpencodingtài khoảnkey) để lấy AccountKey được mã hóa bằng RLP.
Tham số
tài khoảnKey
đối tượng
Một đối tượng xác định keyType
và khóa
bên trong hoặc một phiên bản của AccountKey
([AccountKeyLegacy](../caver.tài khoản.md#tài khoảnkeylegacy), [AccountKeyPublic](../caver.tài khoản.md#tài khoảnkeypublic), [AccountKeyFail](../caver.tài khoản.md#tài khoảnkeyfail), [AccountKeyWeightedMultiSig](../caver.tài khoản.md#tài khoảnkeyweightedmultisig) hoặc [AccountKeyRoleBased](../caver.tài khoản.md#tài khoảnkeyrolebased)).
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ề chuỗi
chuỗi
AccountKey được mã hóa RLP.
Ví dụ
caver.rpc.klay.decodeAccountKey
Giải mã AccountKey được mã hóa RLP. Ngoài ra, bạn có thể sử dụng [caver.tài khoản.tài khoảnKey.decode](../caver.tài khoản.md#caver-tài khoản-tài khoảnkey-decode) để giải mã AccountKey được mã hóa bằng RLP.
Tham số
encodedKey
chuỗi
AccountKey được mã hóa RLP.
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ề đối tượng
đối tượng
Một đối tượng xác định keyType
và Key
bên trong.
Ví dụ
caver.rpc.klay.getBalance
Trả về số dư tài khoản của địa chỉ đã cho trong Klaytn.
Tham số
address
chuỗi
Địa chỉ của tài khoản mà bạn muốn lấy số dư.
blockNumber
số \
chuỗi
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ề chuỗi
chuỗi
Số dư hiện tại cho địa chỉ đã cho bằng peb.
Ví dụ
caver.rpc.klay.getCode
Trả về mã ở địa chỉ đã cho.
Tham số
address
chuỗi
Địa chỉ nơi để nhận mã.
blockNumber
số \
chuỗi
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ề chuỗi
chuỗi
Mã từ địa chỉ đã cho.
Ví dụ
caver.rpc.klay.getTransactionCount
Trả về tổng số lượng giao dịch đã gửi từ một địa chỉ.
Tham số
address
chuỗi
Địa chỉ nơi để nhận số lượng giao dịch.
blockNumber
số \
chuỗi
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ề chuỗi
chuỗi
Số lượng giao dịch đã gửi từ địa chỉ nhất định ở dạng hex.
Ví dụ
caver.rpc.klay.isContractAccount
Trả về true
nếu tài khoản đầu vào có codeHash không trống vào thời điểm có số khối cụ thể. Trả về false
nếu tài khoản là EOA hoặc tài khoản hợp đồng thông minh không có codeHash. Vui lòng tham khảo [Tài khoản hợp đồng thông minh](../../../../../klaytn/design/tài khoảns.md#smart-contract-tài khoảns-scas) để biết thêm thông tin chi tiết.
Tham số
address
chuỗi
Địa chỉ mà bạn muốn kiểm tra isContractAccount.
blockNumber
số \
chuỗi
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
boolean
true có nghĩa là tham số đầu vào là một địa chỉ hợp đồng thông minh hiện có.
Ví dụ
caver.rpc.klay.sign
Tạo dữ liệu đã ký dành riêng cho Klaytn. Tham khảo [API Nền tảng Klaytn - klay_sign](../../../../json-rpc/api-references/klay/tài khoản.md#klay_sign) để biết cách tạo chữ ký.
LƯU Ý: API này cung cấp chức năng ký thông báo bằng cách sử dụng tài khoản đã nhập trong nút Klaytn của bạn. Tài khoản đã nhập trong nút của bạn phải được [mở khóa](../../../../json-rpc/api-references/personal.md#personal_unlocktài khoản) để ký thông báo. Để ký giao dịch bằng tài khoản đã nhập trong nút Klaytn của bạn, hãy sử dụng caver.rpc.klay.signTransaction.
Tham số
address
Chuỗi
Địa chỉ của tài khoản đã nhập để ký thông báo.
thông báo
Chuỗi
Tin nhắn có thể ký.
blockNumber
số \
chuỗi
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ề chuỗi
chuỗi
Chữ ký được thực hiện từ một tài khoản đã nhập.
Ví dụ
caver.rpc.klay.getAccounts
Trả về danh sách các địa chỉ thuộc sở hữu của Nút Klaytn.
Tham số
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ề Mảng
Mảng
Một mảng các địa chỉ thuộc sở hữu của Nút Klaytn.
Ví dụ
caver.rpc.klay.getBlockNumber
Trả về số của khối gần đây nhất.
Tham số
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ề chuỗi
chuỗi
Số của khối mới nhất ở dạng hex.
Ví dụ
caver.rpc.klay.getHeader
Trả về tiêu đề khối theo hàm băm khối hoặc số khối. Nếu người dùng chuyển hàm băm khối dưới dạng tham số, caver.rpc.klay.getHeaderByHash sẽ được gọi ra và nếu số khối được gọi dưới dạng tham số thì caver.rpc.klay.getHeaderByNumber sẽ được gọi ra.
Tham số
blockNumberOrHash
số \
chuỗi
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ề đối tượng
đối tượng
Một đối tượng tiêu đề khối. Để biết mô tả chi tiết về giá trị trả về, vui lòng tham khảo caver.rpc.klay.getHeaderByHash.
Ví dụ
caver.rpc.klay.getHeaderByNumber
Trả về tiêu đề khối theo số khối.
Tham số
blockNumber
số \
chuỗi
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ề đối tượng
đối tượng
Một đối tượng tiêu đề khối. Để biết mô tả chi tiết về giá trị trả về, vui lòng tham khảo caver.rpc.klay.getHeaderByHash.
Ví dụ
caver.rpc.klay.getHeaderByHash
Trả về số khối của khối mới nhất bằng cách sử dụng blockHash
.
Tham số
blockHash
chuỗi
Hàm băm khối.
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ề đối tượng
- Một đối tượng bao gồm tiêu đề khối:
baseFeePerGas
chuỗi
Phí cơ bản trên mỗi đơn vị gas. Giá trị này chỉ được trả về khi EthTxTypeCompatibleBlock được kích hoạt cho số khối đó.
blockScore
chuỗi
Độ khó khai thác trong mạng blockchain. Việc sử dụng blockScore
khác với cơ chế đồng thuận của mạng. Giá trị luôn là 1 trong công cụ đồng thuận BFT.
extraData
chuỗi
Trường "dữ liệu bổ sung" của khối này.
gasUsed
chuỗi
Tổng lượng gas đã được sử dụng bởi tất cả các giao dịch trong khối này.
governanceData
chuỗi
Cấu hình quản trị được mã hóa RLP
hash
chuỗi
Hàm băm của một khối. null
khi đó là khối đang chờ xử lý.
nhật kýBloom
chuỗi
Bộ lọc Bloom cho các bản ghi của khối. null
khi đó là khối đang chờ xử lý.
số
chuỗi
Số khối. null
khi đó là khối đang chờ xử lý.
parentHash
chuỗi
Hàm băm của khối cha mẹ.
receiptsRoot
chuỗi
Gốc của trie biên lai giao dịch của khối.
phần thưởng
chuỗi
Địa chỉ của người thụ hưởng đã được trao phần thưởng khối.
stateRoot
chuỗi
Gốc của trie trạng thái cuối trong khối.
dấu thời gian
chuỗi
Dấu thời gian unix khi khối được đối chiếu.
timestampFoS
chuỗi
Phần giây của dấu thời gian khi khối được đối chiếu.
transactionsRoot
chuỗi
Gốc của trie giao dịch trong khối.
Ví dụ
caver.rpc.klay.getBlock
Trả về thông tin của một khối theo hàm băm khối hoặc số khối. Nếu người dùng chuyển hàm băm khối dưới dạng tham số, caver.rpc.klay.getBlockByHash sẽ được gọi ra và nếu số khối được gọi dưới dạng tham số thì caver.rpc.klay.getBlockByNumber sẽ được gọi ra.
Tham số
blockNumberOrHash
số \
chuỗi
returnTransactionObjects
boolean
(tùy chọn, mặc định false
) Nếu true
, khối được trả về sẽ chứa tất cả giao dịch dưới dạng đối tượng và khối sẽ chỉ chứa các hàm băm giao dịch nếu trả về false
.
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ề đối tượng
đối tượng
Một đối tượng khối. Để biết mô tả chi tiết về giá trị trả về, vui lòng tham khảo caver.rpc.klay.getBlockByHash.
Ví dụ
caver.rpc.klay.getBlockByNumber
Trả về thông tin của một khối theo số khối.
Tham số
blockNumber
số \
chuỗi
returnTransactionObjects
boolean
(tùy chọn, mặc định false
) Nếu true
, khối được trả về sẽ chứa tất cả giao dịch dưới dạng đối tượng và khối sẽ chỉ chứa các hàm băm giao dịch nếu trả về false
.
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ề đối tượng
đối tượng
Một đối tượng khối. Để biết mô tả chi tiết về giá trị trả về, hãy tham khảo caver.rpc.klay.getBlockByHash.
Ví dụ
caver.rpc.klay.getBlockByHash
Trả về số khối của khối mới nhất bằng cách sử dụng blockHash
.
Tham số
blockHash
chuỗi
Hàm băm khối.
returnTransactionObjects
boolean
(tùy chọn, mặc định false
) Nếu true
, khối được trả về sẽ chứa tất cả giao dịch dưới dạng đối tượng và khối sẽ chỉ chứa các hàm băm giao dịch nếu trả về false
.
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ề đối tượng
- Một đối tượng bao gồm khối:
baseFeePerGas
chuỗi
Phí cơ bản trên mỗi đơn vị gas. Giá trị này chỉ được trả về khi EthTxTypeCompatibleBlock được kích hoạt cho số khối đó.
blockScore
chuỗi
Độ khó khai thác trong mạng blockchain. Việc sử dụng blockScore
khác với cơ chế đồng thuận của mạng. Giá trị luôn là 1 trong công cụ đồng thuận BFT.
extraData
chuỗi
Trường "dữ liệu bổ sung" của khối này.
gasUsed
chuỗi
Tổng lượng gas đã được sử dụng bởi tất cả các giao dịch trong khối này.
governanceData
chuỗi
Cấu hình quản trị được mã hóa RLP
hash
chuỗi
Hàm băm của một khối. null
khi đó là khối đang chờ xử lý.
nhật kýBloom
chuỗi
Bộ lọc Bloom cho các bản ghi của khối. null
khi đó là khối đang chờ xử lý.
số
chuỗi
Số khối. null
khi đó là khối đang chờ xử lý.
parentHash
chuỗi
Hàm băm của khối cha mẹ.
receiptsRoot
chuỗi
Gốc của trie biên lai giao dịch của khối.
phần thưởng
chuỗi
Địa chỉ của người thụ hưởng đã được trao phần thưởng khối.
kích thước
chuỗi
Số nguyên chỉ kích thước của khối này theo byte.
stateRoot
chuỗi
Gốc của trie trạng thái cuối trong khối.
dấu thời gian
chuỗi
Dấu thời gian unix khi khối được đối chiếu.
timestampFoS
chuỗi
Phần giây của dấu thời gian khi khối được đối chiếu.
totalBlockScore
chuỗi
Giá trị nguyên chỉ tổng số blockScore của chuỗi cho đến khối này.
giao dịch
Mảng
Mảng đối tượng giao dịch hoặc hàm băm giao dịch 32 byte tùy thuộc vào tham số returnTransactionObjects
.
transactionsRoot
chuỗi
Gốc của trie giao dịch trong khối.
voteData
chuỗi
Phiếu bầu quản trị được mã hóa RLP của người đề xuất.
Ví dụ
caver.rpc.klay.getBlockReceipts
Trả về các biên lai được gộp vào khối được xác định bằng hàm băm khối.
Tham số
blockHash
chuỗi
Hàm băm khối.
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ề Mảng
Mảng
Biên lai giao dịch được đưa vào một khối. Nếu khối mục tiêu không chứa giao dịch, thì hàm sẽ trả về một mảng trống []
. Để biết mô tả chi tiết về biên lai giao dịch, hãy tham khảo caver.rpc.klay.getTransactionReceipt.
Ví dụ
caver.rpc.klay.getBlockTransactionCountByNumber
Trả về số lượng giao dịch trong một khối khớp với số khối đã cho.
Tham số
blockNumber
số \
chuỗi
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ề chuỗi
chuỗi
Số lượng giao dịch trong khối nhất định ở dạng hex.
Ví dụ
caver.rpc.klay.getBlockTransactionCountByHash
Trả về số lượng giao dịch trong một khối khớp với hàm băm khối đã cho.
Tham số
blockHash
chuỗi
Hàm băm khối.
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ề chuỗi
chuỗi
Số lượng giao dịch trong khối nhất định ở dạng hex.
Ví dụ
caver.rpc.klay.getBlockWithConsensusInfoByNumber
Trả về một khối có thông tin đồng thuận khớp với số khối đã cho.
Tham số
blockNumber
số \
chuỗi
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ề đối tượng
chuỗi
Một đối tượng bao gồm khối với thông tin đồng thuận. Để biết mô tả chi tiết về giá trị trả về, hãy tham khảo caver.rpc.klay.getBlockWithConsensusInfoByHash.
Ví dụ
caver.rpc.klay.getBlockWithConsensusInfoByHash
Trả về một khối có thông tin đồng thuận khớp với hàm băm đã cho.
Tham số
blockHash
chuỗi
Hàm băm khối.
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ề đối tượng
- Một đối tượng khối có thông tin đồng thuận (người đề xuất và danh sách thành viên ủy ban) hoặc null khi không tìm thấy bất kỳ khối nào:
blockScore
chuỗi
Độ khó trước đây. Giá trị luôn là 1 trong công cụ đồng thuận BFT
uỷ ban
Mảng
Mảng địa chỉ của các thành viên ủy ban của khối này. Ủy ban là một tập hợp con của những nút xác thực đã tham gia vào giao thức đồng thuận cho khối này.
extraData
chuỗi
Trường "dữ liệu bổ sung" của khối này.
gasUsed
chuỗi
Tổng lượng gas đã được sử dụng bởi tất cả các giao dịch trong khối này.
governanceData
chuỗi
Cấu hình quản trị được mã hóa RLP
hash
chuỗi
Hàm băm của một khối. null
khi đó là khối đang chờ xử lý.
nhật kýBloom
chuỗi
Bộ lọc Bloom cho các bản ghi của khối. null
khi đó là khối đang chờ xử lý.
số
chuỗi
Số khối. null
khi đó là khối đang chờ xử lý.
originProposer
chuỗi
Đề xuất 0 vòng ở cùng một số khối.
parentHash
chuỗi
Hàm băm của khối cha mẹ.
người đề xuất
chuỗi
Địa chỉ của người đề xuất khối.
receiptsRoot
chuỗi
Gốc của trie biên lai giao dịch của khối.
phần thưởng
chuỗi
Địa chỉ của người thụ hưởng đã được trao phần thưởng khối.
vòng
số
Số vòng.
kích thước
chuỗi
Số nguyên chỉ kích thước của khối này theo byte.
stateRoot
chuỗi
Gốc của trie trạng thái cuối trong khối.
dấu thời gian
chuỗi
Dấu thời gian unix khi khối được đối chiếu.
timestampFoS
chuỗi
Phần giây của dấu thời gian khi khối được đối chiếu.
totalBlockScore
chuỗi
Giá trị nguyên chỉ tổng số blockScore của chuỗi cho đến khối này.
giao dịch
Mảng
Mảng đối tượng giao dịch.
transactionsRoot
chuỗi
Gốc của trie giao dịch trong khối.
voteData
chuỗi
Phiếu bầu quản trị được mã hóa RLP của người đề xuất
Ví dụ
caver.rpc.klay.getCommittee
Trả về danh sách tất cả các nút xác thực của ủy ban tại khối được chỉ định.
Tham số
blockNumber
số \
chuỗi
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ề Mảng
Mảng
Địa chỉ của tất cả các nút xác thực của ủy ban tại khối đã cho.
Ví dụ
caver.rpc.klay.getCommitteeSize
Trả về quy mô của ủy ban tại khối được chỉ định.
Tham số
blockNumber
số \
chuỗi
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ề số
số
Quy mô của ủy ban tại khối đã cho.
Ví dụ
caver.rpc.klay.getCouncil
Trả về danh sách tất cả các nút xác thực của hội đồng tại khối được chỉ định.
Tham số
blockNumber
số \
chuỗi
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ề Mảng
Mảng
Một mảng địa chỉ nút xác thực của hội đồng tại khối đã cho hoặc null khi không tìm thấy hội đồng nào.
Ví dụ
caver.rpc.klay.getCouncilSize
Trả về quy mô của hội đồng tại khối được chỉ định.
Tham số
blockNumber
số \
chuỗi
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ề số
số
Quy mô của hội đồng tại khối đã cho.
Ví dụ
caver.rpc.klay.getStorageAt
Trả về giá trị từ vị trí lưu trữ tại một địa chỉ đã cho.
Tham số
address
chuỗi
Địa chỉ nơi để nhận bộ nhớ lưu trữ.
vị trí
số
Vị trí chỉ mục của bộ nhớ lưu trữ. Để biết thêm thông tin về tính toán vị trí
, hãy tham khảo klay_getStorageAt.
blockNumber
số \
chuỗi
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ề chuỗi
chuỗi
Giá trị tại vị trí lưu trữ này.
Ví dụ
caver.rpc.klay.isMinting
Giá trị trả về là true
nếu máy khách đang tích cực khai thác các khối mới.
Tham số
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 máy khách đang khai thác, nếu không sẽ là false
.
Ví dụ
caver.rpc.klay.isSyncing
Trả về đối tượng có dữ liệu về trạng thái đồng bộ hóa hoặc false.
Tham số
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ề object|boolean
- false
nếu Nút Klaytn không đồng bộ hóa. Nếu không, một đối tượng đồng bộ sẽ được trả về:
startingBlock
chuỗi
Số khối ở dạng hex nơi mà quy trình đồng bộ hóa bắt đầu.
currentBlock
chuỗi
Số khối ở dạng hex nơi nút hiện được đồng bộ hóa đến.
highestBlock
chuỗi
Số khối ước tính dạng hex để đồng bộ hóa đến.
knownStates
chuỗi
Các trạng thái ước tính dạng hex cần tải xuống.
pulledStates
chuỗi
Các trạng thái đã tải xuống dạng hex.
Ví dụ
caver.rpc.klay.call
Thực thi lệnh gọi thông báo ngay mà không gửi giao dịch trên chuỗi khối. Trả về dữ liệu hoặc đối tượng lỗi của JSON RPC nếu xảy ra lỗi.
Tham số
callObject
đối tượng
Đối tượng lệnh gọi giao dịch. Xem bảng tiếp theo để biết thuộc tính của đối tượng.
blockNumber
số \
chuỗi
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.
callObject
có các thuộc tính như sau:
đến
chuỗi
(tùy chọn khi thử nghiệm triển khai hợp đồng mới) Địa chỉ mà giao dịch được chuyển đến.
nhập
chuỗi
(tùy chọn) Hàm băm của chữ ký phương pháp và tham số mã hóa. Bạn có thể sử dụng caver.abi.encodeFunctionCall.
từ
chuỗi
(tùy chọn) Địa chỉ nơi giao dịch được gửi đi.
gas
chuỗi
(tùy chọn) Gas được cung cấp để thực hiện giao dịch. klay_call
không sử dụng gas, nhưng một số lần thực thi có thể cần tham số này.
giá gas
chuỗi
(tùy chọn) gasPrice được sử dụng cho mỗi loại gas đã thanh toán.
giá trị
chuỗi
(tùy chọn) Giá trị được gửi cùng với giao dịch này bằng peb
.
Giá trị trả về
Promise
trả về chuỗi
chuỗi
Dữ liệu trả về của lệnh gọi. ví dụ: giá trị trả về của hàm hợp đồng thông minh.
Ví dụ
caver.rpc.klay.estimateGas
Tạo và trả về giá trị lượng gas
ước tính cần thiết để cho phép hoàn tất giao dịch. Giao dịch từ phương pháp này sẽ không được thêm vào chuỗi khối.
Tham số
Xem các tham số caver.rpc.klay.call, ngoại trừ việc tất cả các thuộc tính đều là tùy chọn.
Giá trị trả về
Promise
trả về chuỗi
chuỗi
Lượng gas được sử dụng.
Ví dụ
caver.rpc.klay.estimateComputationCost
Tạo và trả về chi phí tính toán
ước tính sẽ được sử dụng để thực thi giao dịch. Klaytn giới hạn chi phí tính toán của một giao dịch ở mức 100000000
, hiện không mất quá nhiều thời gian cho một giao dịch. Giao dịch sẽ không được thêm vào chuỗi khối như caver.rpc.klay.estimateGas.
Tham số
Xem các tham số caver.rpc.klay.call, ngoại trừ việc tất cả các thuộc tính đều là tùy chọn.
Giá trị trả về
Promise
trả về chuỗi
chuỗi
Lượng chi phí tính toán được sử dụng.
Ví dụ
caver.rpc.klay.getTransactionByBlockHashAndIndex
Trả về thông tin về giao dịch của khối theo hàm băm và vị trí chỉ mục của giao dịch.
Tham số
blockHash
chuỗi
Hàm băm khối.
chỉ mục
số
Một vị trí chỉ mục giao dịch bên trong khối.
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ề đối tượng
đối tượng
Một đối tượng giao dịch, hãy xem caver.rpc.klay.getTransactionByHash để biết thêm thông tin chi tiết.
Ví dụ
caver.rpc.klay.getTransactionByBlockNumberAndIndex
Trả về thông tin về giao dịch theo số khối
và vị trí chỉ mục giao dịch
.
Tham số
blockNumber
số \
chuỗi
chỉ mục
số
Một vị trí chỉ mục giao dịch bên trong khối.
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ề đối tượng
đối tượng
Một đối tượng giao dịch, hãy xem caver.rpc.klay.getTransactionByHash để biết thêm thông tin chi tiết.
Ví dụ
caver.rpc.klay.getTransactionByHash
Trả về thông tin về một giao dịch được yêu cầu theo hàm băm giao dịch.
Tham số
transactionHash
chuỗi
Hàm băm của giao dịch.
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ề đối tượng
- Một đối tượng giao dịch hoặc null
khi không tìm thấy giao dịch:
blockHash
chuỗi
Hàm băm của khối chứa giao dịch này.
blockNumber
chuỗi
Số khối chứa giao dịch này.
codeFormat
chuỗi
(tùy chọn) Định dạng mã của mã hợp đồng thông minh.
feePayer
chuỗi
(tùy chọn) Địa chỉ của người trả phí.
feePayerSignatures
Mảng
(tùy chọn) Mảng các đối tượng chữ ký của người trả phí. Một đối tượng chữ ký chứa ba trường (V, R và S). V chứa mã khôi phục ECDSA. R chứa chữ ký ECDSA r trong khi S chứa chữ ký ECDSA s.
feeRatio
chuỗi
(tùy chọn) Tỷ lệ phí của người trả phí. Nếu tỷ lệ là 30 thì người trả phí phải trả 30% phí. 70% còn lại sẽ được trả bởi người gửi.
từ
chuỗi
Địa chỉ của người gửi.
gas
chuỗi
Gas được người gửi cung cấp.
giá gas
chuỗi
Giá gas được người gửi cung cấp theo đơn vị peb.
hash
chuỗi
Hàm băm của giao dịch.
humanReadable
Boolean
(tùy chọn) true
nếu địa chỉ con người có thể đọc được, ngược lại sẽ là false
.
khóa
chuỗi
(tùy chọn) AccountKey được mã hóa RLP được sử dụng để cập nhật AccountKey của tài khoản Klaytn. Xem [AccountKey](../../../../../klaytn/design/tài khoảns.md#tài khoản-key) để biết thêm thông tin chi tiết.
nhập
chuỗi
(tùy chọn) Dữ liệu được gửi cùng với giao dịch.
số dùng một lần
chuỗi
Số lượng giao dịch được người gửi thực hiện trước giao dịch này.
senderTxHash
chuỗi
(tùy chọn) Hàm băm của tx mà không có địa chỉ và chữ ký của người trả phí. Giá trị này luôn giống với giá trị của hàm băm
đối với các giao dịch không ủy thác phí.
chữ ký
Mảng
Một mảng các đối tượng chữ ký. Một đối tượng chữ ký chứa ba trường (V, R và S). V chứa mã khôi phục ECDSA. R chứa chữ ký ECDSA r trong khi S chứa chữ ký ECDSA s.
đến
chuỗi
Địa chỉ của người nhận. null
nếu đó là giao dịch triển khai hợp đồng.
transactionIndex
chuỗi
Giá trị nguyên biểu thị vị trí chỉ mục của giao dịch trong khối.
loại
chuỗi
Chuỗi biểu thị loại giao dịch.
typeInt
số
Giá trị nguyên biểu thị loại giao dịch.
giá trị
chuỗi
Giá trị được chuyển tính bằng đơn vị peb.
Nếu giao dịch ở trạng thái đang chờ xử lý
chưa được xử lý, các giá trị mặc định cho blockHash
, blockNumber
và transactionIndex
sẽ được trả về. Xem ví dụ bên dưới.
Ví dụ
caver.rpc.klay.getTransactionBySenderTxHash
Trả về thông tin về một giao dịch được yêu cầu theo hàm băm giao dịch của người gửi.
Xin lưu ý rằng API này chỉ trả về kết quả chính xác nếu tính năng lập chỉ mục được bật trong nút mạng bởi --sendertxhashindexing
. Sử dụng thuộc tính caver.rpc.klay.isSenderTxHashIndexingEnabled để kiểm tra xem tính năng lập chỉ mục đã được bật hay chưa.
Tham số
senderTxHash
chuỗi
Hàm băm giao dịch của người gửi. Tham khảo SenderTxHash để biết thêm thông tin chi tiế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ề đối tượng
đối tượng
Một đối tượng giao dịch, hãy xem caver.rpc.klay.getTransactionByHash để biết thêm thông tin chi tiết.
Ví dụ
caver.rpc.klay.getTransactionReceipt
Trả về biên lai của một giao dịch theo hàm băm giao dịch.
LƯU Ý Biên lai không khả dụng cho các giao dịch đang chờ xử lý
có các giao dịch chưa được xử lý.
Tham số
transactionHash
chuỗi
Hàm băm của giao dịch.
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ề đối tượng
- Đối tượng biên lai giao dịch hoặc null
khi không tìm thấy biên lai:
blockHash
chuỗi
Hàm băm của khối chứa giao dịch này.
blockNumber
chuỗi
Số khối chứa giao dịch này.
codeFormat
chuỗi
(tùy chọn) Định dạng mã của mã hợp đồng thông minh.
contractAddress
chuỗi
Địa chỉ hợp đồng được tạo nếu giao dịch là giao dịch tạo hợp đồng, nếu không, giá trị sẽ là null
.
effectiveGasPrice
chuỗi
Giá trị thực tế trên mỗi gas được khấu trừ từ người gửi. Trước khi nâng cấp căn bản Magma, giá trị này bằng với giá gas của giao dịch. Sau nâng cấp căn bản Magma, giá trị này bằng với giá trị của baseFee
trong tiêu đề khối.
feePayer
chuỗi
(tùy chọn) Địa chỉ của người trả phí.
feePayerSignatures
Mảng
(tùy chọn) Mảng các đối tượng chữ ký của người trả phí. Một đối tượng chữ ký chứa ba trường (V, R và S). V chứa mã khôi phục ECDSA. R chứa chữ ký ECDSA r trong khi S chứa chữ ký ECDSA s.
feeRatio
chuỗi
(tùy chọn) Tỷ lệ phí của người trả phí. Nếu tỷ lệ là 30 thì người trả phí phải trả 30% phí. 70% còn lại sẽ được trả bởi người gửi.
từ
chuỗi
Địa chỉ của người gửi.
gas
chuỗi
Gas được người gửi cung cấp.
giá gas
chuỗi
Giá gas được người gửi cung cấp theo đơn vị peb.
gasUsed
chuỗi
Lượng gas được sử dụng bởi riêng giao dịch cụ thể này.
humanReadable
Boolean
(tùy chọn) true
nếu địa chỉ con người có thể đọc được, ngược lại sẽ là false
.
khóa
chuỗi
(tùy chọn) AccountKey được mã hóa RLP được sử dụng để cập nhật AccountKey của tài khoản Klaytn.
nhập
chuỗi
(tùy chọn) Dữ liệu được gửi cùng với giao dịch.
bản ghi
Mảng
Mảng đối tượng bản ghi mà giao dịch này tạo ra.
nhật kýBloom
chuỗi
Bộ lọc Bloom dành cho các ứng dụng khách nhẹ giúp truy xuất nhanh các bản ghi liên quan.
số dùng một lần
chuỗi
Số lượng giao dịch được người gửi thực hiện trước giao dịch này.
senderTxHash
chuỗi
(tùy chọn) Hàm băm của một giao dịch chỉ được người gửi ký. Xem SenderTxHash. Giá trị này luôn giống với transactionHash
đối với các giao dịch không ủy thác phí.
chữ ký
Mảng
Một mảng các đối tượng chữ ký. Một đối tượng chữ ký chứa ba trường (V, R và S). V chứa mã khôi phục ECDSA. R chứa chữ ký ECDSA r trong khi S chứa chữ ký ECDSA s.
trạng thái
chuỗi
0x1
nếu giao dịch thành công, 0x0
nếu Máy ảo Klaytn đặt lại giao dịch.
txError
chuỗi
(tùy chọn) mã lỗi chi tiết nếu trạng thái
bằng 0x0
.
đến
chuỗi
Địa chỉ của người nhận. null
nếu đó là giao dịch tạo hợp đồng.
transactionHash
chuỗi
Hàm băm của giao dịch.
transactionIndex
chuỗi
Giá trị nguyên biểu thị vị trí chỉ mục của giao dịch trong khối.
loại
chuỗi
Chuỗi biểu thị loại giao dịch.
typeInt
số
Giá trị nguyên biểu thị loại giao dịch.
giá trị
chuỗi
Giá trị được chuyển tính bằng đơn vị peb.
LƯU Ý effectiveGasPrice
được hỗ trợ kể từ caver-js phiên bản v1.9.0.
Ví dụ
caver.rpc.klay.getTransactionReceiptBySenderTxHash
Trả về biên lai của một giao dịch theo hàm băm giao dịch của người gửi.
Xin lưu ý rằng API này chỉ trả về kết quả chính xác nếu tính năng lập chỉ mục được bật trong nút mạng bởi --sendertxhashindexing
. Sử dụng thuộc tính caver.rpc.klay.isSenderTxHashIndexingEnabled để kiểm tra xem tính năng lập chỉ mục đã được bật hay chưa.
LƯU Ý Biên lai không khả dụng cho các giao dịch đang chờ xử lý
có các giao dịch chưa được xử lý.
Tham số
senderTxHash
chuỗi
Hàm băm giao dịch của người gửi. Tham khảo SenderTxHash để biết thêm thông tin chi tiế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ề đối tượng
đối tượng
Một đối tượng biên lai giao dịch, hãy xem caver.rpc.klay.getTransactionReceipt để biết thêm thông tin chi tiết.
Ví dụ
caver.rpc.klay.sendRawTransaction
Gửi một giao dịch đã ký
đến Klaytn.
Tham số signedTransaction
có thể là "Giao dịch đã ký được mã hóa RLP". Bạn có thể nhận giao dịch được mã hóa RLP của giao dịch đã ký bằng cách sử dụng transaction.getRLPEncoding
. Để thuận tiện, caver.rpc.klay.sendRawTransaction
cũng chấp nhận "phiên bản giao dịch đã ký" làm tham số.
Tham số
signedTransaction
chuỗi \
đối tượng
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ề
PromiEvent
Trình phát sự kiện kết hợp promise. Bộ phát này sẽ được xử lý khi có biên lai giao dịch.
Đối với PromiEvent, sẽ có các sự kiện sau đây:
transactionHash
trả vềchuỗi
: Được kích hoạt ngay sau khi gửi giao dịch và có hàm băm giao dịch.biên lai
trả vềđối tượng
: Được kích hoạt khi có sẵn biên lai giao dịch. Xem caver.rpc.klay.getTransactionReceipt để biết thêm thông tin chi tiết.lỗi
trả vềLỗi
: Được kích hoạt nếu có lỗi phát sinh trong quá trình gửi. Khi xảy ra lỗi hết gas, tham số thứ hai sẽ là biên lai.
Ví dụ
caver.rpc.klay.sendTransaction
Ký giao dịch với tư cách là người gửi
giao dịch bằng "khóa riêng tư của tài khoản đã nhập" trong Nút Klaytn của bạn và gửi giao dịch đến Klaytn.
Để biết thêm thông tin về từng loại giao dịch, hãy tham khảo Giao dịch.
LƯU Ý: API này cung cấp hàm để ký một giao dịch bằng tài khoản đã nhập trong nút Klaytn của bạn. Tài khoản đã nhập trong nút của bạn phải được [mở khóa](../../../../json-rpc/api-references/personal.md#personal_unlocktài khoản) để ký giao dịch.
Tham số
giao dịch
đối tượng
Một phiên bản của một giao dịch được gửi đến Klaytn.
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ề
PromiEvent
Trình phát sự kiện kết hợp promise. Bộ phát này sẽ được xử lý khi có biên lai giao dịch.
Đối với PromiEvent, sẽ có các sự kiện sau đây:
transactionHash
trả vềchuỗi
: Được kích hoạt ngay sau khi gửi giao dịch và có hàm băm giao dịch.biên lai
trả vềđối tượng
: Được kích hoạt khi có sẵn biên lai giao dịch. Xem caver.rpc.klay.getTransactionReceipt để biết thêm thông tin chi tiết.lỗi
trả vềLỗi
: Được kích hoạt nếu có lỗi phát sinh trong quá trình gửi. Khi xảy ra lỗi hết gas, tham số thứ hai sẽ là biên lai.
Ví dụ
caver.rpc.klay.sendTransactionAsFeePayer
Ký giao dịch ủy thác phí với tư cách là người trả phí
giao dịch bằng khóa riêng tư của tài khoản đã nhập
trong Nút Klaytn của bạn và gửi giao dịch đến Klaytn.
Trước khi sử dụng sendTransaction
với tư cách người trả phí, người gửi giao dịch phải ký bằng (các) chữ ký hợp lệ và số dùng một lần
phải được xác định.
Để biết thêm thông tin về từng loại giao dịch, hãy tham khảo Giao dịch.
LƯU Ý: API này cung cấp hàm để ký một giao dịch bằng tài khoản đã nhập trong nút Klaytn của bạn. Tài khoản đã nhập trong nút của bạn phải được [mở khóa](../../../../json-rpc/api-references/personal.md#personal_unlocktài khoản) để ký giao dịch.
Tham số
giao dịch
đối tượng
Một phiên bản giao dịch có ủy thác phí để gửi đến Klaytn.
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ề
PromiEvent
Trình phát sự kiện kết hợp promise. Bộ phát này sẽ được xử lý khi có biên lai giao dịch.
Đối với PromiEvent, sẽ có các sự kiện sau đây:
transactionHash
trả vềchuỗi
: Được kích hoạt ngay sau khi gửi giao dịch và có hàm băm giao dịch.biên lai
trả vềđối tượng
: Được kích hoạt khi có sẵn biên lai giao dịch. Xem caver.rpc.klay.getTransactionReceipt để biết thêm thông tin chi tiết.lỗi
trả vềLỗi
: Được kích hoạt nếu có lỗi phát sinh trong quá trình gửi. Khi xảy ra lỗi hết gas, tham số thứ hai sẽ là biên lai.
Ví dụ
caver.rpc.klay.signTransaction
Ký giao dịch với tư cách là người gửi giao dịch bằng "khóa riêng tư của tài khoản đã nhập" trong Nút Klaytn của bạn.
Để biết thêm thông tin về từng loại giao dịch, hãy tham khảo Giao dịch.
LƯU Ý: API này cung cấp hàm để ký một giao dịch bằng tài khoản đã nhập trong nút Klaytn của bạn. Tài khoản đã nhập trong nút của bạn phải được [mở khóa](../../../../json-rpc/api-references/personal.md#personal_unlocktài khoản) để ký giao dịch.
Tham số
giao dịch
đối tượng
Phiên bản của một giao dịch dùng để ký.
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ề đối tượng
- Một đối tượng bao gồm giao dịch đã ký:
raw
chuỗi
Giao dịch đã ký được mã hóa RLP.
tx
đối tượng
Đối tượng giao dịch bao gồm cả chữ ký của người gửi.
Ví dụ
caver.rpc.klay.signTransactionAsFeePayer
Ký giao dịch với tư cách là người trả phí giao dịch bằng "khóa riêng tư của tài khoản đã nhập" trong Nút Klaytn của bạn.
Để biết thêm thông tin về từng loại giao dịch, hãy tham khảo Giao dịch.
LƯU Ý: API này cung cấp hàm để ký một giao dịch bằng tài khoản đã nhập trong nút Klaytn của bạn. Tài khoản đã nhập trong nút của bạn phải được [mở khóa](../../../../json-rpc/api-references/personal.md#personal_unlocktài khoản) để ký giao dịch.
Tham số
giao dịch
đối tượng
Phiên bản của một giao dịch dùng để ký.
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ề đối tượng
- Một đối tượng bao gồm giao dịch đã ký:
raw
chuỗi
Giao dịch đã ký được mã hóa RLP.
tx
đối tượng
Đối tượng giao dịch để ký với tư cách là người trả phí.
Ví dụ
caver.rpc.klay.getDecodedAnchoringTransactionByHash
Trả về dữ liệu neo đã được giải mã trong giao dịch cho hàm băm giao dịch đã cho.
Tham số
transactionHash
chuỗi
Hàm băm của giao dịch.
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ề đối tượng
- Một đối tượng bao gồm dữ liệu neo được giải mã:
BlockHash
chuỗi
Hàm băm của khối chuỗi con mà giao dịch neo này đã được thực hiện.
BlockNumber
số
Số khối chuỗi con mà giao dịch neo này đã được thực hiện.
ParentHash
chuỗi
Hàm băm của khối cha mẹ.
TxHash
chuỗi
Gốc của trie giao dịch trong khối.
StateRootHash
chuỗi
Gốc của trie trạng thái cuối trong khối.
ReceiptHash
chuỗi
Gốc của trie biên lai giao dịch của khối.
BlockCount
số
Số khối được tạo trong khoảng thời gian neo này. Trong hầu hết các trường hợp, số này bằng với SC_TX_PERIOD
của chuỗi con ngoại trừ trường hợp giao dịch này là tx neo đầu tiên sau khi bật tính năng neo.
TxCount
số
Số lượng giao dịch được tạo trong chuỗi con trong khoảng thời gian neo này.
Ví dụ
caver.rpc.klay.getChainId
Trả về mã chuỗi của chuỗi.
Tham số
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ề chuỗi
chuỗi
ID chuỗi của chuỗi.
Ví dụ
caver.rpc.klay.getClientVersion
Trả về phiên bản máy khách hiện tại của nút Klaytn.
Tham số
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ề chuỗi
chuỗi
Phiên bản máy khách hiện tại của nút Klaytn.
Ví dụ
caver.rpc.klay.getGasPrice
Trả về mức giá hiện tại cho mỗi gas tính bằng peb.
Tham số
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ề chuỗi
chuỗi
Giá gas hiện tại tính bằng peb.
Ví dụ
caver.rpc.klay.getGasPriceAt
Trả về giá hiện tại cho mỗi gas tính bằng peb cho khối đã cho.
Tham số
blockNumber
số
(tùy chọn) Số khối. Nếu bị bỏ qua, hệ thống sẽ trả về đơn giá mới nhấ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ề chuỗi
chuỗi
Giá gas hiện tại tính bằng peb.
Ví dụ
caver.rpc.klay.getMaxPriorityFeePerGas
Trả về đề xuất giới hạn tối đa phí gas trả thêm cho giao dịch có mức phí thay đổi tính bằng peb. Vì Klaytn có giá gas cố định, nó sẽ trả về giá gas do Klaytn đặt.
Tham số
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ề chuỗi
chuỗi
Đề xuất về giới hạn tối đa phí gas trả thêm tính theo peb.
Ví dụ
caver.rpc.klay.getLowerBoundGasPrice
Trả về giá gas giới hạn dưới tính bằng peb.
Tham số
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ề chuỗi
chuỗi
Giá gas giới hạn dưới tính bằng peb.
Ví dụ
caver.rpc.klay.getUpperBoundGasPrice
Trả về giá gas giới hạn trên tính bằng peb.
Tham số
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ề chuỗi
chuỗi
Giá gas giới hạn trên bằng peb.
Ví dụ
caver.rpc.klay.getFeeHistory
Trả về lịch sử phí cho phạm vi khối được trả về. Đây có thể là một phần phụ của phạm vi được yêu cầu nếu không có sẵn tất cả các khối.
Tham số
blockCount
số\
BigNumber|BN|string
lastBlock
số\
BigNumber|BN|string
rewardPercentiles
Mảng
Một danh sách các giá trị phần trăm tăng dần đơn điệu để lấy mẫu từ phí ưu tiên hiệu quả của mỗi khối cho mỗi loại gas theo thứ tự tăng dần, được tính khối lượng theo loại gas được sử dụng. (Ví dụ, ['0', '25', '50', '75', '100']
hoặc ['0', '0.5', '1', '1.5', '3', '80']
)
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ề đối tượng
- Một đối tượng bao gồm lịch sử phí:
oldestBlock
chuỗi
Khối số thấp nhất của phạm vi được trả về.
phần thưởng
Mảng
Một mảng hai chiều của các khoản phí ưu tiên hiệu quả cho mỗi loại gas ở phần trăm khối được yêu cầu.
baseFeePerGas
Mảng
Mảng phí cơ bản của khối trên mỗi gas. Mảng này bao gồm khối tiếp theo sau khối mới nhất trong khoảng trả về, vì giá trị này có thể được suy ra từ khối mới nhất. Trả về các giá trị 0 cho các khối trước EIP-1559.
gasUsedRatio
Mảng
Một mảng gasUsed/gasLimit trong khối.
Ví dụ
caver.rpc.klay.createAccessList
Phương thức sẽ này tạo một accessList dựa trên một Giao dịch nhất định. accessList chứa tất cả các vị trí lưu trữ và địa chỉ được đọc và ghi bởi giao dịch, ngoại trừ tài khoản người gửi và các phần biên dịch trước. Phương thức này sử dụng cùng một đối tượng lệnh gọi giao dịch và đối tượng blockNumberOrTag như caver.rpc.klay.call
. Một accessList có thể được sử dụng để giải phóng các hợp đồng bị kẹt không thể truy cập được do chi phí gas tăng. Việc thêm một accessList vào giao dịch của bạn không nhất thiết dẫn đến việc sử dụng gas thấp hơn so với giao dịch không có danh sách truy cập.
Tham số
blockParameter
số\
BigNumber|BN|chuỗi
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ề đối tượng
- Một đối tượng bao gồm danh sách truy cập:
oldestBlock
chuỗi
Khối số thấp nhất của phạm vi được trả về.
phần thưởng
Mảng
Một mảng hai chiều của các khoản phí ưu tiên hiệu quả cho mỗi loại gas ở phần trăm khối được yêu cầu.
baseFeePerGas
Mảng
Mảng phí cơ bản của khối trên mỗi gas. Mảng này bao gồm khối tiếp theo sau khối mới nhất trong khoảng trả về, vì giá trị này có thể được suy ra từ khối mới nhất. Trả về các giá trị 0 cho các khối trước EIP-1559.
gasUsedRatio
Mảng
Một mảng gasUsed/gasLimit trong khối.
Ví dụ
caver.rpc.klay.isParallelDBWrite
Trả về giá trị true
nếu nút đang ghi dữ liệu chuỗi khối theo một phương pháp song song.
Tham số
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
boolean
Giá trị true
có nghĩa là nút đang ghi dữ liệu chuỗi khối theo một phương pháp song song. Trả về giá trị false
nếu nút đang ghi dữ liệu theo chuỗi.
Ví dụ
caver.rpc.klay.isSenderTxHashIndexingEnabled
Trả về giá trị true
nếu nút đang lập chỉ mục hàm băm giao dịch của người gửi thành thông tin ánh xạ hàm băm giao dịch.
Tham số
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
boolean
Giá trị true
có nghĩa là nút đang lập chỉ mục hàm băm giao dịch của người gửi thành thông tin ánh xạ hàm băm giao dịch.
Ví dụ
caver.rpc.klay.getProtocolVersion
Trả về phiên bản giao thức Klaytn của nút. Phiên bản hiện tại (kể từ v1.9.0) của Cypress/Baobab là istanbul/65
.
Tham số
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ề chuỗi
chuỗi
Phiên bản giao thức Klaytn của nút.
Ví dụ
caver.rpc.klay.getRewardbase
Trả về địa chỉ ví rewardbase của nút hiện tại. Rewardbase là địa chỉ của tài khoản nơi phần thưởng khối được chuyển đến. Chỉ yêu cầu đối với CN.
Tham số
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ề chuỗi
chuỗi
Địa chỉ rewardbase.
Ví dụ
caver.rpc.klay.getFilterChanges
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ố
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ề 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 cuối cùng.
Đối với các bộ lọc được tạo bằng [caver.rpc.klay.newBlockFilter](klay.md#caver-rpc-klay-newblockbộ lọc), kết quả trả về là các hàm băm khối, ví dụ:
["0x3454645634534..."]
.Đối với các bộ lọc được tạo bằng [caver.rpc.klay.newPendingTransactionFilter](klay.md#caver-rpc-klay-newpendingtransactionbộ lọc), kết quả trả về là các giá trị băm giao dịch, ví dụ:
["0x6345343454645..."]
.Đối với các bộ lọc được tạo bằng [caver.rpc.klay.newFilter](klay.md#caver-rpc-klay-newbộ lọc), bản ghi là các đối tượng có tham số như sau:
logIndex
chuỗi
Vị trí chỉ mục bản ghi trong khối.
transactionIndex
chuỗi
Vị trí chỉ mục của các giao dịch nơi bản ghi này được tạo.
transactionHash
chuỗi
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
chuỗi
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
chuỗi
Số khối chứa bản ghi này. Giá trị là null
nếu giao dịch đang chờ xử lý.
address
chuỗi
Địa chỉ mà bản ghi này được khởi tạo.
data
chuỗi
Chứa các đối số không được lập chỉ mục của bản ghi.
chủ đề
Mảng
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
.).
Ví dụ
caver.rpc.klay.getFilterLogs
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. Đối tượng bộ lọc phải được lấy bằng cách sử dụng [newFilter](klay.md#caver-rpc-klay-newbộ lọc).
Lưu ý rằng id bộ lọc được trả về bởi các hàm tạo bộ lọc khác như [caver.rpc.klay.newBlockFilter](klay.md#caver-rpc-klay-newblockbộ lọc) hoặc [caver.rpc.klay.newPendingTransactionFilter](klay.md#caver-rpc-klay-newpendingtransactionbộ lọc) không thể được sử dụng với hàm này.
Tham số
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ề
Xem [caver.rpc.klay.getFilterChanges](klay.md#caver-rpc-klay-getbộ lọcchanges)
Ví dụ
caver.rpc.klay.getLogs
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.
Tham số
tùy chọn
đối tượng
Các tùy chọn bộ lọc. Xem bảng dưới đây để tìm phần thông tin 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.
Đối tượng tùy chọn có thể chứa các thông tin sau:
fromBlock
số \
chuỗi
toBlock
số \
chuỗi
address
chuỗi \
Mảng
chủ đề
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 loại bỏ các chủ đề, hãy sử dụng null
, vd: [null, '0x12...']
. Bạn 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']]
.
Giá trị trả về
Xem [caver.rpc.klay.getFilterChanges](klay.md#caver-rpc-klay-getbộ lọcchanges)
Ví dụ
caver.rpc.klay.newBlockFilter
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 [caver.rpc.klay.getFilterChanges](klay.md#caver-rpc-klay-getbộ lọcchanges).
Tham số
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ề chuỗi
chuỗi
Id bộ lọc.
Ví dụ
caver.rpc.klay.newFilter
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 đã thay đổi hay chưa, hãy gọi ra [caver.rpc.klay.getFilterChanges](klay.md#caver-rpc-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
newFilter
, hãy gọi [caver.rpc.klay.getFilterLogs](klay.md#caver-rpc-klay-getbộ lọcnhật ký).
Để biết thông tin chi tiết về các chủ đề trong đối tượng bộ lọc, vui lòng 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ùy chọn
đối tượng
Các tùy chọn bộ lọc. Xem bảng dưới đây để tìm phần thông tin 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.
Đối tượng tùy chọn có thể chứa các thông tin sau:
fromBlock
số \
chuỗi
toBlock
số \
chuỗi
address
chuỗi \
Mảng
chủ đề
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 loại bỏ các chủ đề, hãy sử dụng null
, vd: [null, '0x12...']
. Bạn 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']]
.
Giá trị trả về
Promise
trả về chuỗi
chuỗi
Id bộ lọc.
Ví dụ
caver.rpc.klay.newPendingTransactionFilter
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 đã thay đổi hay chưa, hãy gọi ra [caver.rpc.klay.getFilterChanges](klay.md#caver-rpc-klay-getbộ lọcchanges).
Tham số
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ề chuỗi
chuỗi
Id bộ lọc.
Ví dụ
caver.rpc.klay.uninstallFilter
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, các bộ lọc sẽ hết thời gian chờ nếu lệnh [caver.rpc.klay.getFilterChanges](klay.md#caver-rpc-klay-getbộ lọcchanges) không được gọi ra trong một khoảng thời gian.
Tham số
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
boolean
true
nếu gỡ cài đặt bộ lọc thành công, nếu không sẽ là false
.
Ví dụ
caver.rpc.klay.sha3
Trả về Keccak-256 (không phải SHA3-256 đã chuẩn hóa) của dữ liệu đã cho. Bạn có thể sử dụng caver.utils.sha3 thay thế.
Tham số
data
Chuỗi
Dữ liệu được chuyển đổi thành hàm băm SHA3.
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ề chuỗi
chuỗi
Kết quả SHA3 của dữ liệu đã cho.
Ví dụ
Last updated