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ố
Tên | type | Mô tả |
---|---|---|
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
type | Mô tả |
---|---|
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ố
Tên | type | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
đố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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
đố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ên | Loại | Mô tả |
---|---|---|
tài khoảnKey | đối tượng | Một đối tượng xác định |
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
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
đối tượng | Một đối tượng xác định |
Ví dụ
caver.rpc.klay.getBalance
Trả về số dư tài khoản của địa chỉ đã cho trong Klaytn.
Tham số
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
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ố
Tên | type | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
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ố
Tên | Loạ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ề Mảng
type | Mô tả |
---|---|
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ố
Tên | Loạ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ề chuỗi
Loại | Mô tả |
---|---|
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ố
Tên | type | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
đố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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
đố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ố
Tên | Loại | Mô tả |
---|---|---|
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:
Tên | Loại | Mô tả |
---|---|---|
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 |
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. |
nhật kýBloom | chuỗi | Bộ lọc Bloom cho các bản ghi của khối. |
số | chuỗi | Số khối. |
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ố
Tên | Loại | Mô tả |
---|---|---|
blockNumberOrHash | số \ | chuỗi |
returnTransactionObjects | boolean | (tùy chọn, mặc định |
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
Loại | Mô tả |
---|---|
đố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ố
Tên | Loại | Mô tả |
---|---|---|
blockNumber | số \ | chuỗi |
returnTransactionObjects | boolean | (tùy chọn, mặc định |
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
Loại | Mô tả |
---|---|
đố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ố
Tên | Loại | Mô tả |
---|---|---|
blockHash | chuỗi | Hàm băm khối. |
returnTransactionObjects | boolean | (tùy chọn, mặc định |
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:
Tên | Loại | Mô tả |
---|---|---|
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 |
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. |
nhật kýBloom | chuỗi | Bộ lọc Bloom cho các bản ghi của khối. |
số | chuỗi | Số khối. |
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ố |
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ố
Tên | Loại | Mô tả |
---|---|---|
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
type | Mô tả |
---|---|
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 |
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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
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ố
Tên | type | Mô tả |
---|---|---|
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
type | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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:
Tên | Loại | Mô tả |
---|---|---|
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. |
nhật kýBloom | chuỗi | Bộ lọc Bloom cho các bản ghi của khối. |
số | chuỗi | Số khối. |
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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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ố
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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ố
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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ề |
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
Loại | Mô tả |
---|---|
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ố
Tên | Loạ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ề 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ố
Tên | Loạ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ề 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ề:
Tên | Loại | Mô tả |
---|---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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:
Tên | Loại | Mô tả |
---|---|---|
đế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. |
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 |
Giá trị trả về
Promise
trả về chuỗi
Loại | Mô tả |
---|---|
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
Loại | Mô tả |
---|---|
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
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
đố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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
đố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ố
Tên | Loại | Mô tả |
---|---|---|
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:
Tên | Loại | Mô tả |
---|---|---|
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) |
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 |
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. |
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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
đố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ố
Tên | Loại | Mô tả |
---|---|---|
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:
Tên | Loại | Mô tả |
---|---|---|
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à |
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 |
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) |
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 |
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 |
|
txError | chuỗi | (tùy chọn) mã lỗi chi tiết nếu |
đến | chuỗi | Địa chỉ của người nhận. |
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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
đố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ố
Tên | Loại | Mô tả |
---|---|---|
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ề
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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ề
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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ề
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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ý:
Tên | Loại | Mô tả |
---|---|---|
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ố
Tên | type | Mô tả |
---|---|---|
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ý:
Tên | Loại | Mô tả |
---|---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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ã:
Tên | Loại | Mô tả |
---|---|---|
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 |
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ố
Tên | Loạ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ề chuỗi
Loại | Mô tả |
---|---|
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ố
Tên | Loạ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ề chuỗi
Loại | Mô tả |
---|---|
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ố
Tên | Loạ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ề chuỗi
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
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ố
Tên | Loạ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ề chuỗi
Loại | Mô tả |
---|---|
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ố
Tên | Loạ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ề chuỗi
Loại | Mô tả |
---|---|
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ố
Tên | Loạ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ề chuỗi
Loại | Mô tả |
---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
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ụ, |
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í:
Tên | Loại | Mô tả |
---|---|---|
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ố
Tên | Loại | Mô tả |
---|---|---|
callObject | đối tượng | Đối tượng lệnh gọi giao dịch. Vui lòng xem các tham số caver.rpc.klay.call. |
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:
Tên | Loại | Mô tả |
---|---|---|
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ố
Tên | Loạ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ề boolean
Loại | Mô tả |
---|---|
boolean | Giá trị |
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ố
Tên | Loạ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ề boolean
Loại | Mô tả |
---|---|
boolean | Giá trị |
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ố
Tên | Loạ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ề chuỗi
Loại | Mô tả |
---|---|
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ố
Tên | Loạ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ề chuỗi
Loại | Mô tả |
---|---|
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ố
Tên | Loạ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ề 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:
Tên | Loại | Mô tả |
---|---|---|
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à |
blockHash | chuỗi | Hàm băm của khối chứa bản ghi này. Giá trị là |
blockNumber | chuỗi | Số khối chứa bản ghi này. Giá trị 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ụ: |
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ố
Tên | Loạ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ề
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ên | Loại | Mô tả |
---|---|---|
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:
Tên | Loại | Mô tả |
---|---|---|
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 |
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ố
Tên | Loạ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ề chuỗi
Loại | Mô tả |
---|---|
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ên | Loại | Mô tả |
---|---|---|
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:
Tên | Loại | Mô tả |
---|---|---|
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 |
Giá trị trả về
Promise
trả về chuỗi
Loại | Mô tả |
---|---|
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ố
Tên | Loạ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ề chuỗi
Loại | Mô tả |
---|---|
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ố
Tên | Loạ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
Loại | Mô tả |
---|---|
boolean |
|
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ố
Tên | Loại | Mô tả |
---|---|---|
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
Loại | Mô tả |
---|---|
chuỗi | Kết quả SHA3 của dữ liệu đã cho. |
Ví dụ
Last updated